@tuya-sat/microapp-kit 0.0.0-stage → 0.1.26-alpha.0

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.
Files changed (819) hide show
  1. package/AUDIT.md +43 -0
  2. package/CHANGELOG.md +45 -0
  3. package/MAINTAINING.md +143 -0
  4. package/README.md +53 -2
  5. package/START-HERE.md +40 -0
  6. package/bootstrap/build-install-page.mjs +44 -0
  7. package/bootstrap/install-node.ps1 +80 -0
  8. package/bootstrap/install-node.sh +94 -0
  9. package/bootstrap/install.md.in +29 -0
  10. package/bundle.json +852 -0
  11. package/cli.mjs +3 -0
  12. package/package.json +64 -4
  13. package/resources/contracts/project-permissions.json +596 -0
  14. package/resources/contracts/standard-api.catalog.json +5 -0
  15. package/resources/examples/group-display.mjs +23 -0
  16. package/resources/preview/README.md +104 -0
  17. package/resources/preview/agent-open.mjs +1221 -0
  18. package/resources/preview/application-icon.mjs +27 -0
  19. package/resources/preview/authorization-panel.js +243 -0
  20. package/resources/preview/authorization-routes.mjs +634 -0
  21. package/resources/preview/authorization.mjs +353 -0
  22. package/resources/preview/backend-entry.mjs +22 -0
  23. package/resources/preview/backend-process.mjs +26 -0
  24. package/resources/preview/bridge.js +50 -0
  25. package/resources/preview/control.mjs +48 -0
  26. package/resources/preview/device-fixtures.mjs +38 -0
  27. package/resources/preview/fixtures/context.json +10 -0
  28. package/resources/preview/fixtures/device-catalog.json +363 -0
  29. package/resources/preview/host-contract.mjs +104 -0
  30. package/resources/preview/host.js +841 -0
  31. package/resources/preview/local-dev-provider.mjs +27 -0
  32. package/resources/preview/menu-icons.json +82 -0
  33. package/resources/preview/mock-store.mjs +1147 -0
  34. package/resources/preview/run.mjs +131 -0
  35. package/resources/preview/server.mjs +476 -0
  36. package/resources/preview/theme-tokens.mjs +49 -0
  37. package/resources/preview/themes.json +1036 -0
  38. package/resources/resource-manifest.json +210 -0
  39. package/resources/scripts/backend-build-context.mjs +101 -0
  40. package/resources/scripts/backend-runtime.mjs +68 -0
  41. package/resources/scripts/build-backend-image.sh +23 -0
  42. package/resources/scripts/build-safety.mjs +18 -0
  43. package/resources/scripts/build.mjs +138 -0
  44. package/resources/scripts/command-invocation.mjs +10 -0
  45. package/resources/scripts/diagnostics.mjs +34 -0
  46. package/resources/scripts/init-project.mjs +62 -0
  47. package/resources/scripts/package-release.mjs +80 -0
  48. package/resources/scripts/prepare-locales.mjs +77 -0
  49. package/resources/scripts/project-identity.mjs +21 -0
  50. package/resources/scripts/registry-client.mjs +189 -0
  51. package/resources/scripts/resource-files.mjs +22 -0
  52. package/resources/scripts/scaffold.mjs +31 -0
  53. package/resources/scripts/test-backend-image.mjs +162 -0
  54. package/resources/scripts/update-preview-themes.mjs +26 -0
  55. package/resources/scripts/update-resource-manifest.mjs +9 -0
  56. package/resources/scripts/validate-resources.mjs +9 -0
  57. package/resources/template/_gitignore +5 -0
  58. package/resources/template/backend/.dockerignore +7 -0
  59. package/resources/template/backend/.node-version +1 -0
  60. package/resources/template/backend/Dockerfile +62 -0
  61. package/resources/template/backend/deploy/README.md +105 -0
  62. package/resources/template/backend/deploy/data/README.md +3 -0
  63. package/resources/template/backend/deploy/manifest.json +4 -0
  64. package/resources/template/backend/deploy/tasks/README.md +3 -0
  65. package/resources/template/backend/migrations/README.md +5 -0
  66. package/resources/template/backend/next-env.d.ts +6 -0
  67. package/resources/template/backend/next.config.ts +19 -0
  68. package/resources/template/backend/operations.json +4 -0
  69. package/resources/template/backend/package.json +35 -0
  70. package/resources/template/backend/pnpm-lock.yaml +775 -0
  71. package/resources/template/backend/preview-contract.json +4 -0
  72. package/resources/template/backend/public/.keep +0 -0
  73. package/resources/template/backend/scripts/check-runtime.mjs +12 -0
  74. package/resources/template/backend/scripts/dev-deploy-prepare.mjs +362 -0
  75. package/resources/template/backend/scripts/dev-diagnose-database.mjs +199 -0
  76. package/resources/template/backend/scripts/dev-start-backend.sh +30 -0
  77. package/resources/template/backend/src/app/[[...path]]/route.ts +11 -0
  78. package/resources/template/backend/src/app/api/[...path]/route.ts +11 -0
  79. package/resources/template/backend/src/app/api/health/route.ts +16 -0
  80. package/resources/template/backend/src/app/api/preview/context/route.ts +36 -0
  81. package/resources/template/backend/src/instrumentation.ts +10 -0
  82. package/resources/template/backend/src/lib/api-response.mjs +119 -0
  83. package/resources/template/backend/src/lib/business-logger.mjs +29 -0
  84. package/resources/template/backend/src/lib/database-errors.mjs +15 -0
  85. package/resources/template/backend/src/lib/dev-authorization.mjs +84 -0
  86. package/resources/template/backend/src/lib/dev-context.mjs +58 -0
  87. package/resources/template/backend/src/lib/gateway-ingress.mjs +79 -0
  88. package/resources/template/backend/src/lib/gateway-nonce-store.mjs +31 -0
  89. package/resources/template/backend/src/lib/gateway-verification.mjs +197 -0
  90. package/resources/template/backend/src/lib/request-observability.mjs +93 -0
  91. package/resources/template/backend/src/lib/standard-api.ts +28 -0
  92. package/resources/template/backend/src/microapp-identity.json +1 -0
  93. package/resources/template/backend/src/proxy.ts +40 -0
  94. package/resources/template/backend/tests/api-response.test.mjs +77 -0
  95. package/resources/template/backend/tests/database-diagnostics.test.mjs +198 -0
  96. package/resources/template/backend/tests/deployment-connection.test.mjs +100 -0
  97. package/resources/template/backend/tests/deployment-postgres.test.mjs +109 -0
  98. package/resources/template/backend/tests/deployment.test.mjs +196 -0
  99. package/resources/template/backend/tests/dev-authorization.test.mjs +88 -0
  100. package/resources/template/backend/tests/dev-context.test.mjs +35 -0
  101. package/resources/template/backend/tests/gateway-verification.test.mjs +287 -0
  102. package/resources/template/backend/tests/request-observability.test.mjs +125 -0
  103. package/resources/template/backend/tests/routes.test.mjs +253 -0
  104. package/resources/template/backend/tests/startup.test.mjs +147 -0
  105. package/resources/template/backend/tsconfig.json +34 -0
  106. package/resources/template/micro-app/.editorconfig +15 -0
  107. package/resources/template/micro-app/.eslintrc +15 -0
  108. package/resources/template/micro-app/.prettierignore +4 -0
  109. package/resources/template/micro-app/.prettierrc +6 -0
  110. package/resources/template/micro-app/_gitignore +6 -0
  111. package/resources/template/micro-app/_locales/en.json +5 -0
  112. package/resources/template/micro-app/_locales/zh-CN.json +5 -0
  113. package/resources/template/micro-app/antd.less.overwrite.js +4 -0
  114. package/resources/template/micro-app/babel.config.json +3 -0
  115. package/resources/template/micro-app/manifest.json +46 -0
  116. package/resources/template/micro-app/micro.config.js +4 -0
  117. package/resources/template/micro-app/mock/index.json +4 -0
  118. package/resources/template/micro-app/package.json +61 -0
  119. package/resources/template/micro-app/public/favicon.ico +0 -0
  120. package/resources/template/micro-app/public/index.ejs +13 -0
  121. package/resources/template/micro-app/src/App.less +0 -0
  122. package/resources/template/micro-app/src/App.tsx +99 -0
  123. package/resources/template/micro-app/src/api/api-request.mjs +85 -0
  124. package/resources/template/micro-app/src/api/custom-api-headers.mjs +55 -0
  125. package/resources/template/micro-app/src/api/custom-api.ts +10 -0
  126. package/resources/template/micro-app/src/api/errors.mjs +108 -0
  127. package/resources/template/micro-app/src/api/index.ts +34 -0
  128. package/resources/template/micro-app/src/api/presentation.mjs +33 -0
  129. package/resources/template/micro-app/src/api/req.ts +9 -0
  130. package/resources/template/micro-app/src/api/request-url.mjs +20 -0
  131. package/resources/template/micro-app/src/api/res.ts +9 -0
  132. package/resources/template/micro-app/src/api/submission-errors.mjs +84 -0
  133. package/resources/template/micro-app/src/components/CapsuleFilters/index.module.less +121 -0
  134. package/resources/template/micro-app/src/components/CapsuleFilters/index.tsx +100 -0
  135. package/resources/template/micro-app/src/components/MicroAppUI/DataTable.tsx +48 -0
  136. package/resources/template/micro-app/src/components/MicroAppUI/EllipsisText.tsx +25 -0
  137. package/resources/template/micro-app/src/components/MicroAppUI/Layouts.tsx +54 -0
  138. package/resources/template/micro-app/src/components/MicroAppUI/ModalForm.tsx +230 -0
  139. package/resources/template/micro-app/src/components/MicroAppUI/StatusBadge.tsx +19 -0
  140. package/resources/template/micro-app/src/components/MicroAppUI/index.module.less +99 -0
  141. package/resources/template/micro-app/src/components/MicroAppUI/index.ts +13 -0
  142. package/resources/template/micro-app/src/index.css +16 -0
  143. package/resources/template/micro-app/src/index.tsx +66 -0
  144. package/resources/template/micro-app/src/interfaces.ts +545 -0
  145. package/resources/template/micro-app/src/lang/en.ts +1 -0
  146. package/resources/template/micro-app/src/lang/index.ts +31 -0
  147. package/resources/template/micro-app/src/lang/zh.ts +1 -0
  148. package/resources/template/micro-app/src/language-codes.mjs +32 -0
  149. package/resources/template/micro-app/src/language-policy.ts +6 -0
  150. package/resources/template/micro-app/src/microapp-identity.json +1 -0
  151. package/resources/template/micro-app/src/pages/index.module.less +3 -0
  152. package/resources/template/micro-app/src/pages/index.tsx +6 -0
  153. package/resources/template/micro-app/src/public-path.js +4 -0
  154. package/resources/template/micro-app/src/utils/antdLang.ts +244 -0
  155. package/resources/template/micro-app/tests/template.test.cjs +15 -0
  156. package/resources/template/micro-app/tsconfig.extend.json +8 -0
  157. package/resources/template/micro-app/tsconfig.json +24 -0
  158. package/resources/template/micro-app/typings.d.ts +19 -0
  159. package/resources/template/micro-app/yarn.lock +7491 -0
  160. package/resources/tests/agent-open-catalog.test.mjs +43 -0
  161. package/resources/tests/agent-open-preview.test.mjs +878 -0
  162. package/resources/tests/api-request.test.mjs +121 -0
  163. package/resources/tests/api-response.test.mjs +2 -0
  164. package/resources/tests/application-icon-build.test.mjs +34 -0
  165. package/resources/tests/authorization-proxy.test.mjs +202 -0
  166. package/resources/tests/authorization.test.mjs +462 -0
  167. package/resources/tests/backend-context.test.mjs +33 -0
  168. package/resources/tests/backend-preview.test.mjs +67 -0
  169. package/resources/tests/backend-request-logging.test.mjs +2 -0
  170. package/resources/tests/backend-runtime.test.mjs +96 -0
  171. package/resources/tests/browser-authorization-smoke.mjs +111 -0
  172. package/resources/tests/browser-design-smoke.mjs +107 -0
  173. package/resources/tests/browser-language-compat-smoke.mjs +48 -0
  174. package/resources/tests/browser-preview-smoke.mjs +148 -0
  175. package/resources/tests/browser-standard-ui-smoke.mjs +331 -0
  176. package/resources/tests/build-safety.test.mjs +69 -0
  177. package/resources/tests/business-build.test.mjs +86 -0
  178. package/resources/tests/command-invocation.test.mjs +35 -0
  179. package/resources/tests/custom-api-headers.test.mjs +96 -0
  180. package/resources/tests/custom-route.test.mjs +63 -0
  181. package/resources/tests/custom-script-policy.test.mjs +34 -0
  182. package/resources/tests/database-errors.test.mjs +81 -0
  183. package/resources/tests/deployment-package.test.mjs +45 -0
  184. package/resources/tests/dockerfile-logging.test.mjs +31 -0
  185. package/resources/tests/fixtures/capsule-page.tsx +46 -0
  186. package/resources/tests/fixtures/standard-ui-page.tsx +222 -0
  187. package/resources/tests/group-display.test.mjs +28 -0
  188. package/resources/tests/host-contract.test.mjs +84 -0
  189. package/resources/tests/image-test.test.mjs +110 -0
  190. package/resources/tests/initialization.test.mjs +98 -0
  191. package/resources/tests/language-selection.test.mjs +188 -0
  192. package/resources/tests/locale-keys.test.mjs +88 -0
  193. package/resources/tests/preview-control.test.mjs +56 -0
  194. package/resources/tests/preview-icon.test.mjs +117 -0
  195. package/resources/tests/preview-state.test.mjs +183 -0
  196. package/resources/tests/preview-theme.test.mjs +17 -0
  197. package/resources/tests/real-preview-smoke.mjs +34 -0
  198. package/resources/tests/registry-client.test.mjs +272 -0
  199. package/resources/tests/request-errors.test.mjs +51 -0
  200. package/resources/tests/request-method-contract.test.mjs +65 -0
  201. package/resources/tests/resources.test.mjs +31 -0
  202. package/resources/tests/saas-presentation.test.mjs +41 -0
  203. package/resources/tests/sandbox-scripts.test.mjs +144 -0
  204. package/resources/tests/space-permission-guidance.test.mjs +78 -0
  205. package/resources/tests/standard-api-preview.test.mjs +55 -0
  206. package/resources/tests/submission-errors.test.mjs +118 -0
  207. package/resources/tests/version-description-package.test.mjs +60 -0
  208. package/resources/ui/component-sources.json +36 -0
  209. package/runtime/assemble.mjs +66 -0
  210. package/runtime/auth/hidden-input.mjs +45 -0
  211. package/runtime/auth/macos-credentials.js +41 -0
  212. package/runtime/auth/manager.mjs +145 -0
  213. package/runtime/auth/session.mjs +153 -0
  214. package/runtime/auth/state.mjs +107 -0
  215. package/runtime/auth/store.mjs +130 -0
  216. package/runtime/auth/windows-credentials.ps1 +73 -0
  217. package/runtime/auth/wizard.mjs +224 -0
  218. package/runtime/cli.mjs +474 -0
  219. package/runtime/dev-database.mjs +155 -0
  220. package/runtime/dev-provider.mjs +41 -0
  221. package/runtime/errors.mjs +205 -0
  222. package/runtime/install-receipt.mjs +68 -0
  223. package/runtime/installation.mjs +92 -0
  224. package/runtime/integrity.mjs +110 -0
  225. package/runtime/launcher.mjs +104 -0
  226. package/runtime/pack-npm.mjs +76 -0
  227. package/runtime/package-cache.mjs +52 -0
  228. package/runtime/package-identity.mjs +22 -0
  229. package/runtime/preview.mjs +157 -0
  230. package/runtime/project-identity.mjs +57 -0
  231. package/runtime/publication.mjs +372 -0
  232. package/runtime/release-content.mjs +159 -0
  233. package/runtime/release-index.mjs +91 -0
  234. package/runtime/setup.mjs +223 -0
  235. package/runtime/tests/agent-entry.test.mjs +79 -0
  236. package/runtime/tests/auth-wizard.test.mjs +241 -0
  237. package/runtime/tests/auth.test.mjs +367 -0
  238. package/runtime/tests/consistency-workflow.test.mjs +84 -0
  239. package/runtime/tests/dev-provider.test.mjs +27 -0
  240. package/runtime/tests/diagnostics.test.mjs +66 -0
  241. package/runtime/tests/helpers/tar-fixture.mjs +25 -0
  242. package/runtime/tests/install-page.test.mjs +41 -0
  243. package/runtime/tests/install.test.mjs +432 -0
  244. package/runtime/tests/node-bootstrap.test.mjs +104 -0
  245. package/runtime/tests/npm-distribution.test.mjs +98 -0
  246. package/runtime/tests/package-cache.test.mjs +108 -0
  247. package/runtime/tests/package-migration.test.mjs +208 -0
  248. package/runtime/tests/preview-hosts.test.mjs +66 -0
  249. package/runtime/tests/preview.test.mjs +304 -0
  250. package/runtime/tests/project-identity.test.mjs +67 -0
  251. package/runtime/tests/publication.test.mjs +436 -0
  252. package/runtime/tests/release-recovery.test.mjs +417 -0
  253. package/runtime/tests/repository-source.test.mjs +38 -0
  254. package/runtime/tests/skill-set-update.test.mjs +169 -0
  255. package/runtime/tests/standalone.test.mjs +46 -0
  256. package/runtime/tests/update-check.test.mjs +165 -0
  257. package/runtime/tests/update.test.mjs +292 -0
  258. package/runtime/tests/workspace.test.mjs +156 -0
  259. package/runtime/update-check.mjs +160 -0
  260. package/runtime/update-state.mjs +83 -0
  261. package/runtime/update.mjs +292 -0
  262. package/runtime/workspace-migration.mjs +109 -0
  263. package/runtime/workspace.mjs +101 -0
  264. package/schemas/toolchain.schema.json +13 -0
  265. package/setup.mjs +3 -0
  266. package/skills/micro-app-backend-development/SKILL.md +64 -0
  267. package/skills/micro-app-backend-development/references/backend-security-workflow.md +77 -0
  268. package/skills/micro-app-backend-development/references/business-build-helpers.md +11 -0
  269. package/skills/micro-app-backend-development/references/business-logging.md +56 -0
  270. package/skills/micro-app-backend-development/references/database-constraints.md +81 -0
  271. package/skills/micro-app-backend-development/references/database-write-errors.md +29 -0
  272. package/skills/micro-app-backend-development/references/deployment-bundle.md +65 -0
  273. package/skills/micro-app-backend-development/references/dev-preview-context.md +23 -0
  274. package/skills/micro-app-backend-development/references/gateway-verification.md +43 -0
  275. package/skills/micro-app-backend-development/references/implementation.md +49 -0
  276. package/skills/micro-app-backend-development/references/local-database-preview.md +100 -0
  277. package/skills/micro-app-backend-development/references/production-authorization-readiness.md +60 -0
  278. package/skills/micro-app-backend-development/references/project-data-permissions.md +43 -0
  279. package/skills/micro-app-backend-development/references/runtime-resources-and-deployment.md +76 -0
  280. package/skills/micro-app-backend-development/scripts/microapp-kit.mjs +117 -0
  281. package/skills/micro-app-backend-development/tests/behavior-scenarios.md +62 -0
  282. package/skills/micro-app-cloud-integration/SKILL.md +92 -0
  283. package/skills/micro-app-cloud-integration/references/api-catalog.json +1315 -0
  284. package/skills/micro-app-cloud-integration/references/api-catalog.md +59 -0
  285. package/skills/micro-app-cloud-integration/references/api-device-control.md +67 -0
  286. package/skills/micro-app-cloud-integration/references/api-device.md +179 -0
  287. package/skills/micro-app-cloud-integration/references/api-group-ota.md +145 -0
  288. package/skills/micro-app-cloud-integration/references/api-linkage.md +3 -0
  289. package/skills/micro-app-cloud-integration/references/api-models.md +584 -0
  290. package/skills/micro-app-cloud-integration/references/api-project.md +121 -0
  291. package/skills/micro-app-cloud-integration/references/api-space-home.md +244 -0
  292. package/skills/micro-app-cloud-integration/references/backend-authorization.md +95 -0
  293. package/skills/micro-app-cloud-integration/references/calling-conventions.md +118 -0
  294. package/skills/micro-app-cloud-integration/references/preview-agent-open.md +46 -0
  295. package/skills/micro-app-cloud-integration/references/server-to-server-integration.md +13 -0
  296. package/skills/micro-app-cloud-integration/scripts/microapp-kit.mjs +117 -0
  297. package/skills/micro-app-cloud-integration/tests/behavior-scenarios.md +20 -0
  298. package/skills/micro-app-design/SKILL.md +99 -0
  299. package/skills/micro-app-design/agents/openai.yaml +6 -0
  300. package/skills/micro-app-design/assets/tuya-design-system/assets/README.md +22 -0
  301. package/skills/micro-app-design/assets/tuya-design-system/assets/components/TuyaCapsuleSearch.html +67 -0
  302. package/skills/micro-app-design/assets/tuya-design-system/assets/components/TuyaCardGrid.html +71 -0
  303. package/skills/micro-app-design/assets/tuya-design-system/assets/components/TuyaIcon.html +5 -0
  304. package/skills/micro-app-design/assets/tuya-design-system/assets/components/TuyaPageTitle.html +29 -0
  305. package/skills/micro-app-design/assets/tuya-design-system/assets/components/TuyaTopNavigation.html +55 -0
  306. package/skills/micro-app-design/assets/tuya-design-system/assets/components.schema.md +154 -0
  307. package/skills/micro-app-design/assets/tuya-design-system/assets/examples/dashboard.html +588 -0
  308. package/skills/micro-app-design/assets/tuya-design-system/assets/examples/dashboard.md +99 -0
  309. package/skills/micro-app-design/assets/tuya-design-system/assets/examples/table-page.html +477 -0
  310. package/skills/micro-app-design/assets/tuya-design-system/assets/examples/table-page.md +77 -0
  311. package/skills/micro-app-design/assets/tuya-design-system/assets/templates/base.html +878 -0
  312. package/skills/micro-app-design/assets/tuya-design-system/latest/accessibility/accessibility.md +39 -0
  313. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/TuyaCapsuleSearch.html +67 -0
  314. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/arrow-down.svg +3 -0
  315. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/calendar.svg +5 -0
  316. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/check.svg +3 -0
  317. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/checkbox-check.svg +3 -0
  318. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/clear.svg +4 -0
  319. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/search.svg +4 -0
  320. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/preview.html +3705 -0
  321. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/spec.md +78 -0
  322. package/skills/micro-app-design/assets/tuya-design-system/latest/components/card-grid/examples/TuyaCardGrid.html +71 -0
  323. package/skills/micro-app-design/assets/tuya-design-system/latest/components/card-grid/examples/assets/placeholder.svg +4 -0
  324. package/skills/micro-app-design/assets/tuya-design-system/latest/components/card-grid/examples/preview.html +711 -0
  325. package/skills/micro-app-design/assets/tuya-design-system/latest/components/card-grid/spec.md +93 -0
  326. package/skills/micro-app-design/assets/tuya-design-system/latest/components/cascader/spec.md +75 -0
  327. package/skills/micro-app-design/assets/tuya-design-system/latest/components/checkbox/spec.md +72 -0
  328. package/skills/micro-app-design/assets/tuya-design-system/latest/components/date-picker/spec.md +81 -0
  329. package/skills/micro-app-design/assets/tuya-design-system/latest/components/dropdown/spec.md +99 -0
  330. package/skills/micro-app-design/assets/tuya-design-system/latest/components/icon/examples/TuyaIcon.html +5 -0
  331. package/skills/micro-app-design/assets/tuya-design-system/latest/components/icon/spec.md +55 -0
  332. package/skills/micro-app-design/assets/tuya-design-system/latest/components/input/spec.md +84 -0
  333. package/skills/micro-app-design/assets/tuya-design-system/latest/components/modal/spec.md +178 -0
  334. package/skills/micro-app-design/assets/tuya-design-system/latest/components/page-title/examples/TuyaPageTitle.html +29 -0
  335. package/skills/micro-app-design/assets/tuya-design-system/latest/components/page-title/spec.md +67 -0
  336. package/skills/micro-app-design/assets/tuya-design-system/latest/components/pagination/spec.md +94 -0
  337. package/skills/micro-app-design/assets/tuya-design-system/latest/components/radio/spec.md +80 -0
  338. package/skills/micro-app-design/assets/tuya-design-system/latest/components/search-input/spec.md +101 -0
  339. package/skills/micro-app-design/assets/tuya-design-system/latest/components/select/spec.md +96 -0
  340. package/skills/micro-app-design/assets/tuya-design-system/latest/components/slider/spec.md +66 -0
  341. package/skills/micro-app-design/assets/tuya-design-system/latest/components/switch/spec.md +86 -0
  342. package/skills/micro-app-design/assets/tuya-design-system/latest/components/table/spec.md +116 -0
  343. package/skills/micro-app-design/assets/tuya-design-system/latest/components/time-picker/spec.md +75 -0
  344. package/skills/micro-app-design/assets/tuya-design-system/latest/components/tooltip/spec.md +70 -0
  345. package/skills/micro-app-design/assets/tuya-design-system/latest/components/top-navigation/examples/TuyaTopNavigation.html +55 -0
  346. package/skills/micro-app-design/assets/tuya-design-system/latest/components/top-navigation/spec.md +60 -0
  347. package/skills/micro-app-design/assets/tuya-design-system/latest/components/tree/examples/icons/check.svg +3 -0
  348. package/skills/micro-app-design/assets/tuya-design-system/latest/components/tree/examples/preview.html +974 -0
  349. package/skills/micro-app-design/assets/tuya-design-system/latest/components/tree/spec.md +118 -0
  350. package/skills/micro-app-design/assets/tuya-design-system/latest/components/upload/spec.md +86 -0
  351. package/skills/micro-app-design/assets/tuya-design-system/latest/demo-index.md +43 -0
  352. package/skills/micro-app-design/assets/tuya-design-system/latest/design-system.md +116 -0
  353. package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/color.md +165 -0
  354. package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/elevation.md +21 -0
  355. package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/icon.md +78 -0
  356. package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/layout.md +103 -0
  357. package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/radius.md +22 -0
  358. package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/spacing.md +29 -0
  359. package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/typography.md +43 -0
  360. package/skills/micro-app-design/assets/tuya-design-system/latest/interaction/behavior.md +30 -0
  361. package/skills/micro-app-design/assets/tuya-design-system/latest/interaction/feedback.md +23 -0
  362. package/skills/micro-app-design/assets/tuya-design-system/latest/interaction/state.md +28 -0
  363. package/skills/micro-app-design/assets/tuya-design-system/latest/motion/motion.md +31 -0
  364. package/skills/micro-app-design/assets/tuya-design-system/latest/patterns/dashboard.md +34 -0
  365. package/skills/micro-app-design/assets/tuya-design-system/latest/patterns/data-page.md +30 -0
  366. package/skills/micro-app-design/assets/tuya-design-system/latest/patterns/form-page.md +36 -0
  367. package/skills/micro-app-design/assets/tuya-design-system/latest/patterns/monitoring.md +25 -0
  368. package/skills/micro-app-design/assets/tuya-design-system/latest/quality-checklist.md +71 -0
  369. package/skills/micro-app-design/assets/tuya-design-system/latest/registry.yaml +232 -0
  370. package/skills/micro-app-design/assets/tuya-design-system/latest/tokens.yaml +187 -0
  371. package/skills/micro-app-design/assets/tuya-design-system/resources/README.md +26 -0
  372. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states/README.md +13 -0
  373. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277/403.html +58 -0
  374. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277/404.html +58 -0
  375. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277/500.html +58 -0
  376. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//344/272/213/344/273/266/345/274/202/345/270/270.html +58 -0
  377. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/220/234/347/264/242/346/227/240/347/273/223/346/236/234.html +58 -0
  378. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/232/202/346/227/240/344/275/215/347/275/256/344/277/241/346/201/257.html +58 -0
  379. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/232/202/346/227/240/346/210/277/345/261/213.html +58 -0
  380. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/232/202/346/227/240/346/225/260/346/215/256.html +58 -0
  381. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/232/202/346/227/240/346/266/210/346/201/257.html +58 -0
  382. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/232/202/346/227/240/347/275/221/347/273/234.html +58 -0
  383. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/232/202/346/227/240/350/256/276/345/244/207.html +58 -0
  384. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/232/202/346/227/240/351/241/271/347/233/256.html +58 -0
  385. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203.md +159 -0
  386. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210/403.html +31 -0
  387. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210/404.html +31 -0
  388. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210/500.html +31 -0
  389. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210/empty.css +106 -0
  390. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210/empty.js +49 -0
  391. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210/index.html +69 -0
  392. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//344/272/213/344/273/266/345/274/202/345/270/270.html +31 -0
  393. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//345/233/276/347/211/207/345/212/240/350/275/275/345/244/261/350/264/245.html +31 -0
  394. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/220/234/347/264/242/346/227/240/347/273/223/346/236/234.html +31 -0
  395. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/232/202/346/227/240/344/275/215/347/275/256/344/277/241/346/201/257.html +31 -0
  396. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/232/202/346/227/240/346/210/277/345/261/213.html +31 -0
  397. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/232/202/346/227/240/346/225/260/346/215/256.html +31 -0
  398. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/232/202/346/227/240/346/266/210/346/201/257.html +31 -0
  399. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/232/202/346/227/240/347/275/221/347/273/234.html +31 -0
  400. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/232/202/346/227/240/350/256/276/345/244/207.html +31 -0
  401. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/232/202/346/227/240/351/241/271/347/233/256.html +31 -0
  402. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/README.md +23 -0
  403. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/arrow-down.svg +3 -0
  404. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/calendar.svg +5 -0
  405. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/check.svg +3 -0
  406. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/clear.svg +4 -0
  407. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/search.svg +4 -0
  408. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/sources/arrow-down-ref.png +0 -0
  409. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/sources/check-ref.png +0 -0
  410. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/sources/clear-ref.png +0 -0
  411. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/sources/search-ref.png +0 -0
  412. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/Excel.svg +1 -0
  413. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/HD.svg +1 -0
  414. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/PM.svg +1 -0
  415. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/PPT.svg +1 -0
  416. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/README.md +14 -0
  417. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/VOC.svg +1 -0
  418. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/app/347/256/241/347/220/206.svg +1 -0
  419. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/catalog.md +377 -0
  420. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/folder-closed.svg +3 -0
  421. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/license/347/256/241/347/220/206.svg +1 -0
  422. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/nps/351/207/217/350/241/250 /346/224/266/350/227/217.svg" +1 -0
  423. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/sos-2.svg +1 -0
  424. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/sos.svg +1 -0
  425. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/word.svg +1 -0
  426. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/270/200/346/260/247/345/214/226/347/242/263-2.svg +1 -0
  427. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/270/200/346/260/247/345/214/226/347/242/263.svg +1 -0
  428. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/270/212/344/274/240.svg +1 -0
  429. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/214/346/260/247/345/214/226/347/242/263.svg +1 -0
  430. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/221.svg +1 -0
  431. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/221/347/253/257 /344/270/213/350/275/275.svg" +1 -0
  432. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/256/345/272/246 /345/244/252/351/230/263 /346/227/245/351/227/264.svg" +1 -0
  433. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/272/344/275/223/344/274/240/346/204/237/345/231/250.svg +1 -0
  434. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/272/345/203/217@2x.svg +1 -0
  435. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/272/345/221/230/345/244/207/344/273/275@2x.svg +1 -0
  436. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/272/346/260/221/345/270/201@2x.svg +1 -0
  437. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/272/350/204/270/350/257/206/345/210/253/346/210/220/345/212/237@2x.svg +1 -0
  438. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/272/350/241/214/351/227/250/347/246/201.svg +1 -0
  439. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/274/230/346/203/240/345/210/270@2x.svg +1 -0
  440. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/274/232/345/221/230@2x.svg +1 -0
  441. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/201/234/350/275/246@2x.svg +1 -0
  442. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/205/205/347/224/265/346/241/251@2x.svg +1 -0
  443. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/205/245/344/276/265/345/221/212/350/255/246@2x.svg +1 -0
  444. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/205/250/347/220/203 /345/234/260/347/220/203 @2x.svg" +1 -0
  445. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/206/260/347/256/261.svg +1 -0
  446. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/206/267/346/260/264.svg +1 -0
  447. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/210/267/346/274/206.svg +1 -0
  448. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/212/240/346/262/271/347/253/231@2x.svg +1 -0
  449. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/214/226/345/220/210/347/211/251.svg +1 -0
  450. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/214/226/345/255/246-2.svg +1 -0
  451. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/214/226/345/255/246.svg +1 -0
  452. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/215/240/346/257/224/345/233/276.svg +1 -0
  453. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/215/267/345/256/227.svg +1 -0
  454. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/215/267/345/260/272.svg +1 -0
  455. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/216/237/345/255/220 /347/211/251/347/220/206 /346/227/213/350/275/254.svg" +1 -0
  456. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/217/221/345/215/241@2x.svg +1 -0
  457. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/217/260/345/274/217/347/224/265/350/204/221 /346/230/276/347/244/272/345/231/250 /345/261/217/345/271/225.svg" +1 -0
  458. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/220/212/347/201/257.svg +1 -0
  459. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/220/271/351/243/216/346/234/272 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  460. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/221/212/350/255/246/344/270/255/345/277/203.svg +1 -0
  461. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/221/274/345/220/270/347/216/207.svg +1 -0
  462. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/225/206/345/272/227@2x.svg +1 -0
  463. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/226/234/346/254/242@2x.svg +1 -0
  464. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/233/276/347/211/207-/346/255/243/345/270/270.svg +1 -0
  465. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/234/250/347/272/277/346/234/215/345/212/241/345/217/260@2x.svg +1 -0
  466. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/234/260/345/233/276@2x.svg +1 -0
  467. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/234/260/351/223/201@2x.svg +1 -0
  468. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/237/272/345/233/240 DNA.svg" +1 -0
  469. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/237/272/345/233/240.svg +1 -0
  470. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/240/206/345/217/240/346/237/261/347/212/266.svg +1 -0
  471. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/243/260/345/205/211/346/212/245/350/255/246.svg +1 -0
  472. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/244/232/347/275/221/351/241/265 web /345/244/232/347/252/227/345/217/243.svg" +1 -0
  473. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/244/247/350/204/221.svg +1 -0
  474. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/256/236/346/227/266/346/246/202/350/247/210 /351/245/274/345/233/276.svg" +1 -0
  475. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/256/244/345/244/226/346/270/251/345/272/246.svg +1 -0
  476. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/257/271/346/216/245 /344/272/244/346/215/242.svg" +1 -0
  477. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/260/272/345/255/220.svg +1 -0
  478. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/260/272/345/257/270.svg +1 -0
  479. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/267/264/345/243/253@2x.svg +1 -0
  480. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/270/203/345/261/200.svg +1 -0
  481. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/270/203/351/230/262/346/217/220/351/206/222.svg +1 -0
  482. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/272/212 /347/235/241/347/234/240.svg" +1 -0
  483. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/272/212.svg +1 -0
  484. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/272/224/347/224/250/351/205/215/347/275/256.svg +1 -0
  485. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/345/205/263 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  486. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/345/217/221 /344/273/243/347/240/201 Bug@2x.svg" +1 -0
  487. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/345/217/221 /344/273/243/347/240/201 Code@2x.svg" +1 -0
  488. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/345/217/221 /344/273/243/347/240/201 js /344/273/243/347/240/201@2x.svg" +1 -0
  489. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/345/217/221 /344/273/243/347/240/201 /344/273/243/347/240/201@2x.svg" +1 -0
  490. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/345/217/221 /344/273/243/347/240/201 /347/275/221/351/241/265 /344/273/243/347/240/201@2x.svg" +1 -0
  491. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/351/227/250-2.svg +1 -0
  492. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/351/227/250.svg +1 -0
  493. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/275/225/345/203/217.svg +1 -0
  494. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/276/252/347/216/257.svg +1 -0
  495. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/276/256/346/263/242/347/202/211 /347/203/244/347/256/261 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  496. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/277/203/347/216/207 /345/277/203/347/224/265/345/233/276.svg" +1 -0
  497. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/277/203/347/216/207.svg +1 -0
  498. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/277/203/347/224/265/345/233/276 /346/201/222/346/265/201/346/263/204/351/234/262/344/270/212/345/221/212.svg" +1 -0
  499. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/277/203/350/267/263/346/243/200/346/265/213.svg +1 -0
  500. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/200/235/350/200/203 /350/201/224/346/203/263.svg" +1 -0
  501. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/200/245/346/225/221.svg +1 -0
  502. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/210/277/351/227/264@2x.png +0 -0
  503. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/211/213/346/234/272.svg +1 -0
  504. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/211/213/350/241/250.svg +1 -0
  505. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/211/223/345/215/260/346/234/272.svg +1 -0
  506. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/212/225/345/275/261/344/273/252 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  507. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/212/230/347/272/277/345/233/276.svg +1 -0
  508. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/212/230/347/272/277/351/235/242/347/247/257/345/233/276.svg +1 -0
  509. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/212/245/350/255/246.svg +1 -0
  510. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/213/205/346/236/266/350/275/246@2x.svg +1 -0
  511. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/213/215/347/205/247.svg +1 -0
  512. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/214/207/347/272/271@2x.svg +1 -0
  513. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/216/210/346/235/203.svg +1 -0
  514. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/221/204/345/203/217/345/244/264.svg +1 -0
  515. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/224/257/344/273/230@2x.svg +1 -0
  516. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/224/266/350/227/217/346/266/210/346/201/257.svg +1 -0
  517. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/221/346/212/244/350/275/246@2x.svg +1 -0
  518. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/243/347/202/271/345/233/276.svg +1 -0
  519. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/260/346/215/256 /345/210/206/346/236/220 /345/276/252/347/216/257.svg" +1 -0
  520. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/260/346/215/256 /351/245/274/345/233/276.svg" +1 -0
  521. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/260/346/215/256.svg +1 -0
  522. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/260/346/215/256/346/272/220.svg +1 -0
  523. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/264/344/275/223/346/246/202/345/206/265-2.svg +1 -0
  524. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/264/344/275/223/346/246/202/345/206/265.svg +1 -0
  525. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/344/273/266/345/244/271/346/211/223/345/274/200.svg +1 -0
  526. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/345/255/227.svg +1 -0
  527. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 amr.svg" +1 -0
  528. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 ara.svg" +1 -0
  529. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 bmp.svg" +1 -0
  530. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 csv.svg" +1 -0
  531. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 doc.svg" +1 -0
  532. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 gif.svg" +1 -0
  533. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 jpeg.svg" +1 -0
  534. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 jpg.svg" +1 -0
  535. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 json.svg" +1 -0
  536. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 md.svg" +1 -0
  537. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 mp3.svg" +1 -0
  538. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 mp4.svg" +1 -0
  539. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 pdf.svg" +1 -0
  540. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 png.svg" +1 -0
  541. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 ppt.svg" +1 -0
  542. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 psd.svg" +1 -0
  543. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 svg.svg" +1 -0
  544. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 txt.svg" +1 -0
  545. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 wav.svg" +1 -0
  546. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 xls.svg" +1 -0
  547. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 zip.svg" +1 -0
  548. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/255/347/272/277 /346/226/255/347/275/221/351/207/215/350/257/225 /350/204/211/345/206/262.svg" +1 -0
  549. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/271/346/241/210/347/256/241/347/220/206@2x.png +0 -0
  550. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/275/345/267/245/345/221/230/347/256/241/347/220/206@2x.svg +1 -0
  551. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/227/240/344/272/272/346/234/272.svg +1 -0
  552. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/227/245/346/234/237@2x-2.svg +1 -0
  553. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/227/245/346/234/237@2x.svg +1 -0
  554. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/231/272/350/203/275/346/210/277/351/227/264.svg +1 -0
  555. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/231/272/350/203/275/347/233/221/346/216/247.svg +1 -0
  556. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/231/272/350/203/275/351/227/250/347/246/201.svg +1 -0
  557. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/233/262/347/272/277/345/233/276.svg +1 -0
  558. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/234/211/345/256/263-/346/214/245/345/217/221/346/200/247/346/234/211/346/234/272/347/211/251.svg +1 -0
  559. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/234/215/345/212/241/345/231/250-2.svg +1 -0
  560. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/234/215/345/212/241/345/231/250-3.svg +1 -0
  561. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/234/215/345/212/241/345/231/250.svg +1 -0
  562. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/234/254/345/234/260/350/247/206/351/242/221.svg +1 -0
  563. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/234/272/345/231/250/344/272/272 /344/272/272/345/267/245/346/231/272/350/203/275 .svg" +1 -0
  564. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/237/261/347/212/266/345/233/276-2.svg +1 -0
  565. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/237/261/347/212/266/345/233/276.svg +1 -0
  566. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/240/207/346/270/205.svg +1 -0
  567. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/240/207/347/255/276 /346/240/207/350/256/260@2x.svg" +1 -0
  568. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/240/221/346/234/250 /347/216/257/345/242/203.svg" +1 -0
  569. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/240/221/346/234/250.svg +1 -0
  570. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/240/241/350/275/246@2x.svg +1 -0
  571. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/242/257/346/216/247.svg +1 -0
  572. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/250/241/346/235/277.svg +1 -0
  573. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/224/346/263/241/345/233/276.svg +1 -0
  574. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/344/276/265/344/274/240/346/204/237.svg +1 -0
  575. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/346/265/270.svg +1 -0
  576. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/346/265/270/345/221/212/350/255/246.svg +1 -0
  577. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/347/224/265/347/256/241/347/220/206-2.svg +1 -0
  578. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/347/224/265/347/256/241/347/220/206-3.svg +1 -0
  579. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/347/224/265/347/256/241/347/220/206.svg +1 -0
  580. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/347/224/265/347/256/241/347/220/206_/345/211/257/346/234/254.svg +1 -0
  581. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/350/255/246.svg +1 -0
  582. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/261/202/346/225/221.svg +1 -0
  583. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/261/241/346/237/223.svg +1 -0
  584. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/261/275/350/275/246 /350/277/220/350/276/223 @2x.svg" +1 -0
  585. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/262/231/345/217/221.svg +1 -0
  586. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/264/227/350/241/243/346/234/272 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  587. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/265/213/350/257/225 /347/247/222/350/241/250@2x.svg" +1 -0
  588. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/265/264/346/261/240 /346/265/264/347/274/270 .svg" +1 -0
  589. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/266/210/346/201/257@2x-2.svg +1 -0
  590. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/266/210/346/201/257@2x-3.svg +1 -0
  591. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/266/210/346/201/257@2x.svg +1 -0
  592. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/267/273/345/212/240/351/241/271/347/233/256-2.svg +1 -0
  593. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/267/273/345/212/240/351/241/271/347/233/256.svg +1 -0
  594. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/270/251/345/272/246-2.svg +1 -0
  595. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/270/251/345/272/246.svg +1 -0
  596. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/270/251/345/272/246/350/277/207/344/275/216.svg +1 -0
  597. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/270/251/345/272/246/350/277/207/351/253/230.svg +1 -0
  598. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/270/270/346/210/217/344/274/221/351/227/262/345/250/261/344/271/220.svg +1 -0
  599. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/271/277/345/272/246/350/277/207/344/275/216.svg +1 -0
  600. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/271/277/345/272/246/350/277/207/351/253/230.svg +1 -0
  601. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/253.svg +1 -0
  602. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/253/347/201/276.svg +1 -0
  603. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/253/350/255/246.svg +1 -0
  604. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/253/350/275/246@2x-2.svg +1 -0
  605. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/253/350/275/246@2x.svg +1 -0
  606. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/255/347/201/253/345/231/250.svg +1 -0
  607. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/257.svg +1 -0
  608. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/203/237/351/233/276-2.svg +1 -0
  609. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/203/237/351/233/276.svg +1 -0
  610. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/203/237/351/233/276/345/221/212/350/255/246.svg +1 -0
  611. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/203/255/346/260/264.svg +1 -0
  612. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/203/255/346/260/264/345/243/266 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  613. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/205/247/345/272/246.svg +1 -0
  614. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/207/203/346/260/224.svg +1 -0
  615. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/207/203/346/260/224_/345/211/257/346/234/254.svg +1 -0
  616. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/212/266/346/200/201.svg +1 -0
  617. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/216/257/345/242/203 /346/240/221/345/217/266.svg" +1 -0
  618. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/216/257/345/242/203 /346/240/221/346/234/250.svg" +1 -0
  619. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/216/257/345/242/203.svg +1 -0
  620. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/216/257/345/242/203/347/233/221/346/265/213-2.svg +1 -0
  621. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/216/257/345/242/203/347/233/221/346/265/213.svg +1 -0
  622. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/216/257/345/275/242/345/233/276.svg +1 -0
  623. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/262/347/203/267/345/274/202/345/270/270.svg +1 -0
  624. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/262/351/206/233.svg +1 -0
  625. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265.svg +1 -0
  626. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/345/212/250/350/275/246@2x.svg +1 -0
  627. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/345/255/220/345/233/264/346/240/217 /346/241/206/351/200/211.svg" +1 -0
  628. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/346/272/220 /347/224/265/347/223/266.svg" +1 -0
  629. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/350/247/206 /347/233/264/346/222/255 .svg" +1 -0
  630. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/350/264/271.svg +1 -0
  631. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/351/222/273.svg +1 -0
  632. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/351/243/216/346/211/207.svg +1 -0
  633. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/351/245/255/351/224/205 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  634. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/273/346/235/277.svg +1 -0
  635. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/233/221/346/265/213.svg +1 -0
  636. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/233/270/346/234/272.svg +1 -0
  637. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/235/241/347/234/240.svg +1 -0
  638. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/244/276/345/214/272/346/231/272/350/203/275-2.svg +1 -0
  639. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/244/276/345/214/272/346/231/272/350/203/275.svg +1 -0
  640. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/246/273/347/272/277.svg +1 -0
  641. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/247/237/350/265/201/347/256/241/347/220/206.svg +1 -0
  642. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/247/257/345/210/206/350/277/220/350/220/245@2x.svg +1 -0
  643. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/251/272/346/260/224/345/207/200/345/214/226/345/231/250 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  644. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/251/272/350/260/203.svg +1 -0
  645. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/251/272/351/227/264@2x.png +0 -0
  646. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/252/227/345/270/230.svg +1 -0
  647. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/254/224/350/256/260/346/234/254/347/224/265/350/204/221-2.svg +1 -0
  648. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/254/224/350/256/260/346/234/254/347/224/265/350/204/221.svg +1 -0
  649. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/255/211/345/276/205 /345/200/222/350/256/260/346/227/266@2x.svg" +1 -0
  650. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/255/211/345/276/205@2x.svg +1 -0
  651. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/272/242/347/273/277/347/201/257@2x.svg +1 -0
  652. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/273/204/347/273/207/347/256/241/347/220/206@2x-2.png +0 -0
  653. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/273/204/347/273/207/347/256/241/347/220/206@2x.png +0 -0
  654. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/274/226/350/276/221@2x.png +0 -0
  655. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/275/221/351/241/265.svg +1 -0
  656. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/276/216/345/205/203@2x.svg +1 -0
  657. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/200/201/344/272/272 /350/200/201/345/271/264/344/272/272@2x.svg" +1 -0
  658. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/200/263/346/234/272-2.svg +1 -0
  659. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/200/263/346/234/272-3.svg +1 -0
  660. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/200/263/346/234/272.svg +1 -0
  661. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/203/275/345/212/233.svg +1 -0
  662. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/207/252/350/241/214/350/275/246@2x.svg +1 -0
  663. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/212/202/350/203/275.svg +1 -0
  664. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/212/257/347/211/207.svg +1 -0
  665. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/241/200/345/216/213/345/274/202/345/270/270.svg +1 -0
  666. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/241/200/346/260/247.svg +1 -0
  667. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/247/204/350/214/203.md +264 -0
  668. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/247/206/345/233/276/346/250/241/345/274/217.svg +1 -0
  669. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/247/206/351/242/221.svg +1 -0
  670. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/247/206/351/242/221AI.svg +1 -0
  671. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/247/206/351/242/221SD.svg +1 -0
  672. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/242/345/215/225.svg +1 -0
  673. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207-2.svg +1 -0
  674. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207-3.svg +1 -0
  675. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207-4.svg +1 -0
  676. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207-5.svg +1 -0
  677. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207.svg +1 -0
  678. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207/344/272/244/344/273/230-2.svg +1 -0
  679. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207/344/272/244/344/273/230.svg +1 -0
  680. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207/350/277/220/347/273/264.svg +1 -0
  681. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207/350/277/220/350/241/214/347/233/221/346/265/213.svg +1 -0
  682. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207/350/277/236/346/216/245.svg +1 -0
  683. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/347/275/256@2x.svg +1 -0
  684. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/347/275/256/350/260/203/350/257/225.svg +1 -0
  685. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/257/273/345/215/241/345/231/250 /344/277/241/345/217/267.svg" +1 -0
  686. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/264/246/345/217/267@2x.svg +1 -0
  687. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/264/247/350/275/246@2x.svg +1 -0
  688. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/264/255/347/211/251/350/275/246@2x-2.svg +1 -0
  689. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/264/255/347/211/251/350/275/246@2x.svg +1 -0
  690. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/265/204/344/272/247/344/270/255/345/277/203@2x.svg +1 -0
  691. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/267/257/351/232/234.svg +1 -0
  692. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/267/257/351/232/234lu zhang-2.svg" +1 -0
  693. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/267/257/351/232/234lu zhang.svg" +1 -0
  694. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/246/350/241/214@2x.svg +1 -0
  695. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/254/344/272/244/346/235/203/351/231/220.svg +1 -0
  696. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/256/346/244/205-2.svg +1 -0
  697. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/256/346/244/205.svg +1 -0
  698. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/256/346/270/241@2x.svg +1 -0
  699. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/277/350/275/246@2x-2.svg +1 -0
  700. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/277/350/275/246@2x.svg +1 -0
  701. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/277/220/350/220/245/347/256/241/347/220/206.svg +1 -0
  702. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/277/220/350/276/223/350/275/246@2x.svg +1 -0
  703. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/277/233/345/272/246/346/235/241.svg +1 -0
  704. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/200/232/346/226/255/345/231/250.svg +1 -0
  705. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/201/245/346/216/247.svg +1 -0
  706. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/223/201/351/224/271.svg +1 -0
  707. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/224/201.svg +1 -0
  708. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/224/256/347/233/230.svg +1 -0
  709. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/227/250/347/243/201/345/221/212/350/255/246.svg +1 -0
  710. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/227/250/351/224/201.svg +1 -0
  711. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/227/256/345/217/267@2x.svg +1 -0
  712. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/230/266/346/242/257@2x.svg +1 -0
  713. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/233/252/350/212/261 /344/270/213/351/233/252 .svg" +1 -0
  714. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/233/252/350/212/261 /345/210/266/345/206/267.svg" +1 -0
  715. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/233/267/350/276/276 /346/211/253/346/217/217 /345/217/221/347/216/260 .svg" +1 -0
  716. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/235/231/350/204/211/346/263/250/345/260/204.svg +1 -0
  717. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/237/263/345/223/215.svg +1 -0
  718. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/241/271/347/233/256.svg +1 -0
  719. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/243/236/346/234/272@2x-2.svg +1 -0
  720. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/243/236/346/234/272@2x.svg +1 -0
  721. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/251/254/346/241/266.svg +1 -0
  722. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/253/230/345/210/206/345/255/220.svg +1 -0
  723. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/253/230/346/270/205.svg +1 -0
  724. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/274/240/346/240/207.svg +1 -0
  725. package/skills/micro-app-design/assets/tuya-design-system/source.json +18 -0
  726. package/skills/micro-app-design/references/action-outcomes.md +7 -0
  727. package/skills/micro-app-design/references/adaptive-card-grid.md +25 -0
  728. package/skills/micro-app-design/references/capsule-fallback.md +36 -0
  729. package/skills/micro-app-design/references/component-boundaries.md +48 -0
  730. package/skills/micro-app-design/references/component-catalog.md +69 -0
  731. package/skills/micro-app-design/references/design-system.md +34 -0
  732. package/skills/micro-app-design/references/empty-and-error-states.md +27 -0
  733. package/skills/micro-app-design/references/icons.md +33 -0
  734. package/skills/micro-app-design/references/implementation-guidance.md +39 -0
  735. package/skills/micro-app-design/references/modal.md +27 -0
  736. package/skills/micro-app-design/references/page-patterns.md +55 -0
  737. package/skills/micro-app-design/references/quality-checklist.md +57 -0
  738. package/skills/micro-app-design/references/requirements-and-permission-states.md +19 -0
  739. package/skills/micro-app-design/references/source-and-scope.md +40 -0
  740. package/skills/micro-app-design/references/tokens.md +23 -0
  741. package/skills/micro-app-design/references/visual-acceptance.md +51 -0
  742. package/skills/micro-app-design/scripts/microapp-kit.mjs +117 -0
  743. package/skills/micro-app-design/scripts/visual-audit.mjs +197 -0
  744. package/skills/micro-app-design/tests/behavior-scenarios.md +154 -0
  745. package/skills/micro-app-design/tests/validate-design-skill.mjs +35 -0
  746. package/skills/micro-app-design/tests/validate-design-system.mjs +51 -0
  747. package/skills/micro-app-development/SKILL.md +132 -0
  748. package/skills/micro-app-development/agents/openai.yaml +6 -0
  749. package/skills/micro-app-development/references/agent-workflow.md +111 -0
  750. package/skills/micro-app-development/references/application-icons.md +50 -0
  751. package/skills/micro-app-development/references/data-change-safety.md +47 -0
  752. package/skills/micro-app-development/references/delivery-checklist.md +129 -0
  753. package/skills/micro-app-development/references/design-workflow.md +77 -0
  754. package/skills/micro-app-development/references/developer-credentials.md +97 -0
  755. package/skills/micro-app-development/references/development-guide.md +213 -0
  756. package/skills/micro-app-development/references/environment-progress.md +47 -0
  757. package/skills/micro-app-development/references/joint-acceptance.md +105 -0
  758. package/skills/micro-app-development/references/local-development.md +40 -0
  759. package/skills/micro-app-development/references/manifest-v1.2.md +129 -0
  760. package/skills/micro-app-development/references/npm-registry.md +48 -0
  761. package/skills/micro-app-development/references/platform-operations.md +48 -0
  762. package/skills/micro-app-development/references/project-workflow.md +36 -0
  763. package/skills/micro-app-development/references/publication-intent.md +34 -0
  764. package/skills/micro-app-development/references/publication-recovery.md +67 -0
  765. package/skills/micro-app-development/references/requirement-intake.md +122 -0
  766. package/skills/micro-app-development/references/runtime-requirements.md +23 -0
  767. package/skills/micro-app-development/references/space-permission-boundaries.md +46 -0
  768. package/skills/micro-app-development/references/tool-update.md +60 -0
  769. package/skills/micro-app-development/references/toolchain-access.md +33 -0
  770. package/skills/micro-app-development/references/user-journey.md +65 -0
  771. package/skills/micro-app-development/references/workspace-environments.md +39 -0
  772. package/skills/micro-app-development/scripts/application-icon.mjs +108 -0
  773. package/skills/micro-app-development/scripts/install-app-icon.mjs +48 -0
  774. package/skills/micro-app-development/scripts/install-menu-icon.mjs +27 -0
  775. package/skills/micro-app-development/scripts/language-policy.mjs +83 -0
  776. package/skills/micro-app-development/scripts/languages.json +372 -0
  777. package/skills/micro-app-development/scripts/locale-keys.mjs +26 -0
  778. package/skills/micro-app-development/scripts/microapp-kit.mjs +117 -0
  779. package/skills/micro-app-development/scripts/project-code.mjs +13 -0
  780. package/skills/micro-app-development/scripts/review-backend-logging.mjs +27 -0
  781. package/skills/micro-app-development/scripts/review-production-authorization.mjs +37 -0
  782. package/skills/micro-app-development/scripts/validate-micro-app-project.mjs +442 -0
  783. package/skills/micro-app-development/tests/application-icons.test.mjs +131 -0
  784. package/skills/micro-app-development/tests/backend-logging-review.test.mjs +24 -0
  785. package/skills/micro-app-development/tests/behavior-scenarios.md +177 -0
  786. package/skills/micro-app-development/tests/data-change-safety-scenarios.md +25 -0
  787. package/skills/micro-app-development/tests/design-workflow-scenarios.md +40 -0
  788. package/skills/micro-app-development/tests/fixtures/valid-v6/_locales/en.json +6 -0
  789. package/skills/micro-app-development/tests/fixtures/valid-v6/_locales/zh-CN.json +6 -0
  790. package/skills/micro-app-development/tests/fixtures/valid-v6/manifest.json +59 -0
  791. package/skills/micro-app-development/tests/fixtures/valid-v6/micro.config.js +5 -0
  792. package/skills/micro-app-development/tests/fixtures/valid-v6/mock/index.json +11 -0
  793. package/skills/micro-app-development/tests/fixtures/valid-v6/package.json +4 -0
  794. package/skills/micro-app-development/tests/fixtures/valid-v6/src/index.tsx +5 -0
  795. package/skills/micro-app-development/tests/fixtures/valid-v6/src/lang/en.ts +1 -0
  796. package/skills/micro-app-development/tests/fixtures/valid-v6/src/lang/zh.ts +1 -0
  797. package/skills/micro-app-development/tests/fixtures/valid-v6/src/public-path.js +3 -0
  798. package/skills/micro-app-development/tests/production-authorization-review.test.mjs +72 -0
  799. package/skills/micro-app-development/tests/six-skill-routing-scenarios.md +60 -0
  800. package/skills/micro-app-development/tests/user-journey-scenarios.md +19 -0
  801. package/skills/micro-app-development/tests/validate-micro-app-project.test.mjs +428 -0
  802. package/skills/micro-app-frontend-development/SKILL.md +86 -0
  803. package/skills/micro-app-frontend-development/agents/openai.yaml +6 -0
  804. package/skills/micro-app-frontend-development/references/api-and-permissions.md +86 -0
  805. package/skills/micro-app-frontend-development/references/custom-api-requests.md +52 -0
  806. package/skills/micro-app-frontend-development/references/debugging.md +36 -0
  807. package/skills/micro-app-frontend-development/references/i18n-and-theme.md +54 -0
  808. package/skills/micro-app-frontend-development/references/interaction-completion.md +61 -0
  809. package/skills/micro-app-frontend-development/references/micro-frontend-runtime.md +33 -0
  810. package/skills/micro-app-frontend-development/references/routing-and-context.md +96 -0
  811. package/skills/micro-app-frontend-development/references/saas-failure-and-display.md +45 -0
  812. package/skills/micro-app-frontend-development/references/standard-api-requests.md +30 -0
  813. package/skills/micro-app-frontend-development/references/submission-errors.md +51 -0
  814. package/skills/micro-app-frontend-development/scripts/microapp-kit.mjs +117 -0
  815. package/skills/micro-app-frontend-development/tests/behavior-scenarios.md +36 -0
  816. package/skills/micro-app-solution-design/SKILL.md +69 -0
  817. package/skills/micro-app-solution-design/agents/openai.yaml +6 -0
  818. package/skills/micro-app-solution-design/scripts/microapp-kit.mjs +117 -0
  819. package/skills/micro-app-solution-design/tests/behavior-scenarios.md +12 -0
