From 918bb997b9719bab2fe5f3ce5cace66c92143d79 Mon Sep 17 00:00:00 2001
From: Hide_D <hided62@gmail.com>
Date: Sat, 9 Mar 2024 18:14:15 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20NPC=20=EB=AA=85=EB=A0=B9=20=EC=84=A0?=
 =?UTF-8?q?=ED=83=9D=EA=B8=B0=20=ED=95=AD=EB=AA=A9=20=EC=A0=9C=EA=B1=B0,?=
 =?UTF-8?q?=20Server=20Action=20Queue=20=EC=B6=94=EA=B0=80=20-=20NPC=20?=
 =?UTF-8?q?=EB=AA=85=EB=A0=B9=20=EC=84=A0=ED=83=9D=EC=9D=80=20=EA=B8=B0?=
 =?UTF-8?q?=EC=A1=B4=EC=B2=98=EB=9F=BC=20=EB=8F=99=EA=B8=B0=20=EB=AA=A8?=
 =?UTF-8?q?=EB=93=9C=EB=A1=9C=20=EA=B5=AC=ED=98=84=20=20=20-=20=EB=A1=9C?=
 =?UTF-8?q?=EC=A7=81=EC=9D=84=20=EC=B5=9C=EB=8C=80=ED=95=9C=20=EA=B8=B0?=
 =?UTF-8?q?=EC=A1=B4=EA=B3=BC=20=EC=9C=A0=EC=82=AC=ED=95=98=EA=B2=8C=20-?=
 =?UTF-8?q?=20Server=20Action=20Queue=20=EC=B6=94=EA=B0=80=20=20=20-=20?=
 =?UTF-8?q?=EC=99=B8=EB=B6=80=20=EC=9D=B4=EB=B2=A4=ED=8A=B8=20=EB=A3=A8?=
 =?UTF-8?q?=ED=94=84=EA=B0=80=20=EA=B4=80=EB=A6=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/Component.md                 |  33 ++------
 docs/engine_issue_port.drawio.svg | 123 +++++++++++-------------------
 docs/threads.drawio.svg           |  63 +--------------
 3 files changed, 51 insertions(+), 168 deletions(-)

diff --git a/docs/Component.md b/docs/Component.md
index 31ff39c..013bc34 100644
--- a/docs/Component.md
+++ b/docs/Component.md
@@ -51,12 +51,13 @@ Collection은 다양하나, 게임 엔진에 필요한 값과 게임 엔진에 
 게임 엔진은 내부적으로 세개의 처리 큐를 가집니다.
 
 - 장수 처리 Queue: 턴마다 처리되는 장수 명령 처리 Queue입니다.
-- NPC Action Queue: NPC의 명령을 처리하는 Queue입니다.
-  - NPC 명령 선택기의 입력 요청이 이곳에 쌓입니다.
-- 유저 Action Queue: 유저의 명령을 처리합니다.
+  - 내부적으로는 Double Ended Queue로 구현한 일종의 Priority Queue입니다.
+- Server Action Queue: 서버 내 각종 외부 이벤트를 처리하는 Queue입니다.
+  - 경매, 토너먼트, 관리자 처리등이 해당합니다.
+- User Action Queue: 유저의 명령을 처리합니다.
   - API 처리기를 통해 전달됩니다.
 
-세개의 처리 큐는 장수 처리 Queue > NPC Action Queue > 유저 Action Queue 순의 우선순위를 가집니다.
+세개의 처리 큐는 장수 처리 Queue > Server Action Queue > User Action Queue 순의 우선순위를 가집니다.
 
 #### DB 반영 시점
 
@@ -66,20 +67,6 @@ MongoDB에 데이터가 기록되는 시점은 Queue의 아이템 하나를 해
 게임 엔진 내에서 변경되는 내용은 메모리 내의 저장소에만 담아두고, 처리를 마치는 시점에 변경된 내용을 정리하여 한번에 쓰기 작업을 수행하여 Transaction을 모사합니다.
 
 
-### NPC 명령 선택기
-
-NPC 명령 선택기는 NPC가 어떤 턴을 실행해야할지만을 연산하는 컴포넌트입니다.
-
-NPC의 실행턴보다 일정 시간 이전에 적절한 턴이 무엇인지 계산하고, 게임 엔진으로 결과값을 전송합니다.
-
-이때 명령의 규격은 일반 유저가 내리는 명령 규격과 유사한 형태를 갖습니다.
-
-> [!NOTE]
->
-> 기존 삼모전 PHP에서는 명령 선택기가 게임 엔진과 동기적으로 구성되어있었습니다.
-
-
-
 ### API 처리기
 
 API 처리기는 유저의 명령을 받아 1차적으로 처리합니다.
