@bstage-sdk/ai-toolkit 0.14.0 → 0.14.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +7 -7
- package/dist/index.cjs +159 -146
- package/dist/index.d.cts +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +159 -146
- package/package.json +2 -2
package/dist/index.js
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
// src/version.ts
|
|
2
|
-
var VERSION = "0.14.
|
|
2
|
+
var VERSION = "0.14.2";
|
|
3
3
|
|
|
4
4
|
// src/skills/deploy.ts
|
|
5
5
|
function deploySkillMd() {
|
|
6
6
|
return `---
|
|
7
7
|
name: bstage-deploy
|
|
8
|
-
description: b.stage kit \uCF58\uC194\
|
|
8
|
+
description: b.stage kit \uCF58\uC194\uC5D0\uC11C \uBE4C\uB4DC\uD574 \uD398\uC774\uC9C0\uB97C \uC5C5\uB370\uC774\uD2B8\uD558\uACE0 \uB864\uBC31\xB7\uAC8C\uC2DC\xB7\uBE4C\uB4DC \uB85C\uADF8\uB97C \uB2E4\uB8EC\uB2E4. "\uBC30\uD3EC\uD574\uC918", "\uC62C\uB824\uC918", "\uB864\uBC31", "\uAC8C\uC2DC \uAEBC", "\uBE4C\uB4DC \uC2E4\uD328 \uB85C\uADF8 \uBD10\uC918" \uAC19\uC740 \uC694\uCCAD\uC744 \uBC1B\uC744 \uB54C \uC0AC\uC6A9\uD55C\uB2E4.
|
|
9
9
|
---
|
|
10
10
|
|
|
11
11
|
# \uC5ED\uD560
|
|
@@ -14,11 +14,11 @@ description: b.stage kit \uCF58\uC194\uB85C \uBC30\uD3EC\uD558\uACE0 \uB864\uBC3
|
|
|
14
14
|
|
|
15
15
|
# \uC804\uC81C (\uC5EC\uAE30\uC11C \uC5B4\uAE0B\uB098\uBA74 \uB098\uBA38\uC9C0\uB294 \uC758\uBBF8\uAC00 \uC5C6\uB2E4)
|
|
16
16
|
|
|
17
|
-
- **\uCF58\uC194\uC740 \uC6D0\uACA9 \uC800\uC7A5\uC18C \uAE30\uBCF8 \uBE0C\uB79C\uCE58\uC758 push\uB41C \uCEE4\uBC0B\uC744 \uBE4C\uB4DC\uD55C\uB2E4.** \uB85C\uCEEC \`dist/\`\uB97C \uC5C5\uB85C\uB4DC\uD558\uB294 \uAC83\uC774 \uC544\uB2C8\uB2E4. \uB85C\uCEEC\uC5D0\uB9CC \uC788\uB294 \uBCC0\uACBD\uC740 \uC808\uB300 \
|
|
18
|
-
- \`bstage build\`\uB294 **\uB85C\uCEEC \uD655\uC778\uC6A9**\uC774\uB2E4. \
|
|
19
|
-
- **\uB808\uD3EC \uC5F0\uACB0\uC740 \uCF58\uC194 \uD654\uBA74\uC5D0\uC11C\uB9CC** \uD560 \uC218 \uC788\uB2E4. \uD398\uC774\uC9C0
|
|
17
|
+
- **\uCF58\uC194\uC740 \uC6D0\uACA9 \uC800\uC7A5\uC18C \uAE30\uBCF8 \uBE0C\uB79C\uCE58\uC758 push\uB41C \uCEE4\uBC0B\uC744 \uBE4C\uB4DC\uD55C\uB2E4.** \uB85C\uCEEC \`dist/\`\uB97C \uC5C5\uB85C\uB4DC\uD558\uB294 \uAC83\uC774 \uC544\uB2C8\uB2E4. \uB85C\uCEEC\uC5D0\uB9CC \uC788\uB294 \uBCC0\uACBD\uC740 \uC808\uB300 \uBE4C\uB4DC\uC5D0 \uB4E4\uC5B4\uAC00\uC9C0 \uC54A\uB294\uB2E4.
|
|
18
|
+
- \`bstage build\`\uB294 **\uB85C\uCEEC \uD655\uC778\uC6A9**\uC774\uB2E4. \uAC8C\uC2DC\uB418\uB294 \uBE4C\uB4DC\uB294 \uCF58\uC194\uC774 \uB2E4\uC2DC \uB9CC\uB4E0\uB2E4.
|
|
19
|
+
- **\uB808\uD3EC \uC5F0\uACB0\uC740 \uCF58\uC194 \uD654\uBA74\uC5D0\uC11C\uB9CC** \uD560 \uC218 \uC788\uB2E4. \uD398\uC774\uC9C0\uB294 \`bstage placement create\`\uB85C \uB9CC\uB4E0\uB2E4(deploy \uB4F1\uAE09 \uD1A0\uD070). \uC704\uC82F(\uC2AC\uB86F) \uB9CC\uB4E4\uAE30\uC640 \uD398\uC774\uC9C0\xB7\uC704\uC82F \uC0AD\uC81C\uB294 \uCF58\uC194 \uD654\uBA74 \uC804\uC6A9\uC774\uB2E4.
|
|
20
20
|
- \uCF58\uC194\uC740 **\uB808\uD3EC\uB97C \uC5F0\uACB0\uD574\uB3C4 \uC2A4\uC2A4\uB85C \uBE4C\uB4DC\uD558\uC9C0 \uC54A\uB294\uB2E4.** \uCCAB \uBE4C\uB4DC\uB294 \`bstage placement create\`\uAC00(\uC131\uACF5\uD55C \uBE4C\uB4DC\uAC00 \uC5C6\uC73C\uBA74) \uB610\uB294 \`bstage deploy\`\uAC00 \uAC74\uB2E4.
|
|
21
|
-
- \
|
|
21
|
+
- \uC5C5\uB370\uC774\uD2B8\uB294 \uC5EC\uB7EC \uC0AC\uB78C\uC774 \uAC19\uC740 \uC2A4\uD14C\uC774\uC9C0\uB97C \uAC74\uB4DC\uB9B0\uB2E4. \uC5C5\uB370\uC774\uD2B8 \uC9C1\uC804 \uC0C1\uD0DC\uB97C \uD655\uC778\uD558\uACE0, \uC911\uAC04\uC5D0 \uBC14\uB00C\uC5C8\uC73C\uBA74 \uBA48\uCD98\uB2E4.
|
|
22
22
|
|
|
23
23
|
# \uC808\uCC28
|
|
24
24
|
|
|
@@ -30,73 +30,73 @@ bstage list
|
|
|
30
30
|
\`\`\`
|
|
31
31
|
|
|
32
32
|
- \`whoami\` \u2014 \uC5B4\uB290 \uC870\uC9C1\xB7\uC2A4\uD14C\uC774\uC9C0\uC5D0 \uC5B4\uB5A4 \uC5ED\uD560\uB85C \uB85C\uADF8\uC778\uB3FC \uC788\uB294\uC9C0. \uC778\uC99D\uC774 \uC5C6\uC73C\uBA74 \`bstage login\`.
|
|
33
|
-
- \`list\` \u2014 \uC774 \uB808\uD3EC\uC758 \
|
|
33
|
+
- \`list\` \u2014 \uC774 \uB808\uD3EC\uC758 \uD398\uC774\uC9C0\xB7\uC704\uC82F(\uB77C\uC774\uBE0C \uBC84\uC804\xB7\uAC8C\uC2DC \uC0C1\uD0DC)\uACFC \uCD5C\uADFC \uBE4C\uB4DC.
|
|
34
34
|
- \uB450 \uBA85\uB839 \uBAA8\uB450 \uAD6C\uC870\uD654 \uCD9C\uB825\uC744 \uC9C0\uC6D0\uD55C\uB2E4(\`--json\`, \uBA85\uB839\uBCC4 \`--help\` \uD655\uC778) \u2014 \uAC12\uC744 \uD504\uB85C\uADF8\uB7A8\uC73C\uB85C \uC77D\uC5B4\uC57C \uD560 \uB54C \uC4F4\uB2E4.
|
|
35
35
|
|
|
36
36
|
## 2. \uAC08\uB798
|
|
37
37
|
|
|
38
|
-
### 2a. \`bstage list\`\uC5D0 \
|
|
38
|
+
### 2a. \`bstage list\`\uC5D0 \uD398\uC774\uC9C0\uAC00 0\uAC74\uC77C \uB54C
|
|
39
39
|
|
|
40
|
-
\
|
|
40
|
+
\uC5C5\uB370\uC774\uD2B8\uD560 \uC790\uB9AC\uAC00 \uC5C6\uB2E4\uB294 \uB73B\uC774\uB2E4(\`bstage deploy\`\uB294 \uC774 \uC0C1\uD0DC\uC5D0\uC11C \uBE4C\uB4DC\uB3C4 \uD558\uC9C0 \uC54A\uACE0 \uC885\uB8CC \uCF54\uB4DC 2\uB85C \uBA48\uCD98\uB2E4). \uD398\uC774\uC9C0\uB97C CLI\uB85C \uB9CC\uB4E0\uB2E4.
|
|
41
41
|
|
|
42
42
|
\`\`\`bash
|
|
43
|
-
bstage placement create --template <\
|
|
43
|
+
bstage placement create --template <\uD15C\uD50C\uB9BF \uC774\uB984> --path /<\uACBD\uB85C>
|
|
44
44
|
\`\`\`
|
|
45
45
|
|
|
46
|
-
- \`--template\`\uC740 \uBE4C\uB4DC \
|
|
46
|
+
- \`--template\`\uC740 \uBE4C\uB4DC\uC5D0 \uB4E4\uC5B4\uAC04 \uD15C\uD50C\uB9BF \uC774\uB984\uC774\uB2E4 \u2014 sdk\uB294 \`src/pages/{\uC774\uB984}\`, liquid\uB294 \`public/{user|admin}/{\uC774\uB984}\`\uC758 \`{\uC774\uB984}\`. \uBAA8\uB974\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD655\uC778\uD55C\uB2E4.
|
|
47
47
|
- \`--path\`\uB97C \uC0DD\uB7B5\uD558\uBA74 \`/{\uC774\uB984}\`\uC774 \uB41C\uB2E4. \uACBD\uB85C\uB294 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD655\uC778\uD55C\uB2E4(\uB77C\uC774\uBE0C URL\uC774 \uB41C\uB2E4).
|
|
48
|
-
- \uC870\uC9C1\xB7\uC2A4\uD14C\uC774\uC9C0\xB7\uB808\uD3EC\
|
|
49
|
-
- \uC131\uACF5\uD55C \uBE4C\uB4DC\uC5D0 \uADF8 \
|
|
50
|
-
- \uAC19\uC740 \uACBD\uB85C\uC5D0 \uC774 \uB808\uD3EC\xB7\uAC19\uC740 \
|
|
51
|
-
- \uB9CC\uB4E0 \
|
|
48
|
+
- \uC870\uC9C1\xB7\uC2A4\uD14C\uC774\uC9C0\xB7\uB808\uD3EC\xB7\uB300\uC0C1 \uD654\uBA74(\uC0AC\uC6A9\uC790 \uD654\uBA74/\uC6B4\uC601\uC790 \uD654\uBA74)\uC740 \`bstage link\`\uB85C \uB9CC\uB4E0 \uC5F0\uACB0 \uC815\uBCF4\uB97C \uADF8\uB300\uB85C \uC4F4\uB2E4.
|
|
49
|
+
- \uC131\uACF5\uD55C \uBE4C\uB4DC\uC5D0 \uADF8 \uD15C\uD50C\uB9BF\uC774 \uC5C6\uC73C\uBA74(\uCCAB \uBE4C\uB4DC \uC804, \uC0C8 \uD398\uC774\uC9C0\uB97C \uB9C9 push) **push\uB41C \uAE30\uBCF8 \uBE0C\uB79C\uCE58 HEAD\uB85C \uBE4C\uB4DC\uBD80\uD130 \uD558\uACE0** \uB05D\uB098\uBA74 \uD398\uC774\uC9C0\uB97C \uB9CC\uB4E0\uB2E4 \u2014 \uADF8\uB798\uC11C \uCEE4\uBC0B\xB7push\uAC00 \uBA3C\uC800\uB2E4.
|
|
50
|
+
- \uAC19\uC740 \uACBD\uB85C\uC5D0 \uC774 \uB808\uD3EC\xB7\uAC19\uC740 \uD15C\uD50C\uB9BF\uC758 \uD398\uC774\uC9C0\uAC00 \uC774\uBBF8 \uC788\uC73C\uBA74 \uC0C8\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uACE0 \uC131\uACF5\uC73C\uB85C \uB05D\uB09C\uB2E4(\uB2E4\uC2DC \uC2E4\uD589\uD574\uB3C4 \uC548\uC804). \uAC19\uC740 \uACBD\uB85C\uB97C \uB2E4\uB978 \uD398\uC774\uC9C0\uAC00 \uC4F0\uACE0 \uC788\uC73C\uBA74 \uC885\uB8CC \uCF54\uB4DC 4 \u2014 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBCF4\uACE0\uD55C\uB2E4.
|
|
51
|
+
- \uB9CC\uB4E0 \uD398\uC774\uC9C0\uB294 **\uC544\uC9C1 \uB77C\uC774\uBE0C\uAC00 \uC544\uB2C8\uB2E4.** \uC774\uC5B4\uC11C 2b\uC758 \`bstage deploy\`\uB85C \uBE4C\uB4DC\uB97C \uC62C\uB9B0\uB2E4.
|
|
52
52
|
- \uD655\uC778 \uADDC\uCE59\uC740 3\uC808\uACFC \uAC19\uB2E4(\uAE30\uBCF8\uC740 \`--yes\` \uC5C6\uC774 \uC0AC\uC6A9\uC790\uAC00 \uD655\uC778\uCC3D\uC5D0 \uB2F5\uD558\uAC8C \uD55C\uB2E4).
|
|
53
53
|
- \uC885\uB8CC \uCF54\uB4DC 3\uC774\uACE0 \uBA54\uC2DC\uC9C0\uAC00 \uD1A0\uD070 \uB4F1\uAE09\uC744 \uB9D0\uD558\uBA74 deploy \uB4F1\uAE09 \uD1A0\uD070\uC774 \uC544\uB2C8\uAC70\uB098 \uCF58\uC194\uC774 \uC774 \uAE30\uB2A5\uC744 \uC544\uC9C1 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uBC84\uC804\uC774\uB2E4 \u2014 \uC774\uB54C\uB9CC \uCF58\uC194 \uD654\uBA74(\uC2A4\uD14C\uC774\uC9C0 > \uD398\uC774\uC9C0 > \uC0C8 \uD398\uC774\uC9C0)\uC744 \uC548\uB0B4\uD55C\uB2E4.
|
|
54
54
|
- **\uB808\uD3EC \uC5F0\uACB0\uC774 \uC548 \uB3FC \uC788\uC73C\uBA74**(\`bstage link\`\uAC00 \uD6C4\uBCF4\uB97C \uBABB \uCC3E\uC74C) \uCF58\uC194 \uD654\uBA74\uC5D0\uC11C \uC2A4\uD14C\uC774\uC9C0 > \uB808\uD3EC > \uC0C8 \uB808\uD3EC \uC5F0\uACB0\uC744 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBD80\uD0C1\uD55C\uB2E4(\uC870\uC9C1\uC5D0\uC11C \uCC98\uC74C\uC774\uBA74 GitHub \uC571 \uC124\uCE58\uAC00 1\uD68C \uC120\uD589).
|
|
55
|
-
- \uC704\uC82F(\uC2AC\uB86F)
|
|
55
|
+
- \uC704\uC82F(\uC2AC\uB86F)\uC740 CLI\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uCF58\uC194 \uD654\uBA74\uC5D0\uC11C \uC2AC\uB86F \uC790\uB9AC\uB97C \uACE0\uB978\uB2E4. **liquid\uB294 \uD398\uC774\uC9C0(PAGE)\uB9CC** \uAC00\uB2A5\uD558\uB2E4.
|
|
56
56
|
|
|
57
|
-
### 2b. \
|
|
57
|
+
### 2b. \uD398\uC774\uC9C0\xB7\uC704\uC82F\uC774 \uC788\uC744 \uB54C
|
|
58
58
|
|
|
59
59
|
\`\`\`bash
|
|
60
60
|
bstage deploy
|
|
61
61
|
\`\`\`
|
|
62
62
|
|
|
63
|
-
\uC21C\uC11C\uB294 \uC774\uB807\uAC8C \uD750\uB978\uB2E4: git \uC0AC\uC804\uC810\uAC80 \u2192 \uCF58\uC194 \uBE4C\uB4DC \uD2B8\uB9AC\uAC70 \u2192 \uBE4C\uB4DC \uC644\uB8CC \uB300\uAE30(\uB85C\uADF8\uB97C \uB530\uB77C \uCD9C\uB825) \u2192 \
|
|
63
|
+
\uC21C\uC11C\uB294 \uC774\uB807\uAC8C \uD750\uB978\uB2E4: git \uC0AC\uC804\uC810\uAC80 \u2192 \uCF58\uC194 \uBE4C\uB4DC \uD2B8\uB9AC\uAC70 \u2192 \uBE4C\uB4DC \uC644\uB8CC \uB300\uAE30(\uB85C\uADF8\uB97C \uB530\uB77C \uCD9C\uB825) \u2192 \uD398\uC774\uC9C0\xB7\uC704\uC82F\uC744 \uC0C8 \uBE4C\uB4DC\uB85C \uC5C5\uB370\uC774\uD2B8.
|
|
64
64
|
|
|
65
|
-
- \uD2B9\uC815 \
|
|
65
|
+
- \uD2B9\uC815 \uD398\uC774\uC9C0\xB7\uC704\uC82F\uB9CC \uB300\uC0C1\uC73C\uB85C \uD558\uAC70\uB098, \uBE4C\uB4DC\uB9CC \uAC78\uACE0 \uB05D\uB0B4\uAC70\uB098(\uB300\uAE30 \uC0DD\uB7B5), \uAD6C\uC870\uD654 \uCD9C\uB825\uC744 \uC4F0\uB824\uBA74 \`bstage deploy --help\`\uC5D0\uC11C \uD574\uB2F9 \uC635\uC158\uC744 \uD655\uC778\uD55C\uB2E4.
|
|
66
66
|
|
|
67
|
-
## 3. \uC2E4\uD589 \uADDC\uCE59 (\uD655\uC778 \uC5C6\uC774 \
|
|
67
|
+
## 3. \uC2E4\uD589 \uADDC\uCE59 (\uD655\uC778 \uC5C6\uC774 \uC5C5\uB370\uC774\uD2B8\uD558\uC9C0 \uC54A\uB294\uB2E4)
|
|
68
68
|
|
|
69
69
|
\`bstage deploy\`\uB294 \uAE30\uBCF8\uC801\uC73C\uB85C **\uBB34\uC5C7\uC774 \uC5B4\uB514\uB85C \uAC00\uB294\uC9C0 \uD45C\uB85C \uBCF4\uC5EC\uC8FC\uACE0 \uD655\uC778\uC744 \uBB3B\uB294\uB2E4.** \uC774 \uD655\uC778 \uD654\uBA74\uC744 \uC5C6\uC560\uC9C0 \uC54A\uB294 \uAC83\uC774 \uAE30\uBCF8\uAC12\uC774\uB2E4.
|
|
70
70
|
|
|
71
|
-
- \uAE30\uBCF8: \
|
|
71
|
+
- \uAE30\uBCF8: \uC5C5\uB370\uC774\uD2B8 \uC804\uC5D0 \uB124\uAC00 \uD55C \uC904\uB85C \uC694\uC57D\uD558\uACE0(\uC5B4\uB290 \uB808\uD3EC\uC758 \uC5B4\uB290 \uCEE4\uBC0B\uC774 \uC5B4\uB290 \uC2A4\uD14C\uC774\uC9C0\uC758 \uBA87 \uAC1C \uD398\uC774\uC9C0\xB7\uC704\uC82F\uC73C\uB85C \uAC00\uB294\uC9C0), \`--yes\` **\uC5C6\uC774** \uC2E4\uD589\uD574 **CLI\uC758 \uD655\uC778\uCC3D\uC744 \uC0AC\uC6A9\uC790\uAC00 \uC9C1\uC811 \uBCF4\uACE0 \uB2F5\uD558\uAC8C** \uD55C\uB2E4.
|
|
72
72
|
- \uC0AC\uC6A9\uC790\uAC00 \uC774\uBBF8 \uBA85\uC2DC\uC801\uC73C\uB85C \uD655\uC778\uD588\uAC70\uB098 \uBE44\uB300\uD654\uD615 \uD658\uACBD(CI)\uC774\uBA74 \`--yes\`\uB97C \uC4F4\uB2E4. \uAD6C\uC870\uD654 \uCD9C\uB825(\`--json\`)\uC740 \uD655\uC778 \uD504\uB86C\uD504\uD2B8\uC640 \uD568\uAED8 \uC4F8 \uC218 \uC5C6\uC73C\uBBC0\uB85C \`--yes\`\uC640 \uD568\uAED8 \uC4F4\uB2E4.
|
|
73
|
-
- \uC0AC\uC804\uC810\uAC80\uC5D0 \uAC78\uB9AC\uBA74(\uCEE4\uBC0B\uB418\uC9C0 \uC54A\uC740 \uBCC0\uACBD \xB7 \uAE30\uBCF8 \uBE0C\uB79C\uCE58\uAC00 \uC544\uB2D8 \xB7 push\uB418\uC9C0 \uC54A\uC740 \uCEE4\uBC0B) **\uADF8 \uC0AC\uC2E4\uC744 \uACE0\uCE5C\uB2E4.** \`--skip-git-check\`\uB85C \uB36E\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uADF8 \uC635\uC158\uC740 "\uB85C\uCEEC\uACFC \uC6D0\uACA9\uC774 \uB2E4\uB974\uB2E4\uB294 \uAC78 \uC54C\uACE0\uB3C4 \uC6D0\uACA9 \uAE30\uC900\uC73C\uB85C \uBE4C\uB4DC\uD558\uACA0\uB2E4"\uB294 \uC120\uC5B8\uC774\uB77C, \uC0AC\uC6A9\uC790\uAC00 \uBC29\uAE08 \uACE0\uCE5C \uB0B4\uC6A9\uC774 \uBE60\uC9C4 \uCC44 \
|
|
73
|
+
- \uC0AC\uC804\uC810\uAC80\uC5D0 \uAC78\uB9AC\uBA74(\uCEE4\uBC0B\uB418\uC9C0 \uC54A\uC740 \uBCC0\uACBD \xB7 \uAE30\uBCF8 \uBE0C\uB79C\uCE58\uAC00 \uC544\uB2D8 \xB7 push\uB418\uC9C0 \uC54A\uC740 \uCEE4\uBC0B) **\uADF8 \uC0AC\uC2E4\uC744 \uACE0\uCE5C\uB2E4.** \`--skip-git-check\`\uB85C \uB36E\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uADF8 \uC635\uC158\uC740 "\uB85C\uCEEC\uACFC \uC6D0\uACA9\uC774 \uB2E4\uB974\uB2E4\uB294 \uAC78 \uC54C\uACE0\uB3C4 \uC6D0\uACA9 \uAE30\uC900\uC73C\uB85C \uBE4C\uB4DC\uD558\uACA0\uB2E4"\uB294 \uC120\uC5B8\uC774\uB77C, \uC0AC\uC6A9\uC790\uAC00 \uBC29\uAE08 \uACE0\uCE5C \uB0B4\uC6A9\uC774 \uBE60\uC9C4 \uCC44 \uC5C5\uB370\uC774\uD2B8\uB418\uB294 \uB300\uD45C\uC801 \uC6D0\uC778\uC774\uB2E4.
|
|
74
74
|
|
|
75
75
|
## 4. \uC2E4\uD328\uD588\uC744 \uB54C \u2014 \uC885\uB8CC \uCF54\uB4DC\uB85C \uAC08\uB798\uB97C \uC7A1\uB294\uB2E4
|
|
76
76
|
|
|
77
77
|
| \uCF54\uB4DC | \uB73B | \uB300\uC751 |
|
|
78
78
|
| --- | --- | --- |
|
|
79
79
|
| 0 | \uC131\uACF5 | - |
|
|
80
|
-
| 1 | \uC2E4\uD328(\uBE4C\uB4DC \uC2E4\uD328 \uD3EC\uD568) | \`bstage logs <\uBE4C\uB4DC id>\` \uB610\uB294 \`bstage logs -f\`\uB85C \uC6D0\uC778 \uD655\uC778 \uD6C4 \uCF54\uB4DC \uC218\uC815 \u2192 \uCEE4\uBC0B\xB7push \u2192 \
|
|
81
|
-
| 2 | \uC0AC\uC804\uC870\uAC74 \uBBF8\uCDA9\uC871 | \uBA54\uC2DC\uC9C0\uAC00 \uBB34\uC5C7\uC774 \uBE60\uC84C\uB294\uC9C0 \uB9D0\uD55C\uB2E4(\uCEE4\uBC0B\xB7push\xB7\uBE0C\uB79C\uCE58\xB7\
|
|
80
|
+
| 1 | \uC2E4\uD328(\uBE4C\uB4DC \uC2E4\uD328 \uD3EC\uD568) | \`bstage logs <\uBE4C\uB4DC id>\` \uB610\uB294 \`bstage logs -f\`\uB85C \uC6D0\uC778 \uD655\uC778 \uD6C4 \uCF54\uB4DC \uC218\uC815 \u2192 \uCEE4\uBC0B\xB7push \u2192 \uB2E4\uC2DC \`bstage deploy\` |
|
|
81
|
+
| 2 | \uC0AC\uC804\uC870\uAC74 \uBBF8\uCDA9\uC871 | \uBA54\uC2DC\uC9C0\uAC00 \uBB34\uC5C7\uC774 \uBE60\uC84C\uB294\uC9C0 \uB9D0\uD55C\uB2E4(\uCEE4\uBC0B\xB7push\xB7\uBE0C\uB79C\uCE58\xB7\uD398\uC774\uC9C0 0\uAC74 \u2192 \`bstage placement create\`\xB7\uD15C\uD50C\uB9BF \uC774\uB984\xB7\uD655\uC778 \uBD88\uAC00 \uD658\uACBD). \uADF8 \uC870\uAC74\uC744 \uCC44\uC6B4\uB2E4 |
|
|
82
82
|
| 3 | \uC778\uC99D | \`bstage login\` \uB2E4\uC2DC. CI\uBA74 \uD1A0\uD070 \uD658\uACBD\uBCC0\uC218 \uC124\uC815 \uD655\uC778 |
|
|
83
|
-
| 4 | \uCDA9\uB3CC | \uB300\uAE30\uD558\uB294 \uB3D9\uC548 \uB2E4\uB978 \uC0AC\uB78C\uC774 \uBA3C\uC800 \
|
|
83
|
+
| 4 | \uCDA9\uB3CC | \uB300\uAE30\uD558\uB294 \uB3D9\uC548 \uB2E4\uB978 \uC0AC\uB78C\uC774 \uBA3C\uC800 \uC5C5\uB370\uC774\uD2B8\uD588\uB2E4. **\uC7AC\uC2DC\uB3C4\uBD80\uD130 \uD558\uC9C0 \uB9D0\uACE0** \`bstage list\`\uB85C \uD604\uC7AC \uB77C\uC774\uBE0C\uB97C \uD655\uC778\uD558\uACE0 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBCF4\uACE0\uD55C\uB2E4 |
|
|
84
84
|
| 5 | \uC694\uCCAD \uC81C\uD55C | \uC7A0\uC2DC \uAE30\uB2E4\uB838\uB2E4 \uC7AC\uC2DC\uB3C4 |
|
|
85
85
|
|
|
86
86
|
\uBE4C\uB4DC \uB85C\uADF8\uB294 \`bstage logs\`\uB85C \uBCF8\uB2E4(\uBE4C\uB4DC id \uC0DD\uB7B5 \uC2DC \uCD5C\uADFC \uBE4C\uB4DC, \`-f\`\uB85C \uB05D\uB0A0 \uB54C\uAE4C\uC9C0 \uB530\uB77C\uAC10).
|
|
87
87
|
|
|
88
|
-
\
|
|
88
|
+
\uC5C5\uB370\uC774\uD2B8\uB294 \uC131\uACF5\uD588\uB294\uB370 API\uAC00 401\uB85C \uC2E4\uD328\uD558\uAC70\uB098 \uD398\uC774\uC9C0\uAC00 \uAE30\uB300\uC640 \uB2E4\uB974\uBA74(\uC548 \uB738\xB7\uC61B \uD654\uBA74) **\uCD94\uCE21\uC73C\uB85C \uACE0\uCE58\uAE30 \uC804\uC5D0** \`bstage doctor --json\`\uC744 \uC2E4\uD589\uD55C\uB2E4. \`portal.placements[].findings\`\uC758 \`id\`(\uC608: \`appkey.expired\`\xB7\`env.not_rebuilt\`\xB7\`build.update_pending\`)\uB85C \uC6D0\uC778\uC744 \uAC00\uB974\uACE0 \`fix\`\uAC00 \uB9D0\uD558\uB294 \uC870\uCE58\uB97C \uB530\uB978\uB2E4. \`portal.status\`\uAC00 \`skipped\`\uBA74 \`hint\`(\uB85C\uADF8\uC778\xB7\uB9C1\uD06C)\uBD80\uD130, \`unsupported\`\uBA74 \uCF58\uC194\uC774 \uC544\uC9C1 \uC9C4\uB2E8\uC744 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uAC83\uC774\uB2C8 \uC704 \uD45C\uC640 \uB85C\uADF8\uB85C \uB418\uC9DA\uB294\uB2E4. \`portal.status\`\uAC00 \`error\`\uBA74 \uC9C4\uB2E8 \uC790\uCCB4\uAC00 \uC2E4\uD328\uD55C \uAC83\uC774\uB2E4 \u2014 \`reason\`\xB7\`placements[].error\`\uB97C \uC77D\uACE0, \uAD8C\uD55C \uBD80\uC871(401\xB7403)\uC774\uBA74 \uC2A4\uD14C\uC774\uC9C0 \uAD00\uB9AC \uAD8C\uD55C\uC774 \uC788\uB294 \uACC4\uC815\uC778\uC9C0\xB7CLI \uD1A0\uD070 \uB4F1\uAE09\uC774 \uB9DE\uB294\uC9C0\uBD80\uD130 \uD655\uC778\uD55C\uB2E4. doctor\uB294 \uC9C4\uB2E8\uC5D0 error \uD56D\uBAA9\uC774 \uC788\uAC70\uB098 \`portal.status\`\uAC00 \`error\`\uBA74 \uC885\uB8CC \uCF54\uB4DC 1\uB85C \uB05D\uB09C\uB2E4(\`skipped\`\xB7\`unsupported\`\xB7warn\xB7info\uB294 0).
|
|
89
89
|
|
|
90
90
|
## 5. \uB418\uB3CC\uB9AC\uAE30 \xB7 \uAC8C\uC2DC \uB044\uAE30
|
|
91
91
|
|
|
92
|
-
- \`bstage rollback\` \u2014 \uC9C1\uC804 \uC131\uACF5 \uBE4C\uB4DC\uB97C \uB2E4\uC2DC \uB77C\uC774\uBE0C\uB85C \
|
|
92
|
+
- \`bstage rollback\` \u2014 \uC9C1\uC804 \uC131\uACF5 \uBE4C\uB4DC\uB97C \uB2E4\uC2DC \uB77C\uC774\uBE0C\uB85C \uC62C\uB9B0\uB2E4. \uD2B9\uC815 \uBE4C\uB4DC\uB85C \uB418\uB3CC\uB9AC\uB824\uBA74 \uBE4C\uB4DC id\uB97C \uC778\uC790\uB85C \uC900\uB2E4(\`bstage list\`\uC5D0\uC11C \uD655\uC778).
|
|
93
93
|
- \`bstage publish off\` \u2014 \uAC8C\uC2DC\uB9CC \uB048\uB2E4. \uB77C\uC774\uBE0C \uBC84\uC804\uC740 \uADF8\uB300\uB85C \uC720\uC9C0\uB418\uBBC0\uB85C, \uD654\uBA74\uC744 \uAE09\uD788 \uB0B4\uB824\uC57C \uD560 \uB54C \uBA3C\uC800 \uC4F8 \uCE74\uB4DC\uB2E4. \uB418\uB3CC\uB9AC\uB824\uBA74 \`bstage publish on\`.
|
|
94
94
|
- \uB458 \uB2E4 \uAE30\uBCF8\uC73C\uB85C \uD655\uC778\uC744 \uBB3B\uB294\uB2E4. \uC7A5\uC560 \uC0C1\uD669\uC774\uB77C \uC0AC\uC6A9\uC790\uAC00 \uC774\uBBF8 \uACB0\uC815\uD588\uB2E4\uBA74 \`--yes\`\uB97C \uC4F0\uB418, **\uBB34\uC5C7\uC774 \uC5B4\uB5BB\uAC8C \uBC14\uB00C\uB294\uC9C0 \uBA3C\uC800 \uD55C \uC904\uB85C \uC54C\uB9B0\uB2E4.**
|
|
95
95
|
- \uC5B4\uB290 \uCABD\uC744 \uC4F8\uC9C0 \uD5F7\uAC08\uB9AC\uBA74: \uC798\uBABB\uB41C \uB0B4\uC6A9\uC774 \uB5A0 \uC788\uC73C\uBA74 \`publish off\`(\uC989\uC2DC \uB0B4\uB9BC) \u2192 \uC6D0\uC778 \uD30C\uC545 \u2192 \`rollback\`(\uC9C1\uC804 \uC815\uC0C1\uC73C\uB85C \uBCF5\uAD6C).
|
|
96
96
|
|
|
97
97
|
## 6. CI\uC5D0\uC11C \uC4F8 \uB54C
|
|
98
98
|
|
|
99
|
-
- \uB85C\uADF8\uC778\uC740 \uB300\uD654\uD615 \uB300\uC2E0 \uD1A0\uD070 \uBD99\uC5EC\uB123\uAE30 \uACBD\uB85C\uB97C \uC4F4\uB2E4. \uC5F0\uACB0 \uC815\uBCF4(\uC870\uC9C1\xB7\uC2A4\uD14C\uC774\uC9C0\xB7\uB808\uD3EC \uB4F1)\uB294 \`.bstage/project.json\` \uB300\uC2E0 \uD658\uACBD\uBCC0\uC218\uB85C \uC900\uB2E4. **\uBCC0\uC218 \uC774\uB984\uC740 \`bstage login --help\`\xB7\`bstage link --help\`\uC5D0 \uC788\uB294 \uAC83\uC744 \uADF8\uB300\uB85C \uC4F4\uB2E4** \u2014 \uC5EC\uAE30 \uC62E\uACA8 \uC801\uC9C0 \uC54A\uB294\uB2E4(\
|
|
99
|
+
- \uB85C\uADF8\uC778\uC740 \uB300\uD654\uD615 \uB300\uC2E0 \uD1A0\uD070 \uBD99\uC5EC\uB123\uAE30 \uACBD\uB85C\uB97C \uC4F4\uB2E4. \uC5F0\uACB0 \uC815\uBCF4(\uC870\uC9C1\xB7\uC2A4\uD14C\uC774\uC9C0\xB7\uB808\uD3EC \uB4F1)\uB294 \`.bstage/project.json\` \uB300\uC2E0 \uD658\uACBD\uBCC0\uC218\uB85C \uC900\uB2E4. **\uBCC0\uC218 \uC774\uB984\uC740 \`bstage login --help\`\xB7\`bstage link --help\`\uC5D0 \uC788\uB294 \uAC83\uC744 \uADF8\uB300\uB85C \uC4F4\uB2E4** \u2014 \uC5EC\uAE30 \uC62E\uACA8 \uC801\uC9C0 \uC54A\uB294\uB2E4(\uC62E\uACA8 \uC801\uC73C\uBA74 \uC2E4\uC81C \uC774\uB984\uACFC \uC5B4\uAE0B\uB098\uAE30 \uC27D\uB2E4).
|
|
100
100
|
- \uBE44\uB300\uD654\uD615\uC774\uBBC0\uB85C \`--yes\`\uAC00 \uD544\uC694\uD558\uACE0, \uACB0\uACFC\uB97C \uD30C\uC2F1\uD560 \uAC70\uB77C\uBA74 \`--json\`\uACFC \uD568\uAED8 \uC4F4\uB2E4.
|
|
101
101
|
- \uD1A0\uD070\uC740 CI \uC2DC\uD06C\uB9BF\uC73C\uB85C\uB9CC \uC8FC\uC785\uD55C\uB2E4. \uB85C\uADF8\uC5D0 \uCC0D\uAC70\uB098 \uC800\uC7A5\uC18C\uC5D0 \uCEE4\uBC0B\uD558\uC9C0 \uC54A\uB294\uB2E4.
|
|
102
102
|
|
|
@@ -105,11 +105,11 @@ bstage deploy
|
|
|
105
105
|
- \uD1A0\uD070\uC744 \uCD9C\uB825\xB7\uB85C\uADF8\xB7\uCEE4\uBC0B\uC5D0 \uB0A8\uAE30\uAE30 (\`whoami\`\uB85C \uB85C\uADF8\uC778 \uC5EC\uBD80\uB9CC \uD655\uC778\uD55C\uB2E4)
|
|
106
106
|
- \`--skip-git-check\`\uB97C \uC2B5\uAD00\uC801\uC73C\uB85C \uC4F0\uAE30 \u2014 \uC0AC\uC804\uC810\uAC80\uC774 \uC7A1\uB294 \uAC74 "\uC9C0\uAE08 \uACE0\uCE5C \uAC8C \uC548 \uC62C\uB77C\uAC04\uB2E4"\uB294 \uC0AC\uC2E4\uC774\uB2E4
|
|
107
107
|
- \uD655\uC778 \uD504\uB86C\uD504\uD2B8\uB97C \uAE30\uBCF8\uC73C\uB85C \`--yes\`\uB85C \uAC74\uB108\uB6F0\uAE30
|
|
108
|
-
- \uC885\uB8CC \uCF54\uB4DC 4(\uCDA9\uB3CC)\uB97C \uADF8\uB300\uB85C \uC7AC\uC2DC\uB3C4\uD558\uAE30 \u2014 \uB0A8\uC758 \
|
|
109
|
-
- \uB0B4\uAC00 \uB9E1\uC740 \
|
|
110
|
-
- \uB85C\uCEEC \`dist/\`\uB97C \uC5B4\uB518\uAC00\uC5D0 \uC5C5\uB85C\uB4DC\uD574 \
|
|
111
|
-
- \
|
|
112
|
-
- \
|
|
108
|
+
- \uC885\uB8CC \uCF54\uB4DC 4(\uCDA9\uB3CC)\uB97C \uADF8\uB300\uB85C \uC7AC\uC2DC\uB3C4\uD558\uAE30 \u2014 \uB0A8\uC758 \uC5C5\uB370\uC774\uD2B8\uB97C \uB36E\uC5B4\uC4F8 \uC218 \uC788\uB2E4
|
|
109
|
+
- \uB0B4\uAC00 \uB9E1\uC740 \uD398\uC774\uC9C0\xB7\uC704\uC82F \uBC16\uC758 \uAC83\uC744 \uD568\uAED8 \uC5C5\uB370\uC774\uD2B8\xB7\uAC8C\uC2DC \uC804\uD658\uD558\uAE30 (\uBC94\uC704\uB97C \uC881\uD788\uB294 \uC635\uC158\uC740 \`--help\` \uCC38\uC870)
|
|
110
|
+
- \uB85C\uCEEC \`dist/\`\uB97C \uC5B4\uB518\uAC00\uC5D0 \uC5C5\uB85C\uB4DC\uD574 \uAC8C\uC2DC\uD558\uB824 \uC2DC\uB3C4\uD558\uAE30 \u2014 \uAC8C\uC2DC \uACBD\uB85C\uAC00 \uC544\uB2C8\uB2E4
|
|
111
|
+
- \uD398\uC774\uC9C0\uAC00 0\uAC74\uC778\uB370 \`bstage placement create\` \uC5C6\uC774 \`deploy\`\uB97C \uBC18\uBCF5\uD558\uAE30
|
|
112
|
+
- \uD398\uC774\uC9C0\xB7\uC704\uC82F \uC0AD\uC81C\uB97C CLI\uB85C \uC2DC\uB3C4\uD558\uAE30 \u2014 \uC0AD\uC81C\uB294 \uCF58\uC194 \uD654\uBA74 \uC804\uC6A9\uC774\uB2E4
|
|
113
113
|
`;
|
|
114
114
|
}
|
|
115
115
|
|
|
@@ -122,7 +122,7 @@ description: b.stage liquid \uD15C\uD50C\uB9BF\uC744 \uC791\uC131\xB7\uC218\uC81
|
|
|
122
122
|
|
|
123
123
|
# \uC5ED\uD560
|
|
124
124
|
|
|
125
|
-
\uC774 \uD504\uB85C\uC81D\uD2B8\uC5D0\uC11C \`.liquid\` \uD15C\uD50C\uB9BF\uC744 \uC791\uC131\uD55C\uB2E4. \uC791\uC131\uD55C \uD15C\uD50C\uB9BF\uC740 \uCF58\uC194\uC774 \uADF8\uB300\uB85C \uD328\uD0A4\uC9D5\uD558\uACE0, \uD50C\uB7AB\uD3FC\uC774 **\uC11C\uBC84\uC5D0\uC11C \uB370\uC774\uD130\uB97C \uB123\uC5B4** \uB80C\uB354\uD55C\uB2E4. \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uB3C4\uB294 \
|
|
125
|
+
\uC774 \uD504\uB85C\uC81D\uD2B8\uC5D0\uC11C \`.liquid\` \uD15C\uD50C\uB9BF\uC744 \uC791\uC131\uD55C\uB2E4. \uC791\uC131\uD55C \uD15C\uD50C\uB9BF\uC740 b.stage kit \uCF58\uC194\uC774 \uADF8\uB300\uB85C \uD328\uD0A4\uC9D5\uD558\uACE0, \uD50C\uB7AB\uD3FC\uC774 **\uC11C\uBC84\uC5D0\uC11C \uB370\uC774\uD130\uB97C \uB123\uC5B4** \uB80C\uB354\uD55C\uB2E4. \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uB3C4\uB294 \uBC88\uB4E4\uC774 \uC544\uB2C8\uB2E4.
|
|
126
126
|
|
|
127
127
|
\uC774 \uC2A4\uD0AC\uC740 \uAD6C\uC870 \uADDC\uC57D\xB7\uC808\uCC28\xB7\uD568\uC815\uB9CC \uB2F4\uB294\uB2E4. \uBB38\uBC95 \uC0C1\uC138\uB294 liquidjs \uBB38\uC11C\uB97C, \uBA85\uB839 \uC635\uC158\uC740 \`bstage <\uBA85\uB839> --help\`\uB97C \uBCF8\uB2E4.
|
|
128
128
|
|
|
@@ -131,11 +131,11 @@ description: b.stage liquid \uD15C\uD50C\uB9BF\uC744 \uC791\uC131\xB7\uC218\uC81
|
|
|
131
131
|
- \`bstage --help\`, \`bstage <\uBA85\uB839> --help\` \u2014 \uBA85\uB839\xB7\uC635\uC158
|
|
132
132
|
- \uD504\uB85C\uC81D\uD2B8 \uADDC\uCE59: \uB808\uD3EC \uB8E8\uD2B8\uC758 \`AGENTS.md\`
|
|
133
133
|
- \uBB38\uBC95: liquidjs \uACF5\uC2DD \uBB38\uC11C(\uD0DC\uADF8\xB7\uD544\uD130 \uBAA9\uB85D). \uC5EC\uAE30 \uC62E\uACA8 \uC801\uC9C0 \uC54A\uB294\uB2E4
|
|
134
|
-
- \
|
|
134
|
+
- \uAC8C\uC2DC\xB7\uC5C5\uB370\uC774\uD2B8: \`bstage-deploy\` \uC2A4\uD0AC
|
|
135
135
|
|
|
136
|
-
# \uD50C\uB7AB\uD3FC\uC774 \uB123\uB294 \uB370\uC774\uD130 (\
|
|
136
|
+
# \uD50C\uB7AB\uD3FC\uC774 \uB123\uB294 \uB370\uC774\uD130 (\uC0AC\uC6A9\uC790 \uD654\uBA74)
|
|
137
137
|
|
|
138
|
-
\
|
|
138
|
+
\uC0AC\uC6A9\uC790 \uD654\uBA74 \uD15C\uD50C\uB9BF\uC774 \uBC1B\uB294 \uCD5C\uC0C1\uC704 \uAC12\uC740 **\uB2E4\uC12F \uAC1C\uBFD0**\uC774\uB2E4. \uC774 \uC774\uB984 \uC678\uC758 \uBCC0\uC218\uB294 \uBE48 \uBB38\uC790\uC5F4\uC774 \uB41C\uB2E4.
|
|
139
139
|
|
|
140
140
|
| \uC774\uB984 | \uB0B4\uC6A9 |
|
|
141
141
|
| --- | --- |
|
|
@@ -147,19 +147,19 @@ description: b.stage liquid \uD15C\uD50C\uB9BF\uC744 \uC791\uC131\xB7\uC218\uC81
|
|
|
147
147
|
|
|
148
148
|
\uAC01 \uD56D\uBAA9\uC758 \uD544\uB4DC\uB294 \uD50C\uB7AB\uD3FC \uC751\uB2F5\uC744 \uADF8\uB300\uB85C \uB530\uB974\uBBC0\uB85C **\uC2E4\uC81C \uB80C\uB354 \uACB0\uACFC\uB85C \uD655\uC778\uD55C\uB2E4.** \uD544\uB4DC \uC774\uB984\uC744 \uAE30\uC5B5\uC73C\uB85C \uC9C0\uC5B4\uB0B4\uC9C0 \uC54A\uB294\uB2E4.
|
|
149
149
|
|
|
150
|
-
\`data.json\`\uC5D0\uB294 \uC774 \uB2E4\uC12F \uAC1C\uC640 **\uAC19\uC740 \uC774\uB984**\uC73C\uB85C \uC0D8\uD50C\uC744 \uB123\uC5B4\uC57C \uB85C\uCEEC \uD504\uB9AC\uBDF0\uAC00 \
|
|
150
|
+
\`data.json\`\uC5D0\uB294 \uC774 \uB2E4\uC12F \uAC1C\uC640 **\uAC19\uC740 \uC774\uB984**\uC73C\uB85C \uC0D8\uD50C\uC744 \uB123\uC5B4\uC57C \uB85C\uCEEC \uD504\uB9AC\uBDF0\uAC00 \uAC8C\uC2DC\uB41C \uD654\uBA74\uACFC \uAC19\uC740 \uBAA8\uC591\uC774 \uB41C\uB2E4. \uB2E4\uB978 \uC774\uB984\uC744 \uC4F0\uBA74 \uB85C\uCEEC\uC5D0\uC11C\uB9CC \uBCF4\uC774\uACE0 \uAC8C\uC2DC\uD558\uBA74 \uBE44\uB294\uB370, \uADF8 \uCC28\uC774\uAC00 \uD654\uBA74\uC5D0 \uB4DC\uB7EC\uB098\uC9C0 \uC54A\uC544 \uCC3E\uAE30 \uC5B4\uB835\uB2E4.
|
|
151
151
|
|
|
152
|
-
\
|
|
152
|
+
\uC6B4\uC601\uC790 \uD654\uBA74\uC774 \uBB34\uC5C7\uC744 \uBC1B\uB294\uC9C0\uB294 **\uD655\uC778\uB418\uC9C0 \uC54A\uC558\uB2E4.** \uC6B4\uC601\uC790 \uD654\uBA74 \uD15C\uD50C\uB9BF\uC5D0\uC11C\uB294 \uAC12\uC774 \uC628\uB2E4\uACE0 \uAC00\uC815\uD558\uC9C0 \uB9D0\uACE0 \uCCAB \uAC8C\uC2DC\uC5D0\uC11C \uC2E4\uC81C \uB80C\uB354\uB97C \uBCF4\uACE0 \uD310\uB2E8\uD55C\uB2E4.
|
|
153
153
|
|
|
154
154
|
# \uAD6C\uC870 \uADDC\uC57D (\uCF58\uC194 \uBE4C\uB354\uAC00 \uAC15\uC81C\uD55C\uB2E4)
|
|
155
155
|
|
|
156
156
|
\`\`\`
|
|
157
157
|
public/
|
|
158
|
-
user/ \u2014 \
|
|
158
|
+
user/ \u2014 \uC0AC\uC6A9\uC790 \uD654\uBA74\uC6A9
|
|
159
159
|
{name}/
|
|
160
160
|
template.liquid \u2014 \uC2E4\uC81C \uD15C\uD50C\uB9BF (\uD544\uC218)
|
|
161
161
|
data.json \u2014 \uB85C\uCEEC \uBBF8\uB9AC\uBCF4\uAE30\uC6A9 \uC0D8\uD50C \uB370\uC774\uD130 (\uC120\uD0DD)
|
|
162
|
-
admin/ \u2014 \
|
|
162
|
+
admin/ \u2014 \uC6B4\uC601\uC790 \uD654\uBA74\uC6A9 (\uAC19\uC740 \uADDC\uCE59)
|
|
163
163
|
\`\`\`
|
|
164
164
|
|
|
165
165
|
- **\uAE4A\uC774\uAC00 \uACE0\uC815\uC774\uB2E4.** \`public/{user|admin}/{name}/template.liquid\` \uC815\uD655\uD788 \uC774 \uC790\uB9AC\uB9CC \uC778\uC2DD\uD55C\uB2E4. \uD55C \uB2E8\uACC4 \uB354 \uB4E4\uC5B4\uAC00\uAC70\uB098 \uB35C \uB4E4\uC5B4\uAC00\uBA74 **\uCF58\uC194\uC774 \uC870\uC6A9\uD788 \uBB34\uC2DC\uD55C\uB2E4**(\uBE4C\uB4DC\uB294 \uC131\uACF5\uD558\uB294\uB370 \uC544\uBB34\uAC83\uB3C4 \uC548 \uB098\uC628\uB2E4).
|
|
@@ -171,14 +171,14 @@ public/
|
|
|
171
171
|
|
|
172
172
|
## 1. \uC0C8 \uD15C\uD50C\uB9BF \uCD94\uAC00
|
|
173
173
|
|
|
174
|
-
1. \`public/user/{name}/\` \uD3F4\uB354\uB97C \uB9CC\uB4E0\uB2E4(\
|
|
174
|
+
1. \`public/user/{name}/\` \uD3F4\uB354\uB97C \uB9CC\uB4E0\uB2E4(\uC6B4\uC601\uC790 \uD654\uBA74\uC774\uBA74 \`public/admin/{name}/\`). \uC774\uB984\uC740 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD655\uC778\uD55C\uB2E4 \u2014 \uC774 \uC774\uB984\uC774 \uBE4C\uB4DC\uC5D0\uC11C \uD15C\uD50C\uB9BF \uC774\uB984\uC774 \uB41C\uB2E4(\`bstage placement create --template {name}\`).
|
|
175
175
|
2. \`template.liquid\`\uB97C \uB9CC\uB4E0\uB2E4. \uD654\uBA74 \uC804\uCCB4\uB97C \uADF8\uB9AC\uB294 \uB9C8\uD06C\uC5C5\uC774\uB2E4.
|
|
176
176
|
3. \uD544\uC694\uD558\uBA74 \`data.json\`\uC5D0 **\uB85C\uCEEC \uBBF8\uB9AC\uBCF4\uAE30\uC6A9** \uC0D8\uD50C \uB370\uC774\uD130\uB97C \uB123\uB294\uB2E4. \uC2E4\uC81C \uAC12\uC740 \uD50C\uB7AB\uD3FC\uC774 \uB123\uB294\uB2E4 \u2014 \uC0D8\uD50C\uC740 \uBAA8\uC591\uC744 \uB9DE\uCD94\uAE30 \uC704\uD55C \uAC83\uC774\uC9C0 \uACC4\uC57D\uC774 \uC544\uB2C8\uB2E4.
|
|
177
177
|
4. \uB85C\uCEEC\uC5D0\uC11C \uB208\uC73C\uB85C \uD655\uC778\uD55C\uB2E4 \u2014 \`bstage dev\`\uAC00 liquid \uBAA9\uB85D\xB7\uBBF8\uB9AC\uBCF4\uAE30\uB97C \uB744\uC6B4\uB2E4.
|
|
178
178
|
5. \uAC80\uC99D\uD55C\uB2E4 \u2014 liquid \uB808\uD3EC\uC5D0\uC11C \`bstage build\`\uAC00 \uBC88\uB4E4\uC744 \uB9CC\uB4E4\uC9C0 \uC54A\uACE0 **\uAD6C\uC870\xB7\uBB38\uBC95\uC744 \uAC80\uC0AC**\uD55C\uB2E4.
|
|
179
|
-
6. \
|
|
179
|
+
6. \uAC8C\uC2DC\xB7\uC5C5\uB370\uC774\uD2B8\uB294 \`bstage-deploy\` \uC2A4\uD0AC\uC744 \uB530\uB978\uB2E4(push\uB41C \uCEE4\uBC0B\uC744 \uCF58\uC194\uC774 \uBE4C\uB4DC\uD55C\uB2E4).
|
|
180
180
|
|
|
181
|
-
> **\uC124\uCE58\uB41C cli\uAC00 liquid\uB97C \uBAA8\uB974\uB294 \uC61B \uBC84\uC804\uC774\uBA74 4\xB75\uAC00 \uC774 \uB808\uD3EC\uB97C \uC54C\uC544\uBCF4\uC9C0 \uBABB\uD55C\uB2E4.** \uC99D\uC0C1\uC774 \uBD84\uBA85\uD558\uB2E4 \u2014 \`bstage build\`\uAC00 liquid \uAC80\uC99D \uB300\uC2E0 \`src/\` \uC544\uB798\uC5D0\uC11C \uC5C6\uB294 \uC18C\uC2A4 \uD30C\uC77C\uC744 \uCC3E\uB294\uB2E4\uACE0 \uB05D\uB09C\uB2E4. \uADF8\uB54C\uB294 cli\uB97C \uCD5C\uC2E0\uC73C\uB85C \uC62C\uB9AC\uB77C\uACE0 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC54C\uB9B0\uB2E4. \uC62C\uB9B4 \uC218 \uC5C6\uC73C\uBA74 \uB85C\uCEEC \uBBF8\uB9AC\uBCF4\uAE30\uB294 **\uC774 \uB808\uD3EC\uAC00 \uC790\uCCB4\uB85C \uAC00\uC9C4 \uC218\uB2E8**\uC744 \uC4F0\uACE0, \uAD6C\uC870\xB7\uBB38\uBC95\uC740 \uB9AC\uBDF0\uB85C \uD655\uC778\uD55C \uB4A4 \uC2E4\uC81C \uB80C\uB354\uB294 \uCCAB \
|
|
181
|
+
> **\uC124\uCE58\uB41C cli\uAC00 liquid\uB97C \uBAA8\uB974\uB294 \uC61B \uBC84\uC804\uC774\uBA74 4\xB75\uAC00 \uC774 \uB808\uD3EC\uB97C \uC54C\uC544\uBCF4\uC9C0 \uBABB\uD55C\uB2E4.** \uC99D\uC0C1\uC774 \uBD84\uBA85\uD558\uB2E4 \u2014 \`bstage build\`\uAC00 liquid \uAC80\uC99D \uB300\uC2E0 \`src/\` \uC544\uB798\uC5D0\uC11C \uC5C6\uB294 \uC18C\uC2A4 \uD30C\uC77C\uC744 \uCC3E\uB294\uB2E4\uACE0 \uB05D\uB09C\uB2E4. \uADF8\uB54C\uB294 cli\uB97C \uCD5C\uC2E0\uC73C\uB85C \uC62C\uB9AC\uB77C\uACE0 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC54C\uB9B0\uB2E4. \uC62C\uB9B4 \uC218 \uC5C6\uC73C\uBA74 \uB85C\uCEEC \uBBF8\uB9AC\uBCF4\uAE30\uB294 **\uC774 \uB808\uD3EC\uAC00 \uC790\uCCB4\uB85C \uAC00\uC9C4 \uC218\uB2E8**\uC744 \uC4F0\uACE0, \uAD6C\uC870\xB7\uBB38\uBC95\uC740 \uB9AC\uBDF0\uB85C \uD655\uC778\uD55C \uB4A4 \uC2E4\uC81C \uB80C\uB354\uB294 \uCCAB \uAC8C\uC2DC\uC5D0\uC11C \uBCF8\uB2E4.
|
|
182
182
|
|
|
183
183
|
## 2. \uAE30\uC874 \uD15C\uD50C\uB9BF \uC218\uC815
|
|
184
184
|
|
|
@@ -187,7 +187,7 @@ public/
|
|
|
187
187
|
|
|
188
188
|
# liquid \uBB38\uBC95 \uC694\uC810
|
|
189
189
|
|
|
190
|
-
\uC815\uD655\uD55C \uD0DC\uADF8\xB7\uD544\uD130 \uBAA9\uB85D\uC740 liquidjs \uBB38\uC11C\
|
|
190
|
+
\uC815\uD655\uD55C \uD0DC\uADF8\xB7\uD544\uD130 \uBAA9\uB85D\uC740 liquidjs \uBB38\uC11C\uB97C \uAE30\uC900\uC73C\uB85C \uD55C\uB2E4. \uC790\uC8FC \uC4F0\uB294 \uAC83\uB9CC \uC9DA\uB294\uB2E4.
|
|
191
191
|
|
|
192
192
|
**\uBCC0\uC218 \uCD9C\uB825**
|
|
193
193
|
|
|
@@ -231,24 +231,24 @@ public/
|
|
|
231
231
|
|
|
232
232
|
# \uD568\uC815
|
|
233
233
|
|
|
234
|
-
- **sdk\uC640 \uD568\uAED8 \uC788\uB294 \uB808\uD3EC(\uD63C\uD569)\uC5D0\uC11C\uB294 \uC790\uB9AC\uB97C \uB098\uB208\uB2E4.** \`template.tsx\`(React)\uC640 \`.liquid\`\uAC00 \uD55C \uB808\uD3EC\uC5D0 \uC788\uC5B4\uB3C4 \uCF58\uC194\uC774 sdk\uB97C \uBE4C\uB4DC\uD55C \uB4A4 liquid\uB97C \uD568\uAED8 \uD328\uD0A4\uC9D5\uD55C\uB2E4. \uB2E8 sdk \uD398\uC774\uC9C0 \uD3F4\uB354 \`src/pages/user\`\xB7\`src/pages/admin\`\uC740 liquid \
|
|
235
|
-
- **liquid\uB294
|
|
236
|
-
- **\`data.json\`\uC740 \uB85C\uCEEC \uC804\uC6A9\uC774\uB2E4.** \uCF58\uC194\uC774 \uD328\uD0A4\uC9D5\uD560 \uB54C \uC9C0\uC6B4\uB2E4. \uC2E4\uC81C \uB370\uC774\uD130\uC758 \uCD9C\uCC98\uAC00 \uC544\uB2C8\uBBC0\uB85C \uC5EC\uAE30 \uAC12\uC744 \uB9DE\uCDB0 \uB450\uACE0 "\
|
|
237
|
-
- **\`layout.json\`\uB3C4 \uC9C0\uC6CC\uC9C4\uB2E4.** \uB808\uC774\uC544\uC6C3\uC740 \
|
|
234
|
+
- **sdk\uC640 \uD568\uAED8 \uC788\uB294 \uB808\uD3EC(\uD63C\uD569)\uC5D0\uC11C\uB294 \uC790\uB9AC\uB97C \uB098\uB208\uB2E4.** \`template.tsx\`(React)\uC640 \`.liquid\`\uAC00 \uD55C \uB808\uD3EC\uC5D0 \uC788\uC5B4\uB3C4 \uCF58\uC194\uC774 sdk\uB97C \uBE4C\uB4DC\uD55C \uB4A4 liquid\uB97C \uD568\uAED8 \uD328\uD0A4\uC9D5\uD55C\uB2E4. \uB2E8 sdk \uD398\uC774\uC9C0 \uD3F4\uB354 \`src/pages/user\`\xB7\`src/pages/admin\`\uC740 liquid \uBE4C\uB4DC \uC790\uB9AC(\`dist/{user|admin}/\`)\uC640 \uACB9\uCCD0 \`bstage build\`\uAC00 \uC885\uB8CC \uCF54\uB4DC 2\uB85C \uB9C9\uB294\uB2E4(\uB300\uC18C\uBB38\uC790 \uBB34\uC2DC). \uD63C\uD569 \uB808\uD3EC\uC758 liquid \uBBF8\uB9AC\uBCF4\uAE30\uB294 \`bstage dev --kind liquid\`.
|
|
235
|
+
- **liquid\uB294 \uD398\uC774\uC9C0(PAGE)\uB9CC \uAC00\uB2A5\uD558\uB2E4.** \uC2AC\uB86F(\uC704\uC82F \uC790\uB9AC)\uC5D0\uB294 \uB123\uC744 \uC218 \uC5C6\uB2E4. \uD398\uC774\uC9C0\uB294 \`bstage placement create --template {name}\`\uC73C\uB85C \uB9CC\uB4E0\uB2E4(\uCF58\uC194 \uD654\uBA74\uC5D0\uC11C \uB9CC\uB4E4 \uB54C\uB294 \uCEE4\uC2A4\uD140 \uBC29\uC2DD\uC73C\uB85C \`liquid\`\uB97C \uACE0\uB978\uB2E4).
|
|
236
|
+
- **\`data.json\`\uC740 \uB85C\uCEEC \uC804\uC6A9\uC774\uB2E4.** \uCF58\uC194\uC774 \uD328\uD0A4\uC9D5\uD560 \uB54C \uC9C0\uC6B4\uB2E4. \uC2E4\uC81C \uB370\uC774\uD130\uC758 \uCD9C\uCC98\uAC00 \uC544\uB2C8\uBBC0\uB85C \uC5EC\uAE30 \uAC12\uC744 \uB9DE\uCDB0 \uB450\uACE0 "\uAC8C\uC2DC\uD558\uBA74 \uC774 \uAC12\uC774 \uB098\uC628\uB2E4"\uACE0 \uAE30\uB300\uD558\uC9C0 \uC54A\uB294\uB2E4.
|
|
237
|
+
- **\`layout.json\`\uB3C4 \uC9C0\uC6CC\uC9C4\uB2E4.** \uB808\uC774\uC544\uC6C3\uC740 \uCF58\uC194\uC758 \uD398\uC774\uC9C0 \uC124\uC815\uC774 \uC18C\uC720\uD55C\uB2E4 \u2014 \uB808\uD3EC\uC5D0\uC11C \uC815\uD558\uB824 \uD558\uC9C0 \uC54A\uB294\uB2E4.
|
|
238
238
|
- **\uACBD\uB85C \uAE4A\uC774\uB97C \uC9C0\uD0A8\uB2E4.** \uADDC\uC57D \uBC16 \uC704\uCE58\uC758 \uD30C\uC77C\uC740 \uBB34\uC2DC\uB41C\uB2E4. "\uBD84\uBA85 \uB9CC\uB4E4\uC5C8\uB294\uB370 \uBAA9\uB85D\uC5D0 \uC5C6\uB2E4"\uC758 \uB300\uBD80\uBD84\uC774 \uC774 \uACBD\uC6B0\uB2E4.
|
|
239
239
|
- **\uC5D0\uC14B(\uC774\uBBF8\uC9C0\xB7\uC601\uC0C1)\uC740 \uCF58\uC194 \uBBF8\uB514\uC5B4\uC5D0 \uC62C\uB9AC\uACE0 \uADF8 URL\uC744 \uC4F4\uB2E4.** \uCF58\uC194 \uD654\uBA74\uC758 \uC2A4\uD14C\uC774\uC9C0 > \uBBF8\uB514\uC5B4\uC5D0 \uD30C\uC77C\uC744 \uC62C\uB9AC\uBA74 URL\uC744 \uBC1B\uB294\uB2E4. \uADF8 URL\uC744 \uD15C\uD50C\uB9BF\uC5D0 **\uC808\uB300 \uC8FC\uC18C\uB85C** \uB123\uB294\uB2E4. \uC774\uBBF8\uC9C0\xB7\uC601\uC0C1\uB9CC \uC62C\uB9B4 \uC218 \uC788\uACE0, \uD5C8\uC6A9 \uD615\uC2DD\xB7\uC6A9\uB7C9 \uD55C\uB3C4\uB294 \uC5C5\uB85C\uB4DC\uD560 \uB54C \uD654\uBA74\uC774 \uC54C\uB824 \uC900\uB2E4.
|
|
240
|
-
- **\uB808\uD3EC\uC5D0 \uB123\uACE0 \uC0C1\uB300 \uACBD\uB85C\uB85C \uCC38\uC870\uD558\uBA74 \
|
|
241
|
-
- **\uB85C\uCEEC \uD504\uB9AC\uBDF0\uB294 \uC774 \uC810\uC5D0\uC11C \
|
|
240
|
+
- **\uB808\uD3EC\uC5D0 \uB123\uACE0 \uC0C1\uB300 \uACBD\uB85C\uB85C \uCC38\uC870\uD558\uBA74 \uAC8C\uC2DC \uD6C4 \uAE68\uC9C4\uB2E4.** \uB80C\uB354\uB41C HTML\uC774 \uC2A4\uD14C\uC774\uC9C0 \uB3C4\uBA54\uC778 \uD398\uC774\uC9C0 \uC548\uC73C\uB85C \uB4E4\uC5B4\uAC00\uBBC0\uB85C \uC0C1\uB300 \uACBD\uB85C\uB294 \uADF8 \uB3C4\uBA54\uC778 \uAE30\uC900\uC73C\uB85C \uD480\uB9AC\uACE0, \uBE4C\uB4DC\uAC00 \uB193\uC778 \uC8FC\uC18C\uB97C \uAC00\uB9AC\uD0A4\uC9C0 \uC54A\uB294\uB2E4. \uC61B \uAC00\uC774\uB4DC\uC5D0 \`public\`\uC5D0 \uB450\uACE0 \uC0C1\uB300 \uACBD\uB85C\uB85C \uCC38\uC870\uD558\uB77C\uACE0 \uC801\uD78C \uAC83\uC774 \uC788\uB294\uB370 \uC2E0\uADDC \uCF58\uC194\uC5D0\uC11C\uB294 \uB9DE\uC9C0 \uC54A\uB294\uB2E4.
|
|
241
|
+
- **\uB85C\uCEEC \uD504\uB9AC\uBDF0\uB294 \uC774 \uC810\uC5D0\uC11C \uAC8C\uC2DC\uB41C \uD654\uBA74\uACFC \uBC18\uB300\uB85C \uB3D9\uC791\uD55C\uB2E4.** \uD504\uB9AC\uBDF0\uB294 \uD15C\uD50C\uB9BF \uD3F4\uB354\uC758 \uD30C\uC77C\uC744 \uD568\uAED8 \uC11C\uBE59\uD558\uBBC0\uB85C \uC0C1\uB300 \uACBD\uB85C \uC774\uBBF8\uC9C0\uAC00 \uC798 \uBCF4\uC778\uB2E4. **\uD504\uB9AC\uBDF0\uC5D0\uC11C \uBCF4\uC600\uB2E4\uB294 \uAC83\uC744 \uADFC\uAC70\uB85C \uC0BC\uC9C0 \uC54A\uB294\uB2E4.**
|
|
242
242
|
- **\uB370\uC774\uD130 \uBAA8\uC591\uC744 \uCD94\uCE21\uD558\uC9C0 \uC54A\uB294\uB2E4.** \uCD5C\uC0C1\uC704 \uC774\uB984\uC740 \uC704 \uD45C\uAC00 \uC804\uBD80\uC774\uACE0, \uADF8 \uC548\uC758 \uD544\uB4DC\uB294 \uC2E4\uC81C \uB80C\uB354 \uACB0\uACFC\uB85C \uD655\uC778\uD55C\uB2E4.
|
|
243
|
-
- **\uD30C\uC15C(\`{% render %}\`\xB7\`{% include %}\`)\uC740 \
|
|
243
|
+
- **\uD30C\uC15C(\`{% render %}\`\xB7\`{% include %}\`)\uC740 \uAC8C\uC2DC\uB41C \uD654\uBA74\uC5D0\uC11C \uB3D9\uC791\uD558\uC9C0 \uC54A\uB294\uB2E4.** \uAC8C\uC2DC\uB41C \uD654\uBA74\uC744 \uADF8\uB9AC\uB294 \uC5D4\uC9C4\uC740 \uB808\uD3EC\uC758 \uD30C\uC77C\uC744 \uCC3E\uC9C0 \uBABB\uD574 \uADF8 \uC790\uB9AC\uB97C \uBE48 \uBB38\uC790\uC5F4\uB85C \uB80C\uB354\uD55C\uB2E4. \uB85C\uCEEC \uD504\uB9AC\uBDF0\uC5D0\uC11C\uB9CC \uB3D9\uC791\uD558\uBBC0\uB85C \uD504\uB9AC\uBDF0 \uACB0\uACFC\uAC00 \uADFC\uAC70\uAC00 \uB418\uC9C0 \uC54A\uB294\uB2E4. \uD15C\uD50C\uB9BF\uC740 \`template.liquid\` \uD55C \uD30C\uC77C\uC5D0 \uB2F4\uB294\uB2E4(\`bstage build\`\uAC00 \uD30C\uC15C \uD0DC\uADF8\uB97C \uACBD\uACE0\uB85C \uC9DA\uB294\uB2E4).
|
|
244
244
|
|
|
245
245
|
# \uD558\uC9C0 \uB9D0 \uAC83
|
|
246
246
|
|
|
247
247
|
- \`public/{user|admin}/{name}/\` \uBC16\uC5D0 \uD15C\uD50C\uB9BF \uD30C\uC77C \uB450\uAE30
|
|
248
248
|
- \`template.liquid\` \uC678\uC758 \uD30C\uC77C\uBA85 \uC4F0\uAE30
|
|
249
|
-
- \`data.json\`\xB7\`layout.json\`\uC5D0 \
|
|
250
|
-
- \
|
|
251
|
-
- \`{% render %}\`\xB7\`{% include %}\`\uB85C \uD15C\uD50C\uB9BF \uCABC\uAC1C\uAE30 (\
|
|
249
|
+
- \`data.json\`\xB7\`layout.json\`\uC5D0 \uAC8C\uC2DC\uC5D0 \uD544\uC694\uD55C \uC124\uC815\uC744 \uB2F4\uAE30 (\uD328\uD0A4\uC9D5 \uB54C \uC0AC\uB77C\uC9C4\uB2E4)
|
|
250
|
+
- \uD63C\uD569 \uB808\uD3EC\uC5D0\uC11C sdk \uD398\uC774\uC9C0\uB97C \`src/pages/user\`\xB7\`src/pages/admin\` \uC544\uB798\uC5D0 \uB9CC\uB4E4\uAE30 \u2014 liquid \uBE4C\uB4DC \uC790\uB9AC\uC640 \uACB9\uCE5C\uB2E4(React \uD15C\uD50C\uB9BF\uC744 \uD568\uAED8 \uB450\uB294 \uAC83 \uC790\uCCB4\uB294 \uB41C\uB2E4. \uCD94\uAC00\uD55C \uB4A4 \`bstage ai update\`\uB85C AGENTS.md\uB97C \uD63C\uD569 \uBCF8\uBB38\uC73C\uB85C \uBC14\uAFBC\uB2E4)
|
|
251
|
+
- \`{% render %}\`\xB7\`{% include %}\`\uB85C \uD15C\uD50C\uB9BF \uCABC\uAC1C\uAE30 (\uAC8C\uC2DC\uB41C \uD654\uBA74\uC5D0\uC11C \uBE48 \uBB38\uC790\uC5F4\uC774 \uB41C\uB2E4)
|
|
252
252
|
- \uBB38\uBC95\xB7\uD544\uD130\uB97C \uAE30\uC5B5\uC73C\uB85C \uC9C0\uC5B4\uB0B4\uAE30 \u2014 liquidjs \uBB38\uC11C\uC5D0\uC11C \uD655\uC778\uD55C\uB2E4
|
|
253
253
|
- \uAC12\uC774 \uD56D\uC0C1 \uC788\uB2E4\uACE0 \uAC00\uC815\uD558\uAE30 \u2014 \uBE48 \uAC12\xB7\uBE48 \uBAA9\uB85D \uBD84\uAE30\uB97C \uD568\uAED8 \uB123\uB294\uB2E4
|
|
254
254
|
`;
|
|
@@ -275,7 +275,7 @@ description: bstage SDK \uBC84\uC804 \uB9C8\uC774\uADF8\uB808\uC774\uC158\uC744
|
|
|
275
275
|
# \uAD8C\uC704 \uC788\uB294 \uCD9C\uCC98 (\uBA3C\uC800 \uC77D\uAE30)
|
|
276
276
|
|
|
277
277
|
- \`MIGRATION.md\` \u2014 \uBC84\uC804\uBCC4 \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uD56D\uBAA9\xB7\uC808\uCC28(\uB2E8\uC77C \uC18C\uC2A4). \uBC84\uC804 \uBC94\uD504+\uC124\uCE58 \uD6C4 \`node_modules/@bstage-sdk/cli/dist/MIGRATION.md\`(\uB610\uB294 core docs)\uC5D0\uC11C \uC77D\uB294\uB2E4.
|
|
278
|
-
- \`bstage doctor\` \u2014 \
|
|
278
|
+
- \`bstage doctor\` \u2014 \uC124\uCE58 \uBC84\uC804\xB7\uD30C\uC77C\uC774 \uCD5C\uC2E0 SDK\uC640 \uC5B4\uAE0B\uB09C \uACF3 \uC9C4\uB2E8(\uACB0\uC815\uB860). \`npx @bstage-sdk/cli@latest doctor\`.
|
|
279
279
|
- \uBB38\uC11C \uBAA9\uB85D: \`npx bstage docs\` (SDK \uC758\uC874\uC774 \uC5C6\uB294 \uB808\uD3EC\uC5D0\uC11C\uB294 \uC885\uB8CC \uCF54\uB4DC 2\uB85C \uB05D\uB09C\uB2E4 \u2014 liquid \uB808\uD3EC\uB77C\uBA74 \`bstage-liquid\` \uC2A4\uD0AC\uC744 \uBCF8\uB2E4)
|
|
280
280
|
|
|
281
281
|
# \uC808\uCC28
|
|
@@ -286,7 +286,7 @@ description: bstage SDK \uBC84\uC804 \uB9C8\uC774\uADF8\uB808\uC774\uC158\uC744
|
|
|
286
286
|
npx @bstage-sdk/cli@latest doctor --json
|
|
287
287
|
\`\`\`
|
|
288
288
|
|
|
289
|
-
\`bstage ai doctor\`\uB85C \uC2A4\uD0AC\xB7AGENTS.md\uAC00 \uCD5C\uC2E0\uC778\uC9C0\uB3C4 \uD568\uAED8 \uBCF8\uB2E4(
|
|
289
|
+
\`bstage ai doctor\`\uB85C \uC2A4\uD0AC\xB7AGENTS.md\uAC00 \uCD5C\uC2E0\uC778\uC9C0\uB3C4 \uD568\uAED8 \uBCF8\uB2E4(\uC624\uB798\uB41C \uBCF8\uBB38\uC774\uBA74 \`bstage ai update\`).
|
|
290
290
|
|
|
291
291
|
\uCD9C\uB825\uC5D0\uC11C \uB124 \uAC00\uC9C0\uB97C \uC5BB\uB294\uB2E4.
|
|
292
292
|
|
|
@@ -295,7 +295,7 @@ npx @bstage-sdk/cli@latest doctor --json
|
|
|
295
295
|
- \`recommendedDeps\` \u2014 \uAD8C\uC7A5 \uC758\uC874\uC131\uC758 \uC120\uC5B8 \uC0C1\uD0DC(\`declared: false\`\uBA74 \uBBF8\uC120\uC5B8). **\uBC84\uC804 \uB300\uC870\uB85C\uB294 \uC548 \uC7A1\uD788\uB294 \uCD95**\uC774\uBBC0\uB85C \`migrations\`\uAC00 \uBE44\uC5B4 \uC788\uC5B4\uB3C4 \uB530\uB85C \uD655\uC778\uD55C\uB2E4
|
|
296
296
|
- \`migrations\` \u2014 \uC801\uC6A9 \uAC00\uB2A5\uD55C \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uD56D\uBAA9. \uAC01 \uD56D\uBAA9\uC740 \`label\`(\uD5E4\uB354 \uD45C\uAE30, \uC608: \`cli 0.43.0\` \uB610\uB294 \`core 0.32.0 \xB7 react 0.32.0\`) \xB7 \`requirements\`(\uC62C\uB824\uC57C \uD560 \uD328\uD0A4\uC9C0\xB7\uCD5C\uC18C \uBC84\uC804 \uC30D) \xB7 \`items\`(\uD56D\uBAA9 \uC81C\uBAA9)\uB97C \uAC00\uC9C4\uB2E4. \uD5E4\uB354\uC758 \uD328\uD0A4\uC9C0\uB97C \uADF8 \uBC84\uC804 \uC774\uC0C1\uC73C\uB85C \uC62C\uB9B0\uB2E4
|
|
297
297
|
|
|
298
|
-
**\uC885\uB8CC \uCF54\uB4DC 1\uC774\uC5B4\uB3C4 stdout\uC758 JSON\uC740 \uC815\uC0C1\uC774\uB2E4** \u2014 \uB85C\uADF8\uC778\xB7\uB9C1\uD06C\uB41C \uB808\uD3EC\uC5D0\uC11C\uB294 \
|
|
298
|
+
**\uC885\uB8CC \uCF54\uB4DC 1\uC774\uC5B4\uB3C4 stdout\uC758 JSON\uC740 \uC815\uC0C1\uC774\uB2E4** \u2014 \uB85C\uADF8\uC778\xB7\uB9C1\uD06C\uB41C \uB808\uD3EC\uC5D0\uC11C\uB294 b.stage kit \uCF58\uC194 \uC9C4\uB2E8(\`portal\`)\uC774 \uD568\uAED8 \uB3CC\uACE0, \uD398\uC774\uC9C0\xB7\uC704\uC82F\uC5D0 error \uD56D\uBAA9\uC774 \uC788\uAC70\uB098 \uC9C4\uB2E8\uC774 \uC2E4\uD328\uD558\uBA74 1\uB85C \uB05D\uB09C\uB2E4. \`portal\`\uC740 \uAC8C\uC2DC\uB41C \uD398\uC774\uC9C0\xB7\uC704\uC82F\uC758 \uC0C1\uD0DC\uB77C \uB9C8\uC774\uADF8\uB808\uC774\uC158\uACFC \uBB34\uAD00\uD558\uBBC0\uB85C, 1\uC774 \uB098\uC654\uB2E4\uACE0 \uC9C4\uB2E8\uC744 \uC2E4\uD328\uB85C \uBCF4\uC9C0 \uB9D0\uACE0 JSON\uC744 \uADF8\uB300\uB85C \uC77D\uC5B4 \uC704 \uB124 \uD56D\uBAA9\uC73C\uB85C \uC9C4\uD589\uD55C\uB2E4(\uCF58\uC194 \uC9C4\uB2E8 \uBB38\uC81C\uB294 \uB530\uB85C \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC54C\uB9AC\uACE0 \`bstage-deploy\` \uC2A4\uD0AC\uB85C \uB118\uAE34\uB2E4).
|
|
299
299
|
|
|
300
300
|
\`isBstageProject\`\uAC00 false\uBA74 bstage \uD504\uB85C\uC81D\uD2B8\uAC00 \uC544\uB2C8\uBBC0\uB85C \uC911\uB2E8\uD55C\uB2E4. \uB808\uC9C0\uC2A4\uD2B8\uB9AC \uC870\uD68C\uC5D0 \uC2E4\uD328\uD574 \`latestChecked\`\uAC00 false\uBA74 \uBC84\uC804 \uBE44\uAD50\uB97C \uBCF4\uB958\uD55C\uB2E4(\uBCF4\uC77C\uB7EC\uD50C\uB808\uC774\uD2B8\xB7\uD56D\uBAA9\uC740 \uACC4\uC18D \uC9C4\uD589 \uAC00\uB2A5).
|
|
301
301
|
|
|
@@ -305,7 +305,7 @@ npx @bstage-sdk/cli@latest doctor --json
|
|
|
305
305
|
|
|
306
306
|
- \uC62C\uB9B4 \uD328\uD0A4\uC9C0\uB294 \`cli\`\uBFD0\uC774\uB2E4(core\xB7react\xB7design \uC758\uC874\uC774 \uC5C6\uB2E4). \`versions\`\uC5D0 \uADF8\uAC83\uB9CC \uB098\uC628\uB2E4.
|
|
307
307
|
- \uBCF4\uC77C\uB7EC\uD50C\uB808\uC774\uD2B8 \uD30C\uC77C \uBAA9\uB85D\uB3C4 liquid \uAE30\uC900\uC774\uB2E4 \u2014 sdk\uC758 \`src/\`\xB7\`vite.config.ts\`\uAC00 \uC5C6\uB2E4\uACE0 \uB9CC\uB4E4\uC9C0 \uC54A\uB294\uB2E4.
|
|
308
|
-
- \`liquid\` \uAC80\uC99D \uACB0\uACFC(\uBB38\uBC95\xB7\uADDC\uC57D\xB7\uACBD\uACE0)\uAC00 \uD568\uAED8 \uB098\uC628\uB2E4. error\uAC00 \uC788\uC73C\uBA74 \uBC84\uC804 \uC791\uC5C5\uBCF4\uB2E4 \uBA3C\uC800 \uACE0\uCE5C\uB2E4 \u2014 \
|
|
308
|
+
- \`liquid\` \uAC80\uC99D \uACB0\uACFC(\uBB38\uBC95\xB7\uADDC\uC57D\xB7\uACBD\uACE0)\uAC00 \uD568\uAED8 \uB098\uC628\uB2E4. error\uAC00 \uC788\uC73C\uBA74 \uBC84\uC804 \uC791\uC5C5\uBCF4\uB2E4 \uBA3C\uC800 \uACE0\uCE5C\uB2E4 \u2014 \uAC8C\uC2DC\xB7\uC5C5\uB370\uC774\uD2B8\uAC00 \uB9C9\uD788\uB294 \uBB38\uC81C\uB2E4.
|
|
309
309
|
- \uC2A4\uD0AC \uC138\uD2B8\uB294 \`bstage-liquid\`\xB7\`bstage-deploy\`\xB7\`bstage-onboarding\`\xB7\uC774 \uC2A4\uD0AC\uC774\uB2E4. \`bstage ai update\`\uAC00 \uB9DE\uCDB0 \uC900\uB2E4.
|
|
310
310
|
- SDK \uBB38\uC11C(\`npx bstage docs\`)\uB294 SDK \uC758\uC874\uC774 \uC5C6\uC5B4 \uC885\uB8CC \uCF54\uB4DC 2\uB85C \uB05D\uB09C\uB2E4 \u2014 \uC791\uC131 \uADDC\uC57D\xB7\uB370\uC774\uD130\xB7\uC5D0\uC14B\uC740 \`bstage-liquid\` \uC2A4\uD0AC\uC774 \uB4E4\uACE0 \uC788\uB2E4.
|
|
311
311
|
|
|
@@ -354,20 +354,20 @@ doctor\uC758 \`layout.legacyPresent\`\uAC00 \`true\`\uBA74 \`src/templates/\`\uA
|
|
|
354
354
|
|
|
355
355
|
**\uC5EC\uAE30\uC11C\uB9CC\uC740 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBB3C\uC5B4\uC57C \uD55C\uB2E4.** \uC774 \uC2A4\uD0AC\uC758 \uC6D0\uCE59\uC740 "\uC0AC\uC2E4\uC740 \uC5D0\uC774\uC804\uD2B8\uAC00 \uAC80\uC99D\uD558\uACE0, \uC0AC\uC6A9\uC790\uC5D0\uAC90 \uACB0\uC815\uB9CC \uBB3B\uB294\uB2E4"\uC774\uC9C0\uB9CC, \uC774 \uD56D\uBAA9\uC740 **\uC0AC\uC2E4 \uC790\uCCB4\uAC00 \uD504\uB85C\uC81D\uD2B8 \uC18C\uC2A4\uC5D0 \uC5C6\uB2E4**:
|
|
356
356
|
|
|
357
|
-
- \uD3F4\uB354 \uC774\uB984\uC740 \uC9C0\uAE08\uAE4C\uC9C0 \uC544\uBB34 \uC758\uBBF8\uAC00 \uC5C6\uC5C8\uB2E4 \u2014 \uBE4C\uB4DC\uAC00 \uC784\uC2DC \uB77C\uBCA8\uB85C\uB9CC \uC4F0\uACE0 \uBC84\uB838\uB2E4. \uADF8\uB798\uC11C \`src/templates/home/\`\uC774 \uC2E4\uC81C\uB85C\uB294 \`/landing\`\uC5D0 \
|
|
358
|
-
- \uC2AC\uB86F \
|
|
359
|
-
- \
|
|
357
|
+
- \uD3F4\uB354 \uC774\uB984\uC740 \uC9C0\uAE08\uAE4C\uC9C0 \uC544\uBB34 \uC758\uBBF8\uAC00 \uC5C6\uC5C8\uB2E4 \u2014 \uBE4C\uB4DC\uAC00 \uC784\uC2DC \uB77C\uBCA8\uB85C\uB9CC \uC4F0\uACE0 \uBC84\uB838\uB2E4. \uADF8\uB798\uC11C \`src/templates/home/\`\uC774 \uC2E4\uC81C\uB85C\uB294 \`/landing\`\uC5D0 \uAC8C\uC2DC\uB3FC \uC788\uC744 \uC218 \uC788\uB2E4.
|
|
358
|
+
- \uC704\uC82F\uC744 \uC5B4\uB290 \uC2AC\uB86F\uC5D0 \uBD99\uC77C\uC9C0\uB294 \uCF54\uB4DC\uC5D0 \uC120\uC5B8\uD558\uC9C0 \uC54A\uC558\uB2E4(\uC124\uACC4\uC0C1 \uCF58\uC194 \uBAAB\uC774\uC5C8\uB2E4). \uADF8\uB798\uC11C \uD398\uC774\uC9C0\uC778\uC9C0 \uC704\uC82F\uC778\uC9C0\uB3C4 \uC18C\uC2A4\uB85C\uB294 \uAC08\uB9AC\uC9C0 \uC54A\uB294\uB2E4.
|
|
359
|
+
- \uC6B4\uC601\uC790 \uD654\uBA74 \uC804\uC6A9 \`type: 'fullPage' | 'sharedNav'\`\uB294 \uB808\uC774\uC544\uC6C3 \uAD6C\uBD84\uC774\uB77C \uC774 \uD310\uB2E8\uC5D0 \uC4F8 \uC218 \uC5C6\uB2E4.
|
|
360
360
|
|
|
361
|
-
\uC2E4\uC81C \uB9E4\uD551\uC740 \
|
|
361
|
+
\uC2E4\uC81C \uB9E4\uD551\uC740 \uCF58\uC194\uC5D0\uB9CC \uC788\uB2E4. \`layout.legacyTemplates\`\uC758 \uD3F4\uB354\uB97C \uD558\uB098\uC529 \uC9DA\uC5B4 \uBB3B\uB294\uB2E4.
|
|
362
362
|
|
|
363
363
|
- \uBA3C\uC800 **\uC18C\uC2A4\uB97C \uC77D\uACE0 \uCD94\uC815\uC548\uC744 \uB9CC\uB4E4\uC5B4 \uC81C\uC2DC\uD55C\uB2E4.** \uC804\uCCB4 \uD654\uBA74\uC744 \uADF8\uB9AC\uB294\uC9C0 \uC791\uC740 \uC870\uAC01\uC778\uC9C0, \uCEF4\uD3EC\uB10C\uD2B8 \uC774\uB984\uC774 \uBB34\uC5C7\uC778\uC9C0\uB294 \uB124\uAC00 \uC77D\uC5B4\uC11C \uC54C \uC218 \uC788\uB2E4. \uC0AC\uC6A9\uC790\uAC00 \uBC31\uC9C0\uC5D0\uC11C \uB2F5\uD558\uAC8C \uB450\uC9C0 \uC54A\uB294\uB2E4.
|
|
364
364
|
- \uC704\uC82F\uC774\uB77C\uACE0 \uB2F5\uD558\uBA74 **\uC790\uB9AC \uBAA9\uB85D\uC744 \uC120\uD0DD\uC9C0\uB85C \uC81C\uC2DC\uD55C\uB2E4.** \uCE74\uD0C8\uB85C\uADF8\uB294 SDK\uAC00 \uB4E4\uACE0 \uC788\uC73C\uBBC0\uB85C \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uCC3E\uC544\uC624\uB77C\uACE0 \uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 \`node_modules/@bstage-sdk/core\`\uC758 \`SLOT_CATALOG_V2\`(\uB610\uB294 \`SLOT_CATALOG_V2.md\`)\uB97C \uC77D\uC5B4 \`description\`\uACFC \uD568\uAED8 \uBCF4\uC5EC\uC900\uB2E4.
|
|
365
|
-
- \uD398\uC774\uC9C0\uB77C\uACE0 \uB2F5\uD558\uBA74 **\
|
|
366
|
-
- \uD655\uC778\uC774 \uC548 \uB418\uBA74 \uCD94\uCE21\uD574\uC11C \uC62E\uAE30\uC9C0 \uB9D0\uACE0 \uBA48\uCD98\uB2E4. \uACBD\uB85C\uAC00 \uD2C0\uB9AC\uBA74 \
|
|
365
|
+
- \uD398\uC774\uC9C0\uB77C\uACE0 \uB2F5\uD558\uBA74 **\uCF58\uC194\uC5D0 \uB4F1\uB85D\uB41C \uACBD\uB85C**\uB97C \uBB3B\uB294\uB2E4. \uC774\uAC83\uB9CC\uC740 \uC0AC\uC6A9\uC790\uAC00 \uCF58\uC194\uC744 \uBD10\uC57C \uD55C\uB2E4 \u2014 \uB300\uC2E0 "\uCF58\uC194\uC5D0\uC11C \uC774 \uCEE4\uC2A4\uD140 \uD398\uC774\uC9C0\uC758 \uACBD\uB85C\uB97C \uD655\uC778\uD574 \uC8FC\uC138\uC694"\uCC98\uB7FC \uC5B4\uB514\uB97C \uBCF4\uBA74 \uB418\uB294\uC9C0\uAE4C\uC9C0 \uC54C\uB824\uC900\uB2E4.
|
|
366
|
+
- \uD655\uC778\uC774 \uC548 \uB418\uBA74 \uCD94\uCE21\uD574\uC11C \uC62E\uAE30\uC9C0 \uB9D0\uACE0 \uBA48\uCD98\uB2E4. \uACBD\uB85C\uAC00 \uD2C0\uB9AC\uBA74 \uC5C5\uB370\uC774\uD2B8 \uD6C4 \uD654\uBA74\uC774 \uC548 \uB728\uB294\uB370, \uC6D0\uC778\uC744 \uCC3E\uAE30 \uC5B4\uB835\uB2E4.
|
|
367
367
|
|
|
368
|
-
\uC62E\uAE34 \uB4A4\uC5D0\uB294 \uAC1C\uBC1C\uC6A9 \uC9C4\uC785\uC810\uC758 \`import.meta.glob\`(\
|
|
368
|
+
\uC62E\uAE34 \uB4A4\uC5D0\uB294 \uAC1C\uBC1C\uC6A9 \uC9C4\uC785\uC810\uC758 \`import.meta.glob\`(\uC0AC\uC6A9\uC790 \uD654\uBA74 \uD504\uB85C\uC81D\uD2B8\uB294 \`src/App.tsx\`, \uC6B4\uC601\uC790 \uD654\uBA74 \uD504\uB85C\uC81D\uD2B8\uB294 \`src/main.tsx\`)\uACFC \`route-preview.json\`\xB7\`config-preview.json\` \uAC12\uC744 \uD568\uAED8 \uACE0\uCE5C\uB2E4(MIGRATION.md\uC758 \uD574\uB2F9 \uD56D\uBAA9 \uCC38\uC870). \uB9C8\uC9C0\uB9C9\uC5D0 \`npx bstage build\`\uB97C \uB3CC\uB824 \uBE4C\uB4DC \uACB0\uACFC\uBB3C\uC774 \uC758\uB3C4\uD55C \uACBD\uB85C\uB85C \uB098\uC624\uB294\uC9C0 \uD655\uC778\uD558\uACE0, \uADF8 \uBAA9\uB85D\uC744 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBCF4\uC5EC\uC900\uB2E4.
|
|
369
369
|
|
|
370
|
-
> \
|
|
370
|
+
> \uCF58\uC194\uC774 \uD604\uC7AC \uB9E4\uD551\uC744 \uC870\uD68C\uD558\uB294 API\uB97C \uC5F4\uBA74 \uC774 \uBB3C\uC74C\uC740 \uC790\uB3D9 \uC870\uD68C\uB85C \uB300\uCCB4\uD560 \uC218 \uC788\uB2E4. \uADF8\uB54C\uAE4C\uC9C0\uB294 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBB3B\uB294 \uAC8C \uC720\uC77C\uD55C \uBC29\uBC95\uC774\uB2E4.
|
|
371
371
|
|
|
372
372
|
### 3d. AGENTS.md \uAD00\uB9AC \uC601\uC5ED \uB3D9\uAE30\uD654
|
|
373
373
|
|
|
@@ -375,7 +375,7 @@ doctor\uC758 \`layout.legacyPresent\`\uAC00 \`true\`\uBA74 \`src/templates/\`\uA
|
|
|
375
375
|
|
|
376
376
|
- \`ok\` \u2014 \uD560 \uC77C \uC5C6\uC74C.
|
|
377
377
|
- \`stale\` (\uB9C8\uCEE4\uB294 \uC788\uACE0 \uBC84\uC804\uB9CC \uB0AE\uC74C) \u2014 **\uC790\uB3D9**. \`bstage ai update\`\uB97C \uC2E4\uD589\uD558\uBA74 \uAD00\uB9AC \uC601\uC5ED\uB9CC \uCD5C\uC2E0\uC73C\uB85C \uCE58\uD658\uB418\uACE0 \uC790\uC720 \uC601\uC5ED\uC740 \uBCF4\uC874\uB41C\uB2E4. \uB05D.
|
|
378
|
-
- \`legacy\` (\uB9C8\uCEE4 \uC5C6\uC74C \u2014 \uC61B \uD504\uB85C\uC81D\uD2B8) \u2014 **\uD310\uB2E8**. SDK \uB0B4\uC6A9\uACFC \uC0AC\uC6A9\uC790 \uB0B4\uC6A9\uC774 \uD55C \uB369\uC5B4\uB9AC\uB77C
|
|
378
|
+
- \`legacy\` (\uB9C8\uCEE4 \uC5C6\uC74C \u2014 \uC61B \uD504\uB85C\uC81D\uD2B8) \u2014 **\uD310\uB2E8**. SDK \uB0B4\uC6A9\uACFC \uC0AC\uC6A9\uC790 \uB0B4\uC6A9\uC774 \uD55C \uB369\uC5B4\uB9AC\uB77C \uD55C \uBC88\uC740 \uB458\uC744 \uB098\uB220 \uB2E4\uC2DC \uD569\uCE58\uB294 \uC791\uC5C5\uC774 \uD544\uC694\uD558\uB2E4. **\uACBD\uACC4\uB294 \uB124(\uC5D0\uC774\uC804\uD2B8)\uAC00 \uBA3C\uC800 \uBD84\uB958\uD574 \uC81C\uC548\uD558\uACE0, \uC0AC\uC6A9\uC790\uC5D0\uAC90 \uD655\uC778\uB9CC \uBC1B\uB294\uB2E4** \u2014 \uC0AC\uC6A9\uC790\uC5D0\uAC8C "\uC5B4\uB514\uAE4C\uC9C0\uAC00 \uD504\uB85C\uC81D\uD2B8 \uCD94\uAC00\uBD84\uC774\uB0D0"\uB97C \uBC31\uC9C0\uC5D0\uC11C \uBB3B\uC9C0 \uC54A\uB294\uB2E4(\uC0AC\uC6A9\uC790\uB294 AGENTS.md \uAD6C\uC870\uB97C \uBAA8\uB97C \uC218 \uC788\uACE0, \uBD84\uB958\uB294 \uB124 \uCC45\uC784\uC774\uB2E4).
|
|
379
379
|
1. doctor \`--json\`\uC758 \`agentsMd.managedBlock\`\uC774 \uC801\uC6A9\uD560 **\uCD5C\uC2E0 SDK \uAD00\uB9AC \uC601\uC5ED(\uB9C8\uCEE4 \uD3EC\uD568)**\uC774\uB2E4. \uC774\uAC78 \uB808\uD37C\uB7F0\uC2A4\uB85C \uC0BC\uC544, \uC61B AGENTS.md\uC758 \uAC01 \uAD6C\uAC04\uC774 **SDK \uBCF4\uC77C\uB7EC\uD50C\uB808\uC774\uD2B8**(\uD504\uB85C\uC81D\uD2B8 \uAC1C\uC694\xB7SDK \uBB38\uC11C \uBAA9\uB85D\xB7\uD504\uB85C\uC81D\uD2B8 \uAD6C\uC870\xB7\uD15C\uD50C\uB9BF \uC791\uC131 \uADDC\uCE59\xB7\uAE08\uC9C0 \uC0AC\uD56D\xB7\uC61B \`client.get('/api/...')\` \uC608\uC2DC\uB098 \uC5D4\uB4DC\uD3EC\uC778\uD2B8 \uBAA9\uB85D \uB4F1 \u2014 managedBlock\uC774 \uB300\uCCB4\uD558\uB294 \uAC83)\uC778\uC9C0, **\uD504\uB85C\uC81D\uD2B8 \uACE0\uC720 \uB0B4\uC6A9**(\uC774 \uB808\uD3EC\uB9CC\uC758 \uADDC\uCE59\xB7\uB3C4\uBA54\uC778 \uBA54\uBAA8 \uB4F1)\uC778\uC9C0 \uBD84\uB958\uD55C\uB2E4.
|
|
380
380
|
2. \uBD84\uB958 \uACB0\uACFC\uB85C "\uB9E8 \uC704 = managedBlock, \uADF8 \uC544\uB798 \uC790\uC720 \uC601\uC5ED = \uD504\uB85C\uC81D\uD2B8 \uACE0\uC720 \uB0B4\uC6A9\uB9CC" \uAD6C\uC870\uC758 \uC7AC\uC791\uC131\uC548\uC744 \uB9CC\uB4E0\uB2E4. SDK \uBCF4\uC77C\uB7EC\uD50C\uB808\uC774\uD2B8\uB294 managedBlock\uC774 \uB300\uC2E0\uD558\uBBC0\uB85C **\uC790\uC720 \uC601\uC5ED\uC5D0 \uC911\uBCF5 \uBCF4\uC874\uD558\uC9C0 \uC54A\uB294\uB2E4** \u2014 \uD2B9\uD788 \uC61B \`/api/\` \uACBD\uB85C \uBAA9\uB85D\uC774 \uB0A8\uC73C\uBA74 \uC7AC\uBC1C \uC6D0\uC778\uC774 \uB41C\uB2E4.
|
|
381
381
|
3. \uC790\uC720 \uC601\uC5ED\uC73C\uB85C \uBCF4\uC874\uD558\uB824\uB294 \uD56D\uBAA9(=\uB124\uAC00 "\uD504\uB85C\uC81D\uD2B8 \uACE0\uC720"\uB85C \uBD84\uB958\uD55C \uAC83)\uC744 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC81C\uC2DC\uD558\uACE0 **\uACBD\uACC4\uB97C \uD655\uC778\uBC1B\uB294\uB2E4**: "\uC774 \uBD80\uBD84\uB4E4\uC744 \uD504\uB85C\uC81D\uD2B8 \uACE0\uC720 \uB0B4\uC6A9\uC73C\uB85C \uBCF4\uACE0 \uBCF4\uC874\uD558\uB824\uB294\uB370 \uB9DE\uB098\uC694? SDK \uC601\uC5ED\uC73C\uB85C \uBE7C\uB3C4 \uB418\uB294 \uAC8C \uC11E\uC5EC \uC788\uAC70\uB098, \uBE60\uC9C4 \uAC8C \uC788\uB098\uC694?" (\uC774\uAC74 "\uCF54\uB4DC\uAC00 \uB9DE\uB0D0"\uB294 \uAC80\uC99D\uC774 \uC544\uB2C8\uB77C "\uC774\uAC8C \uB108\uD76C\uAC00 \uCD94\uAC00\uD55C \uAC70\uB0D0"\uB294 \uC18C\uC720 \uD655\uC778\uC774\uB77C \uC0AC\uC6A9\uC790\uAC00 \uB2F5\uD560 \uC218 \uC788\uB2E4.) \uC560\uB9E4\uD55C \uAD6C\uAC04\uC740 \uC784\uC758\uB85C \uC9C0\uC6B0\uC9C0 \uB9D0\uACE0 \uC790\uC720 \uC601\uC5ED\uC5D0 \uB0A8\uACA8 \uD6C4\uBCF4\uB85C \uC81C\uC2DC\uD55C\uB2E4.
|
|
@@ -392,7 +392,7 @@ doctor\uC758 \`layout.legacyPresent\`\uAC00 \`true\`\uBA74 \`src/templates/\`\uA
|
|
|
392
392
|
- **\uAE30\uC5B5\xB7\uAC00\uC815\uC73C\uB85C \uC801\uC6A9\uD558\uAE30** \u2014 \uC124\uCE58\uB41C \uD328\uD0A4\uC9C0(\`MIGRATION.md\`\xB7\uD0C0\uC785 \uC120\uC5B8)\uC640 \uD504\uB85C\uC81D\uD2B8 \uC2E4\uC81C \uCF54\uB4DC\uB85C \uD655\uC778\uD558\uC9C0 \uC54A\uACE0 \uBCC0\uD658\uD558\uAE30
|
|
393
393
|
- **\uC0AC\uC6A9\uC790\uC5D0\uAC8C \uCF54\uB4DC \uAC80\uC99D\uC744 \uB5A0\uB118\uAE30\uAE30** \u2014 "\uC774 \uCF54\uB4DC \uB9DE\uB098\uC694?"\uCC98\uB7FC \uC0AC\uC6A9\uC790\uAC00 \uC9C1\uC811 \uD655\uC778\uD574\uC57C \uB2F5\uD560 \uC218 \uC788\uB294 \uC9C8\uBB38\uD558\uAE30 (\uC0AC\uC6A9\uC790\uB294 \uAC1C\uBC1C\uC790\uAC00 \uC544\uB2D0 \uC218 \uC788\uB2E4 \u2014 \uAC80\uC99D\uC740 \uB124 \uBAAB)
|
|
394
394
|
- \uC0AC\uC6A9\uC790 \uCF54\uB4DC\uB97C \uD1B5\uC9F8\uB85C \uB36E\uC5B4\uC4F0\uAE30 (\uD2B9\uD788 \`src/pages/**\`\xB7\`src/slots/**\`, \uCEE4\uC2A4\uD140 \`shared\`/\`api\` \uB4F1)
|
|
395
|
-
- \uD15C\uD50C\uB9BF\uC774 \uD398\uC774\uC9C0\uC778\uC9C0 \uC704\uC82F\uC778\uC9C0, \uD398\uC774\uC9C0\uBA74 \uC5B4\uB290 \uACBD\uB85C\uC778\uC9C0\uB97C **\uCD94\uCE21\uD574\uC11C** \uC62E\uAE30\uAE30 (\
|
|
395
|
+
- \uD15C\uD50C\uB9BF\uC774 \uD398\uC774\uC9C0\uC778\uC9C0 \uC704\uC82F\uC778\uC9C0, \uD398\uC774\uC9C0\uBA74 \uC5B4\uB290 \uACBD\uB85C\uC778\uC9C0\uB97C **\uCD94\uCE21\uD574\uC11C** \uC62E\uAE30\uAE30 (\uCF58\uC194\uC5D0\uB9CC \uC788\uB294 \uC815\uBCF4\uB2E4)
|
|
396
396
|
- \uD55C \uBC88\uC5D0 \uBAA8\uB4E0 \uBCC0\uACBD\uC744 \uC801\uC6A9\uD558\uACE0 \uAC80\uC99D\uC744 \uAC74\uB108\uB6F0\uAE30
|
|
397
397
|
- \`\uD310\uB2E8\` \uD56D\uBAA9\uC744 \uC0AC\uC6A9\uC790 \uD655\uC778 \uC5C6\uC774 \uCD94\uCE21\uC73C\uB85C \uBCC0\uD658\uD558\uAE30
|
|
398
398
|
- \`.bstage/i18n/**/*.json\` \uAC19\uC740 \uC7AC\uC0DD\uC131 \uAC00\uB2A5\uD55C \uCE90\uC2DC\uB97C \uC190\uC73C\uB85C \uD3B8\uC9D1\uD558\uAE30 (\`bstage i18n pull\`\uB85C \uC0DD\uC131)
|
|
@@ -408,21 +408,21 @@ description: b.stage \uCEE4\uC2A4\uD140 \uAC1C\uBC1C\uC744 \uCC98\uC74C\uBD80\uD
|
|
|
408
408
|
|
|
409
409
|
# \uC5ED\uD560
|
|
410
410
|
|
|
411
|
-
\uBE48\uC190\uC5D0\uC11C \uC2DC\uC791\uD574 **\uCCAB \uD654\uBA74\uC774 \uD50C\uB7AB\uD3FC\uC5D0 \uB728\uB294 \uB370\uAE4C\uC9C0** \uC0AC\uC6A9\uC790\uB97C \uB370\uB824\uAC04\uB2E4. \uC774 \uC2A4\uD0AC\uC740 \uC21C\uC11C\uC640 \uC131\uACF5 \uD310\uC815 \uAE30\uC900\uB9CC \uB2F4\uB294\uB2E4. \uBA85\uB839\uC758 \uC815\uD655\uD55C \uC635\uC158\uC740 \uD56D\uC0C1 \`bstage <\uBA85\uB839> --help\`\uB97C, SDK \uC0AC\uC6A9\uBC95\uC740 \uC124\uCE58\uB41C docs\uB97C \uBCF8\uB2E4.
|
|
411
|
+
\uBE48\uC190\uC5D0\uC11C \uC2DC\uC791\uD574 **\uCCAB \uD654\uBA74\uC774 b.stage \uD50C\uB7AB\uD3FC\uC5D0 \uB728\uB294 \uB370\uAE4C\uC9C0** \uC0AC\uC6A9\uC790\uB97C \uB370\uB824\uAC04\uB2E4. \uB808\uD3EC \uC5F0\uACB0\xB7\uAC8C\uC2DC\uB294 b.stage kit \uCF58\uC194(\uC774\uD558 \uCF58\uC194)\uC744 \uAC70\uCE5C\uB2E4. \uC774 \uC2A4\uD0AC\uC740 \uC21C\uC11C\uC640 \uC131\uACF5 \uD310\uC815 \uAE30\uC900\uB9CC \uB2F4\uB294\uB2E4. \uBA85\uB839\uC758 \uC815\uD655\uD55C \uC635\uC158\uC740 \uD56D\uC0C1 \`bstage <\uBA85\uB839> --help\`\uB97C, SDK \uC0AC\uC6A9\uBC95\uC740 \uC124\uCE58\uB41C docs\uB97C \uBCF8\uB2E4.
|
|
412
412
|
|
|
413
413
|
\uD575\uC2EC \uC6D0\uCE59:
|
|
414
414
|
|
|
415
415
|
1. **\uC0AC\uC6A9\uC790\uB294 \uAC1C\uBC1C\uC790\uAC00 \uC544\uB2D0 \uC218 \uC788\uB2E4.** \uD30C\uC77C\xB7\uC124\uC815\xB7\uC124\uCE58 \uC0C1\uD0DC \uD655\uC778\uC740 **\uB124(\uC5D0\uC774\uC804\uD2B8) \uCC45\uC784**\uC774\uB2E4. \uC9C1\uC811 \uC77D\uC5B4 \uD655\uC778\uD558\uACE0, \uC0AC\uC6A9\uC790\uC5D0\uAC90 \uC81C\uD488\xB7\uC120\uD638 **\uACB0\uC815**\uB9CC \uAD6C\uCCB4\uC801 \uC120\uD0DD\uC9C0\uB85C \uBB3B\uB294\uB2E4.
|
|
416
416
|
2. **\uD655\uC778\uC774 \uC548 \uB418\uBA74 \uBA48\uCD98\uB2E4.** \uCD94\uCE21\uD574\uC11C \uB2E4\uC74C \uB2E8\uACC4\uB85C \uB118\uC5B4\uAC00\uC9C0 \uC54A\uB294\uB2E4.
|
|
417
417
|
3. **\uB2E8\uACC4\uB9C8\uB2E4 \uC131\uACF5 \uD310\uC815 \uAE30\uC900\uC744 \uBA3C\uC800 \uB9D0\uD558\uACE0 \uD655\uC778\uD55C\uB2E4.** "\uB410\uB098\uC694?"\uAC00 \uC544\uB2C8\uB77C "\uC774 \uCD9C\uB825\uC774 \uB098\uC624\uBA74 \uC131\uACF5"\uC73C\uB85C \uB9D0\uD55C\uB2E4.
|
|
418
|
-
4. **\uB418\uB3CC\uB9AC\uAE30 \uC5B4\uB824\uC6B4 \uC77C\uC740 \uC2E4\uD589 \uC804\uC5D0 \uBCF4\uC5EC\uC8FC\uACE0 \uD655\uC778\uBC1B\uB294\uB2E4** \u2014 \uC6D0\uACA9 push, \
|
|
418
|
+
4. **\uB418\uB3CC\uB9AC\uAE30 \uC5B4\uB824\uC6B4 \uC77C\uC740 \uC2E4\uD589 \uC804\uC5D0 \uBCF4\uC5EC\uC8FC\uACE0 \uD655\uC778\uBC1B\uB294\uB2E4** \u2014 \uC6D0\uACA9 push, \uC5C5\uB370\uC774\uD2B8(\`bstage deploy\`), \uAC8C\uC2DC \uC804\uD658.
|
|
419
419
|
|
|
420
420
|
# \uAD8C\uC704 \uC788\uB294 \uCD9C\uCC98
|
|
421
421
|
|
|
422
422
|
- \`bstage --help\`, \`bstage <\uBA85\uB839> --help\` \u2014 \uBA85\uB839\xB7\uC635\uC158\uC758 \uC720\uC77C\uD55C \uCD9C\uCC98(\uAE30\uC5B5\uC73C\uB85C \uC635\uC158\uC744 \uB9CC\uB4E4\uC9C0 \uC54A\uB294\uB2E4)
|
|
423
423
|
- \uC124\uCE58 \uD6C4 \`node_modules/@bstage-sdk/core/docs/\` \u2014 GETTING_STARTED\xB7INIT\xB7BUILD_SYSTEM \uB4F1. \uBAA9\uB85D\uC740 \`npx bstage docs\`. SDK \uC758\uC874\uC774 \uC5C6\uB294 \uB808\uD3EC(\uC608: \`.liquid\` \uD30C\uC77C\uB9CC \uB454 \uB808\uD3EC)\uC5D0\uB294 \uC774 \uACBD\uB85C\uAC00 \uC5C6\uC5B4 **\uC885\uB8CC \uCF54\uB4DC 2**\uB85C \uB05D\uB09C\uB2E4 \u2014 \uADF8\uB54C\uB294 \`bstage-liquid\` \uC2A4\uD0AC\uC774 \uADDC\uC57D\xB7\uB370\uC774\uD130\xB7\uC5D0\uC14B\uC744 \uB4E4\uACE0 \uC788\uB2E4
|
|
424
424
|
- \uD504\uB85C\uC81D\uD2B8 \uADDC\uCE59: \uB808\uD3EC \uB8E8\uD2B8\uC758 \`AGENTS.md\`
|
|
425
|
-
- \uC774\uD6C4 \uC791\uC5C5\uC740 \uC2A4\uD0AC\uB85C \uB118\uAE34\uB2E4 \u2014 \`bstage-template\`(React \uD15C\uD50C\uB9BF) \xB7 \`bstage-liquid\`(liquid \uD15C\uD50C\uB9BF) \xB7 \`bstage-deploy\`(\
|
|
425
|
+
- \uC774\uD6C4 \uC791\uC5C5\uC740 \uC2A4\uD0AC\uB85C \uB118\uAE34\uB2E4 \u2014 \`bstage-template\`(React \uD15C\uD50C\uB9BF) \xB7 \`bstage-liquid\`(liquid \uD15C\uD50C\uB9BF) \xB7 \`bstage-deploy\`(\uC5C5\uB370\uC774\uD2B8\xB7\uB864\uBC31\xB7\uAC8C\uC2DC)
|
|
426
426
|
|
|
427
427
|
# \uC808\uCC28
|
|
428
428
|
|
|
@@ -430,13 +430,13 @@ description: b.stage \uCEE4\uC2A4\uD140 \uAC1C\uBC1C\uC744 \uCC98\uC74C\uBD80\uD
|
|
|
430
430
|
|
|
431
431
|
\uC791\uC5C5\uC744 \uC2DC\uC791\uD558\uAE30 \uC804\uC5D0 \uC544\uB798 \uC14B\uC744 **\uD55C \uBC88\uC5D0** \uBB3B\uB294\uB2E4(\uD558\uB098\uC529 \uBB3C\uC73C\uBA74 \uC0AC\uC6A9\uC790\uAC00 \uC9C0\uCE5C\uB2E4).
|
|
432
432
|
|
|
433
|
-
- **(a) \uC5B4\uB514\uC5D0 \uBD99\uC774\uB098** \u2014 \
|
|
433
|
+
- **(a) \uC5B4\uB514\uC5D0 \uBD99\uC774\uB098** \u2014 \uC0AC\uC6A9\uC790 \uD654\uBA74(\uBC29\uBB38\uC790\uAC00 \uBCF4\uB294 \uD654\uBA74)\uC778\uC9C0, \uC6B4\uC601\uC790 \uD654\uBA74(\uC6B4\uC601\uC790\uAC00 \uBCF4\uB294 \uD654\uBA74)\uC778\uC9C0.
|
|
434
434
|
- **(b) \uC5B4\uB5BB\uAC8C \uB9CC\uB4DC\uB098** \u2014 \uB458 \uC911 \uD558\uB098\uB97C \uACE0\uB974\uAC8C \uD558\uACE0 \uD55C \uC904 \uC7A5\uB2E8\uC810\uC744 \uD568\uAED8 \uC900\uB2E4.
|
|
435
435
|
- **React \uCEF4\uD3EC\uB10C\uD2B8(sdk)**: \uC0C1\uD638\uC791\uC6A9\xB7\uC0C1\uD0DC\xB7API \uD638\uCD9C\uC774 \uD544\uC694\uD55C \uD654\uBA74\uC5D0 \uB9DE\uB294\uB2E4. \uB300\uC2E0 \uBE4C\uB4DC\xB7\uBC88\uB4E4 \uAC1C\uB150\uC774 \uB530\uB77C\uC628\uB2E4.
|
|
436
436
|
- **liquid \uD15C\uD50C\uB9BF**: \uB370\uC774\uD130\uB97C \uBC1B\uC544 \uADF8\uB824 \uC8FC\uAE30\uB9CC \uD558\uBA74 \uB418\uB294 \uD654\uBA74\uC5D0 \uB9DE\uB294\uB2E4. \uBC30\uC6B0\uAE30 \uC27D\uACE0 \uBE60\uB974\uC9C0\uB9CC \uBE0C\uB77C\uC6B0\uC800 \uCABD \uB85C\uC9C1\uC740 \uC81C\uD55C\uB41C\uB2E4.
|
|
437
|
-
- **(c) \uC5B4\uB514\uC5D0 \
|
|
437
|
+
- **(c) \uC5B4\uB514\uC5D0 \uC62C\uB9AC\uB098** \u2014 \uD658\uACBD(phase)\uACFC \uC2A4\uD14C\uC774\uC9C0 ID. \uBAA8\uB974\uBA74 "\uCF58\uC194\uC5D0 \uB85C\uADF8\uC778\uD588\uC744 \uB54C \uBCF4\uC774\uB294 \uC2A4\uD14C\uC774\uC9C0 \uC774\uB984"\uC774\uB77C\uACE0 \uC54C\uB824\uC8FC\uACE0, 1\uB2E8\uACC4\uC5D0\uC11C\uB294 \uBE44\uC6CC \uB454 \uCC44 \uC9C4\uD589\uD574\uB3C4 \uB41C\uB2E4(6\uB2E8\uACC4\uC5D0\uC11C \`bstage link\`\uAC00 \uBAA9\uB85D\uC73C\uB85C \uBB3C\uC5B4\uBCF8\uB2E4).
|
|
438
438
|
|
|
439
|
-
\uD55C \uB808\uD3EC\uC5D0 \uB450 \uBC29\uC2DD\uC744 \uD568\uAED8 \uB458 \uC218\uB3C4 \uC788\uB2E4(\uD63C\uD569 \uB808\uD3EC) \u2014 \uCF58\uC194\uC774 React \uD15C\uD50C\uB9BF\uC744 \uBE4C\uB4DC\uD55C \uB4A4 liquid \uD15C\uD50C\uB9BF\uC744 \uD568\uAED8 \uD328\uD0A4\uC9D5\uD55C\uB2E4. \uB2E4\uB9CC \uAC19\uC740 \uD654\uBA74\uC744 \uB450 \uBC29\uC2DD\uC73C\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uACE0, sdk \uD398\uC774\uC9C0 \uD3F4\uB354 \uC774\uB984\uC5D0 \`user\`\xB7\`admin\`\uC744 \uC4F0\uC9C0 \uC54A\uB294\uB2E4(\`src/pages/user\`\uB294 liquid \
|
|
439
|
+
\uD55C \uB808\uD3EC\uC5D0 \uB450 \uBC29\uC2DD\uC744 \uD568\uAED8 \uB458 \uC218\uB3C4 \uC788\uB2E4(\uD63C\uD569 \uB808\uD3EC) \u2014 \uCF58\uC194\uC774 React \uD15C\uD50C\uB9BF\uC744 \uBE4C\uB4DC\uD55C \uB4A4 liquid \uD15C\uD50C\uB9BF\uC744 \uD568\uAED8 \uD328\uD0A4\uC9D5\uD55C\uB2E4. \uB2E4\uB9CC \uAC19\uC740 \uD654\uBA74\uC744 \uB450 \uBC29\uC2DD\uC73C\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uACE0, sdk \uD398\uC774\uC9C0 \uD3F4\uB354 \uC774\uB984\uC5D0 \`user\`\xB7\`admin\`\uC744 \uC4F0\uC9C0 \uC54A\uB294\uB2E4(\`src/pages/user\`\uB294 liquid \uBE4C\uB4DC \uC790\uB9AC\uC640 \uACB9\uCCD0 \`bstage build\`\uAC00 \uC885\uB8CC \uCF54\uB4DC 2\uB85C \uB9C9\uB294\uB2E4). \uD63C\uD569 \uB808\uD3EC\uC758 \uB85C\uCEEC \uBBF8\uB9AC\uBCF4\uAE30\uB294 \`bstage dev\`(React)\uC640 \`bstage dev --kind liquid\`\uB85C \uB530\uB85C \uB744\uC6B4\uB2E4.
|
|
440
440
|
|
|
441
441
|
## 2. \uD504\uB85C\uC81D\uD2B8 \uC0DD\uC131
|
|
442
442
|
|
|
@@ -445,8 +445,8 @@ npx @bstage-sdk/cli@latest init
|
|
|
445
445
|
\`\`\`
|
|
446
446
|
|
|
447
447
|
- CLI\uAC00 \uC774\uBBF8 \uC124\uCE58\uB41C \uD658\uACBD\uC774\uBA74 \`bstage init\`\uB3C4 \uAC19\uB2E4. \uCC98\uC74C\uC774\uB77C\uBA74 \uC704\uCC98\uB7FC \`npx\`\uB85C \uCD5C\uC2E0 CLI\uB97C \uBC14\uB85C \uC4F4\uB2E4.
|
|
448
|
-
- 1\uB2E8\uACC4 (b)\uC758 \uACB0\uC815\uC740 \`--kind sdk\` \uB610\uB294 \`--kind liquid\`\uB85C \uB118\uAE34\uB2E4(\uAE30\uBCF8\uC740 sdk). \uB300\uC0C1(\
|
|
449
|
-
- \uB300\uD654\uD615\uC73C\uB85C \uC2A4\
|
|
448
|
+
- 1\uB2E8\uACC4 (b)\uC758 \uACB0\uC815\uC740 \`--kind sdk\` \uB610\uB294 \`--kind liquid\`\uB85C \uB118\uAE34\uB2E4(\uAE30\uBCF8\uC740 sdk). \uB300\uC0C1 \uD654\uBA74(\uC0AC\uC6A9\uC790 \uD654\uBA74 \`user\`/\uC6B4\uC601\uC790 \uD654\uBA74 \`admin\`)\uC740 \`--target\`\uC774\uB2E4. \uB098\uBA38\uC9C0 \uC635\uC158\uC740 \`bstage init --help\`\uB85C \uD655\uC778\uD55C\uB2E4.
|
|
449
|
+
- \uB300\uD654\uD615\uC73C\uB85C \uC2A4\uD14C\uC774\uC9C0\xB7\uB300\uC0C1 \uD654\uBA74\xB7\uCCAB \uD15C\uD50C\uB9BF \uC774\uB984\xB7phase\uB97C \uBB3B\uB294\uB2E4. \uBE44\uB300\uD654\uD615\uC73C\uB85C \uB3CC\uB824\uC57C \uD558\uBA74 \uC635\uC158 \uC774\uB984\uC744 \uCD94\uCE21\uD558\uC9C0 \uB9D0\uACE0 \`bstage init --help\`\uB85C \uD655\uC778\uD55C\uB2E4.
|
|
450
450
|
- **\uC131\uACF5 \uD310\uC815**: \uC0C8 \uD3F4\uB354\uAC00 \uC0DD\uAE30\uACE0 \uADF8 \uC548\uC5D0 \`package.json\`\xB7\`AGENTS.md\`\xB7\`.claude/skills/\`\uAC00 \uC788\uB2E4. \uC774\uD6C4 \uC791\uC5C5\uC740 **\uC0DD\uC131\uB41C \uD3F4\uB354 \uC548\uC5D0\uC11C** \uD55C\uB2E4(\uC5D0\uC774\uC804\uD2B8\uAC00 \uC791\uC5C5 \uB514\uB809\uD130\uB9AC\uB97C \uC62E\uAE34\uB2E4).
|
|
451
451
|
- init\uC774 \uC5D0\uC774\uC804\uD2B8\uC6A9 \uC2A4\uD0AC\xB7\`AGENTS.md\`\uB97C \uC774\uBBF8 \uC124\uCE58\uD574 \uB454\uB2E4 \u2014 \`bstage ai install\`\uC744 \uB2E4\uC2DC \uB3CC\uB9B4 \uD544\uC694\uB294 \uC5C6\uB2E4. \`.claude/skills/\`\uAC00 \uC2E4\uC81C\uB85C \uC788\uB294\uC9C0\uB9CC \uD655\uC778\uD55C\uB2E4.
|
|
452
452
|
- \uC758\uC874\uC131 \uC124\uCE58\uAC00 \uB05D\uB0AC\uB294\uC9C0 \uD655\uC778\uD55C\uB2E4(\`node_modules\`\uAC00 \uC788\uB294\uC9C0). \uC124\uCE58\uAC00 \uC2E4\uD328\uD588\uB2E4\uBA74 \uC6D0\uC778\uC744 \uC77D\uACE0 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBCF4\uACE0\uD55C\uB2E4 \u2014 \uB118\uC5B4\uAC00\uC9C0 \uC54A\uB294\uB2E4.
|
|
@@ -459,7 +459,7 @@ bstage dev
|
|
|
459
459
|
|
|
460
460
|
- \`npm run dev\`\uB3C4 \uAC19\uC740 \uC77C\uC744 \uD55C\uB2E4(\uD504\uB85C\uC81D\uD2B8 \uC2A4\uD06C\uB9BD\uD2B8).
|
|
461
461
|
- **\uC131\uACF5 \uD310\uC815**: \uD130\uBBF8\uB110\uC5D0 \uB85C\uCEEC \uC8FC\uC18C\uAC00 \uB728\uACE0, \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uBAA9\uB85D\xB7\uBBF8\uB9AC\uBCF4\uAE30\uAC00 \uBCF4\uC778\uB2E4.
|
|
462
|
-
- \uC0AC\uC6A9\uC790\uAC00 \uD654\uBA74\uC744 \uD655\uC778\uD55C \uB4A4, **\uB208\uC5D0 \uBCF4\uC774\uB294 \uBB38\uAD6C \uD558\uB098\uB97C \uBC14\uAFD4** \uC0C8\uB85C\uACE0\uCE68\uC73C\uB85C \
|
|
462
|
+
- \uC0AC\uC6A9\uC790\uAC00 \uD654\uBA74\uC744 \uD655\uC778\uD55C \uB4A4, **\uB208\uC5D0 \uBCF4\uC774\uB294 \uBB38\uAD6C \uD558\uB098\uB97C \uBC14\uAFD4** \uC0C8\uB85C\uACE0\uCE68\uC73C\uB85C \uBC14\uB00C\uB294 \uAC83\uAE4C\uC9C0 \uAC19\uC774 \uBCF8\uB2E4. \uC774 \uD55C \uBC88\uC73C\uB85C "\uACE0\uCE58\uBA74 \uBC14\uB85C \uBCF4\uC778\uB2E4"\uB294 \uAC10\uC774 \uC0DD\uAE34\uB2E4.
|
|
463
463
|
- \uC548 \uB728\uBA74 \uCD94\uCE21\uD558\uC9C0 \uB9D0\uACE0 \uD130\uBBF8\uB110 \uC624\uB958\uB97C \uC77D\uB294\uB2E4. \uD3EC\uD2B8 \uCDA9\uB3CC\uC774\uBA74 \uD3EC\uD2B8\uB97C \uBC14\uAFB8\uB294 \uC635\uC158\uC774 \uC788\uB2E4(\`bstage dev --help\`).
|
|
464
464
|
|
|
465
465
|
## 4. \uCEE4\uBC0B\uD558\uACE0 \uC6D0\uACA9\uC5D0 \uC62C\uB9B0\uB2E4
|
|
@@ -477,7 +477,7 @@ bstage dev
|
|
|
477
477
|
|
|
478
478
|
1. **\uB808\uD3EC \uC5F0\uACB0** \u2014 \uC2A4\uD14C\uC774\uC9C0 > \uB808\uD3EC > \uC0C8 \uB808\uD3EC \uC5F0\uACB0. \uC870\uC9C1\uC5D0\uC11C \uCC98\uC74C\uC774\uB77C\uBA74 GitHub \uC571 \uC124\uCE58\uAC00 \uD55C \uBC88 \uC120\uD589\uB41C\uB2E4(\uC870\uC9C1\uB2F9 1\uD68C).
|
|
479
479
|
|
|
480
|
-
**\
|
|
480
|
+
**\uCF58\uC194\uC740 \uC5F0\uACB0\uB9CC\uC73C\uB85C \uBE4C\uB4DC\uD558\uC9C0 \uC54A\uB294\uB2E4.** \uCCAB \uBE4C\uB4DC\uC640 \uD398\uC774\uC9C0 \uB9CC\uB4E4\uAE30\uB294 7\uB2E8\uACC4\uC5D0\uC11C CLI\uAC00 \uD55C\uB2E4(\`bstage placement create\`). \uC774 \uD654\uBA74 \uB2E8\uACC4\uB294 **\uC0C8 \uB808\uD3EC\uC5D0\uC11C \uCC98\uC74C \uD55C \uBC88\uB9CC** \uD544\uC694\uD558\uB2E4.
|
|
481
481
|
|
|
482
482
|
## 6. CLI\uB97C \uCF58\uC194\uC5D0 \uC5F0\uACB0\uD55C\uB2E4
|
|
483
483
|
|
|
@@ -490,24 +490,24 @@ bstage list
|
|
|
490
490
|
- \`bstage login\` \u2014 \uD130\uBBF8\uB110\uC5D0 \uCF54\uB4DC\uC640 \uC8FC\uC18C\uAC00 \uB728\uACE0 \uBE0C\uB77C\uC6B0\uC800\uAC00 \uC5F4\uB9B0\uB2E4. \uBE0C\uB77C\uC6B0\uC800\uB97C \uC5F4 \uC218 \uC5C6\uB294 \uD658\uACBD\uC774\uBA74 \uCF54\uB4DC\xB7\uC8FC\uC18C\uB9CC \uCD9C\uB825\uD558\uB294 \uC635\uC158\uC774 \uC788\uB2E4(\`--help\`). \uD1A0\uD070\uC740 \uC0AC\uC6A9\uC790 \uD648\uC758 \uC124\uC815 \uB514\uB809\uD130\uB9AC\uC5D0 \uC18C\uC720\uC790\uB9CC \uC77D\uC744 \uC218 \uC788\uB294 \uAD8C\uD55C\uC73C\uB85C \uC800\uC7A5\uB418\uACE0 \uD654\uBA74\uC5D0 \uCC0D\uD788\uC9C0 \uC54A\uB294\uB2E4.
|
|
491
491
|
- **1\uB2E8\uACC4 (c)\uC5D0\uC11C \uC815\uD55C phase\uAC00 sandbox\uAC00 \uC544\uB2C8\uBA74** \`bstage login\`\xB7\`bstage link\` \uB458 \uB2E4\uC5D0 \`--phase <phase>\`\uB97C \uC900\uB2E4. \uC0DD\uB7B5\uD558\uBA74 \uD504\uB85C\uC81D\uD2B8 \`.env\`\uC758 \uAC12\uC744, \uADF8\uAC83\uB3C4 \uC5C6\uC73C\uBA74 sandbox\uB97C \uC4F4\uB2E4 \u2014 liquid \uB808\uD3EC\uC5D0\uB294 \uC2A4\uCE90\uD3F4\uB4DC\uB41C \`.env\`\uAC00 \uC5C6\uC73C\uBBC0\uB85C \uC774 \uD50C\uB798\uADF8\uAC00 \uD2B9\uD788 \uC911\uC694\uD558\uB2E4. \uAE30\uBCF8 \uBAA9\uB85D \uBC16\uC758 \uCF58\uC194\uC774\uBA74 \`--portal\`\uB85C \uC8FC\uC18C\uB97C \uC9C1\uC811 \uC9C0\uC815\uD55C\uB2E4(\`bstage login --help\`).
|
|
492
492
|
- \`bstage link\` \u2014 \uD604\uC7AC \uB514\uB809\uD130\uB9AC\uB97C \uC870\uC9C1\xB7\uC2A4\uD14C\uC774\uC9C0\xB7\uB808\uD3EC\uC5D0 \uC5F0\uACB0\uD558\uACE0 \`.bstage/project.json\`\uC5D0 \uC801\uB294\uB2E4(\uC774 \uD30C\uC77C\uC740 gitignore\uB41C\uB2E4).
|
|
493
|
-
- **\uC131\uACF5 \uD310\uC815**: \`bstage list\`\uAC00 \uC774 \uB808\uD3EC\uC758 \uC870\uC9C1\xB7\uC2A4\uD14C\uC774\uC9C0\uB97C \uBCF4\uC5EC \uC900\uB2E4(\uC5F0\uACB0\uB41C \uB808\uD3EC\uB97C \uBABB \uCC3E\uC73C\uBA74 5\uB2E8\uACC4\uB85C \uB3CC\uC544\uAC04\uB2E4). \uC0C8 \uB808\uD3EC\uB77C\uBA74 \
|
|
493
|
+
- **\uC131\uACF5 \uD310\uC815**: \`bstage list\`\uAC00 \uC774 \uB808\uD3EC\uC758 \uC870\uC9C1\xB7\uC2A4\uD14C\uC774\uC9C0\uB97C \uBCF4\uC5EC \uC900\uB2E4(\uC5F0\uACB0\uB41C \uB808\uD3EC\uB97C \uBABB \uCC3E\uC73C\uBA74 5\uB2E8\uACC4\uB85C \uB3CC\uC544\uAC04\uB2E4). \uC0C8 \uB808\uD3EC\uB77C\uBA74 \uD398\uC774\uC9C0\uB294 \uC544\uC9C1 0\uAC74\uC774\uB2E4 \u2014 7\uB2E8\uACC4\uC5D0\uC11C \uB9CC\uB4E0\uB2E4.
|
|
494
494
|
|
|
495
|
-
## 7. \uD398\uC774\uC9C0
|
|
495
|
+
## 7. \uD398\uC774\uC9C0 \uB9CC\uB4E4\uAE30\uC640 \uCCAB \uBE4C\uB4DC \uC62C\uB9AC\uAE30
|
|
496
496
|
|
|
497
497
|
\`\`\`bash
|
|
498
|
-
bstage placement create --template <\
|
|
498
|
+
bstage placement create --template <\uD15C\uD50C\uB9BF \uC774\uB984> --path /<\uACBD\uB85C>
|
|
499
499
|
bstage deploy
|
|
500
500
|
\`\`\`
|
|
501
501
|
|
|
502
|
-
- \`bstage placement create\` \u2014 \uC774 \uB808\uD3EC\uC758 \
|
|
503
|
-
- \`bstage deploy\` \u2014 push\uB41C \uCEE4\uBC0B\uC744 \uCF58\uC194\uC774 \uBE4C\uB4DC\uD558\uACE0, \uBE4C\uB4DC\uAC00 \uB05D\uB098\uBA74 \uC774 \uB808\uD3EC\uC758 \
|
|
504
|
-
- \uB450 \uBA85\uB839 \uBAA8\uB450 \uAE30\uBCF8\uC73C\uB85C \uBB34\uC5C7\uC744 \uC5B4\uB514\uC5D0 \
|
|
505
|
-
- **\uC131\uACF5 \uD310\uC815**: \`bstage list\`\uC5D0 \
|
|
502
|
+
- \`bstage placement create\` \u2014 \uC774 \uB808\uD3EC\uC758 \uD15C\uD50C\uB9BF \uD558\uB098\uB97C \uD398\uC774\uC9C0\uB85C \uB9CC\uB4E0\uB2E4. \uC131\uACF5\uD55C \uBE4C\uB4DC\uAC00 \uC5C6\uC73C\uBA74 push\uB41C \uCEE4\uBC0B\uC73C\uB85C **\uBE4C\uB4DC\uBD80\uD130** \uD558\uACE0 \uB05D\uB098\uBA74 \uD398\uC774\uC9C0\uB97C \uB9CC\uB4E0\uB2E4. \`--template\`\uC740 sdk\uB294 \`src/pages/{\uC774\uB984}\`, liquid\uB294 \`public/{user|admin}/{\uC774\uB984}\`\uC758 \`{\uC774\uB984}\`\uC774\uACE0, \uACBD\uB85C(\uB77C\uC774\uBE0C URL)\uB294 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD655\uC778\uD55C\uB2E4. liquid\uB294 **\uD398\uC774\uC9C0(PAGE)\uB9CC** \uAC00\uB2A5\uD558\uB2E4. \uB2E4\uC2DC \uC2E4\uD589\uD574\uB3C4 \uAC19\uC740 \uD398\uC774\uC9C0\uB97C \uC911\uBCF5\uC73C\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uB294\uB2E4.
|
|
503
|
+
- \`bstage deploy\` \u2014 push\uB41C \uCEE4\uBC0B\uC744 \uCF58\uC194\uC774 \uBE4C\uB4DC\uD558\uACE0, \uBE4C\uB4DC\uAC00 \uB05D\uB098\uBA74 \uC774 \uB808\uD3EC\uC758 \uD398\uC774\uC9C0\xB7\uC704\uC82F\uC744 \uC0C8 \uBE4C\uB4DC\uB85C \uC5C5\uB370\uC774\uD2B8\uD55C\uB2E4. **\uB85C\uCEEC \uBE4C\uB4DC \uACB0\uACFC\uBB3C\uC744 \uC62C\uB9AC\uB294 \uAC83\uC774 \uC544\uB2C8\uB2E4.**
|
|
504
|
+
- \uB450 \uBA85\uB839 \uBAA8\uB450 \uAE30\uBCF8\uC73C\uB85C \uBB34\uC5C7\uC744 \uC5B4\uB514\uC5D0 \uC62C\uB9B4\uC9C0 \uBCF4\uC5EC\uC8FC\uACE0 \uD655\uC778\uC744 \uBB3B\uB294\uB2E4 \u2014 \uC0AC\uC6A9\uC790\uAC00 \uADF8 \uD654\uBA74\uC744 \uC9C1\uC811 \uBCF4\uAC8C \uD55C\uB2E4.
|
|
505
|
+
- **\uC131\uACF5 \uD310\uC815**: \`bstage list\`\uC5D0 \uD398\uC774\uC9C0\uAC00 1\uAC74 \uC774\uC0C1 \uBCF4\uC774\uACE0 \uC0C1\uD0DC\uAC00 \uB77C\uC774\uBE0C\uC774\uBA70, \uC2A4\uD14C\uC774\uC9C0 \uD654\uBA74\uC5D0\uC11C \uBC14\uB010 \uB0B4\uC6A9\uC774 \uBCF4\uC778\uB2E4.
|
|
506
506
|
- \uC790\uC138\uD55C \uADDC\uCE59(\uC2E4\uD328 \uB300\uC751\xB7\uB864\uBC31\xB7\uAC8C\uC2DC \uB044\uAE30\xB7CI)\uC740 \`bstage-deploy\` \uC2A4\uD0AC\uC5D0 \uC788\uB2E4.
|
|
507
507
|
|
|
508
508
|
## 8. \uC774\uD6C4 \uBC18\uBCF5 \uB8E8\uD504
|
|
509
509
|
|
|
510
|
-
\uACE0\uCE5C\uB2E4 \u2192 \uB85C\uCEEC\uC5D0\uC11C \uD655\uC778\uD55C\uB2E4(\`bstage dev\`) \u2192 \uCEE4\uBC0B\xB7push\uD55C\uB2E4 \u2192 \`bstage deploy\`. \uC0C8 \uD398\uC774\uC9C0\uB97C \uCD94\uAC00\uD588\uC73C\uBA74 push\uD55C \uB4A4 \`bstage placement create\`\uB85C \
|
|
510
|
+
\uACE0\uCE5C\uB2E4 \u2192 \uB85C\uCEEC\uC5D0\uC11C \uD655\uC778\uD55C\uB2E4(\`bstage dev\`) \u2192 \uCEE4\uBC0B\xB7push\uD55C\uB2E4 \u2192 \`bstage deploy\`. \uC0C8 \uD398\uC774\uC9C0\uB97C \uCD94\uAC00\uD588\uC73C\uBA74 push\uD55C \uB4A4 \`bstage placement create\`\uB85C \uD398\uC774\uC9C0\uB97C \uD558\uB098 \uB354 \uB9CC\uB4E4\uACE0 \`bstage deploy\`\uD55C\uB2E4. \uCF58\uC194 \uD654\uBA74\uC73C\uB85C \uB2E4\uC2DC \uAC08 \uC77C\uC740 **\uC704\uC82F(\uC2AC\uB86F) \uB9CC\uB4E4\uAE30\xB7\uD398\uC774\uC9C0\xB7\uC704\uC82F \uC0AD\uC81C\xB7\uC0C8 \uB808\uD3EC \uC5F0\uACB0**\uBFD0\uC774\uB2E4.
|
|
511
511
|
|
|
512
512
|
## 9. \uB9C9\uD614\uC744 \uB54C
|
|
513
513
|
|
|
@@ -517,25 +517,25 @@ bstage deploy
|
|
|
517
517
|
| --- | --- | --- |
|
|
518
518
|
| 0 | \uC131\uACF5 | - |
|
|
519
519
|
| 1 | \uC2E4\uD328 | \uBE4C\uB4DC \uB85C\uADF8 \uD655\uC778(\`bstage logs -f\`) |
|
|
520
|
-
| 2 | \uC0AC\uC804\uC870\uAC74 \uBBF8\uCDA9\uC871 | \uCEE4\uBC0B\xB7push\xB7\uBE0C\uB79C\uCE58\xB7\
|
|
520
|
+
| 2 | \uC0AC\uC804\uC870\uAC74 \uBBF8\uCDA9\uC871 | \uCEE4\uBC0B\xB7push\xB7\uBE0C\uB79C\uCE58\xB7\uD398\uC774\uC9C0 \uC720\uBB34\uB97C \uC810\uAC80(\uD398\uC774\uC9C0 0\uAC74\uC774\uBA74 \`bstage placement create\` \u2014 \uBA54\uC2DC\uC9C0\uAC00 \uBB34\uC5C7\uC774 \uBE60\uC84C\uB294\uC9C0 \uB9D0\uD574 \uC900\uB2E4) |
|
|
521
521
|
| 3 | \uC778\uC99D | \`bstage login\` \uB2E4\uC2DC |
|
|
522
|
-
| 4 | \uCDA9\uB3CC | \uB2E4\uB978 \uC0AC\uB78C\uC774 \uBA3C\uC800 \
|
|
522
|
+
| 4 | \uCDA9\uB3CC | \uB2E4\uB978 \uC0AC\uB78C\uC774 \uBA3C\uC800 \uC5C5\uB370\uC774\uD2B8\uD588\uB2E4 \u2014 \`bstage list\`\uB85C \uD604\uC7AC \uC0C1\uD0DC\uB97C \uBCF4\uACE0 \uB2E4\uC2DC \uD310\uB2E8 |
|
|
523
523
|
| 5 | \uC694\uCCAD \uC81C\uD55C | \uC7A0\uC2DC \uAE30\uB2E4\uB838\uB2E4 \uC7AC\uC2DC\uB3C4 |
|
|
524
524
|
|
|
525
525
|
\uADF8 \uBC16\uC758 \uC9C4\uB2E8:
|
|
526
526
|
|
|
527
|
-
- \`bstage doctor\` \u2014 SDK \uBC84\uC804 \
|
|
527
|
+
- \`bstage doctor\` \u2014 \uC124\uCE58\uB41C SDK \uBC84\uC804\uACFC \uCD5C\uC2E0 \uBC84\uC804\uC758 \uCC28\uC774\xB7\uB204\uB77D \uD30C\uC77C \uC9C4\uB2E8, \uB85C\uADF8\uC778\xB7\uB9C1\uD06C\uB3FC \uC788\uC73C\uBA74 \uD398\uC774\uC9C0\xB7\uC704\uC82F\uBCC4 \uCF58\uC194 \uC9C4\uB2E8\uAE4C\uC9C0. \uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC\uB294 \uACE0\uCE58\uC9C0 \uC54A\uC9C0\uB9CC \`--json\` \uC5C6\uC774 \uC2E4\uD589\uD558\uBA74 SDK\uAC00 \uAD00\uB9AC\uD558\uB294 \uC2A4\uD0AC\xB7\`AGENTS.md\` \uAD00\uB9AC \uC601\uC5ED\uC774 \uB4A4\uCC98\uC84C\uC744 \uB54C \`bstage ai install\`\uACFC \uAC19\uC740 \uB3D9\uAE30\uD654\uB97C \uC790\uB3D9\uC73C\uB85C \uD55C\uB2E4
|
|
528
528
|
- \`bstage ai doctor\` \u2014 \uC2A4\uD0AC\xB7\`AGENTS.md\`\uAC00 \uCD5C\uC2E0\uC778\uC9C0 \uD655\uC778(\uC624\uB798\uB410\uC73C\uBA74 \`bstage ai update\`)
|
|
529
529
|
- \`bstage logs -f\` \u2014 \uCD5C\uADFC \uBE4C\uB4DC \uB85C\uADF8\uB97C \uB05D\uAE4C\uC9C0 \uB530\uB77C\uAC00\uBA70 \uBCF8\uB2E4
|
|
530
530
|
|
|
531
531
|
# \uD558\uC9C0 \uB9D0 \uAC83
|
|
532
532
|
|
|
533
|
-
- \uCF58\uC194 \uD654\uBA74\uC5D0\uC11C\uB9CC \uB418\uB294 \uC77C(\uB808\uD3EC \uC5F0\uACB0\xB7\uC704\uC82F \
|
|
533
|
+
- \uCF58\uC194 \uD654\uBA74\uC5D0\uC11C\uB9CC \uB418\uB294 \uC77C(\uB808\uD3EC \uC5F0\uACB0\xB7\uC704\uC82F \uB9CC\uB4E4\uAE30\xB7\uD398\uC774\uC9C0\xB7\uC704\uC82F \uC0AD\uC81C)\uC744 CLI \uC635\uC158\uC73C\uB85C \uC6B0\uD68C\uD558\uB824 \uC2DC\uB3C4\uD558\uAE30
|
|
534
534
|
- \uC635\uC158 \uC774\uB984\uC744 \uAE30\uC5B5\uC73C\uB85C \uC9C0\uC5B4\uB0B4\uAE30 \u2014 \`--help\`\uB85C \uD655\uC778\uD55C\uB2E4
|
|
535
|
-
- \uC6D0\uACA9 push\xB7\
|
|
535
|
+
- \uC6D0\uACA9 push\xB7\uC5C5\uB370\uC774\uD2B8\uB97C \uC0AC\uC6A9\uC790 \uD655\uC778 \uC5C6\uC774 \uC2E4\uD589\uD558\uAE30
|
|
536
536
|
- \uC0AC\uC6A9\uC790\uC5D0\uAC8C "\uCF54\uB4DC\uAC00 \uB9DE\uB098\uC694"\uCC98\uB7FC \uAC1C\uBC1C \uC9C0\uC2DD\uC774 \uC788\uC5B4\uC57C \uB2F5\uD560 \uC218 \uC788\uB294 \uAC83\uC744 \uBB3B\uAE30 (\uD655\uC778\uC740 \uB124 \uBAAB)
|
|
537
|
-
- \`bstage list\`\uC5D0 \
|
|
538
|
-
- \uD63C\uD569 \uB808\uD3EC\uC5D0\uC11C sdk \uD398\uC774\uC9C0\uB97C \`src/pages/user\`\xB7\`src/pages/admin\` \uC544\uB798\uC5D0 \uB9CC\uB4E4\uAE30 \u2014 liquid \
|
|
537
|
+
- \`bstage list\`\uC5D0 \uD398\uC774\uC9C0\uAC00 0\uAC74\uC778\uB370 \`bstage placement create\` \uC5C6\uC774 \`bstage deploy\`\uB97C \uC2DC\uB3C4\uD558\uAE30
|
|
538
|
+
- \uD63C\uD569 \uB808\uD3EC\uC5D0\uC11C sdk \uD398\uC774\uC9C0\uB97C \`src/pages/user\`\xB7\`src/pages/admin\` \uC544\uB798\uC5D0 \uB9CC\uB4E4\uAE30 \u2014 liquid \uBE4C\uB4DC \uC790\uB9AC\uC640 \uACB9\uCE5C\uB2E4
|
|
539
539
|
`;
|
|
540
540
|
}
|
|
541
541
|
|
|
@@ -585,7 +585,7 @@ function meta(target) {
|
|
|
585
585
|
cssVarExample: "text/primary",
|
|
586
586
|
textStyleExample: "16/title/med",
|
|
587
587
|
shadowExample: "default-large",
|
|
588
|
-
themeNote: "\
|
|
588
|
+
themeNote: "\uC6B4\uC601\uC790 \uD654\uBA74\uC740 **\uB77C\uC774\uD2B8 \uC804\uC6A9**(\uB2E4\uD06C\uBAA8\uB4DC \uC5C6\uC74C)."
|
|
589
589
|
};
|
|
590
590
|
}
|
|
591
591
|
return {
|
|
@@ -650,13 +650,13 @@ description: b.stage \uC11C\uB4DC\uD30C\uD2F0 \uD15C\uD50C\uB9BF\uC744 \uC791\uC
|
|
|
650
650
|
|
|
651
651
|
# \uC5ED\uD560
|
|
652
652
|
|
|
653
|
-
\uC774 \uD504\uB85C\uC81D\uD2B8\uC5D0\uC11C b.stage \uD15C\uD50C\uB9BF\uC744 \uC791\uC131\uD55C\uB2E4. \uC791\uC131\uD55C React \uCEF4\uD3EC\uB10C\uD2B8\uB294 SDK\uAC00 Web Component\uB85C \uBE4C\uB4DC\uD574 \uD50C\uB7AB\uD3FC\uC5D0 \uB9C8\uC6B4\uD2B8\uD55C\uB2E4. \uC774 \uC2A4\uD0AC\uC740 **\uBAA9\uD45C\uC9C0\uD5A5 \uC808\uCC28 + \uD568\uC815**\uB9CC \uB2F4\uB294\uB2E4. \uC815\uD655\uD55C \uC2DC\uADF8\uB2C8\uCC98\uB294 \uD56D\uC0C1 \uC124\uCE58\uB41C docs/\uD0C0\uC785\uC744
|
|
653
|
+
\uC774 \uD504\uB85C\uC81D\uD2B8\uC5D0\uC11C b.stage \uD15C\uD50C\uB9BF\uC744 \uC791\uC131\uD55C\uB2E4. \uC791\uC131\uD55C React \uCEF4\uD3EC\uB10C\uD2B8\uB294 SDK\uAC00 Web Component\uB85C \uBE4C\uB4DC\uD574 \uD50C\uB7AB\uD3FC\uC5D0 \uB9C8\uC6B4\uD2B8\uD55C\uB2E4. \uC774 \uC2A4\uD0AC\uC740 **\uBAA9\uD45C\uC9C0\uD5A5 \uC808\uCC28 + \uD568\uC815**\uB9CC \uB2F4\uB294\uB2E4. \uC815\uD655\uD55C \uC2DC\uADF8\uB2C8\uCC98\uB294 \uD56D\uC0C1 \uC124\uCE58\uB41C docs/\uD0C0\uC785\uC744 \uAE30\uC900\uC73C\uB85C \uBCF8\uB2E4.
|
|
654
654
|
|
|
655
655
|
# \uAD8C\uC704 \uC788\uB294 \uCD9C\uCC98 (\uBA3C\uC800 \uC77D\uAE30)
|
|
656
656
|
|
|
657
657
|
\uCD94\uCE21\uD558\uC9C0 \uB9D0\uACE0 \uC124\uCE58\uB41C \uD328\uD0A4\uC9C0\uB97C \uBCF8\uB2E4. \uC678\uBD80 \uAC80\uC0C9\uBCF4\uB2E4 \uC2E0\uB8B0\uD560 \uC218 \uC788\uB2E4.
|
|
658
658
|
|
|
659
|
-
- \`node_modules/@bstage-sdk/core/docs/\` \u2014 GETTING_STARTED, API_REFERENCE,
|
|
659
|
+
- \`node_modules/@bstage-sdk/core/docs/\` \u2014 GETTING_STARTED, API_REFERENCE, SLOT_PROTOCOL\xB7SLOT_CATALOG_V2(\uD604\uD589 \uC2AC\uB86F \u2014 SLOT_CATALOG\xB7SLOT_SYSTEM\uC740 \uC61B \uBB38\uC11C), I18N, BUILD_SYSTEM, DEV_SERVER, DESIGN_TOKENS, SDK_ARCHITECTURE
|
|
660
660
|
- \uD0C0\uC785: \`node_modules/@bstage-sdk/react/dist/*.d.ts\`, \`node_modules/@bstage-sdk/core/dist/*.d.ts\`
|
|
661
661
|
- \uD504\uB85C\uC81D\uD2B8 \uADDC\uCE59: \uB808\uD3EC \uB8E8\uD2B8\uC758 \`AGENTS.md\`
|
|
662
662
|
- \uBB38\uC11C \uBAA9\uB85D: \`npx bstage docs\`
|
|
@@ -665,7 +665,7 @@ description: b.stage \uC11C\uB4DC\uD30C\uD2F0 \uD15C\uD50C\uB9BF\uC744 \uC791\uC
|
|
|
665
665
|
|
|
666
666
|
## 1. \uC0C8 \uD15C\uD50C\uB9BF \uCD94\uAC00
|
|
667
667
|
|
|
668
|
-
\uD398\uC774\uC9C0\uB294 \`src/pages/{\uACBD\uB85C}/template.tsx\`(\uD3F4\uB354 \uAD6C\uC870\uAC00 \uACE7 \
|
|
668
|
+
\uD398\uC774\uC9C0\uB294 \`src/pages/{\uACBD\uB85C}/template.tsx\`(\uD3F4\uB354 \uAD6C\uC870\uAC00 \uACE7 \uD398\uC774\uC9C0 \uACBD\uB85C), \uC704\uC82F\uC740 \`src/slots/{\uC544\uBB34 \uC774\uB984}/template.tsx\` + \`slot\` \uC635\uC158\uC73C\uB85C \uB9CC\uB4E0\uB2E4. \uD30C\uC77C\uBA85\uC740 \uBC18\uB4DC\uC2DC \`template.tsx\`(\uB77C\uC6B0\uD305\xB7\uBE4C\uB4DC\uAC00 \uC774 \uCEE8\uBCA4\uC158\uC73C\uB85C \uBC1C\uACAC). \`name\`\uC740 Custom Element \uD0DC\uADF8\uB85C \uADF8\uB300\uB85C \uC4F0\uC774\uBBC0\uB85C **\uC18C\uBB38\uC790 \uC2DC\uC791 + \uD558\uC774\uD508 1\uAC1C \uC774\uC0C1 + \uC18C\uBB38\uC790\xB7\uC22B\uC790\xB7\uD558\uC774\uD508\uB9CC**.
|
|
669
669
|
|
|
670
670
|
\`\`\`tsx
|
|
671
671
|
import { createTemplate } from '@bstage-sdk/react'
|
|
@@ -674,17 +674,26 @@ export default function MyWidget() {
|
|
|
674
674
|
return <div>...</div>
|
|
675
675
|
}
|
|
676
676
|
|
|
677
|
-
createTemplate(MyWidget, { name: 'my-widget' }) // Custom Element \uD0DC\uADF8\uBA85 \u2014 \uD558\uC774\uD508 \uD544\uC218, \uD15C\uD50C\uB9BF\uB9C8\uB2E4 \uACE0\uC720. \uD3F4\uB354\uBA85\uACFC \uAC19\uC744 \uD544\uC694 \uC5C6\uC74C(\
|
|
677
|
+
createTemplate(MyWidget, { name: 'my-widget' }) // Custom Element \uD0DC\uADF8\uBA85 \u2014 \uD558\uC774\uD508 \uD544\uC218, \uD15C\uD50C\uB9BF\uB9C8\uB2E4 \uACE0\uC720. \uD3F4\uB354\uBA85\uACFC \uAC19\uC744 \uD544\uC694 \uC5C6\uC74C(\uD398\uC774\uC9C0 \uACBD\uB85C\uB294 \uD3F4\uB354\uAC00 \uC815\uD55C\uB2E4)
|
|
678
678
|
\`\`\`
|
|
679
679
|
|
|
680
680
|
## 2. \uAE30\uB2A5\uBCC4 \uD6C5 (\uC2DC\uADF8\uB2C8\uCC98\uB294 API_REFERENCE.md / .d.ts \uD655\uC778)
|
|
681
681
|
|
|
682
682
|
- **\uD50C\uB7AB\uD3FC \uB124\uBE44\uAC8C\uC774\uC158**: \`useNavigation()\` \u2014 \`navigate\`/\`goBack\`/\`openExternal\`
|
|
683
683
|
- **\uD50C\uB7AB\uD3FC \uC774\uBCA4\uD2B8**: \`useBstageContext()\`\uC758 \`bridge\`\uB85C \`emit\`(\uD15C\uD50C\uB9BF\u2192\uD50C\uB7AB\uD3FC), \uAD6C\uB3C5\uC740 \`usePlatformEvent()\`(\uD50C\uB7AB\uD3FC\u2192\uD15C\uD50C\uB9BF)
|
|
684
|
-
- **API \uD638\uCD9C**: \`shared/client.ts\`\uC758 \`client\` \uC778\uC2A4\uD134\uC2A4\uB97C import\uD574 \uC9C1\uC811 \uD638\uCD9C(\`client.get<T>(...)\`).
|
|
684
|
+
- **API \uD638\uCD9C**: \`shared/client.ts\`\uC758 \`client\` \uC778\uC2A4\uD134\uC2A4\uB97C import\uD574 \uC9C1\uC811 \uD638\uCD9C\uD55C\uB2E4(\`client.get<T>(...)\`).
|
|
685
|
+
- \`BstageClient\`\uB294 \uC778\uC99D fetch\xB7\uAC8C\uC774\uD2B8\uC6E8\uC774 base URL\uC744 \uC2A4\uC2A4\uB85C \uD574\uC11D\uD558\uBBC0\uB85C \uBCC4\uB3C4 \uBC30\uC120\uC774 \uD544\uC694 \uC5C6\uB2E4.
|
|
686
|
+
- \uACBD\uB85C\xB7\uC751\uB2F5 \uBAA8\uC591\uC740 SDK\uAC00 \uB4E4\uACE0 \uC788\uC9C0 \uC54A\uB2E4. \uAC8C\uC774\uD2B8\uC6E8\uC774 API Reference Doc\uC774 \uCD9C\uCC98\uC774\uACE0, \uC751\uB2F5 \uD0C0\uC785\uC740 \uC81C\uB124\uB9AD\uC73C\uB85C \uBA85\uC2DC\uD55C\uB2E4(\uC0DD\uB7B5\uD558\uBA74 \`unknown\`).
|
|
687
|
+
- \uC6B4\uC601\uC790 \uD654\uBA74 \uD15C\uD50C\uB9BF\uB3C4 \uAC19\uC740 \uD074\uB77C\uC774\uC5B8\uD2B8\uB97C \uC4F4\uB2E4. \uC6B4\uC601\uC790 \uD654\uBA74 \uB3C4\uBA54\uC778\uC5D0\uC11C\uB294 \uC6B4\uC601\uC790 \uD654\uBA74 \uAC8C\uC774\uD2B8\uC6E8\uC774\uB97C \uBD80\uB974\uBA70, MANAGEMENT \uD0A4(\`bsm_\`)\uC640 \uC6B4\uC601\uC790 \uB85C\uADF8\uC778 \uC138\uC158\uC774 \uD544\uC694\uD558\uB2E4. PUBLIC \uD0A4\uB294 \`KEY_TYPE_NOT_ALLOWED\`\uB85C \uAC70\uBD80\uB41C\uB2E4. \uC0C1\uC138\uB294 GETTING_STARTED.md \xA78 "API \uD638\uCD9C".
|
|
688
|
+
- **\uBAA9\uB85D\uC5D0 \uC5C6\uB294 API\uB294 \uACBD\uB85C\uB97C \uCD94\uCE21\uD558\uC9C0 \uB9D0\uACE0 \uBC18\uB4DC\uC2DC \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBA3C\uC800 \uD655\uC778\uD560 \uAC83.**
|
|
685
689
|
- **\uC2AC\uB86F context**: \`useSlotContext<Id>()\` \u2014 \uD638\uC2A4\uD2B8\uAC00 \uB9C8\uC6B4\uD2B8 \uC2DC 1\uD68C \uC804\uB2EC\uD558\uB294 read-only \uAC12
|
|
686
|
-
- **\uB2E4\uAD6D\uC5B4**: \uB85C\uCF00\uC77C \uD6C5(\`useLocale\`/\`useMessages\`/\`useBstageTranslations\`)\uC740 **\uBC18\uB4DC\uC2DC \`<BstageLocaleProvider>\` \uD558\uC704\uC5D0\uC11C** \uD638\uCD9C\uD55C\uB2E4(\uBC16\uC774\uBA74 throw).
|
|
687
|
-
-
|
|
690
|
+
- **\uB2E4\uAD6D\uC5B4**: \uB85C\uCF00\uC77C \uD6C5(\`useLocale\`/\`useMessages\`/\`useBstageTranslations\`)\uC740 **\uBC18\uB4DC\uC2DC \`<BstageLocaleProvider>\` \uD558\uC704\uC5D0\uC11C** \uD638\uCD9C\uD55C\uB2E4(\uBC16\uC774\uBA74 throw).
|
|
691
|
+
- \uC0AC\uC6A9\uC790 \uD654\uBA74 \uD15C\uD50C\uB9BF\uC740 \`<BstageLocaleProvider>\`(target \uC0DD\uB7B5), \uC6B4\uC601\uC790 \uD654\uBA74 \uD15C\uD50C\uB9BF\uC740 \`<BstageLocaleProvider target="admin">\`.
|
|
692
|
+
- \uC790\uCCB4 \uBB38\uAD6C\uB294 \`useMessages\`(\uC900\uBE44 \uBD88\uD544\uC694). \uD604\uC7AC \uC5B8\uC5B4\uB9CC \uD544\uC694\uD558\uBA74 \`useLocale\`.
|
|
693
|
+
- \uD50C\uB7AB\uD3FC \uACF5\uC6A9 \uBB38\uAD6C\uB97C \uC4F0\uB824\uBA74 **\uBA3C\uC800 \`bstage i18n pull\`\uC744 \uC2E4\uD589**\uD574 \uBC88\uC5ED \uD0A4\xB7\uD0C0\uC785\xB7\uB85C\uCEEC \uCE90\uC2DC(\`.bstage/i18n\`)\uB97C \uB9CC\uB4E0 \uB4A4 \`useBstageTranslations\`\uB97C \uC4F4\uB2E4. \uC548 \uD558\uBA74 \uB85C\uCEEC dev\uC5D0\uC11C \uBC88\uC5ED\uC774 \uC548 \uB728\uACE0 \uD0A4\uB3C4 \uC54C \uC218 \uC5C6\uB2E4.
|
|
694
|
+
- pull \uB300\uC0C1\uC740 Provider \`target\`\uACFC \uAC19\uC740 \uCD95\uC774\uB2E4. \uC0AC\uC6A9\uC790 \uD654\uBA74 \uC2AC\uB86F \uD15C\uD50C\uB9BF\uC740 \`--target user\`(\uAE30\uBCF8, Bxxxxx), \uC6B4\uC601\uC790 \uD654\uBA74 \uC2AC\uB86F \uD15C\uD50C\uB9BF\uC740 \`--target admin\`(Axxxxx).
|
|
695
|
+
- \uC0C1\uC138 \uC6CC\uD06C\uD50C\uB85C\uB294 I18N.md.
|
|
696
|
+
- **\uB2E4\uAD6D\uC5B4 \uBB38\uAD6C \uBC30\uBD84 (\uC791\uC5C5 \uC804 \uACB0\uC815)**: "\uB2E4\uAD6D\uC5B4 \uCC98\uB9AC\uD574\uC918" \uB958 \uC694\uCCAD\uC744 \uBC1B\uC73C\uBA74 \uC804\uBD80 \`useMessages\`\uB85C \uB9CC\uB4E4\uC9C0 \uB9D0\uACE0, **\uD50C\uB7AB\uD3FC \uD0A4 \uB300\uC870\uBD80\uD130** \uD55C\uB2E4 \u2014 \`bstage i18n pull\` \uC2E4\uD589 \u2192 \uC0DD\uC131\uB41C \`src/bstage-i18n.ts\`\uC5D0\uC11C \uB300\uC0C1 \uBB38\uAD6C\uC758 \uC6D0\uBB38 \uAC80\uC0C9 \u2192 \uB9E4\uCE6D\uB418\uB294 \uD0A4\uAC00 \uC788\uC73C\uBA74 \uACF5\uC6A9 \uD0A4(\`useBstageTranslations\`), \uC5C6\uB294 \uBB38\uAD6C\uB9CC \`useMessages\`\uC5D0 \uCD94\uAC00. \uC800\uC7A5\xB7\uCDE8\uC18C\xB7\uC801\uC6A9\uD558\uAE30 \uAC19\uC740 \uACF5\uC6A9 UI \uB77C\uBCA8\uC740 \uB300\uBD80\uBD84 \uD50C\uB7AB\uD3FC \uD0A4\uAC00 \uC774\uBBF8 \uC788\uB2E4. \uACF5\uC6A9 \uD0A4\uAC00 \uC788\uB294 \uBB38\uAD6C\uB97C \`useMessages\`\uC5D0 \uBCF5\uC0AC\uD574 \uB36E\uC5B4\uC4F0\uBA74 \uD50C\uB7AB\uD3FC \uBC88\uC5ED\uC744 \uACE0\uCCD0\uB3C4 \uD15C\uD50C\uB9BF\uC5D0\uB294 \uBC14\uB00C\uC9C0 \uC54A\uB294\uB2E4(\uD63C\uC6A9 \uD328\uD134\uC740 I18N.md).
|
|
688
697
|
|
|
689
698
|
## 3. \uB514\uC790\uC778 \uD1A0\uD070 (\uC0C9\xB7\uD0C0\uC774\uD3EC\xB7\uADF8\uB9BC\uC790)
|
|
690
699
|
|
|
@@ -693,16 +702,16 @@ ${designGuideSection(target)}
|
|
|
693
702
|
## 4. \uB85C\uCEEC \uC2E4\uD589 / \uBE4C\uB4DC
|
|
694
703
|
|
|
695
704
|
- \`npm run dev\` \u2014 \uC778\uC99D \uD504\uB85D\uC2DC \uD3EC\uD568 \uAC1C\uBC1C \uC11C\uBC84. \uB85C\uADF8\uC778: http://localhost:5173/__bstage__/login
|
|
696
|
-
- \
|
|
705
|
+
- \uBE4C\uB4DC \uACB0\uACFC\uBB3C \uD655\uC778: \`npx bstage build\` \u2192 \uD398\uC774\uC9C0\uB294 \`dist/{\uACBD\uB85C}/template.js\`, \uC704\uC82F\uC740 \`dist/{\uC2AC\uB86F id}/template.js\` (\uC5C5\uB370\uC774\uD2B8\uB294 \`bstage deploy\` \u2014 bstage-deploy \uC2A4\uD0AC \uCC38\uC870)
|
|
697
706
|
|
|
698
707
|
# \uD568\uC815 (SDK \uC124\uACC4 \uC81C\uC57D \u2014 \uC5B4\uAE30\uBA74 \uB7F0\uD0C0\uC784\xB7\uBE4C\uB4DC\uAC00 \uAE68\uC9D0)
|
|
699
708
|
|
|
700
|
-
- **CSS\uB294 Shadow DOM \uC548\uC73C\uB85C \uB123\uC5B4\uC57C \uD55C\uB2E4**: \uD15C\uD50C\uB9BF\uC740 Shadow DOM\uC5D0 \uB9C8\uC6B4\uD2B8\uB41C\uB2E4. **\`import './style.css'\`\uB294 \
|
|
709
|
+
- **CSS\uB294 Shadow DOM \uC548\uC73C\uB85C \uB123\uC5B4\uC57C \uD55C\uB2E4**: \uD15C\uD50C\uB9BF\uC740 Shadow DOM\uC5D0 \uB9C8\uC6B4\uD2B8\uB41C\uB2E4. **\`import './style.css'\`\uB294 \uCF58\uC194\uC774 \uB9CC\uB4E0 \uBE4C\uB4DC\uC5D0\uC11C \uC870\uC6A9\uD788 \uC0AC\uB77C\uC9C4\uB2E4** \u2014 \uB85C\uCEEC \uAC1C\uBC1C \uD654\uBA74\uC5D0\uC11C\uB294 \uC801\uC6A9\uB418\uBBC0\uB85C "\uB85C\uCEEC\uC5D0\uC120 \uB418\uB294\uB370 \uAC8C\uC2DC\uD558\uBA74 \uC2A4\uD0C0\uC77C\uC774 \uC5C6\uB2E4"\uB85C \uB098\uD0C0\uB09C\uB2E4. \uC4F8 \uC218 \uC788\uB294 \uAC74 \uB458\uBFD0\uC774\uB2E4: \u2460 \`createTemplate\`\uC758 \`styles\` \uC635\uC158(\`import css from './x.css?inline'\`) \u2461 \uCEF4\uD3EC\uB10C\uD2B8 \uC548 \`<style>{cssText}</style>\`. inline \`style={{}}\`\uB3C4 \uBB3C\uB860 \uB41C\uB2E4. \uC804\uC5ED CSS(\`<link>\`)\uB294 \uAE08\uC9C0.
|
|
701
710
|
- **IIFE \uB2E8\uC77C \uBC88\uB4E4**: \uBC88\uB4E4\uC740 \uD56D\uC0C1 \uB2E8\uC77C IIFE. \uCF54\uB4DC \uC2A4\uD50C\uB9BF\xB7\uB3D9\uC801 \`import()\` \uBD88\uAC00.
|
|
702
711
|
- **\`__bstage_fetch__\` \uACC4\uC57D**: \uD50C\uB7AB\uD3FC\uC774 \uC778\uC99D fetch\uB97C \uC804\uC5ED\uC73C\uB85C \uC8FC\uC785\uD55C\uB2E4. \`BstageClient\`\uAC00 \uC774\uB97C \uC6B0\uC120 \uC0AC\uC6A9\uD558\uBBC0\uB85C, fetch \uACBD\uB85C\uB97C \uC6B0\uD68C\uD558\uC9C0 \uB9D0 \uAC83.
|
|
703
712
|
- **\`slot.context\`\uB294 \uB2E8\uBC29\uD5A5\xB7read-only**: \uD638\uC2A4\uD2B8\u2192\uC704\uC82F 1\uD68C \uC804\uB2EC. \uC704\uC82F\uC774 \uB418\uB3CC\uB824 \uC4F0\uC9C0 \uC54A\uB294\uB2E4.
|
|
704
713
|
- **\`createTemplate()\` \uD638\uCD9C \uD615\uD0DC \uC720\uC9C0**: \uBE4C\uB4DC \uD30C\uC774\uD504\uB77C\uC778\uC774 \uC18C\uC2A4\uC5D0\uC11C \`createTemplate(\` \uD638\uCD9C\uC744 \uD30C\uC2F1\uD574 \uBA54\uD0C0\uB370\uC774\uD130\uB97C \uBF51\uB294\uB2E4. \uC778\uC790 \uAD6C\uC870\uB97C \uC784\uC758 \uBCC0\uD615\uD558\uBA74 \uD30C\uC2F1 \uC2E4\uD328.
|
|
705
|
-
- **\uD398\uC774\uC9C0 \uD3F4\uB354 \`user\`\xB7\`admin\`\uC740 \uC608\uC57D\uC774\uB2E4**: \uC774 \uB808\uD3EC\uC5D0 liquid \uD15C\uD50C\uB9BF(\`public/{user|admin}/{\uC774\uB984}/template.liquid\`)\uC774 \uD568\uAED8 \uC788\uC73C\uBA74 \`src/pages/user/\u2026\`\xB7\`src/pages/admin/\u2026
|
|
714
|
+
- **\uD398\uC774\uC9C0 \uD3F4\uB354 \`user\`\xB7\`admin\`\uC740 \uC608\uC57D\uC774\uB2E4**: \uC774 \uB808\uD3EC\uC5D0 liquid \uD15C\uD50C\uB9BF(\`public/{user|admin}/{\uC774\uB984}/template.liquid\`)\uC774 \uD568\uAED8 \uC788\uC73C\uBA74 \`src/pages/user/\u2026\`\xB7\`src/pages/admin/\u2026\`\uC740 \uB9CC\uB4E4 \uC218 \uC5C6\uB2E4(\uB300\uC18C\uBB38\uC790 \uBB34\uC2DC). \uD398\uC774\uC9C0 \uBE4C\uB4DC \uACB0\uACFC\uBB3C\uC774 \`dist/{\uD3F4\uB354 \uACBD\uB85C}/\`\uB85C \uB098\uAC00 liquid \uC790\uB9AC\uC640 \uAC19\uC740 \uD2B8\uB9AC\uC5D0 \uB193\uC774\uACE0, \uD55C \uB514\uB809\uD130\uB9AC\uC5D0 \uB450 \uC885\uB958\uAC00 \uB193\uC774\uBA74 \uCF58\uC194\uC774 sdk\uB85C\uB9CC \uD310\uC815\uD574 liquid\uAC00 \uC870\uC6A9\uD788 \uC0AC\uB77C\uC9C4\uB2E4. \`bstage build\`\uC640 \uCF58\uC194 \uBE4C\uB4DC\uAC00 \uC885\uB8CC \uCF54\uB4DC 2\uB85C \uB9C9\uB294\uB2E4. \uC704\uC82F(\`src/slots\`)\uC740 \uC2AC\uB86F id\uB85C \uB098\uAC00\uBBC0\uB85C \uD574\uB2F9 \uC5C6\uB2E4. liquid \uD15C\uD50C\uB9BF\uC774 \uC5C6\uB294 \uB808\uD3EC\uC5D0\uC11C\uB294 \uC81C\uC57D\uC774 \uC5C6\uC9C0\uB9CC, \uB098\uC911\uC5D0 \uCD94\uAC00\uD558\uBA74 \uADF8\uB54C \uB9C9\uD788\uBBC0\uB85C \uCC98\uC74C\uBD80\uD130 \uB2E4\uB978 \uC774\uB984\uC744 \uC4F4\uB2E4.
|
|
706
715
|
|
|
707
716
|
# \uD558\uC9C0 \uB9D0 \uAC83
|
|
708
717
|
|
|
@@ -710,7 +719,7 @@ ${designGuideSection(target)}
|
|
|
710
719
|
- \`customElements.define()\` / \`attachShadow\` \uC9C1\uC811 \uD638\uCD9C (createTemplate\uC774 \uCC98\uB9AC)
|
|
711
720
|
- \`@bstage-sdk/core\`\uC758 \`createWebComponent()\` \uC9C1\uC811 \uC0AC\uC6A9 \u2014 react \uD328\uD0A4\uC9C0 API\uB9CC
|
|
712
721
|
- UI \uC0C9\xB7\uD0C0\uC774\uD3EC\xB7\uADF8\uB9BC\uC790\uB97C hex/rgb\uB85C \uD558\uB4DC\uCF54\uB529 \u2014 \uB514\uC790\uC778 \uD1A0\uD070(\uC704 3\uBC88) \uC0AC\uC6A9
|
|
713
|
-
- liquid \uD15C\uD50C\uB9BF\uC774 \uD568\uAED8 \uC788\uB294 \uB808\uD3EC\uC5D0\uC11C \`src/pages/user\`\xB7\`src/pages/admin\` \uB9CC\uB4E4\uAE30 \u2014 liquid \
|
|
722
|
+
- liquid \uD15C\uD50C\uB9BF\uC774 \uD568\uAED8 \uC788\uB294 \uB808\uD3EC\uC5D0\uC11C \`src/pages/user\`\xB7\`src/pages/admin\` \uB9CC\uB4E4\uAE30 \u2014 liquid \uBE4C\uB4DC \uC790\uB9AC\uC640 \uACB9\uCE5C\uB2E4(\uC704 \uD568\uC815)
|
|
714
723
|
- \uC2DC\uADF8\uB2C8\uCC98\uB97C \uAE30\uC5B5\uC5D0 \uC758\uC874\uD574 \uCD94\uCE21 \u2014 \uC704 docs/.d.ts\uC5D0\uC11C \uD655\uC778
|
|
715
724
|
`;
|
|
716
725
|
}
|
|
@@ -737,7 +746,7 @@ function skillsFor(kind) {
|
|
|
737
746
|
}
|
|
738
747
|
|
|
739
748
|
// src/agents/agentsMdRegion.ts
|
|
740
|
-
var AGENTS_MANAGED_VERSION =
|
|
749
|
+
var AGENTS_MANAGED_VERSION = 18;
|
|
741
750
|
var START_MARKER = `<!-- BSTAGE:MANAGED:START v=${AGENTS_MANAGED_VERSION} \u2014 SDK\uAC00 \uAD00\uB9AC\uD558\uB294 \uC601\uC5ED\uC785\uB2C8\uB2E4. \`bstage ai install\` / \`bstage ai update\`\uAC00 \uC7AC\uC0DD\uC131\uD558\uBBC0\uB85C \uC9C1\uC811 \uD3B8\uC9D1\uD558\uC9C0 \uB9C8\uC138\uC694(\uAC31\uC2E0 \uC2DC \uB36E\uC5B4\uC4F0\uC785\uB2C8\uB2E4). \uD504\uB85C\uC81D\uD2B8 \uACE0\uC720 \uADDC\uCE59\uC740 \uC544\uB798 \uC790\uC720 \uC601\uC5ED\uC5D0 \uC801\uC73C\uC138\uC694. -->`;
|
|
742
751
|
var END_MARKER = `<!-- BSTAGE:MANAGED:END -->`;
|
|
743
752
|
var START_TOKEN = "BSTAGE:MANAGED:START";
|
|
@@ -825,9 +834,9 @@ function parseAgentsIdentity(content) {
|
|
|
825
834
|
function deploySection() {
|
|
826
835
|
return `## \uBC30\uD3EC
|
|
827
836
|
|
|
828
|
-
- \uCF58\uC194\uC740 **\uC6D0\uACA9 \uC800\uC7A5\uC18C \uAE30\uBCF8 \uBE0C\uB79C\uCE58\uC5D0 push\uB41C \uCEE4\uBC0B**\uC744 \uBE4C\uB4DC\uD55C\uB2E4. \uB85C\uCEEC \
|
|
829
|
-
- \
|
|
830
|
-
- \`bstage list\`\uC5D0 \
|
|
837
|
+
- \uCF58\uC194\uC740 **\uC6D0\uACA9 \uC800\uC7A5\uC18C \uAE30\uBCF8 \uBE0C\uB79C\uCE58\uC5D0 push\uB41C \uCEE4\uBC0B**\uC744 \uBE4C\uB4DC\uD55C\uB2E4. \uB85C\uCEEC \uBE4C\uB4DC \uACB0\uACFC\uBB3C\uC744 \uC62C\uB9AC\uB294 \uAC83\uC774 \uC544\uB2C8\uBBC0\uB85C, \uCEE4\uBC0B\xB7push\uD558\uC9C0 \uC54A\uC740 \uBCC0\uACBD\uC740 \uBE4C\uB4DC\uC5D0 \uB4E4\uC5B4\uAC00\uC9C0 \uC54A\uB294\uB2E4.
|
|
838
|
+
- \uC0C8 \uBE4C\uB4DC\uB85C \uC5C5\uB370\uC774\uD2B8\uD558\uB824\uBA74 \`bstage deploy\` \u2014 \uBE4C\uB4DC \uD2B8\uB9AC\uAC70 \u2192 \uC644\uB8CC \uB300\uAE30 \u2192 \uC774 \uB808\uD3EC\uC758 \uD398\uC774\uC9C0\xB7\uC704\uC82F\uC744 \uC0C8 \uBE4C\uB4DC\uB85C \uC5C5\uB370\uC774\uD2B8\uAE4C\uC9C0 \uD55C \uBC88\uC5D0 \uD55C\uB2E4.
|
|
839
|
+
- \`bstage list\`\uC5D0 \uD398\uC774\uC9C0\uAC00 0\uAC74\uC774\uBA74 \`bstage placement create --template <\uD15C\uD50C\uB9BF \uC774\uB984>\`\uC73C\uB85C \uD398\uC774\uC9C0\uB97C \uBA3C\uC800 \uB9CC\uB4E0\uB2E4(\uC131\uACF5\uD55C \uBE4C\uB4DC\uAC00 \uC5C6\uC73C\uBA74 \uBE4C\uB4DC\uBD80\uD130 \uD55C\uB2E4). \uB808\uD3EC \uC5F0\uACB0\xB7\uC704\uC82F(\uC2AC\uB86F) \uB9CC\uB4E4\uAE30\xB7\uD398\uC774\uC9C0\xB7\uC704\uC82F \uC0AD\uC81C\uB294 **\uCF58\uC194 \uD654\uBA74\uC5D0\uC11C\uB9CC** \uAC00\uB2A5\uD558\uB2E4.
|
|
831
840
|
- \uB864\uBC31(\`bstage rollback\`)\xB7\uAC8C\uC2DC \uB044\uAE30(\`bstage publish off\`)\xB7\uC2E4\uD328 \uB300\uC751\xB7CI \uC0AC\uC6A9\uC740 \`bstage-deploy\` \uC2A4\uD0AC\uC744 \uB530\uB978\uB2E4.`;
|
|
832
841
|
}
|
|
833
842
|
function agentsManagedBody({
|
|
@@ -850,23 +859,23 @@ var SDK_STRUCTURE_BLOCK = `src/
|
|
|
850
859
|
main.tsx \u2014 App \uB9C8\uC6B4\uD2B8\uB9CC (\uC218\uC815 \uBD88\uD544\uC694)
|
|
851
860
|
App.tsx \u2014 import.meta.glob \uAE30\uBC18 \uAC1C\uBC1C\uC6A9 \uBAA9\uB85D\xB7\uB77C\uC6B0\uD305 (\uC218\uC815 \uBD88\uD544\uC694)
|
|
852
861
|
shared/
|
|
853
|
-
client.ts \u2014 BstageClient \uC778\uC2A4\uD134\uC2A4 (API \uD0A4\uB294 .env\uC5D0\uC11C \uC8FC\uC785 \u2014 \
|
|
862
|
+
client.ts \u2014 BstageClient \uC778\uC2A4\uD134\uC2A4 (API \uD0A4\uB294 .env\uC5D0\uC11C \uC8FC\uC785 \u2014 \uC0AC\uC6A9\uC790 \uD654\uBA74 \uB808\uD3EC\uB294 PUBLIC bsp_, \uC6B4\uC601\uC790 \uD654\uBA74 \uB808\uD3EC\uB294 MANAGEMENT bsm_)
|
|
854
863
|
pages/
|
|
855
864
|
{\uACBD\uB85C}/
|
|
856
|
-
template.tsx \u2014 \uD398\uC774\uC9C0 (\uD3F4\uB354 \uAD6C\uC870\uAC00 \uACE7 \
|
|
865
|
+
template.tsx \u2014 \uD398\uC774\uC9C0 (\uD3F4\uB354 \uAD6C\uC870\uAC00 \uACE7 \uD398\uC774\uC9C0 \uACBD\uB85C)
|
|
857
866
|
slots/
|
|
858
867
|
{\uC544\uBB34 \uC774\uB984}/
|
|
859
868
|
template.tsx \u2014 \uC704\uC82F (createTemplate\uC758 slot \uC635\uC158\uC774 \uC790\uB9AC\uB97C \uC815\uD568)
|
|
860
869
|
.env \u2014 VITE_BSTAGE_PHASE + API \uD0A4 (\uCEE4\uBC0B \uC548 \uB428, .gitignore)
|
|
861
|
-
.env.example \u2014 \uC704 \uD56D\uBAA9
|
|
870
|
+
.env.example \u2014 \uC704 \uD56D\uBAA9\uC758 \uC790\uB9AC\uD45C\uC2DC\uC790 \uAC12 (\uCEE4\uBC0B\uB428 \u2014 \uBCF5\uC0AC\uD574\uC11C .env \uC0DD\uC131)
|
|
862
871
|
vite.config.ts \u2014 Vite + bstageDevPlugin (phase\uB294 .env\uC5D0\uC11C \uC77D\uC74C)`;
|
|
863
|
-
var SDK_ENV_SECTION = `\`.env\`(\uCEE4\uBC0B \uC548 \uB428)\uB294 phase\uC640 API \uD0A4\uB97C, \`.env.example\`(\uCEE4\uBC0B\uB428)\uC740 \uADF8
|
|
872
|
+
var SDK_ENV_SECTION = `\`.env\`(\uCEE4\uBC0B \uC548 \uB428)\uB294 phase\uC640 API \uD0A4\uB97C, \`.env.example\`(\uCEE4\uBC0B\uB428)\uC740 \uADF8 \uC790\uB9AC\uD45C\uC2DC\uC790 \uAC12\uC744 \uB2F4\uB294\uB2E4. \`client.ts\`\uB294 \`import.meta.env.VITE_BSTAGE_APP_*\`\uB97C, \`vite.config.ts\`\uB294 \`.env\`\uC758 phase\uB97C \uCC38\uC870\uD55C\uB2E4.
|
|
864
873
|
|
|
865
874
|
\`\`\`
|
|
866
875
|
VITE_BSTAGE_PHASE=dev # dev | qa | real | sandbox
|
|
867
876
|
\`\`\``;
|
|
868
877
|
var SDK_API_FORBID_BULLETS = `- \uACBD\uB85C\xB7\uC751\uB2F5 \uBAA8\uC591\uC744 \uCD94\uCE21\uD574 \uD638\uCD9C\uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 SDK\uB294 API \uACBD\uB85C \uBAA9\uB85D\uC744 \uB4E4\uACE0 \uC788\uC9C0 \uC54A\uB2E4(\uC790\uB3D9\uC644\uC131 \uC5C6\uC74C). \uCD9C\uCC98\uB294 \uAC8C\uC774\uD2B8\uC6E8\uC774 API Reference Doc\uC774\uACE0, \uC751\uB2F5 \uD0C0\uC785\uC740 \`client.get<T>(...)\`\uCC98\uB7FC \uC81C\uB124\uB9AD\uC73C\uB85C \uBA85\uC2DC\uD55C\uB2E4.
|
|
869
|
-
- \
|
|
878
|
+
- \uC6B4\uC601\uC790 \uD654\uBA74 API\uB3C4 \uAC19\uC740 \`BstageClient\`\uB85C \uBD80\uB978\uB2E4 \u2014 \uC6B4\uC601\uC790 \uD654\uBA74 \uB3C4\uBA54\uC778\uC5D0 \uC784\uBCA0\uB4DC\uB418\uBA74 \`baseUrl\` \uAE30\uBCF8\uAC12\uC774 \uC6B4\uC601\uC790 \uD654\uBA74 \uAC8C\uC774\uD2B8\uC6E8\uC774(\`/gw\`)\uAC00 \uB418\uACE0, \uAC8C\uC774\uD2B8\uC6E8\uC774\uAC00 \uC6B4\uC601\uC790 \uB85C\uADF8\uC778 \uCFE0\uD0A4\uC640 **MANAGEMENT \uD0A4(\`bsm_\`)**\uB97C \uD568\uAED8 \uD655\uC778\uD55C\uB2E4(PUBLIC \uD0A4\uB294 \`KEY_TYPE_NOT_ALLOWED\`, \uB85C\uCEEC dev\xB7\uCF58\uC194 \uBBF8\uB9AC\uBCF4\uAE30\uC5D0\uC11C\uB294 \uC751\uB2F5\uC774 \uC624\uC9C0 \uC54A\uB294\uB2E4). \uC5B4\uB290 \uCABD\uC774\uB4E0 **\uCF58\uC194 API \uB808\uD37C\uB7F0\uC2A4(\uC0AC\uC6A9\uC790/\uC6B4\uC601\uC790 \uD0ED)\uC5D0 \uC788\uB294 \uACBD\uB85C\uB9CC** \uC4F0\uACE0, \uBAA9\uB85D\uC5D0 \uC5C6\uB294 API\uAC00 \uD544\uC694\uD558\uBA74 \uACBD\uB85C\uB97C \uC784\uC758\uB85C \uB9CC\uB4E4\uC9C0 \uB9D0\uACE0 **\uBC18\uB4DC\uC2DC \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBA3C\uC800 \uD655\uC778**\uD55C\uB2E4. \uC0C1\uC138\uB294 GETTING_STARTED.md "8. \uC6B4\uC601\uC790 \uD654\uBA74 \uD15C\uD50C\uB9BF \u203A API \uD638\uCD9C".`;
|
|
870
879
|
var SDK_DOCS_SECTION = `## SDK \uBB38\uC11C
|
|
871
880
|
|
|
872
881
|
SDK\uC758 API, hooks, \uC2AC\uB86F \uC2DC\uC2A4\uD15C, \uBE4C\uB4DC \uD30C\uC774\uD504\uB77C\uC778 \uB4F1 **SDK\uC640 \uAD00\uB828\uB41C \uBAA8\uB4E0 \uB0B4\uC6A9**\uC740 \uC124\uCE58\uB41C \uD328\uD0A4\uC9C0\uC758 \uBB38\uC11C\uB97C \uCC38\uC870\uD55C\uB2E4. \uC774 \uBB38\uC11C\uB4E4\uC774 \uD56D\uC0C1 \uCD5C\uC2E0\uC774\uBA70 \uC678\uBD80 \uAC80\uC0C9 \uACB0\uACFC\uBCF4\uB2E4 \uC2E0\uB8B0\uD560 \uC218 \uC788\uB2E4.
|
|
@@ -878,10 +887,14 @@ node_modules/@bstage-sdk/core/docs/
|
|
|
878
887
|
\u251C\u2500\u2500 I18N.md \u2014 \uB2E4\uAD6D\uC5B4 \uD6C5 + bstage i18n pull (\uBC88\uC5ED \uCF54\uB4DC\uC820) \uC6CC\uD06C\uD50C\uB85C
|
|
879
888
|
\u251C\u2500\u2500 DESIGN_TOKENS.md \u2014 \uB514\uC790\uC778 \uD1A0\uD070 (\uC0C9\xB7\uD0C0\uC774\uD3EC\xB7\uADF8\uB9BC\uC790) \uC0AC\uC6A9 \uAC00\uC774\uB4DC
|
|
880
889
|
\u251C\u2500\u2500 SLOT_PROTOCOL.md \u2014 \uC2AC\uB86F \uC2DC\uC2A4\uD15C v1 \uD504\uB85C\uD1A0\uCF5C (3-part \uD0A4\xB7context \uB2E8\uBC29\uD5A5)
|
|
881
|
-
\u251C\u2500\u2500
|
|
882
|
-
\u251C\u2500\u2500
|
|
883
|
-
\u251C\u2500\u2500
|
|
890
|
+
\u251C\u2500\u2500 SLOT_CATALOG_V2.md \u2014 \uD604\uD589 \uC2AC\uB86F \uCE74\uD0C8\uB85C\uADF8 (\uD0A4\xB7anchor\xB7context \uACC4\uC57D) \u2014 \uC704\uC82F \uC791\uC5C5\uC740 \uC774 \uBB38\uC11C \uAE30\uC900
|
|
891
|
+
\u251C\u2500\u2500 SLOT_CATALOG.md \u2014 (\uC61B, \uCC38\uC870\uC6A9) \uC61B \uC2AC\uB86F \uBAA9\uB85D\xB7\uC774\uBCA4\uD2B8
|
|
892
|
+
\u251C\u2500\u2500 SLOT_SYSTEM.md \u2014 (\uC61B, \uCC38\uC870\uC6A9) \uC61B \uC2AC\uB86F \uC2DC\uC2A4\uD15C \uC124\uACC4
|
|
893
|
+
\u251C\u2500\u2500 BUILD_SYSTEM.md \u2014 \uBE4C\uB4DC \uD30C\uC774\uD504\uB77C\uC778, \uBE4C\uB4DC \uACBD\uB85C \uADDC\uCE59
|
|
884
894
|
\u251C\u2500\u2500 DEV_SERVER.md \u2014 \uB85C\uCEEC \uAC1C\uBC1C \uC11C\uBC84, \uC778\uC99D \uD504\uB85D\uC2DC
|
|
895
|
+
\u251C\u2500\u2500 INIT.md \u2014 bstage init \uBA85\uB839 \uC0C1\uC138
|
|
896
|
+
\u251C\u2500\u2500 LIQUID.md \u2014 liquid \uD15C\uD50C\uB9BF \uB808\uD3EC \uAC00\uC774\uB4DC (\uD63C\uD569 \uB808\uD3EC \uD3EC\uD568)
|
|
897
|
+
\u251C\u2500\u2500 AI_TOOLKIT.md \u2014 \uC5D0\uC774\uC804\uD2B8\uC6A9 \uC2A4\uD0AC\xB7AGENTS.md\uC640 bstage ai \uBA85\uB839
|
|
885
898
|
\u251C\u2500\u2500 MIGRATION.md \u2014 \uBC84\uC804 \uC0AC\uC774 \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uAC00\uC774\uB4DC (bstage doctor \uC5F0\uACC4)
|
|
886
899
|
\u2514\u2500\u2500 SDK_ARCHITECTURE.md \u2014 \uD328\uD0A4\uC9C0 \uAD6C\uC870, \uC124\uACC4 \uACB0\uC815
|
|
887
900
|
\`\`\`
|
|
@@ -892,8 +905,8 @@ function sdkTemplateRules(space) {
|
|
|
892
905
|
|
|
893
906
|
\uD398\uC774\uC9C0\uB0D0 \uC704\uC82F\uC774\uB0D0\uC5D0 \uB530\uB77C \uB450\uB294 \uACF3\uC774 \uB2E4\uB974\uB2E4. \uD30C\uC77C\uBA85\uC740 \uBC18\uB4DC\uC2DC \`template.tsx\`\uC5EC\uC57C \uD558\uBA70, \`src/pages/\`\xB7\`src/slots/\` \uBC16\uC5D0 \uB450\uBA74 \uBE4C\uB4DC\uAC00 \uC778\uC2DD\uD558\uC9C0 \uC54A\uB294\uB2E4.
|
|
894
907
|
|
|
895
|
-
- **\uD398\uC774\uC9C0** \u2014 \`src/pages/{\uACBD\uB85C}/template.tsx\`. **\uD3F4\uB354 \uAD6C\uC870\uAC00 \uACE7 \
|
|
896
|
-
- **\uC704\uC82F** \u2014 \`src/slots/{\uC544\uBB34 \uC774\uB984}/template.tsx\` + \`createTemplate\`\uC5D0 \`slot\` \uC635\uC158. \uD3F4\uB354 \uC774\uB984\uC740 \
|
|
908
|
+
- **\uD398\uC774\uC9C0** \u2014 \`src/pages/{\uACBD\uB85C}/template.tsx\`. **\uD3F4\uB354 \uAD6C\uC870\uAC00 \uACE7 \uD398\uC774\uC9C0 \uACBD\uB85C**\uB2E4(\`src/pages/settings/custom/\` \u2192 \`/settings/custom\`). \uB3D9\uC801 \uACBD\uB85C(\`[id]\`)\uB294 \uC544\uC9C1 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294\uB2E4.
|
|
909
|
+
- **\uC704\uC82F** \u2014 \`src/slots/{\uC544\uBB34 \uC774\uB984}/template.tsx\` + \`createTemplate\`\uC5D0 \`slot\` \uC635\uC158. \uD3F4\uB354 \uC774\uB984\uC740 \uC790\uB9AC\uB97C \uC815\uD558\uB294 \uB370 \uC4F0\uC774\uC9C0 \uC54A\uACE0, \uC5B4\uB290 \uC790\uB9AC\uC5D0 \uBD99\uC744\uC9C0\uB294 \`slot\`\uB9CC \uC815\uD55C\uB2E4.
|
|
897
910
|
|
|
898
911
|
\`name\`\uC740 Custom Element \uD0DC\uADF8\uB85C \uADF8\uB300\uB85C \uC0AC\uC6A9\uB41C\uB2E4. Custom Element \uC2A4\uD399\uC0C1 **\uC18C\uBB38\uC790\uB85C \uC2DC\uC791 + \uD558\uC774\uD508 1\uAC1C \uC774\uC0C1 + \uC18C\uBB38\uC790\xB7\uC22B\uC790\xB7\uD558\uC774\uD508\uB9CC** \uD5C8\uC6A9. \uC704\uBC18 \uC2DC \uB7F0\uD0C0\uC784\xB7\uBE4C\uB4DC\uAC00 \uAC70\uBD80\uD55C\uB2E4.
|
|
899
912
|
|
|
@@ -920,7 +933,7 @@ createTemplate(MyWidget, {
|
|
|
920
933
|
\`\`\`
|
|
921
934
|
|
|
922
935
|
- \`name\`\uC740 \uD544\uC218 \u2014 Custom Element \uD0DC\uADF8\uBA85\uC774\uB2E4. \uC18C\uBB38\uC790\uB85C \uC2DC\uC791\uD558\uACE0 \uD558\uC774\uD508\uC744 1\uAC1C \uC774\uC0C1 \uB123\uACE0 \uC18C\uBB38\uC790\xB7\uC22B\uC790\xB7\uD558\uC774\uD508\uB9CC \uC4F4\uB2E4. \uB808\uD3EC \uC548\uC5D0\uC11C \uD15C\uD50C\uB9BF\uB9C8\uB2E4 \uB2EC\uB77C\uC57C \uD55C\uB2E4(\`bstage build\`\uAC00 \uAC80\uC0AC). \uAD00\uB840\uB294 \`{space}-{\uD654\uBA74}\`
|
|
923
|
-
- \
|
|
936
|
+
- \uD398\uC774\uC9C0 \uACBD\uB85C\xB7\uC2AC\uB86F \uC790\uB9AC\uB294 \`name\`\uC774 \uC544\uB2C8\uB77C **\uD3F4\uB354 \uC704\uCE58**\uAC00 \uC815\uD55C\uB2E4(\`src/pages/{\uACBD\uB85C}/\`). \uADF8\uB798\uC11C \`name\`\uC740 \uD3F4\uB354\uBA85\uACFC \uAC19\uC744 \uD544\uC694\uAC00 \uC5C6\uB2E4 \u2014 \uC608: \uD3F4\uB354 \`src/pages/todos\` + \`name: '${space}-todos'\`
|
|
924
937
|
- \uCEF4\uD3EC\uB10C\uD2B8 \uD568\uC218\uBA85\uC740 \uC790\uC720\uC774\uB098 \`export default\` \uD544\uC218
|
|
925
938
|
- \`type\` \uB4F1 \uC120\uD0DD \uD544\uB4DC \uCD94\uAC00 \uAC00\uB2A5`;
|
|
926
939
|
}
|
|
@@ -929,8 +942,8 @@ function sdkMigrationSection(skillsList) {
|
|
|
929
942
|
|
|
930
943
|
\uC774 \uD504\uB85C\uC81D\uD2B8\uB294 \uC0DD\uC131 \uC2DC\uC810\uC758 SDK \uBC84\uC804\uC744 \`package.json\`\uC5D0 \uACE0\uC815\uD55C\uB2E4. SDK\uAC00 \uC5C5\uB370\uC774\uD2B8\uB3FC\uB3C4 \uC790\uB3D9\uC73C\uB85C \uB530\uB77C\uC624\uC9C0 \uC54A\uC73C\uBBC0\uB85C, \uCD5C\uC2E0\uC73C\uB85C \uC62C\uB9AC\uB824\uBA74:
|
|
931
944
|
|
|
932
|
-
- \`npx @bstage-sdk/cli@latest doctor\` \u2014 \uBC84\uC804 \
|
|
933
|
-
- \uC2E4\uC81C \uC801\uC6A9\uC740 \`bstage-migrate\` \uC2A4\uD0AC\uC5D0\uAC8C \uB9E1\uAE34\uB2E4 \u2014 \uC5D0\uC774\uC804\uD2B8\uC5D0\uAC8C "bstage \uCD5C\uC2E0 \uBC84\uC804\uC73C\uB85C \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uD574\uC918"\uB77C\uACE0 \uC694\uCCAD\uD558\uBA74, doctor \uACB0\uACFC\uC640 SDK\uC758 \`MIGRATION.md\`\uB97C \uC77D\uACE0 \uC774 \uD504\uB85C\uC81D\uD2B8\uC5D0 \uB9DE\uCDB0 \uBCC0\uD658\uD55C\uB2E4(\uC0AC\uC6A9\uC790 \uCF54\uB4DC\uB294 \uB36E\uC5B4\uC4F0\uC9C0 \uC54A\uACE0
|
|
945
|
+
- \`npx @bstage-sdk/cli@latest doctor\` \u2014 \uC124\uCE58 \uBC84\uC804\uACFC \uCD5C\uC2E0 \uBC84\uC804\uC758 \uCC28\uC774\xB7\uB204\uB77D \uD30C\uC77C\xB7\uC801\uC6A9 \uAC00\uB2A5\uD55C \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uD56D\uBAA9\uC744 \uC9C4\uB2E8\uD55C\uB2E4(\uD30C\uC77C \uC218\uC815 \uC5C6\uC74C, \`--json\` \uC9C0\uC6D0).
|
|
946
|
+
- \uC2E4\uC81C \uC801\uC6A9\uC740 \`bstage-migrate\` \uC2A4\uD0AC\uC5D0\uAC8C \uB9E1\uAE34\uB2E4 \u2014 \uC5D0\uC774\uC804\uD2B8\uC5D0\uAC8C "bstage \uCD5C\uC2E0 \uBC84\uC804\uC73C\uB85C \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uD574\uC918"\uB77C\uACE0 \uC694\uCCAD\uD558\uBA74, doctor \uACB0\uACFC\uC640 SDK\uC758 \`MIGRATION.md\`\uB97C \uC77D\uACE0 \uC774 \uD504\uB85C\uC81D\uD2B8\uC5D0 \uB9DE\uCDB0 \uBCC0\uD658\uD55C\uB2E4(\uC0AC\uC6A9\uC790 \uCF54\uB4DC\uB294 \uB36E\uC5B4\uC4F0\uC9C0 \uC54A\uACE0 \uAE30\uC874 \uCF54\uB4DC\uC640 \uB9DE\uCDB0 \uD569\uCE5C\uB2E4).
|
|
934
947
|
|
|
935
948
|
\uB9C8\uC774\uADF8\uB808\uC774\uC158 \uC808\uCC28\uC758 \uB2E8\uC77C \uC18C\uC2A4\uB294 SDK\uC758 \`node_modules/@bstage-sdk/core/docs/MIGRATION.md\`\uB2E4.
|
|
936
949
|
|
|
@@ -944,9 +957,9 @@ function sdkForbidBullets() {
|
|
|
944
957
|
- \`createTemplate()\` \uD638\uCD9C\uC758 \uC778\uC790 \uAD6C\uC870\uB97C \uC784\uC758\uB85C \uBCC0\uACBD\uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uBE4C\uB4DC \uD30C\uC774\uD504\uB77C\uC778\uC774 \uD30C\uC2F1\uC5D0 \uC2E4\uD328\uD560 \uC218 \uC788\uB2E4
|
|
945
958
|
- \`@bstage-sdk/core\`\uB97C \uC9C1\uC811 import\uD558\uC5EC \`createWebComponent()\`\uB97C \uD638\uCD9C\uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 \`@bstage-sdk/react\`\uC758 API\uB9CC \uC0AC\uC6A9
|
|
946
959
|
- \uC804\uC5ED CSS \uD30C\uC77C(\`<link>\`, \uC678\uBD80 \uC2A4\uD0C0\uC77C\uC2DC\uD2B8)\uC744 \uC0AC\uC6A9\uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 Shadow DOM \uB0B4\uBD80\uC5D0 \uC801\uC6A9\uB418\uC9C0 \uC54A\uB294\uB2E4.
|
|
947
|
-
- **\`import './style.css'\`\uB85C \uC2A4\uD0C0\uC77C\uC744 \uB123\uC9C0 \uC54A\uB294\uB2E4 \u2014 \
|
|
960
|
+
- **\`import './style.css'\`\uB85C \uC2A4\uD0C0\uC77C\uC744 \uB123\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uCF58\uC194\uC774 \uB9CC\uB4E0 \uBE4C\uB4DC\uC5D0\uC11C \uC0AC\uB77C\uC9C4\uB2E4.** \uB85C\uCEEC \uAC1C\uBC1C \uD654\uBA74\uC5D0\uC11C\uB294 \uC801\uC6A9\uB418\uC5B4 \uB208\uCE58\uCC44\uAE30 \uC5B4\uB835\uB2E4. CSS \uD30C\uC77C\uC744 \uC4F0\uB824\uBA74 \`import css from './style.css?inline'\`\uC73C\uB85C \uBB38\uC790\uC5F4\uC744 \uAC00\uC838\uC640 \`createTemplate(..., { styles: css })\`\uC5D0 \uB118\uAE30\uAC70\uB098 \uCEF4\uD3EC\uB10C\uD2B8 \uC548 \`<style>{css}</style>\`\uB85C \uB80C\uB354\uD55C\uB2E4. inline \`style={{}}\`\uB3C4 \uB41C\uB2E4
|
|
948
961
|
- UI \uC0C9\xB7\uD0C0\uC774\uD3EC\xB7\uADF8\uB9BC\uC790\uB97C hex/rgb\uB85C \uD558\uB4DC\uCF54\uB529\uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uC704 '\uB514\uC790\uC778' \uC139\uC158\uC758 \uB514\uC790\uC778 \uD1A0\uD070\uC744 \uC0AC\uC6A9
|
|
949
|
-
- \uC571\uD0A4(APP
|
|
962
|
+
- \uC571\uD0A4(APP ID \`bsa_\u2026\`\xB7APP KEY \`bsp_\u2026\`, \uC6B4\uC601\uC790 \uD654\uBA74 \uAC8C\uC774\uD2B8\uC6E8\uC774 \`bsm_\u2026\`)\uB97C \uC18C\uC2A4 \uCF54\uB4DC\uC5D0 \uB9AC\uD130\uB7F4\uB85C \uB123\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uC778\uC99D \uAC12\uC740 \`.env\`(\uCEE4\uBC0B \uC548 \uB428)\uC5D0\uC11C \`import.meta.env.VITE_BSTAGE_*\`\uB85C\uB9CC \uC8FC\uC785\uD55C\uB2E4. pre-commit \uD6C5\uC774 \uCEE4\uBC0B \uC804 \uAC80\uCD9C\xB7\uCC28\uB2E8\uD558\uBA70 \`--no-verify\`\uB85C \uC6B0\uD68C\uD558\uC9C0 \uC54A\uB294\uB2E4
|
|
950
963
|
${SDK_API_FORBID_BULLETS}`;
|
|
951
964
|
}
|
|
952
965
|
function sdkManagedBody(space, projectName, target) {
|
|
@@ -956,7 +969,7 @@ function sdkManagedBody(space, projectName, target) {
|
|
|
956
969
|
|
|
957
970
|
## \uD504\uB85C\uC81D\uD2B8 \uAC1C\uC694
|
|
958
971
|
|
|
959
|
-
b.stage \uC11C\uB4DC\uD30C\uD2F0 \uD15C\uD50C\uB9BF \uD504\uB85C\uC81D\uD2B8. React \uCEF4\uD3EC\uB10C\uD2B8\uB97C \uC791\uC131\uD558\uBA74 SDK\uAC00 Web Component\uB85C \uBE4C\uB4DC\uD558\uACE0, \uBE4C\uB4DC
|
|
972
|
+
b.stage \uC11C\uB4DC\uD30C\uD2F0 \uD15C\uD50C\uB9BF \uD504\uB85C\uC81D\uD2B8. React \uCEF4\uD3EC\uB10C\uD2B8\uB97C \uC791\uC131\uD558\uBA74 SDK\uAC00 Web Component\uB85C \uBE4C\uB4DC\uD558\uACE0, \uADF8 \uBE4C\uB4DC\uAC00 b.stage \uD50C\uB7AB\uD3FC\uC5D0\uC11C \uB85C\uB4DC\uB418\uC5B4 \uC2E4\uD589\uB41C\uB2E4.
|
|
960
973
|
|
|
961
974
|
- **Space**: ${space}
|
|
962
975
|
- **\uB808\uD3EC**: \`${projectName}\`
|
|
@@ -987,7 +1000,7 @@ ${sdkMigrationSection(SDK_SKILLS_LIST)}
|
|
|
987
1000
|
|
|
988
1001
|
## \uBE4C\uB4DC
|
|
989
1002
|
|
|
990
|
-
- \uB85C\uCEEC\uC5D0\uC11C \
|
|
1003
|
+
- \uB85C\uCEEC\uC5D0\uC11C \uBE4C\uB4DC \uACB0\uACFC\uBB3C\uC744 \uD655\uC778\uD558\uB824\uBA74 \`npx bstage build\`\uB85C \`dist/\`\uB97C \uC0DD\uC131\uD560 \uC218 \uC788\uB2E4(\uAC8C\uC2DC\uB418\uB294 \uBE4C\uB4DC\uB294 b.stage kit \uCF58\uC194\uC774 \uB2E4\uC2DC \uB9CC\uB4E0\uB2E4).
|
|
991
1004
|
|
|
992
1005
|
${deploySection()}
|
|
993
1006
|
|
|
@@ -997,33 +1010,33 @@ ${sdkForbidBullets()}
|
|
|
997
1010
|
`;
|
|
998
1011
|
}
|
|
999
1012
|
var LIQUID_STRUCTURE_BLOCK = `public/
|
|
1000
|
-
user/ \u2014 \
|
|
1013
|
+
user/ \u2014 \uC0AC\uC6A9\uC790 \uD654\uBA74\uC6A9 \uD15C\uD50C\uB9BF
|
|
1001
1014
|
{name}/
|
|
1002
1015
|
template.liquid \u2014 \uD15C\uD50C\uB9BF \uBCF8\uBB38 (\uD544\uC218, \uD30C\uC77C\uBA85 \uACE0\uC815)
|
|
1003
|
-
data.json \u2014 \uB85C\uCEEC \uBBF8\uB9AC\uBCF4\uAE30\uC6A9 \uC0D8\uD50C \uB370\uC774\uD130 (\
|
|
1004
|
-
admin/ \u2014 \
|
|
1005
|
-
var LIQUID_DATA_SECTION = `## \uD50C\uB7AB\uD3FC\uC774 \uB123\uB294 \uB370\uC774\uD130 (\
|
|
1016
|
+
data.json \u2014 \uB85C\uCEEC \uBBF8\uB9AC\uBCF4\uAE30\uC6A9 \uC0D8\uD50C \uB370\uC774\uD130 (\uBE4C\uB4DC\uC5D0\uB294 \uB4E4\uC5B4\uAC00\uC9C0 \uC54A\uC74C)
|
|
1017
|
+
admin/ \u2014 \uC6B4\uC601\uC790 \uD654\uBA74\uC6A9 \uD15C\uD50C\uB9BF (\uAC19\uC740 \uADDC\uCE59)`;
|
|
1018
|
+
var LIQUID_DATA_SECTION = `## \uD50C\uB7AB\uD3FC\uC774 \uB123\uB294 \uB370\uC774\uD130 (\uC0AC\uC6A9\uC790 \uD654\uBA74)
|
|
1006
1019
|
|
|
1007
|
-
\uCD5C\uC0C1\uC704 \uAC12\uC740 \uB2E4\uC12F \uAC1C\uB2E4 \u2014 \`lounges\` \xB7 \`stories\` \xB7 \`contentSections\` \xB7 \`latestContents\` \xB7 \`shopCategories\`. \uC774 \uC774\uB984 \uC678\uC758 \uBCC0\uC218\uB294 \uBE48 \uBB38\uC790\uC5F4\uC774 \uB41C\uB2E4. \uAC01 \uD56D\uBAA9\uC758 \uD544\uB4DC\uB294 \uC2E4\uC81C \uB80C\uB354 \uACB0\uACFC\uB85C \uD655\uC778\uD55C\uB2E4. \`data.json\` \uC0D8\uD50C\uB3C4 \uAC19\uC740 \uC774\uB984\uC744 \uC368\uC57C \uD504\uB9AC\uBDF0\uAC00 \
|
|
1020
|
+
\uCD5C\uC0C1\uC704 \uAC12\uC740 \uB2E4\uC12F \uAC1C\uB2E4 \u2014 \`lounges\` \xB7 \`stories\` \xB7 \`contentSections\` \xB7 \`latestContents\` \xB7 \`shopCategories\`. \uC774 \uC774\uB984 \uC678\uC758 \uBCC0\uC218\uB294 \uBE48 \uBB38\uC790\uC5F4\uC774 \uB41C\uB2E4. \uAC01 \uD56D\uBAA9\uC758 \uD544\uB4DC\uB294 \uC2E4\uC81C \uB80C\uB354 \uACB0\uACFC\uB85C \uD655\uC778\uD55C\uB2E4. \`data.json\` \uC0D8\uD50C\uB3C4 \uAC19\uC740 \uC774\uB984\uC744 \uC368\uC57C \uD504\uB9AC\uBDF0\uAC00 \uAC8C\uC2DC\uB41C \uD654\uBA74\uACFC \uAC19\uC740 \uBAA8\uC591\uC774 \uB41C\uB2E4. \uC6B4\uC601\uC790 \uD654\uBA74\uC774 \uBC1B\uB294 \uAC12\uC740 \uD655\uC778\uB418\uC9C0 \uC54A\uC558\uB2E4.`;
|
|
1008
1021
|
var LIQUID_RULES_BULLETS = `- \uACBD\uB85C \uAE4A\uC774\uAC00 \uACE0\uC815\uC774\uB2E4 \u2014 \`public/{user|admin}/{name}/template.liquid\`(\uC608: \`public/user/welcome/template.liquid\`) \uC790\uB9AC\uC5D0 \uC788\uB294 \uD30C\uC77C\uB9CC \uC778\uC2DD\uD55C\uB2E4. \uB2E4\uB978 \uC704\uCE58\uC758 \uD30C\uC77C\uC740 **\uC870\uC6A9\uD788 \uBB34\uC2DC\uB41C\uB2E4**(\uBE4C\uB4DC\uB294 \uC131\uACF5\uD558\uB294\uB370 \uD654\uBA74\uC5D0 \uB098\uC624\uC9C0 \uC54A\uB294\uB2E4).
|
|
1009
1022
|
- \`{name}\`\uC740 **\uC18C\uBB38\uC790\xB7\uC22B\uC790\xB7\uD558\uC774\uD508**\uB9CC \uC4F4\uB2E4. \uD3F4\uB354 \uD558\uB098\uAC00 \uD398\uC774\uC9C0 \uD558\uB098\uB2E4.
|
|
1010
1023
|
- \uD30C\uC77C\uBA85\uC740 \uBC18\uB4DC\uC2DC \`template.liquid\`\uB2E4.
|
|
1011
1024
|
- \`data.json\`\uC740 \uB85C\uCEEC \uBBF8\uB9AC\uBCF4\uAE30\uC6A9 \uC0D8\uD50C\uC77C \uBFD0\uC774\uB2E4. \uC2E4\uC81C \uAC12\uC740 \uD50C\uB7AB\uD3FC\uC774 \uB123\uC73C\uBBC0\uB85C, \uAC12\uC774 \uBE44\uC5B4 \uC788\uC5B4\uB3C4 \uD654\uBA74\uC774 \uAE68\uC9C0\uC9C0 \uC54A\uAC8C \uAE30\uBCF8\uAC12\xB7\uBE48 \uBAA9\uB85D \uBD84\uAE30\uB97C \uD568\uAED8 \uB123\uB294\uB2E4.
|
|
1012
1025
|
- \uC791\uC131\xB7\uC218\uC815 \uC808\uCC28\uC640 \uBB38\uBC95 \uC694\uC810\uC740 \`bstage-liquid\` \uC2A4\uD0AC\uC744 \uB530\uB978\uB2E4.`;
|
|
1013
1026
|
function liquidForbidBullets() {
|
|
1014
|
-
return `- liquid \uD15C\uD50C\uB9BF\uC744 \uC2AC\uB86F(\uC704\uC82F \uC790\uB9AC)\uC5D0 \uB123\uC73C\uB824 \uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014
|
|
1015
|
-
- \`data.json\`\xB7\`layout.json\`\uC5D0 \
|
|
1027
|
+
return `- liquid \uD15C\uD50C\uB9BF\uC744 \uC2AC\uB86F(\uC704\uC82F \uC790\uB9AC)\uC5D0 \uB123\uC73C\uB824 \uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 **\uD398\uC774\uC9C0(PAGE)\uB9CC \uAC00\uB2A5**\uD558\uB2E4
|
|
1028
|
+
- \`data.json\`\xB7\`layout.json\`\uC5D0 \uAC8C\uC2DC\uC5D0 \uD544\uC694\uD55C \uC124\uC815\uC744 \uB2F4\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uCF58\uC194\uC774 \uD328\uD0A4\uC9D5\uD560 \uB54C \uC9C0\uC6B4\uB2E4(\uB808\uC774\uC544\uC6C3\uC740 \uCF58\uC194\uC758 \uD398\uC774\uC9C0 \uC124\uC815\uC774 \uC18C\uC720)
|
|
1016
1029
|
- \uADDC\uC57D \uBC16 \uACBD\uB85C\uC5D0 \uD15C\uD50C\uB9BF\uC744 \uB450\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uAE4A\uC774\uAC00 \uB2E4\uB974\uBA74 \uBB34\uC2DC\uB41C\uB2E4
|
|
1017
|
-
- \uC5D0\uC14B(\uC774\uBBF8\uC9C0\xB7\uC601\uC0C1)\uC744 \uB808\uD3EC\uC5D0 \uB450\uACE0 \uC0C1\uB300 \uACBD\uB85C\uB85C \uCC38\uC870\uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 \
|
|
1030
|
+
- \uC5D0\uC14B(\uC774\uBBF8\uC9C0\xB7\uC601\uC0C1)\uC744 \uB808\uD3EC\uC5D0 \uB450\uACE0 \uC0C1\uB300 \uACBD\uB85C\uB85C \uCC38\uC870\uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uAC8C\uC2DC \uD6C4 \uAE68\uC9C4\uB2E4. \uCF58\uC194 \uD654\uBA74\uC758 \uC2A4\uD14C\uC774\uC9C0 > \uBBF8\uB514\uC5B4\uC5D0 \uC62C\uB824 \uBC1B\uC740 URL\uC744 \uC808\uB300 \uC8FC\uC18C\uB85C \uB123\uB294\uB2E4(\uC774\uBBF8\uC9C0\xB7\uC601\uC0C1\uB9CC \uC62C\uB9B4 \uC218 \uC788\uACE0 \uD5C8\uC6A9 \uD615\uC2DD\xB7\uC6A9\uB7C9 \uD55C\uB3C4\uB294 \uC5C5\uB85C\uB4DC\uD560 \uB54C \uD654\uBA74\uC774 \uC54C\uB824 \uC900\uB2E4). \uB85C\uCEEC \uD504\uB9AC\uBDF0\uC5D0\uC11C\uB294 \uC0C1\uB300 \uACBD\uB85C\uB3C4 \uBCF4\uC774\uBBC0\uB85C \uD504\uB9AC\uBDF0 \uACB0\uACFC\uB97C \uADFC\uAC70\uB85C \uC0BC\uC9C0 \uC54A\uB294\uB2E4
|
|
1018
1031
|
- \uD50C\uB7AB\uD3FC\uC774 \uB123\uC5B4 \uC8FC\uB294 \uB370\uC774\uD130\uC758 \uC774\uB984\xB7\uAD6C\uC870\uB97C \uCD94\uCE21\uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uCD5C\uC0C1\uC704 \uC774\uB984\uC740 \uC704 '\uD50C\uB7AB\uD3FC\uC774 \uB123\uB294 \uB370\uC774\uD130' \uC808\uC774 \uC804\uBD80\uC774\uACE0, \uADF8 \uC548\uC758 \uD544\uB4DC\uB294 \uC2E4\uC81C \uB80C\uB354 \uACB0\uACFC\uB85C \uD655\uC778\uD55C\uB2E4
|
|
1019
|
-
- \`{% render %}\`\xB7\`{% include %}\`(\uD30C\uC15C)\uB97C \uC4F0\uC9C0 \uC54A\uB294\uB2E4 \u2014 \
|
|
1032
|
+
- \`{% render %}\`\xB7\`{% include %}\`(\uD30C\uC15C)\uB97C \uC4F0\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uAC8C\uC2DC\uB41C \uD654\uBA74\uC5D0\uC11C \uBE48 \uBB38\uC790\uC5F4\uC774 \uB41C\uB2E4(\uB85C\uCEEC \uD504\uB9AC\uBDF0\uC5D0\uC11C\uB9CC \uB3D9\uC791). \uD15C\uD50C\uB9BF\uC740 \`template.liquid\` \uD55C \uD30C\uC77C\uC5D0 \uB2F4\uB294\uB2E4`;
|
|
1020
1033
|
}
|
|
1021
1034
|
function liquidManagedBody(space, projectName) {
|
|
1022
1035
|
return `# AGENTS.md
|
|
1023
1036
|
|
|
1024
1037
|
## \uD504\uB85C\uC81D\uD2B8 \uAC1C\uC694
|
|
1025
1038
|
|
|
1026
|
-
b.stage liquid \uD14C\uB9C8 \uD504\uB85C\uC81D\uD2B8. \`.liquid\` \uD15C\uD50C\uB9BF\uC744 \uC791\uC131\uD558\uBA74 \uCF58\uC194\uC774 \uADF8\uB300\uB85C \uD328\uD0A4\uC9D5\uD574 \uD50C\uB7AB\uD3FC\uC774 \uC11C\uBC84\uC5D0\uC11C \uB370\uC774\uD130\uB97C \uB123\uC5B4 \uB80C\uB354\uD55C\uB2E4.
|
|
1039
|
+
b.stage liquid \uD14C\uB9C8 \uD504\uB85C\uC81D\uD2B8. \`.liquid\` \uD15C\uD50C\uB9BF\uC744 \uC791\uC131\uD558\uBA74 b.stage kit \uCF58\uC194\uC774 \uADF8\uB300\uB85C \uD328\uD0A4\uC9D5\uD574 \uD50C\uB7AB\uD3FC\uC774 \uC11C\uBC84\uC5D0\uC11C \uB370\uC774\uD130\uB97C \uB123\uC5B4 \uB80C\uB354\uD55C\uB2E4.
|
|
1027
1040
|
|
|
1028
1041
|
- **Space**: ${space}
|
|
1029
1042
|
- **\uB808\uD3EC**: \`${projectName}\`
|
|
@@ -1054,7 +1067,7 @@ ${LIQUID_RULES_BULLETS}
|
|
|
1054
1067
|
|
|
1055
1068
|
- \`bstage dev\` \u2014 \uB85C\uCEEC \uBBF8\uB9AC\uBCF4\uAE30(\uBAA9\uB85D\uC5D0\uC11C \uD15C\uD50C\uB9BF\uC744 \uACE8\uB77C \uD655\uC778)
|
|
1056
1069
|
- \`bstage build\` \u2014 \uAC80\uC99D(\uAD6C\uC870\xB7\uBB38\uBC95 \uD655\uC778, \uBC88\uB4E4\uC744 \uB9CC\uB4E4\uC9C0 \uC54A\uB294\uB2E4)
|
|
1057
|
-
- \`bstage deploy\` \u2014 \uCF58\uC194 \
|
|
1070
|
+
- \`bstage deploy\` \u2014 \uCF58\uC194\uC5D0\uC11C \uBE4C\uB4DC\uD574 \uC5C5\uB370\uC774\uD2B8 (\uC544\uB798 "\uBC30\uD3EC" \uC808)
|
|
1058
1071
|
|
|
1059
1072
|
**\uC124\uCE58\uB41C cli\uAC00 liquid\uB97C \uBAA8\uB974\uB294 \uC61B \uBC84\uC804\uC774\uBA74** \uC704 \uB450 \uBA85\uB839\uC774 \uC774 \uB808\uD3EC\uB97C \uC54C\uC544\uBCF4\uC9C0 \uBABB\uD55C\uB2E4 \u2014 \uC99D\uC0C1\uC774 \uBD84\uBA85\uD558\uB2E4: \`bstage build\`\uAC00 liquid \uAC80\uC99D \uB300\uC2E0 \`src/\` \uC544\uB798\uC5D0\uC11C \uC5C6\uB294 \uC18C\uC2A4 \uD30C\uC77C\uC744 \uCC3E\uB294\uB2E4\uACE0 \uB05D\uB09C\uB2E4. \uADF8\uB54C\uB294 cli\uB97C \uCD5C\uC2E0\uC73C\uB85C \uC62C\uB9B0\uB2E4. \uC62C\uB9B4 \uC218 \uC5C6\uC73C\uBA74 \uB85C\uCEEC \uBBF8\uB9AC\uBCF4\uAE30\uB294 \uC774 \uB808\uD3EC\uAC00 \uAC00\uC9C4 \uC218\uB2E8\uC744 \uC4F4\uB2E4.
|
|
1060
1073
|
|
|
@@ -1066,7 +1079,7 @@ ${deploySection()}
|
|
|
1066
1079
|
|
|
1067
1080
|
## \uAE08\uC9C0 \uC0AC\uD56D
|
|
1068
1081
|
|
|
1069
|
-
- React(sdk) \uD15C\uD50C\uB9BF\uC744 \uC774 \uB808\uD3EC\uC5D0 \uCD94\uAC00\uD574 \uD63C\uD569 \uB808\uD3EC\uB85C \uB9CC\uB4E4 \uB54C\uB294 sdk \uD398\uC774\uC9C0 \uD3F4\uB354 \uC774\uB984\uC5D0 \`user\`\xB7\`admin\`\uC744 \uC4F0\uC9C0 \uC54A\uB294\uB2E4(\uB300\uC18C\uBB38\uC790 \uBB34\uC2DC) \u2014 \uADF8 \uC790\uB9AC\uB294 liquid \
|
|
1082
|
+
- React(sdk) \uD15C\uD50C\uB9BF\uC744 \uC774 \uB808\uD3EC\uC5D0 \uCD94\uAC00\uD574 \uD63C\uD569 \uB808\uD3EC\uB85C \uB9CC\uB4E4 \uB54C\uB294 sdk \uD398\uC774\uC9C0 \uD3F4\uB354 \uC774\uB984\uC5D0 \`user\`\xB7\`admin\`\uC744 \uC4F0\uC9C0 \uC54A\uB294\uB2E4(\uB300\uC18C\uBB38\uC790 \uBB34\uC2DC) \u2014 \uADF8 \uC790\uB9AC\uB294 liquid \uBE4C\uB4DC \uACBD\uB85C(\`dist/{user|admin}/{name}/\`)\uC640 \uACB9\uCCD0 \`bstage build\`\uAC00 \uC885\uB8CC \uCF54\uB4DC 2\uB85C \uB9C9\uB294\uB2E4. \uCD94\uAC00\uD55C \uB4A4 \`npx @bstage-sdk/cli@latest ai update\`\uB97C \uB3CC\uB9AC\uBA74 \uC774 \uD30C\uC77C\uC774 \uD63C\uD569 \uBCF8\uBB38\uC73C\uB85C \uBC14\uB010\uB2E4
|
|
1070
1083
|
${liquidForbidBullets()}
|
|
1071
1084
|
`;
|
|
1072
1085
|
}
|
|
@@ -1076,7 +1089,7 @@ function mixedManagedBody(space, projectName, target) {
|
|
|
1076
1089
|
|
|
1077
1090
|
## \uD504\uB85C\uC81D\uD2B8 \uAC1C\uC694
|
|
1078
1091
|
|
|
1079
|
-
b.stage \uCEE4\uC2A4\uD140 \uD15C\uD50C\uB9BF \uD504\uB85C\uC81D\uD2B8 \u2014 **\uD63C\uD569 \uB808\uD3EC**. React \uCEF4\uD3EC\uB10C\uD2B8(sdk) \uD15C\uD50C\uB9BF\uACFC \`.liquid\` \uD15C\uD50C\uB9BF\uC774 \uD55C \uB808\uD3EC\uC5D0 \uC788\uB2E4. \uCF58\uC194\uC740 sdk \uD15C\uD50C\uB9BF\uC744 Web Component\uB85C \uBE4C\uB4DC\uD55C \uB4A4 liquid \uD15C\uD50C\uB9BF\uC744 \uADF8\uB300\uB85C \uD568\uAED8 \uD328\uD0A4\uC9D5\uD558\uACE0, \
|
|
1092
|
+
b.stage \uCEE4\uC2A4\uD140 \uD15C\uD50C\uB9BF \uD504\uB85C\uC81D\uD2B8 \u2014 **\uD63C\uD569 \uB808\uD3EC**. React \uCEF4\uD3EC\uB10C\uD2B8(sdk) \uD15C\uD50C\uB9BF\uACFC \`.liquid\` \uD15C\uD50C\uB9BF\uC774 \uD55C \uB808\uD3EC\uC5D0 \uC788\uB2E4. b.stage kit \uCF58\uC194\uC740 sdk \uD15C\uD50C\uB9BF\uC744 Web Component\uB85C \uBE4C\uB4DC\uD55C \uB4A4 liquid \uD15C\uD50C\uB9BF\uC744 \uADF8\uB300\uB85C \uD568\uAED8 \uD328\uD0A4\uC9D5\uD558\uACE0, \uBE4C\uB4DC \uD56D\uBAA9\uB9C8\uB2E4 \uC885\uB958(sdk\xB7liquid)\uB97C \uB530\uB85C \uBCF8\uB2E4.
|
|
1080
1093
|
|
|
1081
1094
|
- **Space**: ${space}
|
|
1082
1095
|
- **\uB808\uD3EC**: \`${projectName}\`
|
|
@@ -1095,10 +1108,10 @@ ${LIQUID_STRUCTURE_BLOCK}
|
|
|
1095
1108
|
## \uD63C\uD569 \uB808\uD3EC \uADDC\uCE59
|
|
1096
1109
|
|
|
1097
1110
|
- **\uC5B4\uB290 \uBC29\uC2DD\uC73C\uB85C \uB9CC\uB4E4\uAE4C**: \uC0C1\uD638\uC791\uC6A9\xB7\uC0C1\uD0DC\xB7API \uD638\uCD9C\uC774 \uD544\uC694\uD55C \uD654\uBA74\uC740 React(\`src/pages\`\xB7\`src/slots\`), \uB370\uC774\uD130\uB97C \uBC1B\uC544 \uADF8\uB824 \uC8FC\uAE30\uB9CC \uD558\uBA74 \uB418\uB294 \uD654\uBA74\uC740 liquid(\`public/{user|admin}/{name}/\`). \uAC19\uC740 \uD654\uBA74\uC744 \uB450 \uBC29\uC2DD\uC73C\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uB294\uB2E4.
|
|
1098
|
-
- **\uC608\uC57D \uC774\uB984**: sdk \uD398\uC774\uC9C0 \uD3F4\uB354 \`src/pages/user/\u2026\`\xB7\`src/pages/admin/\u2026\`\uC740 \uB9CC\uB4E4 \uC218 \uC5C6\uB2E4(\uB300\uC18C\uBB38\uC790 \uBB34\uC2DC \u2014 \`User\`\uB3C4 \uAC19\uB2E4). \
|
|
1111
|
+
- **\uC608\uC57D \uC774\uB984**: sdk \uD398\uC774\uC9C0 \uD3F4\uB354 \`src/pages/user/\u2026\`\xB7\`src/pages/admin/\u2026\`\uC740 \uB9CC\uB4E4 \uC218 \uC5C6\uB2E4(\uB300\uC18C\uBB38\uC790 \uBB34\uC2DC \u2014 \`User\`\uB3C4 \uAC19\uB2E4). \uBE4C\uB4DC \uACB0\uACFC\uBB3C\uC774 \`dist/{user|admin}/\u2026\`\uB85C \uB098\uAC00 liquid \uBE4C\uB4DC \uC790\uB9AC\uC640 \uACB9\uCE58\uACE0, \uAC19\uC740 \uB514\uB809\uD130\uB9AC\uC5D0 \`template.js\`\xB7\`template.liquid\`\uAC00 \uD568\uAED8 \uC788\uC73C\uBA74 \uCF58\uC194\uC774 sdk\uB85C\uB9CC \uD310\uC815\uD574 liquid\uAC00 \uC870\uC6A9\uD788 \uC0AC\uB77C\uC9C4\uB2E4. \`bstage build\`\uC640 \uCF58\uC194 \uBE4C\uB354\uAC00 \uBAA8\uB450 \uC5EC\uAE30\uC11C \uB9C9\uB294\uB2E4. \uC704\uC82F(\`src/slots\`)\uC740 \uD574\uB2F9 \uC5C6\uB2E4.
|
|
1099
1112
|
- **\`bstage build\`**: sdk \uC5D4\uD2B8\uB9AC\uB97C \uBC88\uB4E4\uD558\uACE0 liquid\uB294 \uAC80\uC99D\uB9CC \uD55C\uB2E4 \u2014 \`dist/\`\uC5D0 liquid\uB294 \uB4E4\uC5B4\uAC00\uC9C0 \uC54A\uB294\uB2E4(\uCF58\uC194\uC774 push\uB41C \uCEE4\uBC0B\uC758 \`public/\`\uC5D0\uC11C \uD328\uD0A4\uC9D5). \uAC80\uC99D \uC624\uB958\uAC00 \uC788\uC73C\uBA74 \uBC88\uB4E4\uD558\uC9C0 \uC54A\uACE0 \uC885\uB8CC \uCF54\uB4DC 2.
|
|
1100
1113
|
- **\`bstage dev\`**: \uAE30\uBCF8\uC740 sdk(Vite) \uD504\uB9AC\uBDF0. liquid \uD504\uB9AC\uBDF0\uB294 \`bstage dev --kind liquid\`\uB85C \uB530\uB85C \uB744\uC6B4\uB2E4 \u2014 \uB450 \uC11C\uBC84\uB97C \uD568\uAED8 \uB744\uC6B0\uC9C0 \uC54A\uB294\uB2E4.
|
|
1101
|
-
- liquid \uD15C\uD50C\uB9BF\uC740
|
|
1114
|
+
- liquid \uD15C\uD50C\uB9BF\uC740 \uD398\uC774\uC9C0(PAGE)\uB9CC \uB41C\uB2E4. \uC704\uC82F \uC790\uB9AC\uC5D0\uB294 sdk \uC704\uC82F(\`src/slots\`)\uB9CC \uBD99\uC778\uB2E4.
|
|
1102
1115
|
|
|
1103
1116
|
## React \uD15C\uD50C\uB9BF \uAC1C\uBC1C \uADDC\uCE59
|
|
1104
1117
|
|
|
@@ -1121,7 +1134,7 @@ ${SDK_ENV_SECTION}
|
|
|
1121
1134
|
- \`npm run dev\` \uB610\uB294 \`bstage dev\` \u2014 sdk(Vite) \uAC1C\uBC1C \uC11C\uBC84(\uC778\uC99D \uD504\uB85D\uC2DC \uD3EC\uD568). \uB85C\uADF8\uC778 \uD398\uC774\uC9C0: http://localhost:5173/__bstage__/login
|
|
1122
1135
|
- \`bstage dev --kind liquid\` \u2014 liquid \uBBF8\uB9AC\uBCF4\uAE30(\uBAA9\uB85D\uC5D0\uC11C \uD15C\uD50C\uB9BF\uC744 \uACE8\uB77C \uD655\uC778, \`data.json\`\uC73C\uB85C \uB80C\uB354)
|
|
1123
1136
|
- \`bstage build\` \u2014 sdk \uBC88\uB4E4 + liquid \uAC80\uC99D
|
|
1124
|
-
- \`bstage deploy\` \u2014 \uCF58\uC194 \
|
|
1137
|
+
- \`bstage deploy\` \u2014 \uCF58\uC194\uC5D0\uC11C \uBE4C\uB4DC\uD574 \uC5C5\uB370\uC774\uD2B8 (\uC544\uB798 "\uBC30\uD3EC" \uC808)
|
|
1125
1138
|
|
|
1126
1139
|
${sdkMigrationSection(MIXED_SKILLS_LIST)}
|
|
1127
1140
|
|
|
@@ -1129,7 +1142,7 @@ ${deploySection()}
|
|
|
1129
1142
|
|
|
1130
1143
|
## \uAE08\uC9C0 \uC0AC\uD56D
|
|
1131
1144
|
|
|
1132
|
-
- sdk \uD398\uC774\uC9C0\uB97C \`src/pages/user\`\xB7\`src/pages/admin\` \uC544\uB798\uC5D0 \uB9CC\uB4E4\uC9C0 \uC54A\uB294\uB2E4 \u2014 liquid \
|
|
1145
|
+
- sdk \uD398\uC774\uC9C0\uB97C \`src/pages/user\`\xB7\`src/pages/admin\` \uC544\uB798\uC5D0 \uB9CC\uB4E4\uC9C0 \uC54A\uB294\uB2E4 \u2014 liquid \uBE4C\uB4DC \uC790\uB9AC\uC640 \uACB9\uCE5C\uB2E4(\uC704 '\uD63C\uD569 \uB808\uD3EC \uADDC\uCE59')
|
|
1133
1146
|
${sdkForbidBullets()}
|
|
1134
1147
|
${liquidForbidBullets()}
|
|
1135
1148
|
`;
|
|
@@ -1165,8 +1178,8 @@ function sanitizeIdentity(value) {
|
|
|
1165
1178
|
// src/install/plan.ts
|
|
1166
1179
|
var AGENTS_FILE = "AGENTS.md";
|
|
1167
1180
|
var CLAUDE_FILE = "CLAUDE.md";
|
|
1168
|
-
var LEGACY_NOTE = "\uAD00\uB9AC \uC601\uC5ED \uB9C8\uCEE4 \uC5C6\
|
|
1169
|
-
var HAND_EDIT_NOTE = "\uBC84\uC804\uC740 \uAC19\uC740\uB370 \uBCF8\uBB38\uC774 \uB2E4\uB985\uB2C8\uB2E4(\uC190\uC218\uC815) \u2014 SDK \uBCF8\uBB38\uC73C\uB85C \uB418\uB3CC\uB9AC\uACE0 \uAE30\uC874 \uBCF8\uBB38\uC740 SKILL.md.bak
|
|
1181
|
+
var LEGACY_NOTE = "\uAD00\uB9AC \uC601\uC5ED \uB9C8\uCEE4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 bstage-migrate \uC2A4\uD0AC\uB85C SDK \uC601\uC5ED\uC744 \uAD50\uCCB4\uD558\uACE0 \uC0AC\uC6A9\uC790 \uB0B4\uC6A9\uC744 \uBCF4\uC874\uD558\uC138\uC694";
|
|
1182
|
+
var HAND_EDIT_NOTE = "\uBC84\uC804\uC740 \uAC19\uC740\uB370 \uBCF8\uBB38\uC774 \uB2E4\uB985\uB2C8\uB2E4(\uC190\uC218\uC815) \u2014 SDK \uBCF8\uBB38\uC73C\uB85C \uB418\uB3CC\uB9AC\uACE0 \uAE30\uC874 \uBCF8\uBB38\uC740 SKILL.md.bak\uC73C\uB85C \uB0A8\uAE41\uB2C8\uB2E4. \uD504\uB85C\uC81D\uD2B8 \uACE0\uC720 \uADDC\uCE59\uC740 AGENTS.md \uC790\uC720 \uC601\uC5ED\uC5D0 \uC801\uC73C\uC138\uC694.";
|
|
1170
1183
|
var NEWER_NOTE = "\uC124\uCE58\uBCF8\uC774 \uC774 toolkit\uBCF4\uB2E4 \uC0C8 \uBC84\uC804\uC785\uB2C8\uB2E4 \u2014 \uC774 CLI\uAC00 \uC624\uB798\uB3FC \uC61B \uBCF8\uBB38\uC73C\uB85C \uB418\uB3CC\uB9BD\uB2C8\uB2E4(\uD558\uD5A5). \uCD5C\uC2E0 CLI(npx @bstage-sdk/cli@latest ai update)\uB85C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.";
|
|
1171
1184
|
var KIND_DRIFT_NOTE = "\uAD00\uB9AC \uC601\uC5ED \uBC84\uC804\uC740 \uCD5C\uC2E0\uC778\uB370 \uBCF8\uBB38\uC774 \uC774 \uD504\uB85C\uC81D\uD2B8 \uC885\uB958\uC758 \uAC83\uACFC \uB2E4\uB985\uB2C8\uB2E4(\uC885\uB958\uAC00 \uBC14\uB00C\uC5C8\uAC70\uB098 \uAD00\uB9AC \uC601\uC5ED\uC744 \uC190\uC73C\uB85C \uACE0\uCE68) \u2014 \uD604\uC7AC \uC885\uB958\uC758 \uBCF8\uBB38\uC73C\uB85C \uAC31\uC2E0\uD569\uB2C8\uB2E4. \uC790\uC720 \uC601\uC5ED\uC740 \uBCF4\uC874\uB429\uB2C8\uB2E4.";
|
|
1172
1185
|
var AGENTS_NEWER_NOTE = "AGENTS.md \uAD00\uB9AC \uC601\uC5ED\uC774 \uC774 toolkit\uBCF4\uB2E4 \uC0C8 \uBC84\uC804\uC785\uB2C8\uB2E4 \u2014 \uC774 CLI\uAC00 \uC624\uB798\uB3FC \uC61B \uBCF8\uBB38\uC73C\uB85C \uB418\uB3CC\uB9BD\uB2C8\uB2E4(\uD558\uD5A5). \uCD5C\uC2E0 CLI(npx @bstage-sdk/cli@latest ai update)\uB85C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.";
|