{"id":2747,"date":"2026-10-25T23:23:27","date_gmt":"2026-10-25T23:23:27","guid":{"rendered":"https:\/\/wayhope.kro.kr\/?p=2747"},"modified":"2026-10-26T08:12:02","modified_gmt":"2026-10-26T08:12:02","slug":"colyseus%eb%a1%9c-%eb%a7%8c%eb%93%a0-%ec%8b%a4%ec%8b%9c%ea%b0%84-%ed%85%8d%ec%82%ac%ec%8a%a4-%ed%99%80%eb%8d%a4-%ed%94%8c%eb%9e%ab%ed%8f%bc","status":"publish","type":"post","link":"https:\/\/wayhope.kro.kr\/?p=2747","title":{"rendered":"Colyseus\ub85c \ub9cc\ub4e0 \uc2e4\uc2dc\uac04 \ud14d\uc0ac\uc2a4 \ud640\ub364 \ud50c\ub7ab\ud3fc"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/wayhope.kro.kr\/gitlab\/wayhope\/pokermultiplayer.git\">https:\/\/wayhope.kro.kr\/gitlab\/wayhope\/pokermultiplayer.git<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">TypeScript \ubaa8\ub178\ub808\ud3ec\ub97c \uae30\ubc18\uc73c\ub85c REST API, \uc2e4\uc2dc\uac04 \uac8c\uc784 \uc11c\ubc84, \ubaa8\ubc14\uc77c \ud074\ub77c\uc774\uc5b8\ud2b8, \uc778\ud504\ub77c\uae4c\uc9c0 \uad6c\ucd95\ud558\ub294 \uacfc\uc815\uc744 \uc815\ub9ac\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2e8\uc21c\ud788 \uc2e4\ud589\ub418\ub294 \ud3ec\ucee4 \uac8c\uc784\uc744 \ub9cc\ub4dc\ub294 \uac83\uc774 \ubaa9\ud45c\uac00 \uc544\ub2c8\ub2e4. \uce69\uc774 \uc624\uac00\ub294 \uc2e4\uc2dc\uac04 \uc2dc\uc2a4\ud15c\uc5d0\uc11c \ubc18\ub4dc\uc2dc \uc9c0\ucf1c\uc57c \ud558\ub294 <strong>\ub370\uc774\ud130 \uc815\ud569\uc131, \ubcf4\uc548, \ub3d9\uc2dc\uc131 \uc81c\uc5b4, \uc7a5\uc560 \ubcf5\uad6c, \uc6b4\uc601 \uc548\uc815\uc131<\/strong>\uc5d0 \ucd08\uc810\uc744 \ub9de\ucd98\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ub4e4\uc5b4\uac00\uba70<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\ud3ec\ucee4 \uac8c\uc784\uc740 \uac89\ubcf4\uae30\uc5d0\ub294 \ub2e8\uc21c\ud558\ub2e4. \uce74\ub4dc\ub97c \uc11e\uace0, \ud50c\ub808\uc774\uc5b4\uc5d0\uac8c \ub098\ub220 \uc8fc\uace0, \ubca0\ud305\ud558\uace0, \uc2b9\uc790\uac00 \ud31f\uc744 \uac00\uc838\uac04\ub2e4. \ud558\uc9c0\ub9cc \uc774 \uac8c\uc784\uc744 \uc5ec\ub7ec \uc0ac\ub78c\uc774 \ub3d9\uc2dc\uc5d0 \uc811\uc18d\ud558\ub294 \uc11c\ubc84\ub85c \uad6c\ud604\ud558\uba74 \ud574\uacb0\ud574\uc57c \ud560 \ubb38\uc81c\uac00 \uae09\uaca9\ud788 \ub298\uc5b4\ub09c\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uc0c1\ub300\ubc29\uc758 \ud640\uce74\ub4dc\uac00 \ub124\ud2b8\uc6cc\ud06c\ub97c \ud1b5\ud574 \ub178\ucd9c\ub418\uc9c0 \uc54a\ub294\ub2e4\ub294 \uac83\uc744 \uc5b4\ub5bb\uac8c \ubcf4\uc7a5\ud560 \uac83\uc778\uac00?<\/li>\n\n\n\n<li>\ub450 \ud50c\ub808\uc774\uc5b4\uac00 \ub3d9\uc2dc\uc5d0 \uac19\uc740 \uce69\uc744 \uc0ac\uc6a9\ud574 \uc11c\ub85c \ub2e4\ub978 \ud14c\uc774\ube14\uc5d0 \uc785\uc7a5\ud558\ub824 \ud558\uba74 \uc5b4\ub5bb\uac8c \ucc98\ub9ac\ud560 \uac83\uc778\uac00?<\/li>\n\n\n\n<li>\ud578\ub4dc\uac00 \uc885\ub8cc\ub418\ub294 \uc21c\uac04 \uc11c\ubc84\uac00 \uc8fd\uc73c\uba74 \uce69\uc740 \uc5b4\ub5bb\uac8c \ubcf4\uc874\ud560 \uac83\uc778\uac00?<\/li>\n\n\n\n<li>\ub3d9\uc77c\ud55c \ud578\ub4dc\uac00 \ub450 \ubc88 \uc815\uc0b0\ub418\ub294 \uc0c1\ud669\uc744 \uc5b4\ub5bb\uac8c \ubc29\uc9c0\ud560 \uac83\uc778\uac00?<\/li>\n\n\n\n<li>\ub85c\uadf8\uc544\uc6c3\uc774\ub098 \uacc4\uc815 \uc815\uc9c0 \uc774\ud6c4\uc5d0\ub3c4 \uc5f0\uacb0\ub418\uc5b4 \uc788\ub294 WebSocket\uc744 \uc5b4\ub5bb\uac8c \uc885\ub8cc\ud560 \uac83\uc778\uac00?<\/li>\n\n\n\n<li>\ub864\ub9c1 \uc5c5\ub370\uc774\ud2b8\ub97c \uc218\ud589\ud560 \ub54c \ud50c\ub808\uc774\uc5b4\uc758 \uc88c\uc11d\uacfc \uc9c4\ud589 \uc911\uc778 \uac8c\uc784\uc744 \uc5b4\ub5bb\uac8c \uc720\uc9c0\ud560 \uac83\uc778\uac00?<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \ud504\ub85c\uc81d\ud2b8\ub294 \uc774\ub7ec\ud55c \ubb38\uc81c\uc5d0 \uad6c\uccb4\uc801\uc778 \ucf54\ub4dc\uc640 \uc544\ud0a4\ud14d\ucc98\ub85c \ub2f5\ud558\ub294 \uacfc\uc815\uc774\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uae30\uc220 \uc2a4\ud0dd<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>\uad6c\uc131 \uc694\uc18c<\/th><th>\uae30\uc220<\/th><\/tr><tr><td>\uac8c\uc784 \uc11c\ubc84<\/td><td>Colyseus 0.16, WebSocket, \uc0c1\ud0dc \ub3d9\uae30\ud654<\/td><\/tr><tr><td>API \uc11c\ubc84<\/td><td>Fastify, REST API<\/td><\/tr><tr><td>\ub370\uc774\ud130\ubca0\uc774\uc2a4<\/td><td>MySQL 8, Prisma ORM<\/td><\/tr><tr><td>\uce90\uc2dc \ubc0f \ubd84\uc0b0 \ucc98\ub9ac<\/td><td>Redis 7<\/td><\/tr><tr><td>\ubaa8\ubc14\uc77c \ud074\ub77c\uc774\uc5b8\ud2b8<\/td><td>React Native, Expo SDK 52, expo-router<\/td><\/tr><tr><td>\ubc30\ud3ec<\/td><td>Docker Compose, Nginx Proxy Manager, Let&#8217;s Encrypt<\/td><\/tr><tr><td>\uc624\ucf00\uc2a4\ud2b8\ub808\uc774\uc158<\/td><td>Kubernetes \ub9e4\ub2c8\ud398\uc2a4\ud2b8, HPA \uad6c\uc131<\/td><\/tr><tr><td>\ud14c\uc2a4\ud2b8<\/td><td>Vitest, \ub2e8\uc704 \ud14c\uc2a4\ud2b8, \ud1b5\ud569 \ud14c\uc2a4\ud2b8, E2E \ud14c\uc2a4\ud2b8<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">\ud14c\uc2a4\ud2b8\ub294 \ucd1d 109\uac1c\ub85c \uad6c\uc131\ud588\ub2e4. \uae30\ubcf8 \ud14c\uc2a4\ud2b8 88\uac1c\uc640 \uc2e4\uc81c MySQL\u00b7Redis\uac00 \ud544\uc694\ud55c \ud1b5\ud569 \ud14c\uc2a4\ud2b8 21\uac1c\ub97c \ubd84\ub9ac\ud574 \uc2e4\ud589\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ucf54\ub4dc \uaddc\ubaa8\ub294 \ub3c4\uba54\uc778 \uc57d 1,200\uc904, \uc560\ud50c\ub9ac\ucf00\uc774\uc158 \uc57d 1,100\uc904, \uc778\ud504\ub77c \uc5b4\ub311\ud130 \uc57d 1,200\uc904, \uac8c\uc784 \uc11c\ubc84 \uc57d 900\uc904, API \uc57d 150\uc904, \ubaa8\ubc14\uc77c \uc571 \uc57d 1,000\uc904\uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \uad6c\uc870\uc5d0\uc11c \uc8fc\ubaa9\ud560 \uc810\uc740 \ud3ec\ucee4 \uaddc\uce59 \uc5d4\uc9c4\ubcf4\ub2e4 \uc8fc\ubcc0\uc758 \uc548\uc804\uc7a5\uce58\uc5d0 \ub354 \ub9ce\uc740 \ucf54\ub4dc\uac00 \ud544\uc694\ud558\ub2e4\ub294 \uac83\uc774\ub2e4. \uac8c\uc784 \uaddc\uce59 \uc790\uccb4\ub97c \uad6c\ud604\ud558\ub294 \uac83\uacfc \uadf8 \uaddc\uce59\uc774 \uc2e4\uc81c \uc6b4\uc601 \ud658\uacbd\uc5d0\uc11c\ub3c4 \uc815\ud655\ud558\uac8c \uc720\uc9c0\ub418\ub3c4\ub85d \ub9cc\ub4dc\ub294 \uac83\uc740 \uc11c\ub85c \ub2e4\ub978 \ubb38\uc81c\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\uc81c\uacf5\ud558\ub294 \uae30\ub2a5<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">\uc0ac\uc6a9\uc790 \uae30\ub2a5<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uc774\uba54\uc77c\uacfc \ube44\ubc00\ubc88\ud638\ub97c \uc774\uc6a9\ud55c \ud68c\uc6d0\uac00\uc785 \ubc0f \ub85c\uadf8\uc778<\/li>\n\n\n\n<li>\ub85c\uadf8\uc544\uc6c3, \uc804\uccb4 \uae30\uae30 \ub85c\uadf8\uc544\uc6c3, \ube44\ubc00\ubc88\ud638 \ubcc0\uacbd<\/li>\n\n\n\n<li>\uac00\uc785 \uc2dc \uae30\ubcf8 \uce69 10,000\uac1c \uc9c0\uae09 \ubc0f \uc9c0\uac11 \uc870\ud68c<\/li>\n\n\n\n<li>\ube14\ub77c\uc778\ub4dc, \ubc14\uc774\uc778 \ubc94\uc704, \ucc29\uc11d \uc778\uc6d0, \ud578\ub4dc \uc9c4\ud589 \uc5ec\ubd80\ub97c \ud45c\uc2dc\ud558\ub294 \uc2e4\uc2dc\uac04 \ub85c\ube44<\/li>\n\n\n\n<li>\ud14c\uc774\ube14 \uc785\uc7a5, \uc88c\uc11d \uc120\ud0dd, \ubc14\uc774\uc778, \uc790\ub9ac \ube44\uc6c0 \ubc0f \ubcf5\uadc0, \ud1f4\uc7a5<\/li>\n\n\n\n<li>\ud14d\uc0ac\uc2a4 \ud640\ub364 \uc804\uccb4 \uaddc\uce59 \uad6c\ud604<\/li>\n\n\n\n<li>\ud3f4\ub4dc, \uccb4\ud06c, \ucf5c, \ub808\uc774\uc988, \uc62c\uc778 \ubc0f \uc0ac\uc774\ub4dc \ud31f \ucc98\ub9ac<\/li>\n\n\n\n<li>\ud504\ub9ac\ud50c\ub78d, \ud50c\ub78d, \ud134, \ub9ac\ubc84, \uc1fc\ub2e4\uc6b4 \ubc0f \uc871\ubcf4 \ud3c9\uac00<\/li>\n\n\n\n<li>\ud134 \uc81c\ud55c \uc2dc\uac04 20\ucd08 \ubc0f \uc2dc\uac04 \ucd08\uacfc \uc2dc \uc790\ub3d9 \uccb4\ud06c\u00b7\ud3f4\ub4dc<\/li>\n\n\n\n<li>\ub124\ud2b8\uc6cc\ud06c \uc5f0\uacb0\uc774 \ub04a\uc5b4\uc9c4 \uacbd\uc6b0 60\ucd08 \ub3d9\uc548 \uc88c\uc11d \uc720\uc9c0<\/li>\n\n\n\n<li>\uc790\ub3d9 \uc7ac\uc811\uc18d \ubc0f \uae30\uc874 \uc88c\uc11d \ubcf5\uad6c<\/li>\n\n\n\n<li>\ud578\ub4dc \uc885\ub8cc \ud6c4 \ub371 \uacf5\uac1c\ub97c \ud1b5\ud55c \uc154\ud50c \uacf5\uc815\uc131 \uac80\uc99d<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">\uc6b4\uc601 \uae30\ub2a5<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>\/health\/live<\/code>, <code>\/health\/ready<\/code> \ud5ec\uc2a4 \uccb4\ud06c<\/li>\n\n\n\n<li>Prometheus \ud615\uc2dd\uc758 <code>\/metrics<\/code> \uc9c0\ud45c \uc81c\uacf5<\/li>\n\n\n\n<li>\uc811\uc18d\uc790 \uc218 \uae30\ubc18 Kubernetes HPA \ud655\uc7a5 \uc9c0\ud45c<\/li>\n\n\n\n<li>\uc11c\ubc84 \uc885\ub8cc \uc2dc \uc9c4\ud589 \uc911\uc778 \ud578\ub4dc \ucc98\ub9ac \ubc0f \uc88c\uc11d \uc720\uc9c0<\/li>\n\n\n\n<li>\uc11c\ubc84 \ube44\uc815\uc0c1 \uc885\ub8cc \uc2dc Redis \uc2a4\ub0c5\uc0f7\uc744 \uc774\uc6a9\ud55c \uac8c\uc784 \uc0c1\ud0dc \ubcf5\uad6c<\/li>\n\n\n\n<li>\ub85c\uadf8\uc778 \uc2e4\ud328, \uacc4\uc815 \uc7a0\uae08, \ub9ac\ud504\ub808\uc2dc \ud1a0\ud070 \uc7ac\uc0ac\uc6a9, WebSocket \uc778\uc99d \uac70\uc808 \ub4f1\uc758 \ubcf4\uc548 \uac10\uc0ac \uae30\ub85d<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\uc804\uccb4 \uc544\ud0a4\ud14d\ucc98<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">\uc2dc\uc2a4\ud15c \uad6c\uc131<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uc804\uccb4 \uc2dc\uc2a4\ud15c\uc740 \ubaa8\ubc14\uc77c \ud074\ub77c\uc774\uc5b8\ud2b8, API \uc11c\ubc84, Colyseus \uac8c\uc784 \uc11c\ubc84, MySQL, Redis\ub85c \uad6c\uc131\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>React Native Mobile\n        |\n        v\nNginx Proxy Manager\nHTTP \/ HTTPS \/ WSS\n        |\n        +--------------------+\n        |                    |\n        v                    v\n   Fastify API          Colyseus Proxy\n        |                    |\n        |              +-----+-----+\n        |              |           |\n        |              v           v\n        |           Game 1      Game 2 ...\n        |              |           |\n        +--------------+-----------+\n                       |\n             +---------+---------+\n             |                   |\n             v                   v\n           MySQL                Redis\n       \uacc4\uc815 \ubc0f \uc6d0\uc7a5          \uce90\uc2dc \ubc0f \ubd84\uc0b0 \uc0c1\ud0dc<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc678\ubd80\uc5d0 \uacf5\uac1c\ud558\ub294 \ud3ec\ud2b8\ub294 Nginx Proxy Manager\uc758 HTTP\u00b7HTTPS \ud3ec\ud2b8\ubfd0\uc774\ub2e4. MySQL, Redis, API \uc11c\ubc84, Colyseus \ud504\ub85d\uc2dc\ub294 \ud638\uc2a4\ud2b8\uc758 \ub8e8\ud504\ubc31 \uc8fc\uc18c\uc5d0 \ubc14\uc778\ub529\ud574 \uc678\ubd80\uc5d0\uc11c \uc9c1\uc811 \uc811\uadfc\ud558\uc9c0 \ubabb\ud558\ub3c4\ub85d \uad6c\uc131\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ud558\ub098\uc758 \ub3c4\uba54\uc778\uc5d0\uc11c REST API\uc640 WebSocket \uc5f0\uacb0\uc744 \ubaa8\ub450 \ucc98\ub9ac\ud558\uae30 \uc704\ud574 \uacbd\ub85c \uae30\ubc18 \ub77c\uc6b0\ud305\uc744 \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>\uacbd\ub85c<\/th><th>\uc804\ub2ec \ub300\uc0c1<\/th><\/tr><tr><td><code>\/api\/*<\/code><\/td><td>Fastify API \uc11c\ubc84. <code>\/api<\/code> \uc811\ub450\uc0ac\ub97c \uc81c\uac70\ud55c \ub4a4 \uc804\ub2ec<\/td><\/tr><tr><td><code>\/matchmake\/*<\/code><\/td><td>Colyseus \ud504\ub85d\uc2dc<\/td><\/tr><tr><td>\uac8c\uc784 WebSocket \uacbd\ub85c<\/td><td>Colyseus \ud504\ub85d\uc2dc\ub97c \uac70\uccd0 \uac8c\uc784 \uc11c\ubc84\ub85c \uc804\ub2ec<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">API \uc694\uccad\uc5d0\uc11c\ub294 <code>X-Forwarded-For<\/code>\ub97c \ud504\ub85d\uc2dc\uac00 \ud655\uc778\ud55c \uc2e4\uc81c \uc811\uc18d IP\ub85c \ub36e\uc5b4\uc368 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc784\uc758\ub85c \uc124\uc815\ud55c IP \ud5e4\ub354\ub97c \uc2e0\ub8b0\ud558\uc9c0 \uc54a\ub3c4\ub85d \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ubaa8\ub178\ub808\ud3ec\uc640 \uacc4\uce35 \uad6c\uc870<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ud504\ub85c\uc81d\ud2b8\ub294 TypeScript \ubaa8\ub178\ub808\ud3ec\ub85c \uad6c\uc131\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>apps\/\n  api\/              Fastify REST API\n  game\/             Colyseus \uac8c\uc784 \uc11c\ubc84\n  mobile\/           Expo React Native \uc571\n\npackages\/\n  domain\/           \uc21c\uc218 \ub3c4\uba54\uc778 \ubaa8\ub378\uacfc \uac8c\uc784 \uaddc\uce59\n  application\/      \uc720\uc2a4\ucf00\uc774\uc2a4\uc640 \ud3ec\ud2b8 \uc778\ud130\ud398\uc774\uc2a4\n  infrastructure\/   Prisma, Redis, \uc778\uc99d \uad6c\ud604\n  contracts\/        DTO, Zod \uc2a4\ud0a4\ub9c8, \uba54\uc2dc\uc9c0 \uacc4\uc57d<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uac01 \uacc4\uce35\uc758 \ucc45\uc784\uc740 \uba85\ud655\ud558\uac8c \uad6c\ubd84\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Domain<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uce74\ub4dc, \uc871\ubcf4 \ud3c9\uac00, \ud31f \ubd84\ubc30, \ud578\ub4dc \uc9c4\ud589, \uc0ac\uc6a9\uc790\uc640 \uc138\uc158 \ub4f1\uc758 \ub3c4\uba54\uc778 \uaddc\uce59\uc744 \ub2f4\ub2f9\ud55c\ub2e4. \ub124\ud2b8\uc6cc\ud06c\ub098 \ub370\uc774\ud130\ubca0\uc774\uc2a4 \uac19\uc740 \uc678\ubd80 \uc758\uc874\uc131\uc744 \uac16\uc9c0 \uc54a\ub294\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Application<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>IdentityService<\/code>, <code>TableSession<\/code>, <code>OutboxDispatcher<\/code> \ub4f1\uc758 \uc720\uc2a4\ucf00\uc774\uc2a4\ub97c \uc81c\uacf5\ud55c\ub2e4. \ub370\uc774\ud130 \uc800\uc7a5\uc18c\uc5d0 \uc9c1\uc811 \uc758\uc874\ud558\uc9c0 \uc54a\uace0 <code>WalletLedger<\/code>, <code>TableSnapshotStore<\/code>, <code>DistributedLock<\/code> \uac19\uc740 \ud3ec\ud2b8 \uc778\ud130\ud398\uc774\uc2a4\ub97c \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Infrastructure<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Application\uc5d0\uc11c \uc815\uc758\ud55c \ud3ec\ud2b8\ub97c Prisma, MySQL, Redis, Argon2id, JWT \ub4f1\uc73c\ub85c \uad6c\ud604\ud55c\ub2e4. \ud14c\uc2a4\ud2b8\uc640 \ub85c\uceec \uac1c\ubc1c\uc744 \uc704\ud55c \uba54\ubaa8\ub9ac \uad6c\ud604\ub3c4 \uc81c\uacf5\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Apps<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Fastify \ub77c\uc6b0\ud2b8\uc640 Colyseus Room \ub4f1 \uc678\ubd80 \uc694\uccad\uc744 \ubc1b\uc544 \uc560\ud50c\ub9ac\ucf00\uc774\uc158 \uacc4\uce35\uc5d0 \uc804\ub2ec\ud558\ub294 \uc5ed\ud560\uc744 \uc218\ud589\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Contracts<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc11c\ubc84\uc640 \ubaa8\ubc14\uc77c \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uacf5\uc720\ud558\ub294 DTO, Zod \uc2a4\ud0a4\ub9c8, \uba54\uc2dc\uc9c0 \uc774\ub984, \uc885\ub8cc \ucf54\ub4dc \ub4f1\uc744 \uc815\uc758\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc758\uc874\uc131\uc740 \ubc14\uae65\uc5d0\uc11c \uc548\ucabd\uc73c\ub85c\ub9cc \ud750\ub978\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Apps \u2192 Application \u2192 Domain\n          \u2191\n   Infrastructure<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Infrastructure\ub294 Application\uc774 \uc815\uc758\ud55c \uc778\ud130\ud398\uc774\uc2a4\ub97c \uad6c\ud604\ud55c\ub2e4. Domain\uc740 \uc678\ubd80 \uc2dc\uc2a4\ud15c\uc744 \uc54c\uc9c0 \ubabb\ud558\uba70, Application \uc5ed\uc2dc \ud2b9\uc815 \ub370\uc774\ud130\ubca0\uc774\uc2a4\ub098 \uce90\uc2dc \uc81c\ud488\uc744 \uc9c1\uc811 \uc54c \ud544\uc694\uac00 \uc5c6\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \uad6c\uc870\uc758 \ud575\uc2ec\uc740 \ud14c\uc2a4\ud2b8 \uac00\ub2a5\uc131\uc774\ub2e4. \uac8c\uc784 \uaddc\uce59\uc740 \ub124\ud2b8\uc6cc\ud06c \uc5c6\uc774 \uac80\uc99d\ud558\uace0, \uc815\uc0b0 \ud750\ub984\uc740 \uba54\ubaa8\ub9ac \uc5b4\ub311\ud130\ub85c \ud14c\uc2a4\ud2b8\ud558\uba70, \uc2e4\uc81c SQL\uacfc Redis \ub3d9\uc791\uc740 \ubcc4\ub3c4\uc758 \ud1b5\ud569 \ud14c\uc2a4\ud2b8\ub85c \ud655\uc778\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\uc21c\uc218 \ub3c4\uba54\uc778: \ud640\ub364 \uaddc\uce59 \uc5d4\uc9c4<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">HoldemHand \uc560\uadf8\ub9ac\uac8c\uc774\ud2b8<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><code>HoldemHand<\/code>\ub294 \ud558\ub098\uc758 \ud3ec\ucee4 \ud578\ub4dc\uc5d0\uc11c \ubc1c\uc0dd\ud558\ub294 \uaddc\uce59\uc744 \uad00\ub9ac\ud558\ub294 \uc560\uadf8\ub9ac\uac8c\uc774\ud2b8\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ud134 \uc9c4\ud589, \ubca0\ud305, \uc62c\uc778, \uc0ac\uc774\ub4dc \ud31f, \uc1fc\ub2e4\uc6b4 \ub4f1\uc758 \uaddc\uce59\uc744 \ub0b4\ubd80\uc5d0\uc11c \ucc98\ub9ac\ud55c\ub2e4. \uc785\ub825\uc740 \ud50c\ub808\uc774\uc5b4\uc758 \ud589\ub3d9\uc774\uace0, \ucd9c\ub825\uc740 \uac8c\uc784 \uc0c1\ud0dc \ubcc0\uacbd\uc744 \ub098\ud0c0\ub0b4\ub294 \uc774\ubca4\ud2b8 \ubaa9\ub85d\uc774\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>export interface PlayerAction {\n  type: \"fold\" | \"check\" | \"call\" | \"raise\" | \"allin\";\n  amount?: number;\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><code>raise<\/code>\uc758 <code>amount<\/code>\ub294 \uc774\ubc88 \ubca0\ud305 \ub77c\uc6b4\ub4dc\uc5d0\uc11c \ucd5c\uc885\uc801\uc73c\ub85c \ub9de\ucd94\ub824\ub294 \ucd1d \ubca0\ud305 \uae08\uc561\uc778 <code>raise to<\/code>\ub97c \uc758\ubbf8\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ud578\ub4dc\ub97c \uc2dc\uc791\ud560 \ub54c\ub294 \uc785\ub825\uc5d0 \ub300\ud55c \ubd88\ubcc0 \uc870\uac74\uc744 \uac80\uc99d\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>invariant(\n  deck.length === 52 &amp;&amp; new Set(deck).size === 52,\n  \"INVALID_DECK\"\n);\n\ninvariant(players.length &gt;= 2, \"NOT_ENOUGH_PLAYERS\");\n\ninvariant(\n  Number.isInteger(p.stack) &amp;&amp; p.stack &gt; 0,\n  \"INVALID_STACK\"\n);<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ub371\uc774 \uc815\ud655\ud788 52\uc7a5\uc774\uace0 \uc911\ubcf5\uc774 \uc5c6\ub294\uc9c0, \ud50c\ub808\uc774\uc5b4 \uc2a4\ud0dd\uc774 \uc591\uc758 \uc815\uc218\uc778\uc9c0, \ubc84\ud2bc \uc88c\uc11d\uc774 \uc2e4\uc81c \ucc29\uc11d\uc790\uc778\uc9c0 \ub4f1\uc744 \ud655\uc778\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ud578\ub4dc \uc0c1\ud0dc\ub294 <code>HandSnapshot<\/code>\uc73c\ub85c \uc9c1\ub82c\ud654\ud558\uace0 \ubcf5\uc6d0\ud560 \uc218 \uc788\ub2e4. \uc774 \uae30\ub2a5\uc740 \uc11c\ubc84 \uc7a5\uc560 \uc774\ud6c4 \uac8c\uc784\uc744 \ubcf5\uad6c\ud558\ub294 \uae30\ubc18\uc774 \ub41c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub610\ud55c \ud578\ub4dc\ub294 <code>version<\/code>\uacfc <code>turnSeq<\/code>\ub97c \uac00\uc9c4\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>version<\/code>: \uac8c\uc784 \uc0c1\ud0dc\uac00 \ubcc0\uacbd\ub420 \ub54c \uc99d\uac00\ud55c\ub2e4. \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ubcf4\uace0 \uc788\ub294 \uc0c1\ud0dc\uac00 \ucd5c\uc2e0\uc778\uc9c0 \ud655\uc778\ud558\ub294 \ub370 \uc0ac\uc6a9\ud55c\ub2e4.<\/li>\n\n\n\n<li><code>turnSeq<\/code>: \ucc28\ub840\uac00 \ubc14\ub014 \ub54c \uc99d\uac00\ud55c\ub2e4. \uc774\uc804 \ucc28\ub840\uc5d0 \ub4f1\ub85d\ud55c \ud0c0\uc774\uba38\uac00 \ud604\uc7ac \uac8c\uc784\uc5d0 \uc798\ubabb \uc801\uc6a9\ub418\uc9c0 \uc54a\ub3c4\ub85d \ud55c\ub2e4.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">\uc0ac\uc774\ub4dc \ud31f \uacc4\uc0b0<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uc62c\uc778\uc774 \ubc1c\uc0dd\ud558\uba74 \ud50c\ub808\uc774\uc5b4\ub9c8\ub2e4 \ubca0\ud305\ud560 \uc218 \uc788\ub294 \uae08\uc561\uc774 \ub2ec\ub77c\uc9c4\ub2e4. \ub530\ub77c\uc11c \uc804\uccb4 \ubca0\ud305 \uae08\uc561\uc744 \ud558\ub098\uc758 \ud31f\uc73c\ub85c \ucc98\ub9ac\ud560 \uc218 \uc5c6\uc73c\uba70, \uae30\uc5ec \uae08\uc561\uc758 \ub808\ubca8\uc744 \uae30\uc900\uc73c\ub85c \ud31f\uc744 \ubd84\ub9ac\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>export function buildPots(\n  contribs: readonly Contribution&#91;]\n): Pot&#91;] {\n  const levels = &#91;\n    ...new Set(\n      contribs\n        .filter((c) =&gt; !c.folded &amp;&amp; c.committed &gt; 0)\n        .map((c) =&gt; c.committed)\n    ),\n  ].sort((a, b) =&gt; a - b);\n\n  const pots: Pot&#91;] = &#91;];\n  let prev = 0;\n\n  for (const level of levels) {\n    let amount = 0;\n\n    for (const c of contribs) {\n      amount += Math.max(\n        0,\n        Math.min(c.committed, level) -\n          Math.min(c.committed, prev)\n      );\n    }\n\n    const eligible = contribs\n      .filter(\n        (c) =&gt; !c.folded &amp;&amp; c.committed &gt;= level\n      )\n      .map((c) =&gt; c.userId);\n\n    if (amount &gt; 0) {\n      pots.push({ amount, eligible });\n    }\n\n    prev = level;\n  }\n\n  \/\/ \uc794\uc5ec \uce69\uacfc \ud2b9\uc218 \uc0c1\ud669 \ucc98\ub9ac\n  return pots;\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc0ac\uc774\ub4dc \ud31f \uacc4\uc0b0\uc5d0\uc11c\ub294 \ub2e4\uc74c \uc870\uac74\uc744 \uc9c0\ucf1c\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ud3f4\ub4dc\ud55c \ud50c\ub808\uc774\uc5b4\uac00 \ub0b8 \uce69\ub3c4 \ud31f\uc5d0 \ud3ec\ud568\ud55c\ub2e4.<\/li>\n\n\n\n<li>\ud3f4\ub4dc\ud55c \ud50c\ub808\uc774\uc5b4\ub294 \ud574\ub2f9 \ud31f\uc758 \uc218\ub839 \uc790\uaca9\uc5d0\uc11c \uc81c\uc678\ud55c\ub2e4.<\/li>\n\n\n\n<li>\ud2b9\uc815 \ud31f\uc5d0 \uc218\ub839 \uc790\uaca9\uc790\uac00 \ud55c \uba85\ubfd0\uc774\uba74 \ucf5c\uc744 \ubc1b\uc9c0 \ubabb\ud55c \ucd08\uacfc \ubca0\ud305\uc744 \ub3cc\ub824\uc8fc\ub294 \ucc98\ub9ac\uac00 \ud544\uc694\ud558\ub2e4.<\/li>\n\n\n\n<li>\ubaa8\ub4e0 \ud31f\uc758 \ud569\uc740 \ud50c\ub808\uc774\uc5b4\uac00 \uae30\uc5ec\ud55c \uce69\uc758 \ud569\uacfc \uac19\uc544\uc57c \ud55c\ub2e4.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc989, \ub2e4\uc74c \ubd88\ubcc0 \uc870\uac74\uc744 \ud56d\uc0c1 \ub9cc\uc871\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>sum(pots) === sum(contributions)<\/code><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \uc870\uac74\uc740 \ub2e8\uc704 \ud14c\uc2a4\ud2b8\uc640 \ud37c\uc9d5 \ud14c\uc2a4\ud2b8\ub97c \ud1b5\ud574 \uac80\uc99d\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc871\ubcf4 \ud3c9\uac00\uae30<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uc871\ubcf4 \ud3c9\uac00\uae30\ub294 \ud50c\ub808\uc774\uc5b4\uac00 \ubcf4\uc720\ud55c \uce74\ub4dc \uc911 \ucd5c\uc801\uc758 5\uc7a5\uc744 \uc120\ud0dd\ud574 \uc810\uc218\ub85c \ubcc0\ud658\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc871\ubcf4 \uce74\ud14c\uace0\ub9ac\ub97c \uac00\uc7a5 \ub192\uc740 \uc790\ub9bf\uc218\uc5d0 \ubc30\uce58\ud558\uace0, \ud0a5\ucee4\ub97c \ud3ec\ud568\ud55c \ud0c0\uc774\ube0c\ub808\uc774\ud06c \uac12\uc744 \ub4a4\uc5d0 \uc774\uc5b4 \ubd99\uc5ec \uc815\uc218 \ud558\ub098\ub85c \ube44\uad50\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>let score = category;\n\nfor (let i = 0; i &lt; 5; i++) {\n  score = score * BASE + (tiebreak&#91;i] ?? 0);\n}\n\nreturn score;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc810\uc218\uac00 \ub192\uc744\uc218\ub85d \uac15\ud55c \ud328\ub2e4. \ub3d9\uc77c\ud55c \uc810\uc218\ub294 \ub3d9\uc810\uc73c\ub85c \ucc98\ub9ac\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A-2-3-4-5 \ud615\ud0dc\uc758 \ud720 \uc2a4\ud2b8\ub808\uc774\ud2b8\ucc98\ub7fc \uc77c\ubc18\uc801\uc778 \uc21c\uc704 \ube44\uad50\ub85c \ucc98\ub9ac\ud558\uae30 \uc5b4\ub824\uc6b4 \uacbd\uacc4 \uc870\uac74\uc740 \ubcc4\ub3c4 \ubd84\uae30\ub85c \ub2e4\ub8ec\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ucd5c\ub300 7\uc7a5\uc758 \uce74\ub4dc\uc5d0\uc11c 5\uc7a5\uc744 \uc120\ud0dd\ud558\ub294 \uc870\ud569\uc740 21\uac00\uc9c0\ub2e4. \ubaa8\ub4e0 \uc870\ud569\uc744 \ud3c9\uac00\ud558\uace0 \uac00\uc7a5 \ub192\uc740 \uc810\uc218\ub97c \uc120\ud0dd\ud558\ub294 \ub2e8\uc21c\ud55c \ubc29\uc2dd\uc744 \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \uad6c\ud604\uc740 \ubd88\ud544\uc694\ud55c \ucd5c\uc801\ud654\ubcf4\ub2e4 \uc815\ud655\uc131\uacfc \uac80\uc99d \uac00\ub2a5\uc131\uc744 \uc6b0\uc120\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uacf5\uc815\ud55c \uc154\ud50c<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uc6b4\uc601 \ud658\uacbd\uc5d0\uc11c\ub294 Fisher\u2013Yates \uc154\ud50c\uacfc <code>crypto.randomInt<\/code>\ub97c \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>export class CsprngRng implements Rng {\n  int(maxExclusive: number) {\n    return randomInt(maxExclusive);\n  }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><code>Math.random()<\/code>\uc774\ub098 \uc2dc\ub4dc \uae30\ubc18 \uc758\uc0ac\ub09c\uc218 \uc0dd\uc131\uae30\ub97c \uc6b4\uc601\uc6a9 \uce74\ub4dc \uc154\ud50c\uc5d0 \uc0ac\uc6a9\ud558\uc9c0 \uc54a\ub294\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub09c\uc218 \uc0dd\uc131\uae30\ub294 <code>Rng<\/code> \uc778\ud130\ud398\uc774\uc2a4 \ub4a4\uc5d0 \ubc30\uce58\ud55c\ub2e4. \ud14c\uc2a4\ud2b8\uc5d0\uc11c\ub294 \uc7ac\ud604 \uac00\ub2a5\ud55c \uc2dc\ub4dc \uae30\ubc18 RNG\ub97c \uc8fc\uc785\ud558\uace0, \uc6b4\uc601 \ud658\uacbd\uc5d0\uc11c\ub294 \uc554\ud638\ud559\uc801\uc73c\ub85c \uc548\uc804\ud55c \ub09c\uc218 \uc0dd\uc131\uae30\ub97c \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub807\uac8c \ud558\uba74 \ub3d9\uc77c\ud55c \uaddc\uce59 \uc5d4\uc9c4\uc744 \uc720\uc9c0\ud558\uba74\uc11c \ud14c\uc2a4\ud2b8 \uc7ac\ud604\uc131\uacfc \uc6b4\uc601 \ubcf4\uc548\uc131\uc744 \ubaa8\ub450 \ud655\ubcf4\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">TableSession: \uaddc\uce59\uacfc \ub124\ud2b8\uc6cc\ud06c \uc0ac\uc774\uc758 \uc870\uc815\uc790<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><code>TableSession<\/code>\uc740 \ud14c\uc774\ube14 \ud558\ub098\uc758 \uac8c\uc784 \uc9c4\ud589\uc744 \uc870\uc815\ud558\ub294 \uc560\ud50c\ub9ac\ucf00\uc774\uc158 \uc11c\ube44\uc2a4\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Colyseus\uc5d0 \uc9c1\uc811 \uc758\uc874\ud558\uc9c0 \uc54a\uc73c\uba70, \uba85\ub839\uc744 \ubc1b\uc544 \ub3c4\uba54\uc778 \ub85c\uc9c1 \uc2e4\ud589, \uc815\uc0b0, \uc2a4\ub0c5\uc0f7 \uc800\uc7a5\uc744 \uc870\uc815\ud55c \ub4a4 <code>TableEvent<\/code> \ubaa9\ub85d\uc744 \ubc18\ud658\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Room\uc740 \uc774 \uc774\ubca4\ud2b8\ub97c \ub124\ud2b8\uc6cc\ud06c\ub85c \uc804\ub2ec\ud558\ub294 \uc5ed\ud560\uc5d0 \uc9d1\uc911\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ud14c\uc774\ube14\ub2f9 \ub2e8\uc77c \uc791\uc131\uc790<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Node.js\ub294 \uc2f1\uae00 \uc2a4\ub808\ub4dc\ub85c \ub3d9\uc791\ud558\uc9c0\ub9cc \ube44\ub3d9\uae30 \ud568\uc218\uc758 <code>await<\/code> \uc9c0\uc810\uc5d0\uc11c\ub294 \ub2e4\ub978 \uba85\ub839\uc774 \uc2e4\ud589\ub420 \uc218 \uc788\ub2e4. \ub530\ub77c\uc11c \ube44\ub3d9\uae30 \ucc98\ub9ac\uac00 \ud3ec\ud568\ub41c \uac8c\uc784 \uc0c1\ud0dc \ubcc0\uacbd\uc740 \uacbd\uc7c1 \uc870\uac74\uc744 \uc77c\uc73c\ud0ac \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc608\ub97c \ub4e4\uc5b4 \ud55c \ud50c\ub808\uc774\uc5b4\uc758 \uc815\uc0b0\uc774 \uc9c4\ud589\ub418\ub294 \ub3c4\uc911 \ub2e4\ub978 \ud50c\ub808\uc774\uc5b4\uc758 \uc561\uc158\uc774 \ub4e4\uc5b4\uc624\uba74, \ub450 \uc791\uc5c5\uc774 \uac19\uc740 \uc0c1\ud0dc\ub97c \uae30\uc900\uc73c\ub85c \uc11c\ub85c \ub2e4\ub978 \uacb0\uacfc\ub97c \ub9cc\ub4e4 \uac00\ub2a5\uc131\uc774 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub97c \ubc29\uc9c0\ud558\uae30 \uc704\ud574 \ubaa8\ub4e0 \uc0c1\ud0dc \ubcc0\uacbd \uba85\ub839\uc744 \ud558\ub098\uc758 Promise \ud050\uc5d0\uc11c \uc21c\ucc28\uc801\uc73c\ub85c \uc2e4\ud589\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>run&lt;T&gt;(fn: () =&gt; Promise&lt;T&gt;): Promise&lt;T&gt; {\n  const next = this.queue.then(fn, fn);\n\n  this.queue = next.catch(() =&gt; undefined);\n\n  return next;\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc55e\uc120 \uba85\ub839\uc774 \uc2e4\ud328\ud558\ub354\ub77c\ub3c4 \ud050\uac00 \uc601\uad6c\uc801\uc73c\ub85c \ub9c9\ud788\uc9c0 \uc54a\ub3c4\ub85d \uc2e4\ud328\ub97c \ucc98\ub9ac\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \uad6c\uc870\uc5d0\uc11c\ub294 \ud55c \ud14c\uc774\ube14\uc758 \uc0c1\ud0dc\ub97c \ubcc0\uacbd\ud558\ub294 \uba85\ub839\uc774 \uc21c\uc11c\ub300\ub85c \uc2e4\ud589\ub418\ubbc0\ub85c, \ud14c\uc774\ube14 \ub0b4\ubd80 \uc0c1\ud0dc\uc5d0 \ub300\ud55c \uc791\uc131\uc790\uac00 \ud56d\uc0c1 \ud558\ub098\ub85c \uc720\uc9c0\ub41c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2e8, \uc774 \ubcf4\uc7a5\uc740 \ud558\ub098\uc758 <code>TableSession<\/code> \uc778\uc2a4\ud134\uc2a4 \uc548\uc5d0\uc11c\ub9cc \uc131\ub9bd\ud55c\ub2e4. \uc5ec\ub7ec \uc11c\ubc84 \ud504\ub85c\uc138\uc2a4\uac00 \ub3d9\uc77c\ud55c \ud14c\uc774\ube14\uc744 \ub3d9\uc2dc\uc5d0 \ucc98\ub9ac\ud558\uc9c0 \ubabb\ud558\ub3c4\ub85d \ubcc4\ub3c4\uc758 \ubd84\uc0b0 \uc18c\uc720\uad8c \uc81c\uc5b4\ub3c4 \ud544\uc694\ud558\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uba85\ub839 \uba71\ub4f1\uc131<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ubaa8\ubc14\uc77c \ub124\ud2b8\uc6cc\ud06c\uc5d0\uc11c\ub294 \uc694\uccad\uc774 \uc911\ubcf5 \uc804\uc1a1\ub420 \uc218 \uc788\ub2e4. \ud074\ub77c\uc774\uc5b8\ud2b8\ub294 \ubaa8\ub4e0 \uba85\ub839\uc5d0 \uace0\uc720\ud55c <code>commandId<\/code>\ub97c \ud3ec\ud568\ud558\uace0, \uc11c\ubc84\ub294 \ucc98\ub9ac\ud55c \uba85\ub839\uc744 \uae30\ub85d\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>const key = `${userId}:${commandId}`;\n\nif (this.seenCommands.has(key)) {\n  return { events: &#91;], duplicate: true };\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc0ac\uc6a9\uc790 ID\uc640 \uba85\ub839 ID\ub97c \uc870\ud569\ud574 \uc911\ubcf5 \uc5ec\ubd80\ub97c \ud310\ub2e8\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc131\uacf5\ud55c \uba85\ub839\ub9cc \ucc98\ub9ac \uc644\ub8cc\ub85c \uae30\ub85d\ud55c\ub2e4. \uac70\uc808\ub41c \uba85\ub839\uc740 \uac19\uc740 ID\ub85c \ub2e4\uc2dc \uc2dc\ub3c4\ud560 \uc218 \uc788\uc5b4\uc57c \ud558\uae30 \ub54c\ubb38\uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2e4\ub9cc \uba54\ubaa8\ub9ac \uae30\ubc18 \uc911\ubcf5 \uae30\ub85d\uc740 \ud504\ub85c\uc138\uc2a4\uac00 \uc7ac\uc2dc\uc791\ub418\uba74 \uc0ac\ub77c\uc9c8 \uc218 \uc788\ub2e4. \uc5ec\ub7ec \uc11c\ubc84\uc5d0\uc11c \ucc98\ub9ac\ud558\uac70\ub098 \uc7a5\uc560 \ubcf5\uad6c \uc774\ud6c4\uc5d0\ub3c4 \uba71\ub4f1\uc131\uc744 \uc720\uc9c0\ud574\uc57c \ud558\ub294 \uc791\uc5c5\uc740 \uc601\uc18d \uc800\uc7a5\uc18c\uc758 \uace0\uc720 \uc81c\uc57d\uacfc \ud2b8\ub79c\uc7ad\uc158\uc744 \ud568\uaed8 \uc0ac\uc6a9\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ub0a1\uc740 \uc0c1\ud0dc\uc758 \uc561\uc158 \ucc28\ub2e8<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ud50c\ub808\uc774\uc5b4\uc758 \uc561\uc158\uc5d0\ub294 \ud604\uc7ac \ubcf4\uace0 \uc788\ub294 \ud578\ub4dc ID\uc640 \ubc84\uc804\uc744 \ud568\uaed8 \ud3ec\ud568\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>if (\n  hand.handId !== msg.handId ||\n  hand.version !== msg.version\n) {\n  throw new AppError(\n    \"CONFLICT\",\n    \"STALE_STATE\",\n    \"\ud654\uba74\uc774 \ucd5c\uc2e0 \uc0c1\ud0dc\uac00 \uc544\ub2d9\ub2c8\ub2e4\"\n  );\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc0c1\ub300\ubc29\uc774 \ubc29\uae08 \ub808\uc774\uc988\ud588\uc9c0\ub9cc \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc774\uc804 \uc0c1\ud0dc\ub97c \ubcf4\uace0 \uc788\ub294 \uacbd\uc6b0, \uc624\ub798\ub41c \uc0c1\ud0dc\ub97c \uae30\uc900\uc73c\ub85c \ud55c \uc561\uc158\uc740 \uac70\uc808\ub41c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub97c \ud1b5\ud574 \ud50c\ub808\uc774\uc5b4\uac00 \uc2e4\uc81c\ub85c \ud655\uc778\ud55c \uae08\uc561\uacfc \ub2e4\ub978 \uae08\uc561\uc73c\ub85c \ubca0\ud305\ud558\ub294 \ubb38\uc81c\ub97c \ubc29\uc9c0\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ucc28\ub840\uc5d0 \uc885\uc18d\ub41c \ud0c0\uc774\uba38<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ud134 \ud0c0\uc774\uba38\ub294 \ub4f1\ub85d\ub41c \uc2dc\uc810\uc758 \ud578\ub4dc, \ucc28\ub840 \ubc88\ud638, \ud50c\ub808\uc774\uc5b4\ub97c \uae30\uc5b5\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>turnTimeout(userId, handId, turnSeq) {\n  return this.run(async () =&gt; {\n    const hand = this.table.hand;\n\n    if (\n      !hand ||\n      hand.isComplete ||\n      hand.handId !== handId ||\n      hand.turnSeq !== turnSeq\n    ) {\n      return { events: &#91;] };\n    }\n\n    if (hand.actorUserId !== userId) {\n      return { events: &#91;] };\n    }\n\n    \/\/ \uc790\ub3d9 \uccb4\ud06c \ub610\ub294 \ud3f4\ub4dc\n  });\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ud0c0\uc774\uba38\uac00 \uc2e4\ud589\ub420 \ub54c \ud574\ub2f9 \ucc28\ub840\uac00 \uc5ec\uc804\ud788 \uc720\ud6a8\ud55c\uc9c0 \ud655\uc778\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uadf8\uc0ac\uc774\uc5d0 \ud50c\ub808\uc774\uc5b4\uac00 \uc815\uc0c1\uc801\uc73c\ub85c \ud589\ub3d9\ud588\uac70\ub098 \ucc28\ub840\uac00 \ubcc0\uacbd\ub410\ub2e4\uba74 \uc774\uc804 \ud0c0\uc774\uba38\ub294 \uc544\ubb34 \uc791\uc5c5\ub3c4 \ud558\uc9c0 \uc54a\ub294\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc5f0\uc18d\uc73c\ub85c \ud0c0\uc784\uc544\uc6c3\uc774 \ubc1c\uc0dd\ud558\uba74 \ud574\ub2f9 \ud50c\ub808\uc774\uc5b4\ub97c \uc790\ub9ac \ube44\uc6c0 \uc0c1\ud0dc\ub85c \uc804\ud658\ud558\ub294 \uc815\ucc45\ub3c4 \uc801\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Colyseus Room: \uc228\uaca8\uc9c4 \uc815\ubcf4\uc640 \ub124\ud2b8\uc6cc\ud06c \uacc4\uce35<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">\uacf5\uac1c \uc0c1\ud0dc\uc640 \ube44\uacf5\uac1c \uc815\ubcf4\uc758 \ubd84\ub9ac<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Colyseus\uc758 Schema \uc0c1\ud0dc\ub294 \uc5f0\uacb0\ub41c \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0 \ub3d9\uae30\ud654\ub41c\ub2e4. \ub530\ub77c\uc11c Schema\uc5d0\ub294 \ubaa8\ub4e0 \ud50c\ub808\uc774\uc5b4\uac00 \uc54c\uc544\ub3c4 \ub418\ub294 \uc815\ubcf4\ub9cc \ud3ec\ud568\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>\/**\n * \ubaa8\ub4e0 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0 \ub3d9\uae30\ud654\ub418\ub294 \uacf5\uac1c \uc0c1\ud0dc\ub9cc \uc815\uc758\ud55c\ub2e4.\n * \ud640\uce74\ub4dc, \ub371 \uc21c\uc11c, RNG \uc0c1\ud0dc\ub294 \ud3ec\ud568\ud558\uc9c0 \uc54a\ub294\ub2e4.\n *\/\nexport class PublicSeat extends Schema {\n  \/\/ seat, stack, folded, allIn, connected, shown ...\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ud640\uce74\ub4dc\uc640 \ub371 \uc21c\uc11c, \ub09c\uc218 \uc0dd\uc131\uae30 \uc0c1\ud0dc\ub97c \uacf5\uac1c Schema\uc5d0 \ub123\uc5b4\uc11c\ub294 \uc548 \ub41c\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ud640\uce74\ub4dc\ub294 <code>game:private-cards<\/code> \uba54\uc2dc\uc9c0\ub85c \ud574\ub2f9 \ud50c\ub808\uc774\uc5b4\uc5d0\uac8c\ub9cc \uc804\uc1a1\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uc1fc\ub2e4\uc6b4\uc5d0\uc11c \uacf5\uac1c\ub41c \uce74\ub4dc\ub294 <code>shown<\/code> \ub4f1\uc758 \uacf5\uac1c \uc0c1\ud0dc\ub85c \ub3d9\uae30\ud654\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uc7a5\uc560 \ubcf5\uad6c\uc6a9 \uc2a4\ub0c5\uc0f7\uc5d0\ub294 \ud640\uce74\ub4dc\uc640 \ub371\uc774 \ud3ec\ud568\ub420 \uc218 \uc788\uc73c\ubbc0\ub85c \uc678\ubd80\uc5d0 \ub178\ucd9c\ud558\uc9c0 \uc54a\ub294\ub2e4.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\ud575\uc2ec\uc740 \ud074\ub77c\uc774\uc5b8\ud2b8 UI\uc5d0\uc11c \uce74\ub4dc\ub97c \uc228\uae30\ub294 \uac83\uc774 \uc544\ub2c8\ub2e4. <strong>\uc0c1\ub300\ubc29\uc5d0\uac8c \uacf5\uac1c\ud558\uba74 \uc548 \ub418\ub294 \uc815\ubcf4 \uc790\uccb4\ub97c \uc0c1\ub300\ubc29\uc758 \ub124\ud2b8\uc6cc\ud06c \uba54\uc2dc\uc9c0\uc5d0 \ud3ec\ud568\ud558\uc9c0 \uc54a\ub294 \uac83<\/strong>\uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">E2E \ud14c\uc2a4\ud2b8\uc5d0\uc11c\ub3c4 \uc0c1\ub300\ubc29\uc758 \ud640\uce74\ub4dc\uac00 \uc5b4\ub5a4 \uba54\uc2dc\uc9c0\uc5d0\ub3c4 \ud3ec\ud568\ub418\uc9c0 \uc54a\ub294\uc9c0 \uac80\uc99d\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">WebSocket \uc785\uc7a5 \uc778\uc99d<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Colyseus\uc758 <code>onAuth<\/code>\uc5d0\uc11c \uc5f0\uacb0 \uc2dc\uc810\uc758 \uc778\uc99d\uc744 \uc218\ud589\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>override async onAuth(_client, options, context) {\n  if (serverState.draining || this.draining) {\n    throw new ServerError(503, \"SERVER_DRAINING\");\n  }\n\n  \/\/ \ud14c\uc774\ube14 ID \ud655\uc778\n\n  const rl = await svc.rateLimiter.consume(\n    `ws-auth:${ip}`,\n    60,\n    60\n  );\n\n  if (!rl.allowed) {\n    throw new ServerError(429, \"TOO_MANY_REQUESTS\");\n  }\n\n  const token = context.token;\n\n  if (!token) {\n    throw new ServerError(401, \"MISSING_TOKEN\");\n  }\n\n  const principal = await svc.identity.authenticate(token);\n\n  assertCanJoinTable(principal);\n\n  return principal;\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc778\uc99d \uacfc\uc815\uc5d0\uc11c\ub294 \ub2e4\uc74c \ud56d\ubaa9\uc744 \uac80\uc99d\ud55c\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uc11c\ubc84\uac00 \uc885\ub8cc \uc900\ube44 \uc0c1\ud0dc\uc778\uc9c0<\/li>\n\n\n\n<li>\ud14c\uc774\ube14 \uc811\uadfc \uad8c\ud55c\uc774 \uc788\ub294\uc9c0<\/li>\n\n\n\n<li>IP \uae30\uc900 \uc811\uc18d \uc81c\ud55c\uc744 \ucd08\uacfc\ud588\ub294\uc9c0<\/li>\n\n\n\n<li>JWT\uac00 \uc720\ud6a8\ud55c\uc9c0<\/li>\n\n\n\n<li>\uc138\uc158\uc774 \ud65c\uc131 \uc0c1\ud0dc\uc778\uc9c0<\/li>\n\n\n\n<li>\uacc4\uc815\uc774 \uc815\uc9c0\ub418\uc5c8\uac70\ub098 \uc81c\ud55c\ub41c \uc0c1\ud0dc\uc778\uc9c0<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc778\uc99d\uc5d0 \uc2e4\ud328\ud558\uba74 <code>WS_AUTH_REJECTED<\/code> \ubcf4\uc548 \uc774\ubca4\ud2b8\ub97c \uae30\ub85d\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">JWT\ub294 URL\uc5d0 \ub123\uc9c0 \uc54a\uace0 \uc778\uc99d \ud5e4\ub354\ub85c \uc804\ub2ec\ud55c\ub2e4. URL\uc5d0 \ud1a0\ud070\uc744 \ud3ec\ud568\ud558\uba74 \ud504\ub85d\uc2dc\uc640 \uc778\uadf8\ub808\uc2a4 \uc811\uadfc \ub85c\uadf8 \ub4f1\uc5d0 \ubbfc\uac10\ud55c \uac12\uc774 \ub0a8\uc744 \uc218 \uc788\uae30 \ub54c\ubb38\uc774\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uba54\uc2dc\uc9c0 \ucc98\ub9ac \ud30c\uc774\ud504\ub77c\uc778<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ubaa8\ub4e0 \ud074\ub77c\uc774\uc5b8\ud2b8 \uba54\uc2dc\uc9c0\ub294 \uacf5\ud1b5 \uac80\uc99d \uc808\ucc28\ub97c \uac70\uce5c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>\uc778\uc99d \uc8fc\uccb4 \ud655\uc778\n    \u2193\n\ud1a0\ud070 \ubc84\ud0b7 \uae30\ubc18 \uc18d\ub3c4 \uc81c\ud55c\n    \u2193\n\ud1a0\ud070 \ub9cc\ub8cc \ud655\uc778\n    \u2193\nZod \uc2a4\ud0a4\ub9c8 \uac80\uc99d\n    \u2193\nTableSession \uba85\ub839 \uc2e4\ud589\n    \u2193\n\uac8c\uc784 \uc774\ubca4\ud2b8 \uc801\uc6a9 \ubc0f \uacb0\uacfc \uc751\ub2f5<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uba54\uc2dc\uc9c0 \ucc98\ub9ac \uc815\ucc45\uc740 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ucd08\ub2f9 10\uac74, \ubc84\uc2a4\ud2b8 20\uac74\uc744 \ud5c8\uc6a9\ud558\ub294 \ud1a0\ud070 \ubc84\ud0b7 \uc801\uc6a9<\/li>\n\n\n\n<li>\uc704\ubc18\uc774 \ub204\uc801\ub418\uba74 \uc5f0\uacb0 \uc885\ub8cc<\/li>\n\n\n\n<li>\uc815\uc758\ub418\uc9c0 \uc54a\uc740 \uba54\uc2dc\uc9c0\ub3c4 \uc18d\ub3c4 \uc81c\ud55c\uc5d0 \ud3ec\ud568<\/li>\n\n\n\n<li>\ubaa8\ub4e0 \uba85\ub839\uc5d0 <code>game:action-result<\/code>\ub85c \uc131\uacf5 \ub610\ub294 \uc2e4\ud328 \uc751\ub2f5 \ubc18\ud658<\/li>\n\n\n\n<li>\uc911\ubcf5 \uc694\uccad\uc740 <code>DUPLICATE<\/code> \ucf54\ub4dc\ub85c \uad6c\ubd84<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uc11c \ubcf4\ub0b8 \uac12\uc740 \uc2e0\ub8b0\ud558\uc9c0 \uc54a\ub294\ub2e4. \uac8c\uc784 \uc0c1\ud0dc\ub97c \ubcc0\uacbd\ud558\ub294 \ucd5c\uc885 \ud310\ub2e8\uc740 \uc11c\ubc84\uac00 \uc218\ud589\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc5f0\uacb0 \uc885\ub8cc\uc640 \ud3f4\ub4dc\uc758 \ubd84\ub9ac<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ubaa8\ubc14\uc77c \ud658\uacbd\uc5d0\uc11c\ub294 \ub124\ud2b8\uc6cc\ud06c\uac00 \ubd88\uc548\uc815\ud558\uac70\ub098 \uc18c\ucf13\uc774 \uc870\uc6a9\ud788 \ub04a\uc5b4\uc9c0\ub294 \uacbd\uc6b0\uac00 \ub9ce\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub530\ub77c\uc11c \ube44\uc790\ubc1c\uc801\uc778 \uc5f0\uacb0 \uc885\ub8cc\ub97c \uace7\ubc14\ub85c \ud3f4\ub4dc\ub85c \ucc98\ub9ac\ud558\uc9c0 \uc54a\uace0, 60\ucd08 \ub3d9\uc548 \uc88c\uc11d\uc744 \uc720\uc9c0\ud55c\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uc5f0\uacb0\uc774 \ub04a\uae34 \ud50c\ub808\uc774\uc5b4\uc758 \ucc28\ub840\uc5d0\ub294 \ucd5c\ub300 4\ucd08\ub9cc \uae30\ub2e4\ub9b0\ub2e4.<\/li>\n\n\n\n<li>\ucc28\ub840\uac00 \uc9c0\ub098\uba74 \uc11c\ubc84 \ud0c0\uc774\uba38\uac00 \uc790\ub3d9 \uccb4\ud06c \ub610\ub294 \ud3f4\ub4dc\ub97c \ucc98\ub9ac\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uc7ac\uc811\uc18d \uc720\uc608 \uc2dc\uac04\uc774 \ub05d\ub098\uba74 \uc88c\uc11d\uc744 \uc815\ub9ac\ud558\uace0 \ub0a8\uc740 \uce69\uc744 \ud658\uae09\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uac19\uc740 \uc0ac\uc6a9\uc790\uac00 \ub2e4\ub978 \uae30\uae30\ub85c \uc811\uc18d\ud558\uba74 \uae30\uc874 \uc5f0\uacb0\uc744 \uc885\ub8cc \ucf54\ub4dc <code>4409<\/code>\ub85c \ub300\uccb4\ud55c\ub2e4.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub807\uac8c \uc5f0\uacb0 \uc0c1\ud0dc\uc640 \uac8c\uc784 \uaddc\uce59\uc744 \ubd84\ub9ac\ud558\uba74 \uc77c\uc2dc\uc801\uc778 \ub124\ud2b8\uc6cc\ud06c \uc7a5\uc560\uac00 \ubd88\ud544\uc694\ud55c \uac8c\uc784 \uc885\ub8cc\ub85c \uc774\uc5b4\uc9c0\ub294 \uac83\uc744 \ubc29\uc9c0\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\uce69 \uc6d0\uc7a5\uacfc \uc815\uc0b0: \ub370\uc774\ud130 \uc815\ud569\uc131 \ubcf4\uc7a5<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">\uc9c0\uac11 \ub370\uc774\ud130 \ubaa8\ub378<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uce69 \uad00\ub9ac\uc5d0\ub294 \ub2e8\uc21c\ud55c \uc794\uc561 \ud544\ub4dc\ub9cc \uc0ac\uc6a9\ud558\uc9c0 \uc54a\ub294\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>wallet.balance\n    \uc0ac\uc6a9 \uac00\ub2a5\ud55c \uce69\n\nwallet.reserved\n    \ud14c\uc774\ube14\uc5d0 \uc608\uc57d\ub41c \uce69\uc758 \ud569\n\nChipReservation\n    \uc0ac\uc6a9\uc790\uc640 \ud14c\uc774\ube14\ubcc4 \uc2a4\ud0dd\uc758 DB \uc0ac\ubcf8\n\nLedgerEntry\n    \ucd94\uac00 \uc804\uc6a9 \uc6d0\uc7a5, idempotencyKey \uace0\uc720 \uc81c\uc57d\n\nSettlement\n    \ud578\ub4dc\ub2f9 \ud558\ub098\uc758 \uc815\uc0b0 \uae30\ub85d, handId \uae30\ubcf8 \ud0a4<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ubc14\uc774\uc778\uc740 \uc0ac\uc6a9 \uac00\ub2a5\ud55c \uce69\uc744 \uc608\uc57d \uce69\uc73c\ub85c \uc774\ub3d9\uc2dc\ud0a4\ub294 \uc791\uc5c5\uc774\ub2e4. \ud1f4\uc7a5\ud560 \ub54c\ub294 \ubc18\ub300\ub85c \ucc98\ub9ac\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ud578\ub4dc \uacb0\uacfc\ub294 \ud14c\uc774\ube14\uc5d0 \uc608\uc57d\ub41c \uce69\uc758 \uc99d\uac10\uc73c\ub85c \ubc18\uc601\ud55c\ub2e4. \uc74c\uc218 \uc794\uc561\uc740 \uc560\ud50c\ub9ac\ucf00\uc774\uc158 \uac80\uc99d\ubfd0 \uc544\ub2c8\ub77c \ub370\uc774\ud130\ubca0\uc774\uc2a4\uc758 <code>CHECK<\/code> \uc81c\uc57d\uc73c\ub85c\ub3c4 \ubc29\uc9c0\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ud558\ub098\uc758 \ud2b8\ub79c\uc7ad\uc158\uc73c\ub85c \uc815\uc0b0<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ud578\ub4dc\uac00 \uc885\ub8cc\ub418\uba74 <code>settleHand<\/code>\uc5d0\uc11c \ud558\ub098\uc758 MySQL \ud2b8\ub79c\uc7ad\uc158\uc73c\ub85c \ubaa8\ub4e0 \uc815\uc0b0 \uc791\uc5c5\uc744 \ucc98\ub9ac\ud55c\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>handId<\/code>\ub97c \uae30\uc900\uc73c\ub85c \uc815\uc0b0 \ub808\ucf54\ub4dc\ub97c \uc0dd\uc131\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uc774\ubbf8 \uc815\uc0b0\ub41c \ud578\ub4dc\ub77c\uba74 \uc911\ubcf5 \ucc98\ub9ac \uc5c6\uc774 \uc885\ub8cc\ud55c\ub2e4.<\/li>\n\n\n\n<li>\ud578\ub4dc \uae30\ub85d, \ub371 \uacf5\uac1c \uc815\ubcf4, \ucc38\uac00\uc790, \uc561\uc158, \uacb0\uacfc JSON\uc744 \uc800\uc7a5\ud55c\ub2e4.<\/li>\n\n\n\n<li>\ud50c\ub808\uc774\uc5b4\ubcc4 \uc608\uc57d \uce69, \uc9c0\uac11, \uc6d0\uc7a5\uc744 \uac31\uc2e0\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uac19\uc740 \ud2b8\ub79c\uc7ad\uc158 \uc548\uc5d0 Outbox \uc774\ubca4\ud2b8\ub97c \uae30\ub85d\ud55c\ub2e4.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc608\uc57d \uce69\uc744 \uac31\uc2e0\ud560 \ub54c\ub294 \uae30\uc874 \uac12\uc774 \uc608\uc0c1\ud55c \uc2dc\uc791 \uc2a4\ud0dd\uacfc \uc77c\uce58\ud558\ub294\uc9c0 \ud655\uc778\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>const r = await tx.chipReservation.updateMany({\n  where: {\n    userId: p.userId,\n    tableId: s.tableId,\n    amount: p.startStack,\n  },\n  data: {\n    amount: p.endStack,\n  },\n});\n\nif (r.count !== 1) {\n  throw new ReservationConflictError(\n    `reservation mismatch for ${p.userId}`\n  );\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \uc870\uac74\ubd80 \uc5c5\ub370\uc774\ud2b8\ub294 \uc77d\uc740 \uac12\uacfc \uc2e4\uc81c\ub85c \ubcc0\uacbd\ud558\ub824\ub294 \uac12\uc774 \ub2e4\ub97c \ub54c \uc815\uc0b0\uc744 \uc911\ub2e8\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2e4\ub978 \uc791\uc5c5\uc774 \uc608\uc57d \uce69\uc744 \uba3c\uc800 \ubcc0\uacbd\ud588\ub2e4\uba74 \uc870\uac74\uc774 \uc77c\uce58\ud558\uc9c0 \uc54a\uc73c\ubbc0\ub85c \ud2b8\ub79c\uc7ad\uc158\uc744 \ub864\ubc31\ud55c\ub2e4. \uc798\ubabb\ub41c \uc0c1\ud0dc\ub97c \ub36e\uc5b4\uc4f0\ub294 \ub300\uc2e0 \ucda9\ub3cc\uc744 \uba85\uc2dc\uc801\uc73c\ub85c \uac10\uc9c0\ud558\ub294 \ubc29\uc2dd\uc774\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc815\uc0b0 \uc804 \ubd88\ubcc0 \uc870\uac74 \uac80\uc99d<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ub370\uc774\ud130\ubca0\uc774\uc2a4\uc5d0 \uacb0\uacfc\ub97c \ubc18\uc601\ud558\uae30 \uc804\uc5d0 \uce69\uc758 \uc774\ub3d9\uc774 \uc815\ud655\ud55c\uc9c0 \uac80\uc99d\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>if (p.endStack !== p.startStack + net) {\n  fail(`stack mismatch for ${p.userId}`);\n}\n\nif (netSum !== 0) {\n  fail(`net sum is ${netSum}`);\n}\n\nif (startSum !== endSum) {\n  fail(\"chips not conserved\");\n}\n\nif (potTotal !== winTotal) {\n  fail(\"pot payout mismatch\");\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ud575\uc2ec \uac80\uc99d \uc870\uac74\uc740 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uc2dc\uc791 \uc2a4\ud0dd\uacfc \uc21c\uc190\uc775\uc758 \ud569\uc774 \uc885\ub8cc \uc2a4\ud0dd\uacfc \uc77c\uce58\ud574\uc57c \ud55c\ub2e4.<\/li>\n\n\n\n<li>\ud50c\ub808\uc774\uc5b4 \uc804\uccb4\uc758 \uc21c\uc190\uc775 \ud569\uc740 0\uc774\uc5b4\uc57c \ud55c\ub2e4.<\/li>\n\n\n\n<li>\uc804\uccb4 \uce69\uc758 \ud569\uc740 \ubcc0\ud558\uc9c0 \uc54a\uc544\uc57c \ud55c\ub2e4.<\/li>\n\n\n\n<li>\ud31f\uc758 \ucd1d\uc561\uacfc \uc9c0\uae09\ub41c \uce69\uc758 \ud569\uc774 \uc77c\uce58\ud574\uc57c \ud55c\ub2e4.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \uc870\uac74\uc744 \uc704\ubc18\ud558\ub294 \uc0c1\ud669\uc740 \uc77c\ubc18\uc801\uc778 \uc7ac\uc2dc\ub3c4\ub85c \ud574\uacb0\ud560 \ubb38\uc81c\uac00 \uc544\ub2c8\ub2e4. \ud14c\uc774\ube14\uc744 <code>SETTLEMENT_PENDING<\/code> \uc0c1\ud0dc\ub85c \uc804\ud658\ud558\uace0 \uc6b4\uc601\uc790\uc758 \ud655\uc778\uc744 \uc694\uad6c\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc815\ud569\uc131\uc774 \uae68\uc9c4 \uacb0\uacfc\ub97c \uc790\ub3d9\uc73c\ub85c \ud655\uc815\ud558\ub294 \uac83\ubcf4\ub2e4 \uc815\uc0b0\uc744 \uc911\ub2e8\ud558\ub294 \ud3b8\uc774 \uc548\uc804\ud558\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ub3d9\uc2dc\uc131 \uc81c\uc5b4\uc640 \uc7a0\uae08 \uc21c\uc11c<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ub3d9\uc77c\ud55c \uc0ac\uc6a9\uc790\uc758 \ubc14\uc774\uc778, \ud658\uae09, \ud578\ub4dc \uc815\uc0b0\uc774 \ub3d9\uc2dc\uc5d0 \ubc1c\uc0dd\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub97c \ubc29\uc9c0\ud558\uae30 \uc704\ud574 \ubaa8\ub4e0 \uc791\uc5c5\uc5d0\uc11c \uc7a0\uae08 \uc21c\uc11c\ub97c \ud1b5\uc77c\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\uc9c0\uac11 \ud589 \u2192 \uc608\uc57d \uce69<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc815\uc0b0\uc5d0 \uc5ec\ub7ec \uc0ac\uc6a9\uc790\uac00 \ucc38\uc5ec\ud558\ub294 \uacbd\uc6b0\uc5d0\ub294 <code>userId<\/code> \uc21c\uc11c\ub85c \ud589\uc744 \uc7a0\uadfc\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>async function lockWallet(tx: Tx, userId: string) {\n  await tx.$queryRaw`\n    SELECT userId\n    FROM wallets\n    WHERE userId = ${userId}\n    FOR UPDATE\n  `;\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc77c\uad00\ub41c \uc7a0\uae08 \uc21c\uc11c\ub294 \uad50\ucc29 \uc0c1\ud0dc\uac00 \ubc1c\uc0dd\ud560 \uac00\ub2a5\uc131\uc744 \uc904\uc778\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc794\uc561 \ucc28\uac10\uc740 <code>UPDATE ... WHERE balance &gt;= amount<\/code> \ud615\ud0dc\uc758 \uc870\uac74\ubd80 \uc5c5\ub370\uc774\ud2b8\ub85c \ucc98\ub9ac\ud55c\ub2e4. \uc794\uc561\uc774 \ucda9\ubd84\ud558\uc9c0 \uc54a\uc73c\uba74 \ubcc0\uacbd\uc774 \uc801\uc6a9\ub418\uc9c0 \uc54a\uc73c\ubbc0\ub85c \uc74c\uc218 \uc794\uc561\uc744 \ubc29\uc9c0\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uba71\ub4f1 \ud0a4\ub294 \uc7a0\uae08\uc744 \ud68d\ub4dd\ud55c \ub4a4 \ud655\uc778\ud55c\ub2e4. \uc55e\uc120 \ud2b8\ub79c\uc7ad\uc158\uc774 \ucee4\ubc0b\ud55c \uacb0\uacfc\ub97c \ud655\uc778\ud55c \ud6c4 \uc911\ubcf5 \uc694\uccad \uc5ec\ubd80\ub97c \ud310\ub2e8\ud558\uae30 \uc704\ud574\uc11c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Transactional Outbox \ud328\ud134<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uc815\uc0b0\uc740 \uc644\ub8cc\ub410\uc9c0\ub9cc \uc774\ubca4\ud2b8 \ubc1c\ud589\uc5d0 \uc2e4\ud328\ud558\ub294 \uc0c1\ud669\uc744 \uace0\ub824\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc815\uc0b0 \ud2b8\ub79c\uc7ad\uc158 \uc548\uc5d0\uc11c Outbox \uc774\ubca4\ud2b8\uae4c\uc9c0 \uae30\ub85d\ud558\uace0, \ubcc4\ub3c4\uc758 \ub514\uc2a4\ud328\ucc98\uac00 \ud574\ub2f9 \uc774\ubca4\ud2b8\ub97c \uc77d\uc5b4 Redis Pub\/Sub\uc73c\ub85c \ubc1c\ud589\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>UPDATE outbox_events\nSET lockToken = ?, lockedUntil = ?\nWHERE status = 'PENDING'\n  AND nextAttemptAt &lt;= ?\n  AND (lockedUntil IS NULL OR lockedUntil &lt; ?)\nORDER BY createdAt\nLIMIT ?;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ud558\ub098\uc758 \uc870\uac74\ubd80 \uc5c5\ub370\uc774\ud2b8\ub85c \ucc98\ub9ac\ud560 \uc774\ubca4\ud2b8\ub97c \uc120\uc810\ud558\ubbc0\ub85c \uc5ec\ub7ec \uc778\uc2a4\ud134\uc2a4\uac00 \uac19\uc740 \uc774\ubca4\ud2b8\ub97c \ub3d9\uc2dc\uc5d0 \ucc98\ub9ac\ud558\ub294 \ubb38\uc81c\ub97c \uc904\uc778\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ubc1c\ud589\uc5d0 \uc2e4\ud328\ud558\uba74 \ub2e4\uc74c \uc2dc\ub3c4 \uc2dc\uac01\uc744 \uc870\uc815\ud558\uace0 \uc7ac\uc2dc\ub3c4\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Outbox\ub294 \ub370\uc774\ud130\ubca0\uc774\uc2a4 \ubcc0\uacbd\uacfc \uc774\ubca4\ud2b8 \ubc1c\ud589 \uc0ac\uc774\uc758 \ubd88\uc77c\uce58\ub97c \uc904\uc5ec \uc8fc\uc9c0\ub9cc, \uc774\ubca4\ud2b8 \uc18c\ube44\uc790\uc5d0\uc11c\ub3c4 \uc911\ubcf5 \ucc98\ub9ac\ub97c \uace0\ub824\ud574\uc57c \ud55c\ub2e4. \uc77c\ubc18\uc801\uc73c\ub85c \uc804\ub2ec\uc740 \ucd5c\uc18c \ud55c \ubc88 \ubc1c\uc0dd\ud560 \uc218 \uc788\ub2e4\uace0 \uac00\uc815\ud558\uace0 \uc18c\ube44\uc790\uc758 \uba71\ub4f1\uc131\uc744 \ubcf4\uc7a5\ud558\ub294 \uac83\uc774 \uc548\uc804\ud558\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ubd84\uc0b0 \ud658\uacbd: \ud14c\uc774\ube14 \uc18c\uc720\uad8c\uacfc \uc7a5\uc560 \ubcf5\uad6c<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">\ud14c\uc774\ube14 \uc18c\uc720\uad8c \uc81c\uc5b4<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ubd84\uc0b0 \ud658\uacbd\uc5d0\uc11c\ub294 \ud558\ub098\uc758 \ud14c\uc774\ube14\uc744 \uc5ec\ub7ec \uac8c\uc784 \uc11c\ubc84\uac00 \ub3d9\uc2dc\uc5d0 \ucc98\ub9ac\ud558\uc9c0 \ubabb\ud558\ub3c4\ub85d \ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub450 \uc11c\ubc84\uac00 \uac19\uc740 \ud14c\uc774\ube14\uc744 \uc18c\uc720\ud558\uba74 \uc11c\ub85c \ub2e4\ub978 \uac8c\uc784 \uc0c1\ud0dc\ub97c \uae30\uc900\uc73c\ub85c \uce69\uc744 \ubcc0\uacbd\ud560 \uc218 \uc788\uae30 \ub54c\ubb38\uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Redis\uc758 <code>SET NX PX<\/code>\ub97c \uc774\uc6a9\ud574 \ud14c\uc774\ube14\ubcc4 \ubd84\uc0b0 \ub77d\uc744 \ud68d\ub4dd\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>this.lease = await svc.lock.tryAcquire(\n  `table-owner:${config.tableId}`,\n  OWNER_LOCK_TTL_MS\n);\n\nif (!this.lease) {\n  throw new ServerError(409, \"TABLE_ALREADY_HOSTED\");\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uad6c\ud604\uc5d0\uc11c\ub294 \ub2e4\uc74c \uc815\ucc45\uc744 \uc801\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ub77d\uc740 \uc77c\uc815 \uc2dc\uac04 \ud6c4 \ub9cc\ub8cc\ub418\ub3c4\ub85d \uc124\uc815\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uc11c\ubc84\ub294 \uc8fc\uae30\uc801\uc73c\ub85c \ub77d\uc744 \uc5f0\uc7a5\ud55c\ub2e4.<\/li>\n\n\n\n<li>\ub77d \ud574\uc81c\uc640 \uc5f0\uc7a5\uc740 Lua \uc2a4\ud06c\ub9bd\ud2b8\ub85c \ucc98\ub9ac\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uc18c\uc720\uad8c \ud1a0\ud070\uc774 \uc77c\uce58\ud560 \ub54c\ub9cc \ub77d\uc744 \ubcc0\uacbd\ud558\uac70\ub098 \ud574\uc81c\ud55c\ub2e4.<\/li>\n\n\n\n<li>\ub77d\uc744 \uc783\uc740 Room\uc740 \uc2a4\uc2a4\ub85c \uc885\ub8cc\ud55c\ub2e4.<\/li>\n\n\n\n<li><code>TableProvisioner<\/code>\uac00 \uc18c\uc720\uc790\uac00 \uc5c6\ub294 \ud14c\uc774\ube14\uc744 \ucc3e\uc544 Room \uc0dd\uc131\uc744 \uc2dc\ub3c4\ud55c\ub2e4.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2e4\ub9cc TTL \uae30\ubc18 \ub77d\ub9cc\uc73c\ub85c \ubaa8\ub4e0 \ubd84\uc0b0 \uc815\ud569\uc131\uc774 \uc790\ub3d9 \ubcf4\uc7a5\ub418\ub294 \uac83\uc740 \uc544\ub2c8\ub2e4. \ub124\ud2b8\uc6cc\ud06c \ub2e8\uc808\uc774\ub098 \uc77c\uc2dc \uc815\uc9c0\ub85c \uc778\ud574 \uc774\uc804 \uc18c\uc720\uc790\uac00 \ub77d\uc744 \uc783\uc740 \ub4a4\uc5d0\ub3c4 \uc791\uc5c5\uc744 \uacc4\uc18d\ud560 \uc218 \uc788\ub294 \uc0c1\ud669\uae4c\uc9c0 \uace0\ub824\ud574\uc57c \ud55c\ub2e4. \uc911\uc694\ud55c \uc601\uc18d \ub370\uc774\ud130 \ubcc0\uacbd\uc740 \ub370\uc774\ud130\ubca0\uc774\uc2a4\uc758 \uc870\uac74\ubd80 \uc5c5\ub370\uc774\ud2b8\uc640 \uace0\uc720 \uc81c\uc57d\uc73c\ub85c \ubcf4\ud638\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Redis \uc2a4\ub0c5\uc0f7\uc744 \uc774\uc6a9\ud55c \ubcf5\uad6c<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><code>TableSession<\/code>\uc740 \uba85\ub839\uc774 \ucc98\ub9ac\ub420 \ub54c\ub9c8\ub2e4 \ud14c\uc774\ube14 \uc0c1\ud0dc\ub97c Redis\uc5d0 \uc800\uc7a5\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc2a4\ub0c5\uc0f7\uc5d0\ub294 \uc9c4\ud589 \uc911\uc778 \ud578\ub4dc, \ub371, \ud640\uce74\ub4dc \ub4f1 \ubcf5\uad6c\uc5d0 \ud544\uc694\ud55c \uc815\ubcf4\uac00 \ud3ec\ud568\ub41c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc11c\ubc84\uac00 \ube44\uc815\uc0c1 \uc885\ub8cc\ub418\uba74 \ub77d\uc774 \ub9cc\ub8cc\ub41c \uc774\ud6c4 \ub2e4\ub978 \uc11c\ubc84\uac00 \ud574\ub2f9 \ud14c\uc774\ube14\uc744 \uc5f4\uace0 \uc2a4\ub0c5\uc0f7\uc744 \uc774\uc6a9\ud574 \uac8c\uc784 \uc0c1\ud0dc\ub97c \ubcf5\uc6d0\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ubcf5\uad6c \uc2dc\uc5d0\ub294 \ub2e4\uc74c \uc791\uc5c5\uc744 \uc218\ud589\ud55c\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uae30\uc874 \ud50c\ub808\uc774\uc5b4\ub97c \uc5f0\uacb0\uc774 \ub04a\uae34 \uc0c1\ud0dc\ub85c \ubcf5\uc6d0\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uc7ac\uc811\uc18d \uc720\uc608 \uc2dc\uac04 \uc548\uc5d0 \uae30\uc874 \ud50c\ub808\uc774\uc5b4\uac00 \ub3cc\uc544\uc62c \uc218 \uc788\ub3c4\ub85d \ud55c\ub2e4.<\/li>\n\n\n\n<li>\uc644\ub8cc\ub410\uc9c0\ub9cc \uc815\uc0b0\ub418\uc9c0 \uc54a\uc740 \ud578\ub4dc\ub294 <code>settlementPending<\/code> \uc0c1\ud0dc\ub85c \uc7ac\uc2dc\ub3c4\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uc88c\uc11d\uc5d0\ub294 \uc5c6\uc9c0\ub9cc \uc608\uc57d \uce69\uc774 \ub0a8\uc544 \uc788\ub294 \uc0ac\uc6a9\uc790\ub97c \ucc3e\uc544 \ud658\uae09 \ucc98\ub9ac\ud55c\ub2e4.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc2a4\ub0c5\uc0f7 \uc800\uc7a5 \uc2e4\ud328\uac00 \uace7\ubc14\ub85c \uac8c\uc784\uc744 \uc911\ub2e8\uc2dc\ud0a4\uc9c0\ub294 \uc54a\ub294\ub2e4. \uc2a4\ub0c5\uc0f7\uc740 \ube60\ub978 \ubcf5\uad6c\ub97c \uc704\ud55c \ubcf4\uc870 \uc790\ub8cc\uc774\uba70, \uc601\uc18d\uc801\uc778 \uce69 \uc815\uc0b0\uc758 \uae30\uc900\uc740 MySQL \uc6d0\uc7a5\uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc2e4\uc81c\ub85c <code>SIGKILL<\/code>\ub85c \uac8c\uc784 \uc11c\ubc84\ub97c \uc885\ub8cc\ud558\ub294 \ud14c\uc2a4\ud2b8\uc5d0\uc11c\ub294 \ub77d TTL\uacfc \ud504\ub85c\ube44\uc800\ub108 \uc8fc\uae30\uc5d0 \ub530\ub77c \uc57d 30~40\ucd08 \ub4a4 \uac19\uc740 \ud578\ub4dc\uc640 \ud640\uce74\ub4dc\ub97c \ubcf5\uad6c\ud558\uace0 \uce69\uc744 \ubcf4\uc874\ud558\ub294 \uac83\uc744 \ud655\uc778\ud588\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \ubcf5\uad6c \uc2dc\uac04\uc740 \ubb34\uc911\ub2e8 \ubcf5\uad6c\uac00 \uc544\ub2c8\ub77c\ub294 \ud55c\uacc4\ub3c4 \ud568\uaed8 \uc758\ubbf8\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc6b0\uc544\ud55c \uc885\ub8cc\uc640 \ub864\ub9c1 \uc5c5\ub370\uc774\ud2b8<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Kubernetes\ub294 \ub864\ub9c1 \uc5c5\ub370\uc774\ud2b8 \uacfc\uc815\uc5d0\uc11c Colyseus Room\uc744 \uc790\ub3d9\uc73c\ub85c \ub2e4\ub978 Pod\ub85c \uc774\uc804\ud574 \uc8fc\uc9c0 \uc54a\ub294\ub2e4. \ub530\ub77c\uc11c \uc11c\ubc84 \uc885\ub8cc \uc808\ucc28\ub97c \uc9c1\uc811 \uc124\uacc4\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>SIGTERM \uc218\uc2e0\n    \u2193\n\uc0c8 \uc785\uc7a5 \ucc28\ub2e8 \ubc0f Readiness 503\n    \u2193\n\uc0c8 \ud578\ub4dc \uc2dc\uc791 \uc911\ub2e8\n    \u2193\n\uc9c4\ud589 \uc911\uc778 \ud578\ub4dc \uc644\ub8cc \ub300\uae30\n    \u2193\n\ub0a8\uc740 Room\uc758 \uc2a4\ub0c5\uc0f7 \uc800\uc7a5\n    \u2193\n\ub2e4\ub978 \ud504\ub85c\uc138\uc2a4\uac00 Room \ubcf5\uad6c<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uac1c\ubc1c \uacfc\uc815\uc5d0\uc11c \uc911\uc694\ud55c \ubb38\uc81c\uac00 \ud558\ub098 \uc788\uc5c8\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Colyseus\ub294 \uae30\ubcf8 \uc885\ub8cc \uacfc\uc815\uc5d0\uc11c \uc5f0\uacb0\uc744 \ucf54\ub4dc <code>4000<\/code>\uc73c\ub85c \ub2eb\ub294\ub2e4. \uc774 \ucf54\ub4dc\ub294 \uc790\ubc1c\uc801\uc778 \ud1f4\uc7a5\uc73c\ub85c \ud574\uc11d\ub420 \uc218 \uc788\uc5b4, \ubc30\ud3ec\ud560 \ub54c\ub9c8\ub2e4 \ud50c\ub808\uc774\uc5b4\uc758 \uc88c\uc11d\uc774 \ud574\uc81c\ub418\ub294 \ubb38\uc81c\uac00 \ubc1c\uc0dd\ud588\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub97c \ubc29\uc9c0\ud558\uae30 \uc704\ud574 \uc11c\ubc84 \uc885\ub8cc \uc804\uc6a9 \ucf54\ub4dc <code>4503<\/code>\uc744 \uc0ac\uc6a9\ud574 \ube44\uc790\ubc1c\uc801\uc778 \uc5f0\uacb0 \uc885\ub8cc \uacbd\ub85c\ub97c \ud0c0\ub3c4\ub85d \ud588\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>override onBeforeShutdown(): void {\n  void this.disconnect(CloseCode.SERVER_SHUTTING_DOWN);\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ud074\ub77c\uc774\uc5b8\ud2b8\ub294 \ud574\ub2f9 \uc885\ub8cc \ucf54\ub4dc\ub97c \ud655\uc778\ud558\uace0 \uc7ac\uc811\uc18d\uc744 \uc2dc\ub3c4\ud55c\ub2e4. \uae30\uc874 Room\uc774 \uc0b4\uc544 \uc788\uc73c\uba74 \uc7ac\uc811\uc18d \ud1a0\ud070\uc73c\ub85c \ubcf5\uadc0\ud558\uace0, Room\uc774 \ubcf5\uad6c\ub41c \uacbd\uc6b0\uc5d0\ub294 \uc0c8 Room\uc5d0 \uc785\uc7a5\ud574 \uc0ac\uc6a9\uc790 ID\ub97c \uae30\uc900\uc73c\ub85c \uae30\uc874 \uc88c\uc11d\uc5d0 \ub2e4\uc2dc \uc5f0\uacb0\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \ubc29\uc2dd\uc740 \ub2e8\uc21c\ud788 \ud504\ub85c\uc138\uc2a4\ub97c \uc7ac\uc2dc\uc791\ud558\ub294 \uac83\uacfc \uac8c\uc784 \uc138\uc158\uc744 \uc720\uc9c0\ud558\uba74\uc11c \ubc30\ud3ec\ud558\ub294 \uac83\uc758 \ucc28\uc774\ub97c \ubcf4\uc5ec \uc900\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ubcf4\uc548 \uc124\uacc4<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">\uc778\uc99d \ud750\ub984<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uc778\uc99d\uc740 API \ub85c\uadf8\uc778\ubd80\ud130 WebSocket \uc5f0\uacb0, \uc138\uc158 \ud3d0\uae30\uae4c\uc9c0 \uc77c\uad00\ub41c \ud750\ub984\uc73c\ub85c \uc124\uacc4\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>\ud68c\uc6d0\uac00\uc785 \/ \ub85c\uadf8\uc778\n        \u2193\nArgon2id \ube44\ubc00\ubc88\ud638 \uac80\uc99d\n        \u2193\n\uc138\uc158 \uc0dd\uc131\n        \u2193\nAccess JWT + Refresh Token \ubc1c\uae09\n        \u2193\nRefresh \uc694\uccad \uc2dc \ud1a0\ud070 \ud68c\uc804\n        \u2193\nWebSocket onAuth\n        \u2193\nJWT \uac80\uc99d \u2192 \uc138\uc158 \ud655\uc778 \u2192 \uacc4\uc815 \uc0c1\ud0dc \ud655\uc778<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">\ube44\ubc00\ubc88\ud638 \ubcf4\ud638<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ube44\ubc00\ubc88\ud638\ub294 \ud3c9\ubb38\uc774\ub098 \ubcf5\ud638\ud654 \uac00\ub2a5\ud55c \ud615\ud0dc\ub85c \uc800\uc7a5\ud558\uc9c0 \uc54a\ub294\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Argon2id\ub97c \uc774\uc6a9\ud574 \ube44\ubc00\ubc88\ud638\ub97c \uac80\uc99d\ud558\uace0, \ub2e4\uc74c \uc124\uc815\uc744 \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uba54\ubaa8\ub9ac \ube44\uc6a9: 19 MiB<\/li>\n\n\n\n<li>\ubc18\ubcf5 \ud69f\uc218: 2<\/li>\n\n\n\n<li>\ubcd1\ub82c\ub3c4: 1<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\ube44\ubc00\ubc88\ud638 \uc815\ucc45\uc740 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ucd5c\uc18c 10\uc790, \ucd5c\ub300 128\uc790<\/li>\n\n\n\n<li>\uc11c\ub85c \ub2e4\ub978 \ubb38\uc790 5\uc885 \uc774\uc0c1<\/li>\n\n\n\n<li>\uc601\ubb38 \uc18c\ubb38\uc790, \ub300\ubb38\uc790, \uc22b\uc790, \uae30\ud638 \uc911 \ucd5c\uc18c 2\uc885\ub958 \uc774\uc0c1<\/li>\n\n\n\n<li>\uc77c\uc815 \uae38\uc774 \uc774\uc0c1\uc758 \uc774\uba54\uc77c \uc544\uc774\ub514\ub97c \ube44\ubc00\ubc88\ud638\uc5d0 \ud3ec\ud568\ud558\uc9c0 \ubabb\ud558\ub3c4\ub85d \uc81c\ud55c<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc874\uc7ac\ud558\uc9c0 \uc54a\ub294 \uc774\uba54\uc77c\ub85c \ub85c\uadf8\uc778\ud558\ub294 \uacbd\uc6b0\uc5d0\ub3c4 \ub354\ubbf8 \ud574\uc2dc\ub97c \uc774\uc6a9\ud574 \ub3d9\uc77c\ud55c \uc218\uc900\uc758 \ube44\ubc00\ubc88\ud638 \uac80\uc99d \ube44\uc6a9\uc744 \uc18c\ube44\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>if (!user) {\n  await this.burnPasswordCheck(input.password);\n  throw invalidCredentials();\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc0ac\uc6a9\uc790 \uc874\uc7ac \uc5ec\ubd80\uc5d0 \ub530\ub77c \uc751\ub2f5 \uc2dc\uac04\uc774\ub098 \uc624\ub958 \uba54\uc2dc\uc9c0\uac00 \ud06c\uac8c \ub2ec\ub77c\uc9c0\ub294 \uac83\uc744 \ubc29\uc9c0\ud558\uae30 \uc704\ud55c \uc124\uacc4\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc5f0\uc18d \ub85c\uadf8\uc778 \uc2e4\ud328\uac00 5\ud68c \ubc1c\uc0dd\ud558\uba74 15\ubd84 \ub3d9\uc548 \uacc4\uc815\uc744 \uc7a0\uadf8\uace0, \ub85c\uadf8\uc778\uc5d0 \uc131\uacf5\ud558\uba74 \uc2e4\ud328 \ud69f\uc218\ub97c \ucd08\uae30\ud654\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Access Token\uacfc Refresh Token<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ud1a0\ud070\uc740 \uc5ed\ud560\uacfc \uc218\uba85\uc744 \uad6c\ubd84\ud55c\ub2e4.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>\ud1a0\ud070<\/th><th>\ud615\ud0dc<\/th><th>\uc218\uba85<\/th><th>\uc800\uc7a5 \uc704\uce58<\/th><\/tr><tr><td>Access Token<\/td><td>JWT, HS256<\/td><td>\uae30\ubcf8 10\ubd84<\/td><td>\ud074\ub77c\uc774\uc5b8\ud2b8 \uba54\ubaa8\ub9ac<\/td><\/tr><tr><td>Refresh Token<\/td><td>32\ubc14\uc774\ud2b8 \ub09c\uc218 \uae30\ubc18 \ubd88\ud22c\uba85 \ud1a0\ud070<\/td><td>\uae30\ubcf8 30\uc77c<\/td><td>\ud074\ub77c\uc774\uc5b8\ud2b8 OS \ubcf4\uc548 \uc800\uc7a5\uc18c<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Access JWT\ub294 <code>iss<\/code>, <code>aud<\/code>, <code>exp<\/code>, <code>sub<\/code>, <code>sid<\/code> \ub4f1\uc758 \ud074\ub808\uc784\uc744 \uac80\uc99d\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Refresh Token \uc6d0\ubb38\uc740 \uc11c\ubc84\uc5d0 \uc800\uc7a5\ud558\uc9c0 \uc54a\uace0 SHA-256 \ud574\uc2dc\ub9cc \uc800\uc7a5\ud55c\ub2e4. \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uc11c\ub294 Keychain \ub610\ub294 Android Keystore \uae30\ubc18\uc758 \ubcf4\uc548 \uc800\uc7a5\uc18c\ub97c \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Access Token\uc740 \uba54\ubaa8\ub9ac\uc5d0\ub9cc \ubcf4\uad00\ud574 \ub514\uc2a4\ud06c\uc5d0 \ub0a8\uc9c0 \uc54a\ub3c4\ub85d \ud558\uace0, Refresh Token\uc740 <code>expo-secure-store<\/code>\ub97c \uc774\uc6a9\ud574 \uc800\uc7a5\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \uad6c\uc870\ub294 Access Token \ud0c8\ucde8\uc758 \uc720\ud6a8 \uc2dc\uac04\uc744 \uc81c\ud55c\ud558\uace0, \uc11c\ubc84 \ub370\uc774\ud130\ubca0\uc774\uc2a4\uac00 \uc720\ucd9c\ub418\ub354\ub77c\ub3c4 Refresh Token \uc6d0\ubb38\uc774 \uc9c1\uc811 \ub178\ucd9c\ub418\ub294 \uac83\uc744 \ubc29\uc9c0\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Refresh Token \ud68c\uc804\uacfc \uc7ac\uc0ac\uc6a9 \ud0d0\uc9c0<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Refresh Token\uc740 \uc0ac\uc6a9\ud560 \ub54c\ub9c8\ub2e4 \uae30\uc874 \ud1a0\ud070\uc744 \ud3d0\uae30\ud558\uace0 \uc0c8 \ud1a0\ud070\uc744 \ubc1c\uae09\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ubbf8 \uc0ac\uc6a9\ub41c \ud1a0\ud070\uc774 \ub2e4\uc2dc \uc81c\ucd9c\ub418\uba74 \ud1a0\ud070 \ud0c8\ucde8 \uac00\ub2a5\uc131\uc744 \uace0\ub824\ud574 \uc138\uc158 \uc804\uccb4\ub97c \ud3d0\uae30\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>const won =\n  await this.d.refreshTokens.markUsedIfUnused(\n    stored.id,\n    now\n  );\n\nif (!won) {\n  return this.handleReuse(session, ctx);\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><code>markUsedIfUnused<\/code>\ub294 \ub2e4\uc74c\uacfc \uac19\uc740 \uc870\uac74\ubd80 \uc5c5\ub370\uc774\ud2b8\ub97c \uc774\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>UPDATE refresh_tokens\nSET usedAt = ?\nWHERE id = ?\n  AND usedAt IS NULL;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ub3d9\uc2dc\uc5d0 \uac19\uc740 \ud1a0\ud070\uc73c\ub85c \uc694\uccad\uc774 \ub4e4\uc5b4\uc624\ub354\ub77c\ub3c4 \uc870\uac74\uc744 \uba3c\uc800 \ucda9\uc871\ud55c \uc694\uccad \ud558\ub098\ub9cc \uc131\uacf5\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uc11c\ub3c4 \uc5ec\ub7ec \uac31\uc2e0 \uc694\uccad\uc774 \ub3d9\uc2dc\uc5d0 \ubc1c\uc0dd\ud558\uc9c0 \uc54a\ub3c4\ub85d <code>single-flight<\/code> \ud328\ud134\uc744 \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>let refreshing: Promise&lt;AuthResponseDto | null&gt; | null =\n  null;\n\nexport function refreshSession() {\n  if (refreshing) return refreshing;\n\n  refreshing = (async () =&gt; {\n    \/\/ \ud1a0\ud070 \uac31\uc2e0 \ucc98\ub9ac\n  })().finally(() =&gt; {\n    refreshing = null;\n  });\n\n  return refreshing;\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub807\uac8c \ud558\uba74 \uc5ec\ub7ec API \uc694\uccad\uc774 \ub3d9\uc2dc\uc5d0 \ub9cc\ub8cc\ub41c Access Token\uc744 \ubc1c\uacac\ud574\ub3c4 \uc2e4\uc81c Refresh \uc694\uccad\uc740 \ud558\ub098\ub9cc \uc2e4\ud589\ub41c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2e4\ub9cc \ud604\uc7ac \uc124\uacc4\ub294 \uc751\ub2f5\uc774 \uc720\uc2e4\ub418\uc5b4 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ub3d9\uc77c\ud55c Refresh Token\uc744 \ub2e4\uc2dc \ubcf4\ub0b4\ub294 \uc0c1\ud669\uc5d0\uc11c\ub3c4 \uc138\uc158\uc774 \ud3d0\uae30\ub420 \uc218 \uc788\ub2e4. \uc774\ub97c \uc644\ud654\ud558\ub824\uba74 \uc81c\ud55c\ub41c \uc7ac\uc2dc\ub3c4 \uc720\uc608 \uad6c\uac04\uc774\ub098 \ud1a0\ud070 \ud68c\uc804 \uacb0\uacfc\uc758 \uc548\uc804\ud55c \uc7ac\uc804\ub2ec \uc815\ucc45\uc774 \ud544\uc694\ud558\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc138\uc158 \ud3d0\uae30\uc758 \uc2e4\uc2dc\uac04 \uc5f0\uacb0 \uc804\ud30c<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ub85c\uadf8\uc544\uc6c3, \ube44\ubc00\ubc88\ud638 \ubcc0\uacbd, \uacc4\uc815 \uc815\uc9c0 \uc774\ud6c4\uc5d0\ub294 \uae30\uc874 WebSocket \uc5f0\uacb0\ub3c4 \uc885\ub8cc\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ucc98\ub9ac \ud750\ub984\uc740 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uc138\uc158\uc744 \ud3d0\uae30\ud558\uace0 Redis \uc138\uc158 \uce90\uc2dc\ub97c <code>REVOKED<\/code> \uc0c1\ud0dc\ub85c \ubcc0\uacbd\ud55c\ub2e4.<\/li>\n\n\n\n<li>Redis Pub\/Sub\uc73c\ub85c \ud3d0\uae30 \uc774\ubca4\ud2b8\ub97c \ubc1c\ud589\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uac01 \uac8c\uc784 \uc11c\ubc84\ub294 \ud574\ub2f9 \uc0ac\uc6a9\uc790\uc5d0\uac8c \uc5f0\uacb0\ub41c \uc18c\ucf13\uc744 \uc885\ub8cc \ucf54\ub4dc <code>4403<\/code>\uc73c\ub85c \ub2eb\ub294\ub2e4.<\/li>\n\n\n\n<li>Pub\/Sub \uba54\uc2dc\uc9c0\ub97c \ub193\uce58\ub294 \uc0c1\ud669\uc5d0 \ub300\ube44\ud574 15\ucd08\ub9c8\ub2e4 \uc138\uc158 \uc0c1\ud0dc\ub97c \ub2e4\uc2dc \ud655\uc778\ud55c\ub2e4.<\/li>\n\n\n\n<li>Access Token\uc774 \ub9cc\ub8cc\ub410\ub294\ub370 \uac31\uc2e0 \uba54\uc2dc\uc9c0 <code>auth:renew<\/code>\uac00 \uc624\uc9c0 \uc54a\uc740 \uc5f0\uacb0\ub3c4 \uc885\ub8cc\ud55c\ub2e4.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \uad6c\uc870\ub294 \ube60\ub978 \uc774\ubca4\ud2b8 \uc804\ub2ec\uacfc \uc8fc\uae30\uc801\uc778 \uc0c1\ud0dc \ud655\uc778\uc744 \uacb0\ud569\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Pub\/Sub\uc740 \ube60\ub978 \uc804\ud30c \uc218\ub2e8\uc774\uba70, \uc138\uc158\uc758 \ucd5c\uc885 \uc0c1\ud0dc\ub294 \ub370\uc774\ud130\ubca0\uc774\uc2a4\ub97c \uae30\uc900\uc73c\ub85c \ud310\ub2e8\ud55c\ub2e4. Redis \uce90\uc2dc\ub294 \ud3d0\uae30\ub41c \uc138\uc158\uc744 \ub2e4\uc2dc \ud65c\uc131\ud654\ud558\uc9c0 \uc54a\ub3c4\ub85d \uc870\uac74\ubd80 \uac31\uc2e0\uc744 \uc801\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Rate Limit\uacfc \uc785\ub825 \uac80\uc99d<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uc694\uccad \uc885\ub958\ubcc4\ub85c \uc18d\ub3c4 \uc81c\ud55c\uc744 \uc801\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>\uad6c\uac04<\/th><th>\uc81c\ud55c<\/th><\/tr><tr><td>API \uc804\uc5ed<\/td><td>\ubd84\ub2f9 300\uac74<\/td><\/tr><tr><td>\ub85c\uadf8\uc778<\/td><td>IP\ub2f9 \ubd84\ub2f9 30\ud68c, \uacc4\uc815\ub2f9 5\ubd84\uc5d0 10\ud68c<\/td><\/tr><tr><td>\ud68c\uc6d0\uac00\uc785<\/td><td>IP\ub2f9 \uc2dc\uac04\ub2f9 10\ud68c<\/td><\/tr><tr><td>Refresh<\/td><td>IP\ub2f9 \ubd84\ub2f9 60\ud68c<\/td><\/tr><tr><td>WebSocket \uc811\uc18d<\/td><td>IP\ub2f9 \ubd84\ub2f9 60\ud68c<\/td><\/tr><tr><td>WebSocket \uba54\uc2dc\uc9c0<\/td><td>\ucd08\ub2f9 10\uac74, \ubc84\uc2a4\ud2b8 20\uac74<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">\ucd94\uac00\ub85c \ub2e4\uc74c \ubc29\uc5b4\uc120\uc744 \uc801\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Helmet\uc744 \uc774\uc6a9\ud55c HTTP \ubcf4\uc548 \ud5e4\ub354<\/li>\n\n\n\n<li>\ud5c8\uc6a9 \ucd9c\ucc98\ub97c \uc81c\ud55c\ud558\ub294 CORS<\/li>\n\n\n\n<li>\uc694\uccad \ubcf8\ubb38 \ucd5c\ub300 16KB<\/li>\n\n\n\n<li>Zod \uae30\ubc18 \uc785\ub825 \uac80\uc99d<\/li>\n\n\n\n<li>WebSocket <code>maxPayload<\/code> 16KB<\/li>\n\n\n\n<li>\uc77c\uad00\ub41c \uc624\ub958 \uc751\ub2f5 \ud615\uc2dd<\/li>\n\n\n\n<li>\ub0b4\ubd80 \uc624\ub958 \uc0c1\uc138\uc758 \uc678\ubd80 \ub178\ucd9c \ubc29\uc9c0<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc624\ub958 \uc751\ub2f5\uc740 \ub2e4\uc74c \uad6c\uc870\ub85c \ud1b5\uc77c\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"error\": {\n    \"code\": \"INVALID_REQUEST\",\n    \"message\": \"\uc694\uccad\uc744 \ucc98\ub9ac\ud560 \uc218 \uc5c6\uc2b5\ub2c8\ub2e4.\"\n  }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc2e4\uc81c \uc624\ub958 \ucf54\ub4dc\ub294 \uc0c1\ud669\uc5d0 \ub530\ub77c \ub2ec\ub77c\uc9c0\uc9c0\ub9cc, \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ub0b4\ubd80 \uad6c\ud604\uc744 \uc54c\uc9c0 \ubabb\ud574\ub3c4 \uc624\ub958\ub97c \ubd84\ub958\ud558\uace0 \ucc98\ub9ac\ud560 \uc218 \uc788\ub3c4\ub85d \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uac8c\uc784 \uacf5\uc815\uc131 \uac80\uc99d: \ub371 \ucee4\ubc0b\uba3c\ud2b8<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ud50c\ub808\uc774\uc5b4\uac00 \uac8c\uc784 \uc885\ub8cc \ud6c4 \uc11c\ubc84\uc758 \uc154\ud50c \uacb0\uacfc\ub97c \uac80\uc99d\ud560 \uc218 \uc788\ub3c4\ub85d \ub371 \ucee4\ubc0b\uba3c\ud2b8\ub97c \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>const deck = createShuffledDeck(rng);\nconst salt = crypto.randomHex(16);\n\nconst commitment = crypto.sha256Hex(\n  `${deck.join(\",\")}:${salt}`\n);<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ud578\ub4dc \uc2dc\uc791 \uc2dc\uc5d0\ub294 \ub371 \uc790\uccb4\uac00 \uc544\ub2c8\ub77c \ud574\uc2dc\uac12\uc778 <code>deckCommitment<\/code>\ub9cc \uacf5\uac1c\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ud578\ub4dc\uac00 \uc885\ub8cc\ub418\uba74 \ub371\uacfc \uc194\ud2b8\ub97c \uacf5\uac1c\ud55c\ub2e4. \ud50c\ub808\uc774\uc5b4\ub294 \uacf5\uac1c\ub41c \uac12\uc73c\ub85c \ud574\uc2dc\ub97c \ub2e4\uc2dc \uacc4\uc0b0\ud574 \uc2dc\uc791 \uc2dc\uc810\uc758 \ucee4\ubc0b\uba3c\ud2b8\uc640 \uc77c\uce58\ud558\ub294\uc9c0 \ud655\uc778\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub97c \ud1b5\ud574 \ud578\ub4dc\uac00 \uc9c4\ud589\ub418\ub294 \ub3d9\uc548 \uc11c\ubc84\uac00 \uacf5\uac1c\ub41c \ucee4\ubc0b\uba3c\ud2b8\uc640 \ub2e4\ub978 \ub371\uc73c\ub85c \ubc14\uafb8\uc9c0 \uc54a\uc558\ub294\uc9c0 \uc0ac\ud6c4 \uac80\uc99d\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2e4\ub9cc \uc774 \ubc29\uc2dd\ub9cc\uc73c\ub85c \uc11c\ubc84\uc758 \ubaa8\ub4e0 \ubd80\uc815 \ud589\uc704\ub97c \uc99d\uba85\ud560 \uc218 \uc788\ub294 \uac83\uc740 \uc544\ub2c8\ub2e4. \ub610\ud55c \ud3f4\ub4dc\ud55c \ud50c\ub808\uc774\uc5b4\uc758 \uce74\ub4dc\uae4c\uc9c0 \uacf5\uac1c\ud558\ub294 \uc815\ucc45\uc740 \ubcc4\ub3c4\ub85c \uac80\ud1a0\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ubcf4\uc548 \uac10\uc0ac \ub85c\uadf8<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><code>SecurityEvent<\/code> \ud14c\uc774\ube14\uc5d0\ub294 \ub2e4\uc74c\uacfc \uac19\uc740 \uc774\ubca4\ud2b8\ub97c \uae30\ub85d\ud55c\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>LOGIN_SUCCESS<\/code><\/li>\n\n\n\n<li><code>LOGIN_FAILED<\/code><\/li>\n\n\n\n<li><code>ACCOUNT_LOCKED<\/code><\/li>\n\n\n\n<li><code>REFRESH_REUSE_DETECTED<\/code><\/li>\n\n\n\n<li><code>LOGOUT_ALL<\/code><\/li>\n\n\n\n<li><code>PASSWORD_CHANGED<\/code><\/li>\n\n\n\n<li><code>ACCOUNT_SUSPENDED<\/code><\/li>\n\n\n\n<li><code>WS_AUTH_REJECTED<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uac10\uc0ac \ub85c\uadf8 \uae30\ub85d\uc5d0 \uc2e4\ud328\ud558\ub354\ub77c\ub3c4 \ub85c\uadf8\uc778 \ub4f1 \uc8fc\uc694 \uc0ac\uc6a9\uc790 \ud750\ub984\uc774 \ubd88\ud544\uc694\ud558\uac8c \uc911\ub2e8\ub418\uc9c0 \uc54a\ub3c4\ub85d \ucc98\ub9ac\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2e8, \ubcf4\uc548 \uc0ac\uace0 \uc870\uc0ac\uc5d0 \ud544\uc218\uc801\uc778 \uc774\ubca4\ud2b8\ub294 \ub2e8\uc21c\ud788 \uc624\ub958\ub97c \ubb34\uc2dc\ud558\ub294 \uc815\ucc45\ub9cc\uc73c\ub85c \ucda9\ubd84\ud558\uc9c0 \uc54a\uc744 \uc218 \uc788\ub2e4. \uc6b4\uc601 \ud658\uacbd\uc5d0\uc11c\ub294 \uc774\ubca4\ud2b8 \uc190\uc2e4 \ud5c8\uc6a9 \ubc94\uc704\uc640 \ubcc4\ub3c4 \uc601\uc18d \ud050 \uc0ac\uc6a9 \uc5ec\ubd80\ub97c \uba85\ud655\ud788 \uacb0\uc815\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">React Native \ubaa8\ubc14\uc77c \ud074\ub77c\uc774\uc5b8\ud2b8<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">\ub514\ub809\ud130\ub9ac \uad6c\uc870<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ubaa8\ubc14\uc77c \uc571\uc740 Expo\uc640 React Native\ub97c \uae30\ubc18\uc73c\ub85c \uad6c\uc131\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>app\/\n  login\n  lobby\n  table\/&#91;tableId]\n\nfeatures\/\n  auth\/\n    AuthProvider\n    RequireAuth\n\n  lobby\/\n    useLobby\n\n  poker\/\n    usePokerTable\n    components\n\ninfrastructure\/\n  colyseus\/\n    gameClient\n    nativeWebSocket\n\n  http\/\n    apiClient\n\n  secure-storage\/\n    tokenStore\n\nshared\/\n  config\n  ids\n  ui<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc11c\ubc84\uc758 <code>@poker\/contracts<\/code> \ud328\ud0a4\uc9c0\ub97c \uadf8\ub300\ub85c \uc0ac\uc6a9\ud574 \uba54\uc2dc\uc9c0 \uc774\ub984\uacfc DTO\uac00 \uc11c\ubc84\u00b7\ud074\ub77c\uc774\uc5b8\ud2b8 \uc0ac\uc774\uc5d0\uc11c \uc77c\uce58\ud558\ub3c4\ub85d \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uac8c\uc784 \ud654\uba74\uc740 <code>usePokerTable<\/code> \ud6c5\uc744 \ud1b5\ud574 \uc5f0\uacb0 \uc0c1\ud0dc\uc640 \uac8c\uc784 \uc774\ubca4\ud2b8\ub97c \uad00\ub9ac\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ud1a0\ud070 \uc800\uc7a5 \uc815\ucc45<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Refresh Token: <code>expo-secure-store<\/code>\ub97c \ud1b5\ud574 OS \ubcf4\uc548 \uc800\uc7a5\uc18c\uc5d0 \uc800\uc7a5<\/li>\n\n\n\n<li>Access Token: \uba54\ubaa8\ub9ac \ubcc0\uc218\uc5d0\ub9cc \uc800\uc7a5<\/li>\n\n\n\n<li>\ub85c\uadf8\uc544\uc6c3: \ub85c\uceec \ud1a0\ud070 \uc81c\uac70\uc640 \uc11c\ubc84 \uc138\uc158 \ud3d0\uae30\ub97c \ud568\uaed8 \ucc98\ub9ac<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc778\uc99d \uc815\ubcf4\uc758 \uc218\uba85\uacfc \uc800\uc7a5 \uc704\uce58\ub97c \ubd84\ub9ac\ud574 \ub514\uc2a4\ud06c\uc5d0 \ub0a8\ub294 \ubbfc\uac10\ud55c \uc815\ubcf4\ub97c \ucd5c\uc18c\ud654\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc7ac\uc811\uc18d \ub85c\uc9c1<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uc5f0\uacb0\uc774 \ub04a\uae30\uba74 \uc885\ub8cc \ucf54\ub4dc\ub97c \ud655\uc778\ud574 \uc7ac\uc811\uc18d \uc5ec\ubd80\ub97c \ud310\ub2e8\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>room.onLeave((code) =&gt; {\n  if (TERMINAL_CLOSE_CODES.has(code)) {\n    \/\/ \uc138\uc158 \ud3d0\uae30 \ub4f1: \uc7ac\uc811\uc18d\ud558\uc9c0 \uc54a\uace0 \uc548\ub0b4\n    return;\n  }\n\n  void reconnect(room.reconnectionToken);\n});<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ube44\uc815\uc0c1 \uc885\ub8cc\uc5d0\uc11c\ub294 \uc9c0\uc218 \ubc31\uc624\ud504 \ubc29\uc2dd\uc73c\ub85c \uc7ac\uc811\uc18d\uc744 \uc2dc\ub3c4\ud55c\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uc11c\ubc84\uc758 60\ucd08 \uc720\uc608 \uc2dc\uac04 \uc548\uc5d0\uc11c \uc7ac\uc811\uc18d\uc744 \uc2dc\ub3c4\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uae30\uc874 Room\uc774 \uc0b4\uc544 \uc788\uc73c\uba74 \uc7ac\uc811\uc18d \ud1a0\ud070\uc744 \uc774\uc6a9\ud55c\ub2e4.<\/li>\n\n\n\n<li>Room\uc774 \uc0ac\ub77c\uc84c\ub2e4\uba74 \uc0c8 Room\uc5d0 \uc785\uc7a5\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uc11c\ubc84\ub294 \uc0ac\uc6a9\uc790 ID\ub97c \uae30\uc900\uc73c\ub85c \uae30\uc874 \uc88c\uc11d\uc5d0 \ub2e4\uc2dc \uc5f0\uacb0\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uc571\uc774 \ubc31\uadf8\ub77c\uc6b4\ub4dc\uc5d0\uc11c \ubcf5\uadc0\ud558\uba74 \uc18c\ucf13 \uc0c1\ud0dc\ub97c \ud655\uc778\ud55c\ub2e4.<\/li>\n\n\n\n<li>Access Token \ub9cc\ub8cc 2\ubd84 \uc804\ubd80\ud130 \uc0c8 \ud1a0\ud070\uc744 \ubc1b\uc544 <code>auth:renew<\/code>\ub85c \uc11c\ubc84\uc5d0 \uc804\ub2ec\ud55c\ub2e4.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\ubaa8\ubc14\uc77c\uc5d0\uc11c\ub294 \uc571\uc774 \ubc31\uadf8\ub77c\uc6b4\ub4dc\uc5d0 \uc788\ub294 \ub3d9\uc548 \uc5f0\uacb0\uc774 \uc870\uc6a9\ud788 \ub04a\uae38 \uc218 \uc788\uc73c\ubbc0\ub85c, \uc5f0\uacb0 \uc0c1\ud0dc\ub97c \uba85\uc2dc\uc801\uc73c\ub85c \uc810\uac80\ud558\ub294 \ub85c\uc9c1\uc774 \ud544\uc694\ud558\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">React Native WebSocket \ud5e4\ub354 \ud638\ud658\uc131<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uac1c\ubc1c \uacfc\uc815\uc5d0\uc11c React Native\uc758 WebSocket \uad6c\ud604\uacfc Colyseus \ud074\ub77c\uc774\uc5b8\ud2b8 \uc0ac\uc774\uc758 \ud638\ud658\uc131 \ubb38\uc81c\uac00 \ubc1c\uc0dd\ud588\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Node.js\uc758 WebSocket\uc740 \ub2e4\uc74c \ud615\ud0dc\ub97c \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>new WebSocket(url, { headers });<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ubc18\uba74 React Native\uc758 WebSocket\uc740 \ub2e4\uc74c \ud615\ud0dc\ub97c \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>new WebSocket(url, protocols, { headers });<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \ucc28\uc774 \ub54c\ubb38\uc5d0 <code>Authorization<\/code> \ud5e4\ub354\uac00 \uc804\ub2ec\ub418\uc9c0 \uc54a\uace0 \uc11c\ubc84\uc758 <code>onAuth<\/code>\uc5d0\uc11c <code>MISSING_TOKEN<\/code> \uc624\ub958\uac00 \ubc1c\uc0dd\ud588\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">JWT\ub97c URL\uc5d0 \ud3ec\ud568\ud558\ub294 \ubc29\uc2dd\uc73c\ub85c \uc6b0\ud68c\ud560 \uc218\ub3c4 \uc788\uc9c0\ub9cc, \uc811\uadfc \ub85c\uadf8\uc5d0 \ud1a0\ud070\uc774 \ub0a8\uc744 \uc218 \uc788\uc5b4 \uc0ac\uc6a9\ud558\uc9c0 \uc54a\uc558\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub300\uc2e0 React Native\uc758 WebSocket \uc2dc\uadf8\ub2c8\ucc98\ub97c \uc9c0\uc6d0\ud558\ub294 \uc587\uc740 \uc5b4\ub311\ud130\ub97c \uad6c\ud604\ud588\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>class HeaderAwareWebSocket extends NativeWebSocket {\n  constructor(url: string, second?: unknown) {\n    if (\n      second &amp;&amp;\n      typeof second === \"object\" &amp;&amp;\n      !Array.isArray(second)\n    ) {\n      const {\n        headers,\n        protocols,\n      } = second as {\n        headers?: Record&lt;string, string&gt;;\n        protocols?: string | string&#91;];\n      };\n\n      super(\n        url,\n        protocols,\n        headers ? { headers } : undefined\n      );\n    } else {\n      super(url, second as string | string&#91;] | undefined);\n    }\n  }\n}\n\nglobalThis.WebSocket =\n  HeaderAwareWebSocket as unknown as typeof WebSocket;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Colyseus \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ubaa8\ub4c8 \ub85c\ub4dc \uc2dc\uc810\uc5d0 \uc804\uc5ed WebSocket\uc744 \uc77d\uae30 \ub54c\ubb38\uc5d0 \uc774 \uc5b4\ub311\ud130\ub294 \ud574\ub2f9 \ud074\ub77c\uc774\uc5b8\ud2b8\ubcf4\ub2e4 \uba3c\uc800 import\ub418\uc5b4\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \ubb38\uc81c\ub294 \uc11c\ubc84 \uc778\uc99d \ub85c\uc9c1\uc774 \uc815\uc0c1\uc774\uc5b4\ub3c4 \ud50c\ub7ab\ud3fc\ubcc4 \ub124\ud2b8\uc6cc\ud06c \uad6c\ud604 \ucc28\uc774 \ub54c\ubb38\uc5d0 \uc778\uc99d\uc774 \uc2e4\ud328\ud560 \uc218 \uc788\ub2e4\ub294 \uc810\uc744 \ubcf4\uc5ec \uc900\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\uc778\ud504\ub77c\uc640 \ubc30\ud3ec<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Docker Compose \uad6c\uc131<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ub85c\uceec \ubc0f \ub2e8\uc77c \ud638\uc2a4\ud2b8 \ubc30\ud3ec \ud658\uacbd\uc740 Docker Compose\ub85c \uad6c\uc131\ud55c\ub2e4.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>\uc11c\ube44\uc2a4<\/th><th>\uc5ed\ud560<\/th><th>\ud638\uc2a4\ud2b8 \ubc14\uc778\ub529<\/th><\/tr><tr><td>MySQL<\/td><td>\uacc4\uc815, \uc9c0\uac11, \uc6d0\uc7a5, \ud578\ub4dc \uae30\ub85d<\/td><td><code>127.0.0.1:3306<\/code><\/td><\/tr><tr><td>Redis<\/td><td>\uce90\uc2dc, \uc2a4\ub0c5\uc0f7, \ubd84\uc0b0 \ub77d<\/td><td><code>127.0.0.1:6380<\/code><\/td><\/tr><tr><td>Migration<\/td><td>Prisma \ub9c8\uc774\uadf8\ub808\uc774\uc158\uacfc \ucd08\uae30 \ub370\uc774\ud130<\/td><td>\uc77c\ud68c\uc131 \uc2e4\ud589<\/td><\/tr><tr><td>API<\/td><td>Fastify REST API<\/td><td><code>127.0.0.1:3000<\/code><\/td><\/tr><tr><td>Game<\/td><td>Colyseus \uac8c\uc784 \uc11c\ubc84 \ub450 \uac1c<\/td><td>\ub0b4\ubd80 \ub124\ud2b8\uc6cc\ud06c<\/td><\/tr><tr><td>Proxy<\/td><td>Colyseus \ud504\ub85d\uc2dc<\/td><td><code>127.0.0.1:2567<\/code><\/td><\/tr><tr><td>Nginx Proxy Manager<\/td><td>HTTPS \ubc0f \uc678\ubd80 \uc694\uccad \ub77c\uc6b0\ud305<\/td><td>80, 443 \ubc0f \uad00\ub9ac \ud3ec\ud2b8<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">MySQL\uc740 <code>mysql:8.0<\/code>, Redis\ub294 <code>redis:7-alpine<\/code>\uc744 \uc0ac\uc6a9\ud55c\ub2e4. Redis\ub294 AOF\ub97c \ud65c\uc131\ud654\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uac8c\uc784 \uc11c\ubc84\ub97c \uc5ec\ub7ec \uac1c \uc2e4\ud589\ud558\uace0 Redis Presence\uc640 Driver\ub97c \uc774\uc6a9\ud574 \ubc29 \ubaa9\ub85d\uacfc \ud504\ub85c\uc138\uc2a4 \uac04 \ud1b5\uc2e0\uc744 \uacf5\uc720\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ud638\uc2a4\ud2b8\uc758 \ub85c\uceec Redis\uac00 \uae30\ubcf8 \ud3ec\ud2b8\ub97c \uc0ac\uc6a9\ud558\uace0 \uc788\ub294 \ud658\uacbd\uc5d0\uc11c\ub294 \ucee8\ud14c\uc774\ub108\uc758 \ud638\uc2a4\ud2b8 \ud3ec\ud2b8\ub97c 6380\uc73c\ub85c \uc124\uc815\ud574 \ucda9\ub3cc\uc744 \ud53c\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">SSL \uc885\ub2e8\uacfc \ud504\ub85d\uc2dc \uc124\uc815<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Nginx Proxy Manager\ub294 Let&#8217;s Encrypt\uc758 HTTP-01 \uac80\uc99d\uc744 \ud1b5\ud574 \uc778\uc99d\uc11c\ub97c \ubc1c\uae09\ud558\uace0 \uc790\ub3d9 \uac31\uc2e0\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub3d9\uc77c\ud55c \ub3c4\uba54\uc778\uc73c\ub85c REST API\uc640 WebSocket\uc744 \ubaa8\ub450 \uc81c\uacf5\ud558\uae30 \uc704\ud574 Custom Nginx \uc124\uc815\uc744 \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>\/api\/<\/code> \uacbd\ub85c\ub294 \uc811\ub450\uc0ac\ub97c \uc81c\uac70\ud55c \ub4a4 Fastify\ub85c \uc804\ub2ec\ud55c\ub2e4.<\/li>\n\n\n\n<li>\ub098\uba38\uc9c0 \uacbd\ub85c\ub294 WebSocket \uc5c5\uadf8\ub808\uc774\ub4dc\ub97c \ud5c8\uc6a9\ud574 Colyseus \ud504\ub85d\uc2dc\ub85c \uc804\ub2ec\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uc2e4\uc81c \uc811\uc18d IP\ub294 \ud504\ub85d\uc2dc\uac00 \ud655\uc778\ud55c \uc8fc\uc18c\ub85c \uc804\ub2ec\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uac8c\uc784 \uc11c\ubc84\uac00 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0 \uc54c\ub824 \uc8fc\ub294 \uacf5\uac1c \uc8fc\uc18c\ub294 <code>PUBLIC_ADDRESS<\/code>\ub85c \uad00\ub9ac\ud55c\ub2e4.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">HTTPS\uc640 WSS\ub97c \ub3d9\uc77c\ud55c \ub3c4\uba54\uc778\uc73c\ub85c \ud1b5\ud569\ud558\uba74 \ubaa8\ubc14\uc77c \ud074\ub77c\uc774\uc5b8\ud2b8\uc758 \ub124\ud2b8\uc6cc\ud06c \uc124\uc815\uc744 \ub2e8\uc21c\ud558\uac8c \uc720\uc9c0\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Kubernetes\uc640 \uc790\ub3d9 \ud655\uc7a5<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uac01 \uac8c\uc784 \uc11c\ubc84\ub294 \ud504\ub85c\uc138\uc2a4 \ub2e8\uc704 \uc9c0\ud45c\ub97c <code>\/metrics<\/code>\uc5d0\uc11c \ub178\ucd9c\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>poker_game_connected_clients\n    \ud504\ub85c\uc138\uc2a4\uc5d0 \uc811\uc18d \uc911\uc778 \ud074\ub77c\uc774\uc5b8\ud2b8 \uc218\n\npoker_game_rooms\n    \ud504\ub85c\uc138\uc2a4\uc758 \uc804\uccb4 Room \uc218\n\npoker_game_table_rooms\n    \ud504\ub85c\uc138\uc2a4\uc758 \ud3ec\ucee4 \ud14c\uc774\ube14 Room \uc218\n\npoker_game_draining\n    \uc885\ub8cc \uc900\ube44 \uc0c1\ud0dc \uc5ec\ubd80<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">HPA\ub294 <code>poker_game_connected_clients<\/code>\ub97c \uae30\uc900\uc73c\ub85c Pod \uc218\ub97c \uc870\uc808\ud558\ub3c4\ub85d \uad6c\uc131\ud588\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Pod\ub2f9 \ud3c9\uade0 \uc811\uc18d\uc790 300\uba85\uc744 \ubaa9\ud45c\ub85c \uc124\uc815<\/li>\n\n\n\n<li>\ucd5c\uc18c 2\uac1c, \ucd5c\ub300 10\uac1c Pod<\/li>\n\n\n\n<li>\ud655\uc7a5\uc740 1\ubd84\uc5d0 \ucd5c\ub300 2\uac1c<\/li>\n\n\n\n<li>\ucd95\uc18c\ub294 15\ubd84 \uc548\uc815\ud654 \uc774\ud6c4 10\ubd84\uc5d0 1\uac1c\uc529 \uc9c4\ud589<\/li>\n\n\n\n<li><code>terminationGracePeriodSeconds: 120<\/code>\uc73c\ub85c \uc885\ub8cc \uc720\uc608 \uc2dc\uac04 \ud655\ubcf4<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc811\uc18d\uc790 \uc218\uac00 \uc7a0\uae50 \ubcc0\ud560 \ub54c\ub9c8\ub2e4 Pod\uac00 \ubc18\ubcf5\uc801\uc73c\ub85c \uc0dd\uc131\u00b7\uc0ad\uc81c\ub418\uba74 Room \ubcf5\uad6c\uc640 \uc5f0\uacb0 \uc774\uc804 \ube44\uc6a9\uc774 \ucee4\uc9c4\ub2e4. \ub530\ub77c\uc11c \ud655\uc7a5\uc740 \ube44\uad50\uc801 \ube60\ub974\uac8c, \ucd95\uc18c\ub294 \ubcf4\uc218\uc801\uc73c\ub85c \uc218\ud589\ud558\ub3c4\ub85d \uc124\uc815\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\uc911\uc694\ud55c \uc81c\ud55c \uc0ac\ud56d:<\/strong> \uc811\uc18d\uc790 300\uba85\uc774\ub77c\ub294 \uac12\uc740 \uc2e4\uc81c \ubd80\ud558 \uce21\uc815 \uacb0\uacfc\uac00 \uc544\ub2cc \uc784\uc2dc \uc124\uc815\uc774\ub2e4. \ub610\ud55c HPA\uac00 Prometheus \uae30\ubc18 \uc0ac\uc6a9\uc790 \uc815\uc758 \uc9c0\ud45c\ub97c \uc77d\uc73c\ub824\uba74 Prometheus\uc640 <code>prometheus-adapter<\/code> \ub4f1\uc758 \uad6c\uc131\uc774 \ud544\uc694\ud558\ub2e4. \ud574\ub2f9 Kubernetes \ub9e4\ub2c8\ud398\uc2a4\ud2b8\ub294 \uc791\uc131\ud588\uc9c0\ub9cc \uc2e4\uc81c \ud074\ub7ec\uc2a4\ud130\uc5d0 \uc801\uc6a9\ud574 \uac80\uc99d\ud558\uc9c0 \uc54a\uc558\ub2e4.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\uac1c\ubc1c \ubc29\ubc95\uacfc \ud14c\uc2a4\ud2b8 \uc804\ub7b5<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">\uc548\ucabd\uc5d0\uc11c \ubc14\uae65\ucabd\uc73c\ub85c \uac1c\ubc1c<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uac1c\ubc1c \uc21c\uc11c\ub294 \ub3c4\uba54\uc778\ubd80\ud130 \uc778\ud504\ub77c\uc640 \ud074\ub77c\uc774\uc5b8\ud2b8 \ubc29\ud5a5\uc73c\ub85c \uc9c4\ud589\ud55c\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Domain: \uce74\ub4dc, \uc871\ubcf4, \ud31f \uacc4\uc0b0, \ud578\ub4dc \uaddc\uce59\uc744 \uad6c\ud604\ud558\uace0 \ud14c\uc2a4\ud2b8\ub85c \uace0\uc815\ud55c\ub2e4.<\/li>\n\n\n\n<li>Application: \ud3ec\ud2b8\uc640 \uc720\uc2a4\ucf00\uc774\uc2a4\ub97c \uc815\uc758\ud558\uace0 \uba54\ubaa8\ub9ac \uc5b4\ub311\ud130\ub85c \uac80\uc99d\ud55c\ub2e4.<\/li>\n\n\n\n<li>Infrastructure: Prisma\uc640 Redis \uc5b4\ub311\ud130\ub97c \uad6c\ud604\ud558\uace0 \uc2e4\uc81c \ub370\uc774\ud130\ubca0\uc774\uc2a4\ub85c \ud1b5\ud569 \ud14c\uc2a4\ud2b8\ud55c\ub2e4.<\/li>\n\n\n\n<li>Apps: Fastify \ub77c\uc6b0\ud2b8\uc640 Colyseus Room\uc744 \uc5f0\uacb0\ud55c\ub2e4.<\/li>\n\n\n\n<li>Mobile: \uacf5\uc720 \uacc4\uc57d\uc744 \uc0ac\uc6a9\ud574 \ud654\uba74\uacfc \ub124\ud2b8\uc6cc\ud06c \ub85c\uc9c1\uc744 \uad6c\ud604\ud55c\ub2e4.<\/li>\n\n\n\n<li>Deployment: Docker Compose\ub85c \uc804\uccb4 \uc2a4\ud0dd\uc744 \uc2e4\ud589\ud558\uace0 \uc885\ub2e8 \uac04 \ud14c\uc2a4\ud2b8\ub97c \uc218\ud589\ud55c\ub2e4.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub807\uac8c \uac1c\ubc1c\ud558\uba74 \uc678\ubd80 \uc2dc\uc2a4\ud15c\uc744 \ucd94\uac00\ud558\ub354\ub77c\ub3c4 \ub3c4\uba54\uc778 \uaddc\uce59\uc774 \ubd88\ud544\uc694\ud558\uac8c \ud754\ub4e4\ub9ac\uc9c0 \uc54a\ub294\ub2e4. \uc778\ud504\ub77c\uc5d0\uc11c \ubc1c\uacac\ud55c \uc624\ub958\ub3c4 \ub0b4\ubd80 \uacc4\uce35\uc758 \ud14c\uc2a4\ud2b8\ub85c \uc7ac\ud604\ud558\uace0 \uc218\uc815\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ud14c\uc2a4\ud2b8 \uad6c\uc131<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>\ud14c\uc2a4\ud2b8 \uc885\ub958<\/th><th>\uac80\uc99d \ub300\uc0c1<\/th><\/tr><tr><td>\ub3c4\uba54\uc778 \ub2e8\uc704 \ud14c\uc2a4\ud2b8<\/td><td>\uc871\ubcf4 \ud3c9\uac00, \uc0ac\uc774\ub4dc \ud31f, \ud640\ub364 \uc9c4\ud589<\/td><\/tr><tr><td>\ud37c\uc9d5 \ud14c\uc2a4\ud2b8<\/td><td>\ubb34\uc791\uc704 3,000\uac1c \ud578\ub4dc\uc5d0\uc11c \uce69 \ubcf4\uc874<\/td><\/tr><tr><td>\uc560\ud50c\ub9ac\ucf00\uc774\uc158 \ud14c\uc2a4\ud2b8<\/td><td>TableSession, \uc778\uc99d, \uc815\uc0b0 \uc7ac\uc2dc\ub3c4<\/td><\/tr><tr><td>API \ud14c\uc2a4\ud2b8<\/td><td>Fastify \uc778\uc99d \uc5d4\ub4dc\ud3ec\uc778\ud2b8<\/td><\/tr><tr><td>Room E2E<\/td><td>\uc2e4\uc81c Colyseus \uc11c\ubc84, \uc778\uc99d, \uba54\uc2dc\uc9c0, \ud640\uce74\ub4dc \ube44\uc720\ucd9c<\/td><\/tr><tr><td>\ud1b5\ud569 \ud14c\uc2a4\ud2b8<\/td><td>\uc2e4\uc81c MySQL\u00b7Redis \ub3d9\uc2dc\uc131, Outbox, CHECK \uc81c\uc57d<\/td><\/tr><tr><td>\uc804\uccb4 \uc2a4\ud0dd E2E<\/td><td>Docker Compose, WSS \uc5f0\uacb0, \uc11c\ubc84 \uc885\ub8cc \ubc0f \ubcf5\uad6c<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">\ub3c4\uba54\uc778 \ud14c\uc2a4\ud2b8\uc5d0\uc11c\ub294 \ud720 \uc2a4\ud2b8\ub808\uc774\ud2b8, \ub3d9\uc810, \uc5ec\ub7ec \ud50c\ub808\uc774\uc5b4\uc758 \uc62c\uc778 \ub4f1 \uacbd\uacc4 \uc870\uac74\uc744 \uac80\uc99d\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ud37c\uc9d5 \ud14c\uc2a4\ud2b8\ub294 \ubb34\uc791\uc704\ub85c \uc0dd\uc131\ud55c 3,000\uac1c \ud578\ub4dc\uc5d0\uc11c \uce69\uc758 \ud569\uc774 \ubcf4\uc874\ub418\ub294\uc9c0 \ud655\uc778\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Room E2E \ud14c\uc2a4\ud2b8\uc5d0\uc11c\ub294 \uc0c1\ub300\ubc29\uc758 \ud640\uce74\ub4dc\uac00 \ub178\ucd9c\ub418\uc9c0 \uc54a\ub294\uc9c0, \uc18d\ub3c4 \uc81c\ud55c\uc774 \uc791\ub3d9\ud558\ub294\uc9c0, <code>auth:renew<\/code>\uac00 \ucc98\ub9ac\ub418\ub294\uc9c0, \uc138\uc158 \ud3d0\uae30 \uc2dc \uc5f0\uacb0\uc774 \uc885\ub8cc\ub418\ub294\uc9c0\ub97c \uac80\uc99d\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc2e4\uc81c \uc778\ud504\ub77c\uac00 \ud544\uc694\ud55c \ud1b5\ud569 \ud14c\uc2a4\ud2b8 21\uac1c\ub294 <code>INTEGRATION=1<\/code>\ub85c \ubcc4\ub3c4 \uc2e4\ud589\ud55c\ub2e4. \uae30\ubcf8 <code>npm test<\/code>\uc5d0\uc11c\ub294 \ub098\uba38\uc9c0 88\uac1c \ud14c\uc2a4\ud2b8\ub97c \uc2e4\ud589\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uba54\ubaa8\ub9ac \uc5b4\ub311\ud130\uc758 \uc5ed\ud560<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><code>PERSISTENCE=memory<\/code>\ub97c \uc124\uc815\ud558\uba74 MySQL\uacfc Redis \uc5c6\uc774\ub3c4 <code>npm run dev:all<\/code> \uba85\ub839\uc73c\ub85c API\uc640 \uac8c\uc784 \uc11c\ubc84\ub97c \uc2e4\ud589\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \ubc29\uc2dd\uc740 \uac1c\ubc1c\uacfc \ub2e8\uc704 \ud14c\uc2a4\ud2b8 \uc18d\ub3c4\ub97c \ub192\uc5ec \uc900\ub2e4. \uadf8\ub7ec\ub098 \uba54\ubaa8\ub9ac \uad6c\ud604\uc740 \uc2e4\uc81c SQL \ud2b8\ub79c\uc7ad\uc158\uacfc \ud589 \uc7a0\uae08, \uc5ec\ub7ec \uc694\uccad \uac04\uc758 \ub3d9\uc2dc\uc131 \ubb38\uc81c\ub97c \uc644\ubcbd\ud558\uac8c \uc7ac\ud604\ud558\uc9c0 \ubabb\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub530\ub77c\uc11c \ube60\ub978 \uac1c\ubc1c\uc744 \uc704\ud574 \uba54\ubaa8\ub9ac \uc5b4\ub311\ud130\ub97c \uc0ac\uc6a9\ud558\ub418, \uc911\uc694\ud55c \ub3d9\uc2dc\uc131 \ub3d9\uc791\uc740 \uc2e4\uc81c MySQL\uacfc Redis\ub97c \uc774\uc6a9\ud55c \ud1b5\ud569 \ud14c\uc2a4\ud2b8\ub85c \uac80\uc99d\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc2e4\uc81c \uc778\ud504\ub77c\uc5d0\uc11c \ubc1c\uacac\ud55c \ubb38\uc81c<\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>\uc99d\uc0c1<\/th><th>\uc6d0\uc778<\/th><th>\ud574\uacb0<\/th><\/tr><tr><td>\uc9c0\uac11 \ub3d9\uc2dc \uc694\uccad\uc5d0\uc11c \uc720\ub2c8\ud06c \uc81c\uc57d \uc704\ubc18<\/td><td>\uc911\ubcf5 \uc694\uccad\uc774 \ub3d9\uc2dc\uc5d0 \ucc98\ub9ac\ub418\ub294 \uad6c\uac04<\/td><td>\uc9c0\uac11 \ud589 \uc7a0\uae08, \uc7a0\uae08 \uc21c\uc11c \ud1b5\uc77c, \uba71\ub4f1 \ud0a4 \ud655\uc778<\/td><\/tr><tr><td>\uc11c\ubc84 \uc885\ub8cc \ud6c4 \ud14c\uc774\ube14 \ubcf5\uad6c \uc2e4\ud328<\/td><td>\uc8fd\uc740 \ud504\ub85c\uc138\uc2a4\uc758 Room\uc774 \ub4dc\ub77c\uc774\ubc84\uc5d0 \ub0a8\uc74c<\/td><td>\ud504\ub85c\ube44\uc800\ub108\uc758 \uc18c\uc720\uad8c \ud310\ub2e8 \uac1c\uc120<\/td><\/tr><tr><td>\ubc30\ud3ec\ud560 \ub54c \uc88c\uc11d \ud574\uc81c<\/td><td>\uc885\ub8cc \ucf54\ub4dc\uac00 \uc790\ubc1c\uc801 \ud1f4\uc7a5\uc73c\ub85c \ud574\uc11d\ub428<\/td><td>\uc11c\ubc84 \uc885\ub8cc \uc804\uc6a9 \ucf54\ub4dc \uc0ac\uc6a9<\/td><\/tr><tr><td>JWT\uac00 \ud504\ub85d\uc2dc \ub85c\uadf8\uc5d0 \ub0a8\uc744 \uc704\ud5d8<\/td><td>URL\uc744 \ud1b5\ud55c \ud1a0\ud070 \uc804\ub2ec<\/td><td>\uc778\uc99d \ud5e4\ub354 \uc0ac\uc6a9<\/td><\/tr><tr><td>\uc8fd\uc740 \ub178\ub4dc\ub85c \uc694\uccad\uc774 \uc804\ub2ec\ub418\uc5b4 \uc751\ub2f5 \uc9c0\uc5f0<\/td><td>Colyseus \ud504\ub85d\uc2dc\uc758 \ub3d9\uc791<\/td><td>\ud074\ub77c\uc774\uc5b8\ud2b8 \ud0c0\uc784\uc544\uc6c3\uacfc \uc7ac\uc2dc\ub3c4 \uc801\uc6a9<\/td><\/tr><tr><td>\ubaa8\ubc14\uc77c\uc5d0\uc11c <code>MISSING_TOKEN<\/code> \ubc1c\uc0dd<\/td><td>React Native WebSocket\uc774 \ud5e4\ub354\ub97c \ubb34\uc2dc<\/td><td>WebSocket \uc5b4\ub311\ud130 \uad6c\ud604<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub7ec\ud55c \ubb38\uc81c\ub294 \ub2e8\uc704 \ud14c\uc2a4\ud2b8\ub9cc\uc73c\ub85c\ub294 \ubc1c\uacac\ud558\uae30 \uc5b4\ub824\uc6e0\ub2e4. \uc2e4\uc81c MySQL, Redis, Docker, \ud504\ub85d\uc2dc, \ubaa8\ubc14\uc77c \ud658\uacbd\uc744 \ud568\uaed8 \uc2e4\ud589\ud588\uc744 \ub54c \ube44\ub85c\uc18c \ub4dc\ub7ec\ub0ac\ub2e4.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>https:\/\/wayhope.kro.kr\/gitlab\/wayhope\/pokermultiplayer.git TypeScript \ubaa8\ub178\ub808\ud3ec\ub97c \uae30\ubc18\uc73c\ub85c REST API, \uc2e4\uc2dc\uac04 \uac8c\uc784 \uc11c\ubc84, \ubaa8\ubc14\uc77c \ud074\ub77c\uc774\uc5b8\ud2b8, \uc778\ud504\ub77c\uae4c\uc9c0 \uad6c\ucd95\ud558\ub294 \uacfc\uc815\uc744 \uc815\ub9ac\ud55c\ub2e4. \ub2e8\uc21c\ud788 \uc2e4\ud589\ub418\ub294 \ud3ec\ucee4 \uac8c\uc784\uc744 \ub9cc\ub4dc\ub294 \uac83\uc774 \ubaa9\ud45c\uac00 \uc544\ub2c8\ub2e4. \uce69\uc774 \uc624\uac00\ub294 \uc2e4\uc2dc\uac04 \uc2dc\uc2a4\ud15c\uc5d0\uc11c \ubc18\ub4dc\uc2dc \uc9c0\ucf1c\uc57c \ud558\ub294 \ub370\uc774\ud130 \uc815\ud569\uc131, \ubcf4\uc548, \ub3d9\uc2dc\uc131 \uc81c\uc5b4, \uc7a5\uc560 \ubcf5\uad6c, \uc6b4\uc601 \uc548\uc815\uc131\uc5d0 \ucd08\uc810\uc744 \ub9de\ucd98\ub2e4. \ub4e4\uc5b4\uac00\uba70 \ud3ec\ucee4 \uac8c\uc784\uc740 \uac89\ubcf4\uae30\uc5d0\ub294 \ub2e8\uc21c\ud558\ub2e4. \uce74\ub4dc\ub97c \uc11e\uace0, \ud50c\ub808\uc774\uc5b4\uc5d0\uac8c \ub098\ub220 \uc8fc\uace0, \ubca0\ud305\ud558\uace0, \uc2b9\uc790\uac00 \ud31f\uc744 \uac00\uc838\uac04\ub2e4. [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-2747","post","type-post","status-publish","format-standard","hentry","category-dev-logs"],"_links":{"self":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts\/2747","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2747"}],"version-history":[{"count":3,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts\/2747\/revisions"}],"predecessor-version":[{"id":2763,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts\/2747\/revisions\/2763"}],"wp:attachment":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2747"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=2747"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=2747"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}