@@ -100,6 +87,8 @@ API 처리기는 유저의 명령을 받아 1차적으로 처리합니다.
 
 API 처리기와 연계되어(= 같은 스레드에서) 운용됩니다.
 
+외부 이벤트 처리기가 게임 엔진에 요청하는 경우 `Server Action Queue`를 사용합니다.
+
 ## 기존 삼국지 모의전투 PHP와 비교하여 달라진 부분
 
 ### 게임 엔진
@@ -110,14 +99,6 @@ PHP 버전에서 장수 처리 Queue는 `sammo::TurnExecutionHelper`에 해당
 
 이러한 처리 방법은 장수 처리 Queue 하나만으로 운영되는 형태로 생각할 수 있습니다.
 
-### NPC 명령 선택기
-
-NPC의 실행 턴이 무엇이 될지는 엔진내에 NPC 턴 실행 직전에 결정되므로, 게임 엔진 에서 처리되어있다고 볼 수 있습니다.
-
-`sammo::GeneralAI`가 처리를 전담하고 있으며, `sammo::TurnExecutionHelper`가 `sammo::GeneralAI::chooseNationTurn()`, `sammo::GeneralAI::chooseGeneralTurn()`를 호출하는 방식입니다.
-
-게임 엔진과 분리되어 있지 않으므로, 턴 입력, 세율 조정 등의 작업이 직접 이루어졌습니다.
-
 ### API 처리기
 
 유기체 서버 시절에서는 `c_*.php` 계열 함수들이 API를 처리하는 형태였고, 이후 HiDCHe 에서 json web api 처리를 위해 `j_*.php` 계열 함수들이 추가되었습니다.