@@ -0,0 +1,77 @@
1
+ # 自用 backend 安全生成引导
2
+
3
+ 更新:2026-09-15。M1 只允许开发者自己的 SaaS 使用其自己开发的微应用。平台负责装配归属与可信入口等平台能力,开发者负责自定义 backend 的接口和业务数据安全。Skill 帮助减少生成代码中的缺陷,不承诺自动证明安全,也不要求先建设平台强制数据代理才能开发。
4
+
5
+ 自用不等于单用户、单角色或单项目。同一开发者的不同 SaaS 默认仍隔离;跨 SaaS 共享必须是明确设计的业务能力,不能因 developer_uid 相同自动放开。
6
+
7
+ ## 1. 在现有需求摘要中确定权限矩阵
8
+
9
+ 复用需求收集结果,仅对实际业务补齐:谁能执行哪个操作、针对哪个 SaaS/项目/家庭/本人记录、允许哪些字段、是否存在状态限制。只收集业务意图,平台权限码由已确认契约映射。
10
+
11
+ 每条业务 API 在已有接口声明中对应:method/path、业务操作、权限来源、目标数据范围、读写字段及需要验证的拒绝场景。平台能确认的操作与项目范围来自可信上下文;“仅本人创建”“完成后不能修改”等自定义规则由 backend 根据真实记录执行。未知规则不默认授予全部角色。
12
+
13
+ ## 2. 统一鉴权,业务路由不漏接
14
+
15
+ 保留模板的 [统一验签入口](gateway-verification.md):src/proxy.ts 对全部业务请求执行正式签名、实际请求绑定和进程内 nonce 判重,handler 通过 getVerifiedContext 读取身份后执行操作权限校验。不要缩窄路由覆盖或在每个 handler 重写签名,不用浏览器自报 userId/role/projectId 构造授权。本期单进程单副本,缓存重启清空;扩为多副本前须接入共享原子存储。仅本地预览跳过正式验签,DEV 测试身份和权限校验仍必需。
16
+
17
+ 网关传递经验证且绑定请求的上下文,backend 校验来源、请求绑定、时效及目标后使用其中已确认的授权事实;具体格式按平台契约,缺失时保持相关业务路由拒绝。健康探针可独立,但只返回最小健康状态。不得将未声明业务路由、后台任务或调试路由当匿名例外。
18
+
19
+ ## 3. 把范围落实到数据访问
20
+
21
+ 持久化建模按 [数据库设计与隔离](database-constraints.md) 先形成实体归属与共享策略,再落实字段、唯一性、关联约束和受限查询入口;不要用项目创建人或数据库 schema 代替业务范围设计。
22
+
23
+ - 业务表按实际隔离模型保存归属,如 SaaS、业务租户、项目/家庭或创建者。不是要求每张表机械增加所有字段;关联表需能沿已校验关系确定归属,全局字典需明确只读/管理边界。
24
+ - 创建时从已验证身份与已授权目标设置归属;请求可以选择项目,但必须先确认属于授权范围。拒绝任意覆盖租户、所有者等保护字段。
25
+ - 查询、计数、聚合、详情、修改、删除、批量和导出都通过统一的数据访问方法带入范围,禁止仅按对象 ID 操作。关联对象也要校验范围。
26
+ - 对请求字段采用明确允许列表和类型/长度/枚举校验,禁止将整个 body 展开到数据库更新中。读响应同样只返回允许字段。
27
+ - SQL 一律参数化;动态排序字段/列名必须经允许列表映射,不能认为占位符可以安全代替任意 SQL 标识符。
28
+
29
+ 例如:工单表确有 saas_id、tenant_id、project_id、created_by 时,“仅能完成本人在当前项目创建且仍开放的工单”的更新条件应同时包含这些范围、创建者及状态。值来自已验证上下文和已校验参数,不接受 body 直接覆盖:
30
+
31
+ ```sql
32
+ -- 说明性示例:表名/字段/状态按项目实际 schema,不是平台固定规范。
33
+ UPDATE work_orders
34
+ SET status = $1
35
+ WHERE id = $2 AND saas_id = $3 AND tenant_id = $4
36
+ AND project_id = $5 AND created_by = $6 AND status = $7
37
+ RETURNING id;
38
+ ```
39
+
40
+ 目标状态由服务端业务规则决定。未更新任何记录时,不再尝试去掉范围条件;按照 API 契约返回不可见/不允许操作等结果,不泄漏其他范围对象。多表写入或先查后写使用事务、版本条件或等效原子机制。
41
+
42
+ ## 4. 按功能增加必要保护
43
+
44
+ | 触发条件 | 引导生成的检查 |
45
+ |---|---|
46
+ | 所有业务接口 | 类型/长度/请求大小限制;允许的操作和数据范围;响应字段控制;错误不返回堆栈/数据库信息;Secret 仅服务端安全注入 |
47
+ | 写操作/业务副作用 | 状态转换验证;必要的幂等与并发保护;上游重试不能重复创建/扣费/控制;权限检查通过前不执行副作用 |
48
+ | 列表/搜索/导出 | 分页上限、范围内统计;导出权限独立确认,不提供绕过列表策略的下载入口 |
49
+ | 文件上传/下载 | 大小和类型限制、存储对象归属、路径穿越防护;私有文件不得通过永久公共 URL 绕过鉴权 |
50
+ | 接收 URL 或外部请求 | 限制目的地址/协议及重定向,拒绝内网管理/元数据地址;超时和响应大小限制;不接受客户端指定 backend/数据库地址 |
51
+ | 实时订阅/缓存/异步任务 | 按作用域隔离,切换/撤权后失效;执行时按正式协议处理过期授权,不使用无范围全权身份补救 |
52
+ | 富文本或浏览器渲染外部内容 | 使用安全渲染/必要清洗,不直接注入不可信 HTML;不用宽泛 CORS 或关闭宿主已有防护解决联调问题 |
53
+
54
+ 数据库可由 backend 通过 pg 访问,生产连接由部署环境注入;生产迁移与业务服务使用该区同一连接和账号,按迁移及业务需要配置权限;DEV provider 的角色分离不延伸为生产契约,DEV/PROD 凭据和数据保持隔离。按 [数据库约束](database-constraints.md) 使用参数化 SQL;DEV 示例客户端不等于生产连接配置。
55
+
56
+ ## 5. 验证“合法可用、越权不执行”
57
+
58
+ 按本次 API 实际范围编写测试,不要求每次修改跑无关场景:
59
+
60
+ - 合法用户与目标成功;缺失/伪造/过期上下文、无操作权限失败。
61
+ - 替换为另一 SaaS、租户、项目/家庭或用户的对象 ID 后被拒绝;只读角色不能写。
62
+ - 伪造归属字段或增加未允许字段被拒绝;批量混入越权对象符合契约且不误写。
63
+ - 列表、计数、关联和导出不会泄漏其他范围数据。
64
+ - 权限失败后实际数据库未变化、外部副作用未调用,不能只断言 HTTP 状态码。
65
+ - 涉及状态/并发/重试时验证重复执行和非法转换;涉及 DEV 身份时确认 PROD 不接受。
66
+
67
+ 单元测试可模拟可信上下文,但须单独验证真实验证组件的拒绝行为;DEV 集成使用隔离测试库和测试身份,真实 SaaS 联调另行记录。不能把所有测试用户都设成管理员,也不能通过禁用鉴权让测试通过。
68
+
69
+ ## 6. 交付说明
70
+
71
+ 报告已实现的权限矩阵、公共验证入口和数据范围控制,列出运行过的测试及未验证契约。发现漏鉴权路由、无范围写入、Secret 泄漏或失败后仍产生副作用时修复后再称该功能完成;不要仅生成一份检查表而不修代码。
72
+
73
+ 范围仅限当前需求及受影响入口。缺少网关协议时明确具体依赖,继续不受影响的代码/模型设计;不要将平台强制数据层作为新的阻塞前提。开发者对业务安全负责,Skill/测试/扫描帮助降低风险,不替代开发者审查。
74
+
75
+ ## 家庭与项目权限边界
76
+
77
+ 按 [空间权限能力边界](../../micro-app-development/references/space-permission-boundaries.md) 收集需求和验收:家庭按默认角色权限,桌面端权限只读;项目支持可编辑权限点的单项授权撤权。不得把项目授权接口或模拟能力套用到家庭;两种模式都保留可信上下文与数据范围校验。
@@ -0,0 +1,11 @@
1
+ # Standard backend builds
2
+
3
+ Custom build scripts, installation hooks, and JavaScript migration tasks are not supported. Do not generate scripts/build/, build-inputs/, or custom package.json commands. Complete code/resource generation during development and include the resulting source or public resources in the release.
4
+
5
+ The tools validate package scripts against the template commands, run frozen dependency installation with --ignore-scripts, and invoke Next build directly. Dependency lifecycle scripts are also disabled; packages that require them need a platform-reviewed solution rather than a custom hook. Tests and standard DEV commands remain available locally.
6
+
7
+ Business build inputs are package.json, pnpm-lock.yaml, next.config.ts, tsconfig.json, next-env.d.ts, src/, and optional public/. public/ is included in the runtime image; other dynamic resources depend on Next output tracing. The source archive excludes the scripts/ directory. platform service rejects custom script directories, custom package commands and task migrations before queueing a build.
8
+
9
+ Use only SQL migrations with type=sql and inputs=[]; preserve applied history and transaction boundaries. Existing task histories require controlled assessment, not rewriting the ledger or silently converting old entries.
10
+
11
+ This restriction does not sandbox application code, tests or Next configuration. Tenant database permissions and network isolation remain necessary. Updating the kit does not overwrite business source; existing projects with unsupported inputs must be migrated explicitly before publication.
@@ -0,0 +1,56 @@
1
+ # backend 业务运行日志
2
+
3
+ 新增或修改业务接口时,Agent 必须在生成的 backend 代码中实现日志,并运行请求验证实际输出。复用项目已有logger和公共入口;没有时补充轻量公共封装。仅写说明或仅输出容器启动日志不算完成。
4
+
5
+ ## 实现顺序与关联
6
+
7
+ 在公共入口、验签之前生成服务端 requestId,贯穿验签、鉴权、业务服务、数据访问及响应。外部传入标识只能经长度/字符校验后作为独立关联字段,不能代替可信身份或覆盖服务端标识。跨proxy/handler传播使用受控内部机制,清除客户端伪造同名字段;不得改变原验签协议和签名覆盖的内容。错误响应可返回安全requestId,便于用户提供排查线索。
8
+
9
+ 业务日志按单行JSON写到服务stdout/stderr,沿用宿主日志采集;不默认另建日志服务、数据库表或公共日志下载接口。字段包括 timestamp、level、event、requestId、environment、method、route(路由模板)、stage、outcome;结束事件另有statusCode、durationMs、业务结果码。HTTP 200中的业务失败仍记录failure。尚未匹配路由模板时使用固定unknown,不记录含对象标识的原始path或query。异步任务按真实任务标识关联,不复用全局可变请求上下文。
10
+
11
+ | 阶段 | 必须输出的业务信息 |
12
+ |---|---|
13
+ | 接收/参数校验 | method、路由模板、校验结果;按接口允许列表输出入参安全值或摘要;未验证输入只记录类型/大小及受控校验原因 |
14
+ | 正式验签 | success/failure与稳定原因码,例如缺失签名、时效、请求绑定、重放、配置缺失;只记录验证器实际结果 |
15
+ | 本地预览 | 正式验签明确skipped_dev,单独记录DEV身份验证结果,不能写成生产验签成功 |
16
+ | 业务鉴权 | allow/deny、受控操作码、操作/范围/对象/字段检查的失败阶段与原因;验证通过后才能记录必要的脱敏身份关联信息 |
17
+ | 业务与依赖 | 关键业务动作及结果、数据库/上游调用阶段、耗时与安全错误码,不逐行打印执行数据 |
18
+ | 返回/失败 | HTTP状态、业务结果码、出参安全值或摘要、耗时、稳定错误码和安全排查建议 |
19
+
20
+ 验签或鉴权拒绝时,即使handler未执行,也必须输出带同一requestId的拒绝和结束事件。鉴权未执行记not_evaluated;被拒请求的出参仅记录安全错误码,不能记录未授权目标详情或暴露目标是否存在。常规完成用info、预期拒绝用warn、服务故障用error;关键失败及结束摘要不能仅置于默认关闭的debug。健康探针可降噪,业务接口不能因此遗漏。
21
+
22
+ ## 入参、出参与错误的安全边界
23
+
24
+ 为每条API定义独立的日志字段允许列表,默认未知字段不记录。允许记录业务排查必需的非敏感状态、类型、数量和经批准的字段值;列表用数量和必要状态摘要,个人信息与业务敏感内容省略或掩码。对象标识仅在通过对应授权后按最小需要记录,禁止完整对象快照。入参出参记录的是安全摘要,不是整个请求/响应。
25
+
26
+ 禁止输出App Key、Secret Key、密码、私钥、Authorization、Cookie、访问令牌、JWS/签名原文、nonce、DEV私有句柄、数据库连接串、完整环境、签名URL及原始headers。嵌套字段同样适用,不能只按顶层字段名替换。生产与DEV采用同一脱敏规则;排错不能临时开启全量敏感日志。
27
+
28
+ 使用结构化序列化处理换行/控制字符,禁止字符串拼接用户输入。默认单字符串最多256字符、数组最多10项、对象深度最多3层、单事件最多8 KiB UTF-8;超限生成有效JSON摘要并标记truncated,不直接截断JSON文本,不为计算摘要全量读取超大流。
29
+
30
+ 在既有有界解析和校验后取字段;日志不得额外消费request body、改变原始验签字节或重复解析。流式/二进制/文件请求响应只记类型、已知大小和结果,不缓冲整个流。普通响应在序列化前从受控返回对象提取摘要;流的结束/中断按实际可观测事件记录,不能提前宣称传输成功。
31
+
32
+ 错误采用稳定code、失败stage、安全message和可操作建议。数据库日志允许已验证格式的SQLSTATE及受控操作名称,不输出SQL正文、绑定参数、驱动detail、原始error.message/stack/cause或内部连接地址;上游错误同样先映射再输出。不要console.log(error/request/response)。日志封装故障不能放宽验签、改变授权结果、触发重复业务操作或遮盖原始安全错误响应。
33
+
34
+ ## 验证与交付
35
+
36
+ 捕获实际stdout/stderr,分别触发成功、参数错误、验签失败、无操作权限/跨范围、数据库失败及上游超时,按实际功能选取场景。断言同请求关联完整、拒绝无业务副作用、DEV状态真实、日志JSON可解析且有界。用测试敏感哨兵检查所有输出均无泄漏,并验证请求body仍可读取、响应与原业务契约一致。不能仅断言logger被调用。详细用例见 ../tests/behavior-scenarios.md。
37
+
38
+ 向用户提供脱敏日志样例、requestId、实际获取入口与排查顺序:请求到达→验签→鉴权→业务/数据库→响应。构建日志中的BUILD_STEP、运行启动/迁移的BACKEND_STARTUP/SQL_DEPLOY与本节业务日志分开说明。release logs查询构建日志,不能当作部署后的业务运行日志;生产运行日志由实际可用的托管平台或获授权运维入口读取,接口未接入时明确缺口,不编造命令、不要求用户提供凭据或原始敏感日志。
39
+
40
+
41
+ ## 默认日志封装与排障完整性
42
+
43
+ 模板默认接线如下,不能只复制 logger 文件:
44
+
45
+ - `src/instrumentation.ts` 安装 `request-observability.mjs` 的 HTTP 入口钩子;正式环境及 DEV 都输出 `microapp.http.received` 和 `microapp.http.completed`,即使 handler 未执行也能判断请求是否到达。GET/HEAD 健康探针降噪。入口尚未匹配路由时 route 为 unknown;HTTP 完成记录只代表传输状态,不代表业务成功。
46
+ - `src/proxy.ts` 使用同一服务端 requestId 记录正式验证结果,或 DEV 的 skipped_dev 与独立身份验证结果。提前拒绝也有安全原因码及后续授权 not_evaluated。跨 proxy/rewrite/handler 的诊断标识使用进程内证明保护,覆盖客户端同名字段;这只是日志关联,不是授权凭据,不改变正式验签协议。
47
+ - 每个业务路由最终导出必须使用 `withApiErrors(handler, {route: '/api/records/[id]'})` 或已有项目的等价请求/异常边界。第三参数提供 `{requestId, log, runStage}`;自动记录 handler 接收、返回及未捕获异常。业务 HTTP 200 + success:false 仍记失败。不要为每个层级重新生成 ID,也不要直接读取客户端请求 ID 作为服务端 ID。
48
+ - `runStage('database', 'list_records', () => repository.list(...))` 在真实依赖失败时先记录阶段、操作、耗时、`errorType/category` 及可识别 SQLSTATE,再原样抛出。外层可映射数据库错误;不要先 catch 丢掉异常再只返回 INTERNAL_ERROR。自行处理的异常也要在映射前用 `safeErrorMetadata(error)` 和同一个 log 记录。该分类不包含原始 message/stack/detail/cause 或 SQL。
49
+
50
+ 固定 route 使用实际路由模板,不能传入 URL/query/用户输入;handler 已匹配后不能仍全部写 unknown。对业务鉴权显式记录 allowed/denied 和受控原因;操作及范围检查不会由日志封装自动完成。关键输入输出摘要也由业务在有界解析、授权和校验后显式记录,例如 inputCount/outputCount/affectedRows。基础 logger 只接收允许字段和数量,未知字段丢弃;确有需要时按每接口允许列表扩展,不能展开 request/response/body/error。
51
+
52
+ 入口可记录格式受限的 `upstreamRequestId` 以关联平台请求;它与本地 requestId 分开,不代表可信身份。日志 sink 异常被隔离,不改变业务或认证结果。新模板提供基础保障,已有项目升级工具包不会覆盖业务源码:必须显式同步 instrumentation、proxy、公共封装和业务路由并重跑测试。
53
+
54
+ 项目校验器的 observability.* 仅是接线审阅提示;有 wrapper 名称或没有告警均不能证明真实输出。验收必须发实际 HTTP 请求,捕获运行进程 stdout/stderr,按响应 requestId 找齐入口、验证、handler/异常和结束事件。额外触发 HTTP 200 业务失败、SQLSTATE 42P01/42703、并发请求、伪造诊断字段及 sink 抛错;断言关联不串线、无敏感内容、body 仍可读取及响应契约不变。
55
+
56
+ 区分“源日志缺少字段”和“平台查询脱敏误伤”:核对同一 requestId 的获授权容器输出与平台查询结果。平台发布服务结构化日志逐字段脱敏应保留受控事件名与 environment 标签,不能把点分事件名当域名,也不能从 environment 起吞掉整行;完整环境对象、凭据、签名、地址仍必须遮蔽。不要以关闭脱敏解决缺失字段。
@@ -0,0 +1,81 @@
1
+ # 数据库设计与隔离
2
+
3
+ 本地 Coding Agent 的逐步操作、已有项目追加数据库与故障处理,见 [本地数据库预览调试](local-database-preview.md)。
4
+ 本参考包含完整能力包所需的数据库规则,不要求另装 database-skill。使用项目 backend/ 内已有的 PostgreSQL、Prisma schema 与 pg;Prisma 用于模型描述,不以 Prisma Client 做运行时 CRUD,不切换到 Python/Alembic。
5
+
6
+ ## 建表前确定每类数据的归属
7
+
8
+ 复用已有需求与设计,先按业务实体记录:数据属于谁、谁可读/写/导出、是否绑定项目/家庭/节点、是否允许共享或转移,以及离开项目/删除用户后的保留规则,再设计表结构。一个微应用可同时包含多种归属,不按整库只选一种隔离方式。仅补问会改变业务共享边界的缺失信息,例如“这个清单仅自己可见,还是项目成员共享”;用户不必选择字段名或数据库技术。
9
+
10
+ 在已有需求/设计中维护简短的实体归属表,至少明确实体、隔离维度、可信来源、读写条件和唯一性范围。没有确定共享边界时继续不依赖它的工作,相关数据接口保持拒绝,不自行放开所有项目成员。
11
+
12
+ | 实际业务 | 归属字段示例 | 查询与授权含义 |
13
+ |---|---|---|
14
+ | SaaS 内共享的业务配置、分类 | saas_id | 匹配当前 SaaS,另外验证业务维护权限;项目管理员不自动成为 SaaS 管理员 |
15
+ | 用户在 SaaS 内的个人偏好、私人记录 | saas_id + owner_uid | 匹配 SaaS 和当前用户;不因当前项目切换而丢失个人记录 |
16
+ | 项目/家庭/节点共享的工单、台账 | saas_id + scope_type + scope_id,或明确的 project_id/home_id | 匹配 SaaS 和本次操作获授权的空间范围;创建人只是审计信息,不自动限制为仅本人可见 |
17
+ | 用户在某项目/家庭内的私人清单 | saas_id + scope_type + scope_id + owner_uid | SaaS、空间、本人条件同时满足;不能在“空间范围”和“本人”之间使用 OR 放宽 |
18
+ | 明确存在业务租户的记录 | 在上述维度增加 tenant_code 或等效业务外键 | 业务租户来自可信上下文/权威关系,不使用数据库 tenant/schema 标识代替 |
19
+ | 应用维护的公共枚举/字典 | 独立公共表,或沿已验证父对象确定归属 | 仅明确全局共享的数据可不按 SaaS 分隔;只读与维护入口分别授权 |
20
+
21
+ 字段名是设计示例,不是平台固定表结构。业务数据默认以 SaaS 为最外层边界;只有权威运行时资源映射已经保证完整隔离时,才可据实省略重复字段并记录依据。开发者相同、当前只有一个 SaaS/用户、代码运行在同一 backend,都不是取消隔离的依据。不为每个用户或业务项目默认创建数据库/schema。
22
+
23
+ created_by/updated_by 表示审计来源,owner_uid 表示业务所有者,不能混用。共享工单通常允许获授权成员共同处理,创建者字段不应把它误变为私人数据;私人数据也不能因为项目 owner 拥有项目全部节点权限而自动向其开放。管理员代查、转交或共享须有明确业务能力及授权。
24
+
25
+ 数据库租户/schema、开发工作区和微应用标识属于资源边界,业务 saasId、用户 uid、项目/家庭 ID 属于数据授权边界。业务 tenantCode 是可选的另一维度;不能把 DEV tenantId 当成正式 tenantCode,也不能一律要求每张表增加 tenant_id。
26
+
27
+ ## 将归属落实到结构和约束
28
+
29
+ - 同时支持家庭与项目的数据可采用 scope_type + scope_id,避免把同名 ID 或不同空间类型混为一类。若业务必须区分项目根和所属节点,分别记录/关联,并从权威关系解析;不能认定 currentScope.id 一定是项目根或自行沿路径授予后代权限。
30
+ - 必需归属列设为 NOT NULL;全局数据与局部数据尽量分表或使用明确类型与约束,不用空 SaaS/空项目作为“所有人可见”的隐式约定。子表可通过已校验父表确定归属,无需机械重复全部字段。
31
+ - 业务唯一键按真实共享范围定义,例如 SaaS 内唯一编码用 UNIQUE(saas_id, code),项目内唯一编码用 UNIQUE(saas_id, scope_type, scope_id, code),项目内个人配置用 UNIQUE(saas_id, scope_type, scope_id, owner_uid, preference_key)。不要误建全库唯一约束,也不能认为随机/全局唯一 id 已提供隔离。
32
+ - 关联对象必须属于获准范围。父子表重复保存归属时,可用包含隔离列的复合外键约束同一归属;不重复保存时,在事务内按父表归属校验并访问。仅有 FOREIGN KEY(parent_id) 不能证明父子 SaaS/项目相同。确需跨项目关联时,单独建模该关系及双方授权。
33
+ - 索引结合实际查询设计:常用 SaaS/空间/用户等值条件与状态、时间或分页键组合;不机械生成所有维度排列。列表、统计与导出使用相同范围条件。
34
+ - 所有权转移、项目迁移、成员离开、共享与归档是业务行为。明确数据保留、关联记录和后续可见性;不因用户切项目而改写历史归属,不因成员撤权自动删除项目共享数据。
35
+
36
+ ## 统一生成数据访问范围
37
+
38
+ 正式身份来自公共验签组件的 getVerifiedContext;预览来自已验证 DEV 身份及 authorizeDevOperation 的最新授权结果,预览免签不免数据隔离。saasId/uid 来自可信上下文;业务租户仅在模型需要且可信来源存在时使用;目标项目/家庭/节点还须根据本次操作的权威授权确定。签名中的当前范围和角色不等于全部可访问节点,跨项目汇总或子节点范围缺少正式契约时不能自行推导。
39
+
40
+ 无真实 SaaS 的预览使用服务端模拟 SaaS/用户/空间标识写入测试记录,执行同一套业务范围过滤,不在业务 SQL 硬编码模拟 ID。资源隔离、ID 类型适配及当前单 SaaS 页面验收边界见 [本地数据库预览调试](local-database-preview.md#无真实-saas-时的数据范围)。
41
+
42
+ 所选模型必需的身份、租户或空间事实缺失时拒绝相关操作,不补默认租户、不使用空字符串替代,也不用请求参数补成可信身份。用户选择目标只表达意图,授权通过后才能成为查询范围。
43
+
44
+ 按实体与操作在项目已有 service/repository 中集中形成服务端范围对象,再通过同一受限入口执行详情、列表、统计、关联、批量、写入与导出。范围对象不从客户端 body/query 直接构造,不允许空范围回退为全量;动态 SQL 的业务参数不得覆盖范围参数。不同 API 可以按矩阵收窄权限,不能各自遗漏最外层边界。无需为了这个规则引入固定 ORM、RLS 平台或新的数据库代理。
45
+
46
+ 例如已经明确“用户仅能完成自己在当前项目拥有且仍开放的工单”,且表具有这些字段时:
47
+
48
+ ```sql
49
+ UPDATE work_orders
50
+ SET status = $1
51
+ WHERE saas_id = $2 AND project_id = $3 AND owner_uid = $4
52
+ AND id = $5 AND status = $6
53
+ RETURNING id;
54
+ ```
55
+
56
+ 参数分别来自允许的状态转换、可信 SaaS、已授权目标项目、可信用户、已校验对象 ID 与原状态。这是说明性片段,表名/字段按业务设计;若工单是项目共享资源,应改用获准空间和操作策略,而不是机械保留 owner_uid 条件。未命中不尝试删除范围条件重试。更新、删除、多表关联和批量访问同样执行完整策略,不能先仅按对象 ID 查询后依赖浏览器判断。
57
+
58
+ 创建时由服务端设置归属,客户端保护字段采用显式拒绝或按 API 契约忽略,不能把整个 body 展开到 INSERT/UPDATE。用户输入的关联 ID、目标节点或代办用户是待授权对象;只有验证后才能写入。日志、缓存、导出文件和后台任务也须继承同样的数据边界,见 [数据权限](project-data-permissions.md)。
59
+
60
+ ## 隔离验收
61
+
62
+ 按实际模型选择代表性数据验证:不同 SaaS 的相同业务编码、同 SaaS 的两个项目/节点、同项目两个用户、私人记录与共享记录、重复关联 ID。检查唯一约束按设计允许/拒绝,关联不能串入其他范围;查询、计数、统计、分页、导出一致,越权修改后数据库未变。仅验证返回 403 或 SQL 包含某个字段不够。
63
+
64
+ 涉及业务租户、跨项目汇总、权限撤销、所有权转移或异步任务时增加对应用例。DEV 使用模拟用户和隔离测试库;真实 SaaS 契约联调另行记录。不存在某隔离维度时不造测试租户,也不以 Mock 结果替代真实数据库约束验证。
65
+
66
+ ## 访问与隔离
67
+
68
+ - 在 backend/ 运行工具,按项目脚本使用显式 schema/输出路径;不在前端目录执行数据库操作。
69
+ - 当前通用 CLI 通过随包本地 Docker DEV provider 获取隔离测试库,先核验 Docker 能力、资源分配与环境;外部 provider 尚未接入。M1_RUNTIME_ENV=DEV 只是本地保护开关,不能证明连接是测试库或调用方有权。
70
+ - 缺少隔离 DEV 资源时阻断数据库执行,不猜连接、复制生产数据或改连生产。测试身份、密码、连接及完整环境值不写代码、日志或 Git。
71
+ - 工作区/数据库 schema 标识不是 SaaS 用户授权。每个读取、更新、删除和批量操作都把已验证的 SaaS/项目/家庭/用户范围带入查询,校验对象归属及字段权限。
72
+ - pg 查询使用参数化值;表名、列名、排序等不能直接拼接用户输入,应通过固定映射/允许列表选择。事务内操作复用同一连接,异常回滚并释放连接;错误脱敏。
73
+ - 生产连接由区域运行环境注入,使用该区同一连接与账号执行累计迁移和业务访问。DEV provider 的迁移/运行角色分离不代表生产要求,不复制 DEV 客户端绕过生产鉴权。
74
+
75
+ ## 变更与验证
76
+
77
+ 持久化结构或必要业务数据变化按 [部署变更包](deployment-bundle.md) 维护完整累计 SQL 迁移及 manifest(type=sql、inputs=[])。Prisma schema 或生成文件不代表变更已执行。编写时运行项目已有 deploy:seal,交付前 deploy:check,并在分配的隔离 DEV 库验证实际执行。
78
+
79
+ 已发布历史只追加,不修改、删除或重排;禁止在无审查 baseline 的同一数据库同时执行 schema push 与首次 CREATE 迁移。生产不自动 db push,不在路由请求或镜像构建时迁移;区域容器 ENTRYPOINT 在迁移成功后才启动业务服务。
80
+
81
+ 验证空库、跨版本补迁移、重复执行、部分成功后重试、历史篡改拒绝、并发启动及旧服务兼容性。越权拒绝须确认数据库未变、外部副作用未发生。长回填、破坏性或非事务变更单独审查,不承诺自动 down 或旧镜像可重启回滚;当前 runner 的历史前缀校验限制见部署变更包。
@@ -0,0 +1,29 @@
1
+ # Database write failures and restrictions
2
+
3
+ Apply to generated create/update/delete/import handlers that persist data. Use the template's `src/lib/database-errors.mjs` (`databaseFailure`) and `business-logger.mjs` (`createBusinessLogger`); keep the existing project error envelope and transaction boundaries.
4
+
5
+ ## Classification
6
+
7
+ | Evidence | Business code | Meaning |
8
+ | --- | --- | --- |
9
+ | PostgreSQL SQLSTATE 25006 | DATABASE_READ_ONLY | Database is read-only; capacity is only one possible cause |
10
+ | PostgreSQL SQLSTATE 42501 during a write | DATABASE_WRITE_RESTRICTED | Database write permission denied; do not report end-user operation permission denial |
11
+ | Connection failure, disk full, unrecognized driver error | DATABASE_UNAVAILABLE | Preserve unknown write outcome where applicable; do not infer quota from an error message |
12
+
13
+ The helper supports pg `error.code` and Prisma raw-query P2010 `meta.code`. Do not infer SQLSTATE from message text; explicitly adapt and test other ORM envelopes. Do not replace validation, unique-conflict, authorization or other existing business mappings with a generic database error.
14
+
15
+ User-facing read-only and write-permission failures both say: 'Database writes are restricted. Contact the administrator for assistance.' Do not state or infer capacity exceeded, and do not add a capacity-status lookup or a capacity-confirmation flag. Technical codes and SQLSTATE remain in safe logs for administrators.
16
+
17
+ ## Response and transaction boundary
18
+
19
+ Map a failed write after its transaction has rolled back (or a single autocommit statement has definitively failed). Confirmed read-only (25006) and write-permission (42501) rejections use HTTP 200 with `success: false`, safe `code`, `requestId`, and `retryable: false`. Connection failures and unmapped system errors use HTTP 500 with a safe JSON failure envelope; never emit HTTP 503 from the micro-app backend. Log mapped `code`, validated `sqlState`, stage and duration. Never return raw SQL, bind values, driver detail/message/stack or addresses. Do not use HTTP 403 for a database role failure. HTTP 200 is transport completion, not successful persistence; the frontend must reject `success:false`.
20
+
21
+ These two restriction codes mean the requested operation was rejected, not an unknown write. Do not emit them for a rollback failure, lost COMMIT reply, partially committed multi-step workflow or a write followed by a failing read. Keep such outcomes explicitly unknown/partial using the existing business contract, preserve idempotency and never auto-repeat. Transactions should encompass related database mutations; external side effects require their own recovery boundary.
22
+
23
+ Reads remain available where supported. A write restriction also affects updates and deletes: do not offer ordinary users a “delete data to free space” action that cannot work under read-only access. Administrator remediation is outside the business write API; do not promise an unimplemented purchase or cleanup flow.
24
+
25
+ ## Frontend and acceptance
26
+
27
+ Frontend uses `requestError` and `databaseErrorMessage` from `src/api/errors.mjs`, displaying the localized reason next to the affected form with the safe request reference. Preserve entered values on failure, release submitting state, do not clear/navigate or auto-retry. Only say input was retained when the UI actually retains it. Do not claim success or disable independent queries. Saved data followed by refresh failure is a read error, not a failed creation.
28
+
29
+ Test create/update/delete rejection, read availability, retained form state, no automatic resubmission, pg/Prisma wrappers, absence of capacity claims, unrelated permission/connection errors and transaction ambiguity. Inject synthetic errors locally; never fill a real production database or switch production permissions for this test. Verify generated API responses and frontend behavior, not only helper calls. Existing apps require explicit source integration and redeployment; updating the kit alone does not patch business source.
@@ -0,0 +1,65 @@
1
+ # Coding 生成部署变更包
2
+
3
+ ## 触发与归属
4
+
5
+ 每次 backend 修改检查是否改变持久化结构、必要字典或已有业务数据语义。有变化,同步生成版本化变更;纯接口逻辑/文案变化不制造迁移。使用 Next.js + TypeScript 模板的 `backend/deploy/README.md` 和 `scripts/dev-deploy-prepare.mjs`,不另造 Python/Alembic 工程。
6
+
7
+ - SQL 在 `backend/migrations/<id>.sql`。
8
+ - 不支持 JavaScript 迁移任务;结构、必要字典和数据转换使用事务内 SQL。
9
+ - 当前迁移 inputs 必须为空数组;测试 fixtures 单独保留在 tests/。
10
+ - `backend/deploy/manifest.json` 按固定宽度序号维护 id/type/file/inputs/sha256。首次迁移要能初始化空库;后续追加,已发布 SQL 与历史声明不改不删。不要按聊天轮次机械产生版本。
11
+
12
+
13
+ ## DEV 工具与正式平台入口
14
+
15
+ 项目中的 `scripts/dev-deploy-prepare.mjs`、`scripts/dev-diagnose-database.mjs`、`scripts/dev-start-backend.sh` 仅用于本地 DEV、check/seal 和官方 Node24 参考镜像,由开发包维护,不作为业务扩展点。正式构建的 runner、诊断、启动入口及其固定 pg 依赖由平台维护,内嵌到镜像 `/opt/microapp-platform`,不从源码包复制平台脚本;修改 DEV 工具不改变正式平台入口。平台发布服务的正式脚本更新需构建新镜像,既有镜像保持不变。
16
+
17
+ `backend-context.tgz` 保留业务源码及累计 SQL 迁移,排除全部 scripts/。平台发布服务拒绝自定义脚本、安装/构建钩子及 JavaScript 迁移。平台脚本固定并不构成业务代码沙箱。
18
+
19
+ 本地参考镜像从本地 backend 目录创建隔离快照,保留 DEV 工具并排除依赖缓存、宿主状态和密钥;可用 `build-backend-image.sh <local-backend-directory> <image-tag>` 构建。上传 context 不含 DEV 工具,不能直接作为本地参考 Dockerfile 的输入。`image-test` 直接复制随包模板进行本地回归,不能替代平台发布服务正式镜像验收。
20
+
21
+ ## Coding 操作顺序
22
+
23
+ 1. 阅读既有模型、迁移历史与目标行为,判断上一版 backend 仍运行时的兼容性。涉及字段类型/名称变更、删字段、改表或删表时,先完成[数据结构变更风险评估](../../micro-app-development/references/data-change-safety.md)及用户提醒,核实必要存量事实和风险取舍后再实现受影响迁移。受阻时先准备草案和一次性隔离测试,不执行已有数据上的变更或交接为可打包上传。必要时分成先扩展、转换、后续收缩的多个发布;不自动加入删列/清库/down。
24
+ 2. 同步业务代码、Prisma schema 描述、增量 SQL 和 manifest。node-pg 仍负责运行时 SQL,不引入 Prisma Client。不要使用 db push 代替增量文件;已有 DEV 库结构不等于具备生产迁移历史。
25
+ 3. 执行 `pnpm deploy:seal` 写入内容摘要,评审仅新增或未发布变更;执行 `pnpm deploy:check`。check 校验包,不连接数据库也不执行 SQL;不能把 check 成功当数据库迁移成功。
26
+ 4. 本地统一预览按 [本地数据库预览调试](local-database-preview.md) 执行 preview build/start;start 中的受信 Docker provider 自动分配隔离 DEV 库,受控注入 MIGRATION_DATABASE_URL 与 DEPLOY_SCOPE 并调用迁移 runner。Agent 无需读取密码或再手动执行 apply。仅在已有受控测试执行环境明确注入上述输入时,才直接执行 `pnpm deploy:prepare`。这些名字是 runner 本地输入,不是平台已冻结 DTO;身份/scope 由 provider 决定,不由浏览器请求指定,不使用生产连接或把连接值写入文件/日志。
27
+ 5. 验证首次初始化、已有版本升级、重复执行、失败回滚和重试、历史被篡改拒绝、并发锁,以及旧版本兼容。结合业务测试验证转换后对象范围与数据结果。缺 DEV 库时继续离线检查,但真实迁移验收标为受阻。
28
+
29
+ ## 执行边界
30
+
31
+ 每条变更和成功历史在同一个 PostgreSQL 事务中提交。runner 使用 session advisory lock,需直连或有 session affinity 的连接;不适配 transaction pooling。内部账本 `<tenant_schema>._sql_deploy_history` 在真实连接的独立租户 schema 内按稳定资源 scope 记录 id、摘要和完成时间,平台按目标区保存任务失败/进度事件。scope 是资源标识,不提供 SaaS/项目权限隔离。
32
+
33
+ 已有包含 task 或非空 inputs 的发布历史须先进行受控兼容评估;不能删除历史、改写已发布迁移或迁移账本,也不能静默把旧 task 转成 SQL 来通过新校验。新包不支持这些历史格式时应明确阻断发布并制定恢复方案。
34
+
35
+
36
+ ## 跨微应用版本升级(已确认)
37
+
38
+ 每个发布包携带从初始迁移到本版本的完整累计 manifest 和 SQL 文件,不能只打包本版本新增文件。已发布历史只追加,不改写、删除或在中间插入;seal 不能替代历史不可变检查。
39
+
40
+ 例如 microAppVersion v1 对应 0001,v2 新增 0002,v3 没有数据库变化,v4 新增 0003。直接部署 v4 时,目标库已完成 0001 就依次补执行 0002、0003,无需运行 v2/v3 的服务。另一数据区已完成 0002 则只执行 0003;全新库执行全部。判断依据是各目标库账本,不是 microAppVersion 或声明的 schemaVersion,也不是中国区部署结果。
41
+
42
+ 0003 失败时保留已提交的 0002;同一不可变包重试只执行 0003。若脚本本身有缺陷,不能覆盖已发布脚本,须评估新的修复发布或受控恢复方案;“新增修复脚本”也不能自动越过前面持续失败的脚本。失败不能激活目标版本,已完成的迁移不随服务部署失败自动回滚。
43
+
44
+ DEPLOY_SCOPE 跨发布保持稳定,不能使用 releaseId、microAppVersion 或每次部署任务 ID。各区必须连接本区真实目标资源,并兼容所有仍在使用该数据库的旧服务版本。当前 check 只验证本包,尚无发布时对照历史发布包的不可变校验;目标库执行时的前缀检查不能替代发布门禁。
45
+
46
+ ## 发布交接
47
+
48
+ 构建/打包仅校验累计变更包并携带到 backend-context.tgz,不连接生产库、不自动 seal。平台集成状态仍为 PENDING。
49
+
50
+ ## 已确认的生产启动方式(2026-09-24)
51
+
52
+ IoT 用户在 IoT 平台选择版本和目标区域并发起部署;平台执行授权后的区域编排。每个区域的容器启动入口先运行累计迁移,成功后才启动 backend HTTP 服务,平台确认前后端就绪后激活该区域版本。Coding Agent 只生成与验证代码,不直接操作生产数据库。
53
+
54
+ 平台发布服务Dockerfile 将项目业务 manifest/SQL 与平台发布服务自有 runner、诊断、启动脚本及固定依赖打入同一个后端镜像,并通过 ENTRYPOINT/CMD 调用启动脚本;不能用 Dockerfile RUN 在构建阶段执行数据库迁移。迁移与业务服务使用该区同一套数据库连接配置和数据库账号,不要求额外迁移身份,也不使用 IoT 登录凭据连接数据库。平台仍须按用户权限解析所属微应用及区域资源,不接受任意客户端连接串。
55
+
56
+ 启动流程为:校验配置 → 获取迁移锁并核对目标库账本 → 补执行未完成项 → 成功后 exec 启动业务进程。无数据库服务直接启动;有数据库服务即使本版本无新增迁移,也须核对累计历史。容器重建/多副本启动同样经过该入口,依靠账本和锁去重;锁忙需有界等待/重试,失败或超时不启动业务服务、不激活目标版本。Secret 仅在运行时注入,不写入镜像或日志。
57
+
58
+ 正式入口将业务 DATABASE_URL 映射到 MIGRATION_DATABASE_URL,覆盖外部传入的其他迁移连接;DEPLOY_SCOPE 使用平台注入的稳定资源标识,保留本区租户 schema/search_path,不回落 DEV TENANT_DB_*。迁移成功后 exec 启动 server.js,失败则退出。连接需支持 session advisory lock;锁忙目前直接失败,真实区域设施仍须联调验收。
59
+
60
+
61
+ 运行日志应能定位具体失败:先看 SQL_DEPLOY 的 stage/status,再看受验证迁移 id、code、sqlState/position 和安全说明/建议。不要求用户提供连接串、密码或原始数据库错误;禁止把 SQL/参数、error.detail 或 stack 写入可见日志。Dockerfile RUN 的 BUILD_STEP 是构建日志,Pod 中的 BACKEND_STARTUP/SQL_DEPLOY 是运行日志。业务账本变更须同步累计历史;正式脚本更新须同步平台发布服务内嵌资源并重新构建固定镜像;旧账本不能通过建空表重跑来替代受控核对。
62
+
63
+ ## 数据变更的用户提示
64
+
65
+ 开发 SQL 迁移或涉及删除/改字段的业务逻辑时,按[风险评估与拦截](../../micro-app-development/references/data-change-safety.md)在实现前整理实际对象、范围、存量兼容、执行时机、数据损失和恢复限制,交总入口提醒用户并补齐必要决策。打包和注册前按[用户全流程引导](../../micro-app-development/references/user-journey.md#打包前与注册前说明具体数据变更)复核实际固定包。仅上传注册不会执行生产迁移,但不能据此上传已知不可执行或关键风险未知的变更;DEV 测试可能先执行,必要证据/授权缺失时暂停相关实现、执行与交付。已有确认按同一对象、环境和影响复用,不能将 DEV 数据处理授权套用到生产。
@@ -0,0 +1,23 @@
1
+ # DEV 预览身份与项目授权
2
+
3
+ 本地预览不执行正式网关的 RSA 验签、签名时间窗或 nonce 防重放,不要求注入正式密钥。该分支只在 NODE_ENV=development 与 V6_LOCAL_PREVIEW=1 同时成立时启用;以下测试身份和业务授权校验仍需执行。正式环境使用 [公共验签组件](gateway-verification.md),不接受预览变量或 header 绕过。
4
+
5
+ 调用链为浏览器 `/custom-aicoding-api/{microAppCode}/api/<path>` → 预览代理移除一次入口前缀 → 真实 DEV backend `/{microAppCode}/api/<path>` → 身份验证后内部映射到 `/api/<path>`。代理从服务端测试成员关系构造身份,每次运行的私有凭证只经环境变量和内部 header 传递。浏览器自报 user、role、permissions 或同名 header 不能作为身份。`src/proxy.ts` 验证 DEV 环境、凭证和上下文,`src/lib/dev-context.mjs` 负责解析;仅解析成功不代表业务操作已授权。
6
+
7
+ 当前模板契约为 `v6-local-dev-v2`。内部 `x-v6-preview-context` 使用 UTF-8 JSON 的 base64url 编码,支持中文角色名。上下文包括环境、SaaS/租户、隔离模式、当前项目/家庭、user.uid、角色类型及实际 roleId/roleCode。每个用户在一个项目只有一个角色;owner、admin、member 是 App 角色类型,自定义角色仍有自己的角色 ID。家庭模式下 projectId 等于 homeId。
8
+
9
+ 代理 header 中的 authorization.mode 为 handle,permissions 和 spaces 故意为空,完整授权留在服务端以避免大项目超过 HTTP header 上限。不要据此判定无权限或直接给管理员放行。业务路由调用 `authorizeDevOperation(request, permissionCode, { spaceId, capability: 'read' | 'manage' })`,由它使用私有请求句柄回查最新的 effective 授权快照,再检查操作和节点能力。句柄不进入普通业务响应或日志。
10
+
11
+ 公共方法验证的是平台模拟的身份、功能和节点范围;业务代码仍需验证对象/关联对象归属、字段和状态限制,并在同一范围内执行查询或写入。需要列表/导出时使用回查后的获准节点约束查询,不能先拉全量再在浏览器过滤。修改数据前重新校验;已有提交不会因后来撤权自动回滚。owner 的全部项目授权不绕过业务不变量,也不自动放开开发者自定义规则。
12
+
13
+ backend 的标准平台调用使用 `src/lib/standard-api.ts`。它携带同一请求的私有句柄与 DEV 凭证回调标准 API Mock,保持原用户和项目;不读取后来切换的全局身份。代理限制回调路径、原项目和句柄有效期,回调不能访问测试配置控制面。不要自行拼 user/role header 或换成开发者凭据。
14
+
15
+ 左下角选择测试用户;“模拟设置 → 项目授权模拟”仅配置项目角色与当前微应用的 Web 入口和功能权限点。固定操作按角色类型决定;成员/节点范围及邀请/申请不提供面板操作,其他微应用权限不纳入此面板。既有预置成员/节点授权仍参与业务 API 校验;配置面板修改测试事实不代表当前用户具备业务管理权限。各标签页的体验身份独立,授权配置共享。
16
+
17
+ 前端 `getCurrentUser().user_id` 对应 DEV user.uid;roles 是实际角色对象数组,不把 role 字符串塞入数组。正常使用 hasPermission 控制交互;撤权、切用户和切项目时,宿主重挂载并清理旧状态。`/custom-aicoding-api/{microAppCode}/api/preview/context` 返回真实 backend 回查后的诊断信息,已经去除私有句柄。
18
+
19
+ 已有 backend 接入时同步解析器、公共授权方法、标准 API 客户端、诊断路由和 preview-contract.json,再构建/重启;不能只修改版本标记,也不保留旧协议兼容分支。旧 Mock 状态遇到 PREVIEW_STATE_RESET_REQUIRED 时,先说明重置只影响该工作区 Mock、保留备份并取得清空测试数据的授权,不静默删除,也不碰 backend 数据。
20
+
21
+ 验收走实际预览代理:合法用户成功;局部/只读用户越权失败且数据未改变;伪造身份头无效;直连 backend 缺凭证为 401;缺失或错误上下文为 403;请求在途切换身份不串用权限;撤权后回调失败;请求结束后的句柄不能复用。Mock 验收与真实 SaaS 权限联调分开,DEV 协议不是生产网关协议,测试通过不构成平台安全保证。
22
+
23
+ 数据库按 databaseRequired:true 使用随包本地 Docker provider 启动隔离 PostgreSQL 并注入 DATABASE_URL。外部 MICRO_APP_DEV_PROVIDER 不透传;缺 Docker 时报告数据库预览受阻,不使用生产库或关闭鉴权。先 preview build 再 start,修改后使用 preview restart 停止、构建并启动,当前没有 HMR。密码不写文件或日志。
@@ -0,0 +1,43 @@
1
+ # 正式 backend 统一验签
2
+
3
+ 2026-10-19 已确认签名协议与单副本范围。模板已经提供公共实现,不要求每条 API 重写密码学代码。实际 SaaS 网关联调仍须单独验收。
4
+
5
+ ## 必须保留的统一入口
6
+
7
+ `backend/src/proxy.ts` 覆盖全部路径与方法。只有精确 `/api/health` 的 GET/HEAD 是最小存活探针;业务、未来新增路由、调试、后台操作以及非 `/api` 路径都不能成为匿名例外。先验签和判重,再内部派发与执行副作用。不要缩窄 matcher、增加业务白名单,或根据浏览器 header/query 开关验签。
8
+
9
+ 公共组件为 `src/lib/gateway-verification.mjs`,正式部署只需安全注入 `MICRO_APP_GATEWAY_PUBLIC_KEY`(RSA 公钥 PEM,至少 2048 bit)和 `MICRO_APP_GATEWAY_AUDIENCE`(平台发布服务返回的原值)。backend 不接收签名私钥、主密钥或开发者凭证。配置缺失返回 HTTP 500 + 安全 JSON;缺签名、验签失败、请求篡改、重放和超过默认 1 MiB body 上限均返回 HTTP 200 + success:false + 稳定错误码,不执行 handler。HTTP 200 不等于验签通过。边界调整需与网关同步,不在业务 handler 中放宽。
10
+
11
+ 网关使用单个 `X-Aicoding-Request-Context`:compact JWS,protected header 精确为 `{"alg":"PS256","typ":"micro-app-request+jws"}`,不支持 kid 或其他扩展。RSA-PSS/SHA-256,saltLength=32。payload 字段为 aud、iat(整数秒)、nonce(128 bit 随机值的小写 32 位 hex)、request、biz。验签时间窗为 `iat-5 <= now < iat+30`。
12
+
13
+ request 包含 method、target(网关移除入口前缀后的 `/{code}/{businessPath}` 原路径及 query,保留 code)、bodySha256(包括空 body 的原字节 SHA-256 小写 hex)和 headers。headers 精确绑定实际存在的 content-type、idempotency-key,无该头就省略对应字段。签名后不能重排 query、重新序列化 body 或改写绑定头。模板先校验实际收到的完整 target,再按自身 `src/microapp-identity.json` 中的 code 内部映射到业务路由;不接受旧入口前缀,也不接受任意其他 code。Next 配置关闭 proxy URL 自动规范化与尾斜杠重定向,通过 afterFiles 内部路由映射派发,不能用会二次进入 proxy 的绝对 rewrite 替换。
14
+
15
+ 模板 src/instrumentation.ts 在生产启动时注册 gateway-ingress.mjs,通过 Node HTTP request-start 通道先于 Next 捕获原始路径/query 和重复安全头,避免框架重编码 query 或删除保留参数后漏检。内部元数据每次覆盖浏览器同名头,使用仅存本进程的随机 HMAC 密钥证明来源,进入 handler 前移除;该密钥自动生成,不是新增部署配置。捕获未生效返回 HTTP 500 + 安全 JSON,伪造或重复安全头返回 HTTP 200 + success:false + GATEWAY_RAW_INGRESS_INVALID,均阻止业务派发。不能删除 instrumentation、只复制 proxy,或通过自报原始路径跳过捕获。实现使用 [Node HTTP 通道](https://nodejs.org/download/release/v24.21.0/docs/api/diagnostics_channel.html#http);Node/Next 版本或服务启动方式变更时必须重跑真实请求测试。
16
+
17
+ 不支持 Content-Encoding,禁止代理解压后仍沿用原签名。路径编码、空白和原字节跨代理保留需要真实链路验证,代理改变实际内容应导致拒绝。
18
+
19
+ ## 业务 API 如何使用
20
+
21
+ 正式 handler 在统一入口通过后调用 `getVerifiedContext(request)`,从公共组件取得 saasId、uid、lang、currentScope(id/type/roleCodes),按模型可有 tenantCode。此方法重新验证签名 envelope,不信任未签名的内部身份头;完整请求绑定与 nonce 消费由统一 proxy 执行,不能用 accessor 替换入口。业务代码禁止自行解码 JWS 后把 payload 当可信对象。
22
+
23
+ 签名有效只证明调用来源及内容完整。每条 API 仍按 [安全生成流程](backend-security-workflow.md) 校验功能、SaaS/业务租户、项目/家庭、对象、字段和状态。角色数组为空不能授予任何业务权限。请求参数中的 uid、projectId 或 tenantCode 不得覆盖可信身份或扩大查询范围。
24
+
25
+ ## 单副本防重放
26
+
27
+ `src/lib/gateway-nonce-store.mjs` 提供同一进程共享的 TTL nonce 缓存,按 audience+nonce 原子消费,保存到 iat+30,过期回收;容量 10,000 条,满时返回 HTTP 500 + 安全 JSON,不能淘汰仍有效的 nonce 来放行。无 PostgreSQL/Redis 依赖,不要求为了验签声明业务数据库。
28
+
29
+ 适用边界是每个 backend 一个 Node 进程、一个副本,不支持 cluster/多 worker/滚动更新期间同时接流量的多个进程。进程重启清空缓存,不能承诺跨重启防重放;有副作用的业务仍需自己的幂等约束。扩为多副本或要求跨重启判重时,替换 consume 接口为共享原子存储并完成集成测试,不能继续复用各进程内存。
30
+
31
+ ## 预览与验收
32
+
33
+ 仅 `NODE_ENV=development` 且由本地工具注入 `V6_LOCAL_PREVIEW=1` 时,跳过上述签名、时间窗及 nonce 验证;不需要 RSA 密钥或生产 audience。本地私有凭证与 DEV 上下文校验继续执行,业务操作使用 `authorizeDevOperation` 回查最新模拟权限,见 [DEV 上下文](dev-preview-context.md)。生产即使设置预览变量也不能跳过验签。
34
+
35
+ 新增 API 至少验证:合法签名可到达 handler;缺签名/错密钥/算法/typ/aud/时间/上下文被拒;method/path/query/body/绑定头篡改及并发重放无业务副作用;非 `/api` 路由不能绕过;预览无签名可用且伪造 DEV 身份失败。模板测试覆盖公共协议,具体 API 的对象、字段及业务副作用仍需实际测试。
36
+
37
+ ### Production role codes and business authorization
38
+
39
+ `biz.currentScope.roleCodes` contains authoritative role codes for the signed current scope. These are not the preview App role types `owner/admin/member`. Do not generate a production allowlist from preview role names or treat any nonempty role array as an operation grant. Establish and verify the actual role-code-to-operation mapping or authoritative permission lookup for the application. Unknown roles remain denied until that mapping is confirmed. Signature and replay checks authenticate context; they do not establish `DEVICE_VIEW` or write permission.
40
+
41
+ Acceptance must include actual built-in and custom production role codes, empty and unknown roles, scope mismatch, and independent read/write decisions. Report any unconfigured production write authorization explicitly; a passing preview must not imply production CRUD is available. Diagnostic evidence should identify the authorization stage, operation and safe reason without logging tokens, signatures or complete claims.
42
+
43
+ When diagnosing gateway business context, emit a dedicated structured event immediately after `getVerifiedContext` succeeds and before business authorization. Include only allowlisted SaaS/user/language/optional tenant, current scope and role codes, selected scope and operation, correlated by request ID. Both granted and denied operations must produce that event; failed verification must not output untrusted claims as verified context. Retain redaction, bounded output and explicit truncation metadata, and never dump the JWS, credential headers or request body. Tests must verify event order, both authorization outcomes, absent context for invalid signatures and credential non-disclosure.
@@ -0,0 +1,49 @@
1
+ # 基于场景模板实现 backend
2
+
3
+ 先读项目实际文件。基线为 Next.js 16.1.1、TypeScript、Zod、pnpm;React 依赖是框架依赖,不意味着要创建 backend 页面。不要覆盖已有业务代码或借用前端 React 18 的依赖目录。
4
+
5
+ ## 目录与职责
6
+
7
+ - src/app/api/**/route.ts:HTTP 输入输出、统一验证/授权入口调用、业务服务调用。根据模板实际路由组织扩展,不复制生成另一套服务器。
8
+ - 业务模块:沿用已有结构;新项目可按领域放 service 与请求 schema,复杂的数据访问可提取 repository。简单计算无需机械创建所有层。
9
+ - 公共上下文验证:保留模板 src/proxy.ts 与 [正式验签组件](gateway-verification.md),handler 使用 getVerifiedContext 读取签名身份,再校验业务权限;禁止直接把 req.headers 或自行解码的 JWS 当授权对象。预览跳过正式验签,使用 DEV 公共授权方法。
10
+ - storage/database:持久化时按 [数据库约束](database-constraints.md)组织 schema 与 pg 客户端;不默认创建数据库或样例业务表。
11
+ - operations.json:当前模板的操作声明起点,读其实际格式。它仍需与发布契约对齐,不能把自拟字段当平台已支持协议。
12
+ - migrations/、锁文件:业务需要时维护;构建不连接生产数据库,运行进程不自动执行 schema push。backend/Dockerfile 仅供本地镜像验证参考,正式构建使用平台发布服务服务端配方;修改本地 Dockerfile 不会改变正式构建。
13
+
14
+ ## 自定义接口契约
15
+
16
+ 根据需求定义业务接口,记录 method、外部路径、backend 路径、参数/响应、所需操作与数据范围、业务错误、分页或幂等约定。外部 /custom-aicoding-api 与内部 /api 的具体重写由网关契约决定,不能假定删除前缀就一定匹配。
17
+
18
+ Zod 或项目现有验证方式限制输入类型、长度、枚举及可写字段;采用统一错误响应,保留安全 trace 信息,不暴露堆栈/数据库连接或越权对象信息。不能因为契约由自己设计就省略授权、校验和前后端一致性。
19
+
20
+ 纯计算接口也检查调用权限和输入资源限制。需要持久化时把授权范围与字段规则放进查询/更新条件;涉及外部 API 时把上游 client 与业务服务分开,处理超时和响应校验,有副作用的调用不盲目重试。
21
+
22
+ 若模板自带 DEV 身份验证器,先确认它明确限制 DEV;不得直接作为生产验证实现。健康检查不代表业务接口/数据库/鉴权已就绪。未接入生产协议的路由应明确拒绝,不能返回伪造成功。
23
+
24
+ ## 响应生成与验收
25
+
26
+ 遵循 [自定义接口响应契约](../../micro-app-cloud-integration/references/backend-authorization.md#自定义接口响应契约):成功使用 200 + JSON,业务拒绝使用 200 + success:false + 安全业务码,系统故障使用 500 + success:false + 安全错误码;禁止 201/202/204、3xx、空响应、HTML、文本、流式输出。不得依赖 Set-Cookie、Refresh、Location 或 CORS 响应头生效。
27
+
28
+ 新 handler 复用模板 `src/lib/api-response.mjs` 的 `apiResponse(body, { status })`;它固定 JSON 响应并拒绝不支持的状态,不接受任意响应头。成功示例 `apiResponse({ success: true, code: 0, result })`,业务拒绝示例 `apiResponse({ success: false, code: 'INVALID_ARGUMENT', requestId, retryable: false })`;系统故障示例 `apiResponse({ success: false, code: 'INTERNAL_ERROR', requestId, retryable: false }, { status: 500 })`。仅返回已映射的安全错误,不能把原始异常对象、堆栈、SQL、凭据放入 JSON。业务 envelope 是应用约定,不是网关字段校验规则。
29
+
30
+ 生成的业务 handler 使用 `withApiErrors(handler, {route: '/api/records/[id]'})` 包住最终导出,消费第三参数 `{requestId, log, runStage}` 关联日志和响应,不另造请求标识。保留模板 instrumentation 与 proxy 的默认入口/验签日志;业务鉴权、参数校验及出入参安全摘要仍需显式接入。数据库或上游调用用 `runStage` 记录真实失败,再映射业务错误;不要 catch 后静默返回安全错误。未捕获异常由边界先记录安全分类再返回安全 500 JSON。该边界不能改写Next在handler外生成的默认响应;Agent 必须为具体路由显式导出不支持方法的 methodNotAllowed,并保留根/API未知路由兜底;不能仅调用 helper 就宣称全部响应合规。生产业务身份从 getVerifiedContext 取得,不能把 DEV 授权器用于生产。
31
+
32
+ 在项目实际 HTTP 路由测试中调用 `assertApiResponse(response)`,再断言业务内容与副作用;覆盖读取/创建/更新/删除成功、HTTP 200 下的参数错误/权限拒绝/资源不存在/方法不支持/数据库只读,以及 HTTP 500 的连接或配置故障与未知异常。该断言校验状态、JSON 类型和实际解析、禁止依赖的响应头;模板 helper 单测不替代这些业务测试。通过 proxy 的测试需使用合法签名/隔离 DEV 身份;无效签名另测拒绝。健康探针独立于业务通道验收。
33
+
34
+ ## 业务日志
35
+
36
+ 按 [业务运行日志](business-logging.md) 实现公共logger、请求关联、入参出参允许列表摘要、验签/鉴权结果及安全错误映射,并验证实际输出;不要直接打印请求或异常对象。
37
+
38
+ ## 验证与交接
39
+
40
+ 按 package.json 执行 pnpm install --frozen-lockfile、pnpm typecheck、pnpm build、pnpm test;测试依赖构建时先构建,具体顺序以已有脚本为准。涉及数据库时增加隔离 DEV 数据库测试;涉及外部副作用时使用测试适配器。安全测试要求见 backend-security-workflow.md,不能以结构检查代替业务测试。
41
+
42
+ 交给前端 Skill:接口/响应、manifest 所需声明、操作权限、无权/错误/空态及 Mock 或 DEV 调用方式。交给发布流程:是否确需 backend/数据库、迁移与契约变更、构建与测试结果。不得自选生产区域或执行未经授权的部署。
43
+
44
+
45
+ ## 生产授权完成条件
46
+
47
+ 生成/修改业务 backend、设计生产配置或交付发布前,必须读取 [生产授权接入与交付门槛](production-authorization-readiness.md)。`upgradeSupportProjects=true` 表示家庭与项目同时支持,不是 project-only。不得自行发明角色白名单配置并假设平台注入;必须落实可信授权来源、配置交付和两种空间的实际验收。生产业务仍走 DEV 授权器、必要配置未落实等已知阻塞,不能以构建成功或 Mock 通过宣称生产可用。用户明确授权联调部署时如实保留未验收状态。
48
+
49
+ HEAD遵循HTTP无响应体语义,只核对状态、Content-Type及无副作用;不能要求HEAD返回可解析JSON。GET等有响应体的方法继续用assertApiResponse验证。