diff --git a/docs/engine_issue_port.drawio.svg b/docs/engine_issue_port.drawio.svg
index 246911a..8ce3dc8 100644
--- a/docs/engine_issue_port.drawio.svg
+++ b/docs/engine_issue_port.drawio.svg
@@ -1,4 +1,4 @@
-<svg host="65bd71144e" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="441px" height="271px" viewBox="-0.5 -0.5 441 271" content="&lt;mxfile&gt;&lt;diagram id=&quot;ovDIAAWsHlNK0DibyGEH&quot; name=&quot;페이지-1&quot;&gt;zZjBjpswEIafxlJ7iQAbYh9twraXVq320LMTvAGJhIiQJrtP37ExCQSiUikFLsjM2GB/8zNjg3C4u3wp5CH5lscqQ54TXxBeIc8LAgxXbXivDJQElWFbpHFlcm+G1/RDWaNjrac0VsdWxzLPszI9tI2bfL9Xm7Jlk0WRn9vd3vKs/daD3KqO4XUjs671VxqXiV2Ft7zZv6p0m9RvdgNWeXay7mxXckxknJ8bJhwhHBZ5Xlat3SVUmWZXc6nGvTzwXidWqH05ZIBXDfgts5NdG4pCxCLEfd2gFDEqoYPjIsw9G7Zj+V6TKPLTPlb6YQ7C4pykpXo9yI32niH0YEvKXQZ3MF7Yd6miVJeH83WvFEA9Kt+psniHLnaARy04qxzi2PvzLQ5uDTdpxABbm7Sh314ffaMDDQuoHxYeAAv8ui083Y4E4gHi8GDn50nBoMf43EnwYTwQH3kCPjIA31prjYDWfDY/rQ2F9Qyt+R1Yi8VifkiCEZEEA/TzAR1AOvPUDxsR1rIfVoi4yU9w1bNz+KZM8/1s8lPgTJif6MD8hKIVogQJAmsJIamFwDrIYCJiXUBrq1sm9XPETQ0QGDHXFgYqTAQ4EksdgYZ36dSLn1Cz9wEYXF+fEQDWCcD3H+H8RErIhCKtt8BtSLJWF8iS1h+63ovoafiTq+qe2Ki7Ntd9TOz2IXc/YNjEBZpj6wMWejcniEVMyfzQjirG7vEB0G7+ivaa/VaIMbNpnhvF5ZgUh5wr3gxUrg8WYmV0uESc1JbKhZEI+0sRdBCuHUWpjQ/jiJpHMZD3avIYdEoPGTMG/YcTqNY6A0CDG9ogal9betOF3lO5pk9ganyTdhXOKkzUGOdGm45Ju3u6MWR8xFemoXensp9yp8ThWZS4e56+NybPIUejy6cu4/XnB5A9Xecis1cVrJnMHZtOWMM9O/ZDT6VPYd89aUENjHtgSw1b7vT69+vjwaz9n+HDzYtxQz+s883U8O9Lp+/+P/hwe/s1anyN/8s4+gM=&lt;/diagram&gt;&lt;/mxfile&gt;">
+<svg host="65bd71144e" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="441px" height="271px" viewBox="-0.5 -0.5 441 271" content="&lt;mxfile&gt;&lt;diagram id=&quot;ovDIAAWsHlNK0DibyGEH&quot; name=&quot;페이지-1&quot;&gt;zZhNk6IwEIZ/Tap2LxYQPsIxQWb2soctD3tGyQhVKBbiqPPrtzsJIoJTHFzloqE7HZOn33SChEab03uV7LLfZSoL4ljpidA5cRzbYhZ8oeWsLSyg2rCu8tR0ag2L/Es2kcZ6yFO573Ssy7Ko813XuCq3W7mqO7akqspjt9tHWXR/dZesZc+wWCVF3/o3T+vMrMIJWvsvma+z5pdtP9SeTdJ0NivZZ0laHq9MNCY0qsqy1q3NKZIFwmu46Li3O97LxCq5rccEODrgMykOZm0kjkgYE+5hgzESsgQ6WDah3DFZ2tfnhkRVHrapxMEsQsUxy2u52CUr9B4h92DL6k0BTxAv+pMz8/2UVS1PVyYz2XdZbmRdnaGL8TqNdIxyXMs8H9s82A3c7CoH1NgSk/r1ZeiWDjQMoGFYdAQs8GNbONiOBeE+4TCw9ecgIeg+Pvsl+Cgdic99AD53BL4las0FrXnh9LQ2FtYjtOb1YM1ms+kh8Z+IxB+hny/oANKZpn7CJ8IKhmFFhKv6BJ84O4uv6rzcTqY++dYL6xMbWZ9IPCfMJcKFtURQ1CJg7RcwEbGsoLXGlir9nHB1BghKQtscDEyoDHAiAszAlTewmsW/ULO3CRh9vj4iAWEvAQtZwdynp1PXfaFO7f7ZoATlET5XDdzbyZAmI6Vb1lQCvKzgxL3pyc59Js8xB8vpR5/x8ucdyA7e+WK100V4XS70hreQ/sU9OfbsmezvnFMd9h8KHMdLtZgrcAHhbmPRLkpENFyGoYOwTRRjpn6HnDA1VAjVd/6IHPSAD6RldD15atm17xx8+q4g8MgCbqhiW7/LDORicB/gJcNWgb4Zqk2BzrEeiinji1Nwuw28sVfbh6Sgf/R1uEH9YPp1kqHO0aW4GZKqHuFu4areKLZ42RxKSu8+MzXpP7P0N+PeSB9wY30RKPeW8jf7Qd3rdFFnbxg+Aj0Erl5Ov6d65//Rh8f2jy3lu/p7kMb/AA==&lt;/diagram&gt;&lt;/mxfile&gt;">
     <defs/>
     <g>
         <rect x="0" y="70" width="120" height="30" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/>
@@ -129,68 +129,13 @@
                     <div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 20px; margin-left: 161px;">
                         <div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;">
                             <div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">
-                                NPC Action Queue
+                                Server Action Queue
                             </div>
                         </div>
                     </div>
                 </foreignObject>
                 <text x="220" y="24" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">
-                    NPC Action Queue
-                </text>
-            </switch>
-        </g>
-        <rect x="160" y="70" width="120" height="30" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/>
-        <g transform="translate(-0.5 -0.5)">
-            <switch>
-                <foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;">
-                    <div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 85px; margin-left: 161px;">
-                        <div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;">
-                            <div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">
-                                NPCa 세율 20%
-                            </div>
-                        </div>
-                    </div>
-                </foreignObject>
-                <text x="220" y="89" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">
-                    NPCa 세율 20%
-                </text>
-            </switch>
-        </g>
-        <rect x="160" y="100" width="120" height="40" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/>
-        <g transform="translate(-0.5 -0.5)">
-            <switch>
-                <foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;">
-                    <div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 120px; margin-left: 161px;">
-                        <div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;">
-                            <div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">
-                                NPCa 턴1
-                                <br/>
-                                출병 무위
-                            </div>
-                        </div>
-                    </div>
-                </foreignObject>
-                <text x="220" y="124" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">
-                    NPCa 턴1...
-                </text>
-            </switch>
-        </g>
-        <rect x="160" y="140" width="120" height="40" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/>
-        <g transform="translate(-0.5 -0.5)">
-            <switch>
-                <foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;">
-                    <div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 160px; margin-left: 161px;">
-                        <div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;">
-                            <div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">
-                                NPCc 턴1
-                                <br/>
-                                귀환
-                            </div>
-                        </div>
-                    </div>
-                </foreignObject>
-                <text x="220" y="164" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">
-                    NPCc 턴1...
+                    Server Action Queue
                 </text>
             </switch>
         </g>
@@ -201,15 +146,15 @@
                     <div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 130px; margin-left: 321px;">
                         <div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;">
                             <div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">
-                                장수f 경매결과
+                                국가a
                                 <br/>
-                                백마 획득
+                                세율 30%
                             </div>
                         </div>
                     </div>
                 </foreignObject>
                 <text x="380" y="134" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">
-                    장수f 경매결과...
+                    국가a...
                 </text>
             </switch>
         </g>
@@ -220,35 +165,34 @@
                     <div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 170px; margin-left: 321px;">
                         <div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;">
                             <div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">
-                                시스템
+                                장수x(국가b)
                                 <br/>
-                                적토마 잠금
+                                사령턴1 발령
                             </div>
                         </div>
                     </div>
                 </foreignObject>
                 <text x="380" y="174" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">
-                    시스템
-적토마 잠금
+                    장수x(국가b)...
                 </text>
             </switch>
         </g>
-        <rect x="320" y="190" width="120" height="40" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/>
+        <rect x="160" y="70" width="120" height="40" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/>
         <g transform="translate(-0.5 -0.5)">
             <switch>
                 <foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;">
-                    <div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 210px; margin-left: 321px;">
+                    <div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 90px; margin-left: 161px;">
                         <div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;">
                             <div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">
-                                국가a
+                                장수f 경매결과
                                 <br/>
-                                세율 30%
+                                백마 획득
                             </div>
                         </div>
                     </div>
                 </foreignObject>
-                <text x="380" y="214" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">
-                    국가a...
+                <text x="220" y="94" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">
+                    장수f 경매결과...
                 </text>
             </switch>
         </g>
@@ -259,34 +203,53 @@
                     <div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 250px; margin-left: 321px;">
                         <div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;">
                             <div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">
-                                장수x(국가b)
+                                유니크 경매
                                 <br/>
-                                사령턴1 발령
+                                적토마 잠금
                             </div>
                         </div>
                     </div>
                 </foreignObject>
                 <text x="380" y="254" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">
-                    장수x(국가b)...
+                    유니크 경매...
                 </text>
             </switch>
         </g>
-        <rect x="160" y="180" width="120" height="40" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/>
+        <rect x="160" y="110" width="120" height="40" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/>
         <g transform="translate(-0.5 -0.5)">
             <switch>
                 <foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;">
-                    <div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 200px; margin-left: 161px;">
+                    <div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 130px; margin-left: 161px;">
                         <div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;">
                             <div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">
-                                NPCd(국가a)
+                                토너먼트 우승자
                                 <br/>
-                                사령턴1 포상
+                                장수b
                             </div>
                         </div>
                     </div>
                 </foreignObject>
-                <text x="220" y="204" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">
-                    NPCd(국가a)...
+                <text x="220" y="134" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">
+                    토너먼트 우승자...
+                </text>
+            </switch>
+        </g>
+        <rect x="320" y="190" width="120" height="40" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/>
+        <g transform="translate(-0.5 -0.5)">
+            <switch>
+                <foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;">
+                    <div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 210px; margin-left: 321px;">
+                        <div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;">
+                            <div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">
+                                설문 유니크 시도
+                                <br/>
+                                장수 c
+                            </div>
+                        </div>
+                    </div>
+                </foreignObject>
+                <text x="380" y="214" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">
+                    설문 유니크 시도...
                 </text>
             </switch>
         </g>
diff --git a/docs/threads.drawio.svg b/docs/threads.drawio.svg
index 15a5c2c..259a984 100644
--- a/docs/threads.drawio.svg
+++ b/docs/threads.drawio.svg
@@ -1,4 +1,4 @@
-<svg host="65bd71144e" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="751px" height="351px" viewBox="-0.5 -0.5 751 351" content="&lt;mxfile&gt;&lt;diagram id=&quot;wkgMyGHKSWno4An-QBqW&quot; name=&quot;페이지-1&quot;&gt;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&lt;/diagram&gt;&lt;/mxfile&gt;">
+<svg host="65bd71144e" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="511px" height="351px" viewBox="-0.5 -0.5 511 351" content="&lt;mxfile&gt;&lt;diagram id=&quot;wkgMyGHKSWno4An-QBqW&quot; name=&quot;페이지-1&quot;&gt;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&lt;/diagram&gt;&lt;/mxfile&gt;">
     <defs/>
     <g>
         <path d="M 390 285 C 390 276.72 416.86 270 450 270 C 465.91 270 481.17 271.58 492.43 274.39 C 503.68 277.21 510 281.02 510 285 L 510 335 C 510 343.28 483.14 350 450 350 C 416.86 350 390 343.28 390 335 Z" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/>
@@ -79,23 +79,6 @@
                 </text>
             </switch>
         </g>
-        <rect x="630" y="120" width="120" height="60" rx="9" ry="9" fill="rgb(255, 255, 255)" stroke="rgb(0, 0, 0)" pointer-events="all"/>
-        <g transform="translate(-0.5 -0.5)">
-            <switch>
-                <foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;">
-                    <div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 118px; height: 1px; padding-top: 150px; margin-left: 631px;">
-                        <div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;">
-                            <div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">
-                                NPC 명령 선택기
-                            </div>
-                        </div>
-                    </div>
-                </foreignObject>
-                <text x="690" y="154" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">
-                    NPC 명령 선택기
-                </text>
-            </switch>
-        </g>
         <path d="M 182 186.37 L 182 270" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/>
         <path d="M 182 181.12 L 185.5 188.12 L 182 186.37 L 178.5 188.12 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/>
         <path d="M 232.93 182.95 L 406.8 274" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/>
@@ -104,14 +87,8 @@
         <path d="M 388.88 135 L 381.88 138.5 L 383.63 135 L 381.88 131.5 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/>
         <path d="M 236.37 150 L 390 150" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="stroke"/>
         <path d="M 231.12 150 L 238.12 146.5 L 236.37 150 L 238.12 153.5 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/>
-        <path d="M 623.63 165 L 510 165" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/>
-        <path d="M 628.88 165 L 621.88 168.5 L 623.63 165 L 621.88 161.5 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/>
-        <path d="M 516.37 135 L 630 135" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/>
-        <path d="M 511.12 135 L 518.12 131.5 L 516.37 135 L 518.12 138.5 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/>
         <path d="M 438 180 L 438 263.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/>
         <path d="M 438 268.88 L 434.5 261.88 L 438 263.63 L 441.5 261.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/>
-        <path d="M 654.45 183.13 L 493.2 274" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/>
-        <path d="M 659.03 180.55 L 654.65 187.03 L 654.45 183.13 L 651.21 180.94 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/>
         <path d="M 158 180 L 158 263.63" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/>
         <path d="M 158 268.88 L 154.5 261.88 L 158 263.63 L 161.5 261.88 Z" fill="rgb(0, 0, 0)" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="all"/>
         <path d="M 462 186.37 L 462 270" fill="none" stroke="rgb(0, 0, 0)" stroke-miterlimit="10" pointer-events="stroke"/>
@@ -137,44 +114,6 @@
                 </text>
             </switch>
         </g>
-        <rect x="530" y="100" width="80" height="30" fill="none" stroke="none" pointer-events="all"/>
-        <g transform="translate(-0.5 -0.5)">
-            <switch>
-                <foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;">
-                    <div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 78px; height: 1px; padding-top: 115px; margin-left: 531px;">
-                        <div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;">
-                            <div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">
-                                NPC별
-                                <br/>
-                                턴 입력
-                            </div>
-                        </div>
-                    </div>
-                </foreignObject>
-                <text x="570" y="119" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">
-                    NPC별...
-                </text>
-            </switch>
-        </g>
-        <rect x="530" y="170" width="80" height="30" fill="none" stroke="none" pointer-events="all"/>
-        <g transform="translate(-0.5 -0.5)">
-            <switch>
-                <foreignObject pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility" style="overflow: visible; text-align: left;">
-                    <div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 78px; height: 1px; padding-top: 185px; margin-left: 531px;">
-                        <div data-drawio-colors="color: rgb(0, 0, 0); " style="box-sizing: border-box; font-size: 0px; text-align: center;">
-                            <div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; pointer-events: all; white-space: normal; overflow-wrap: normal;">
-                                NPC별
-                                <br/>
-                                턴 입력 요청
-                            </div>
-                        </div>
-                    </div>
-                </foreignObject>
-                <text x="570" y="189" fill="rgb(0, 0, 0)" font-family="Helvetica" font-size="12px" text-anchor="middle">
-                    NPC별...
-                </text>
-            </switch>
-        </g>
         <rect x="255" y="106" width="120" height="30" fill="none" stroke="none" pointer-events="all"/>
         <g transform="translate(-0.5 -0.5)">
             <switch>