@lark-apaas/coding-steering 0.1.6-alpha.0 → 0.1.6-alpha.10

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 (21) hide show
  1. package/README.md +11 -2
  2. package/package.json +1 -1
  3. package/steering/design-stack/skills/.gitkeep +0 -0
  4. package/steering/nestjs-react-fullstack/skills/.gitkeep +0 -0
  5. package/steering/nestjs-react-fullstack/skills/authz-guide/SKILL.md +174 -0
  6. package/steering/nestjs-react-fullstack/skills/authz-guide/references/dynamic-permission-guide.md +621 -0
  7. package/steering/nestjs-react-fullstack/skills/authz-guide/references/management-page-spec.md +505 -0
  8. package/steering/nestjs-react-fullstack/skills/authz-guide/references/runtime-role-controller-spec.md +203 -0
  9. package/steering/nestjs-react-fullstack/skills/authz-guide/references/sdk-examples.md +90 -0
  10. package/steering/nestjs-react-fullstack/skills/authz-guide/references/sdk-types.md +216 -0
  11. package/steering/nestjs-react-fullstack/skills/client-builtins-file-storage-service/SKILL.md +405 -0
  12. package/steering/nestjs-react-fullstack/skills/devops-guide/SKILL.md +119 -0
  13. package/steering/nestjs-react-fullstack/skills/plugin-guide/SKILL.md +582 -0
  14. package/steering/nestjs-react-fullstack/skills/plugin-guide/references/plugin-coding-guide.md +357 -0
  15. package/steering/nestjs-react-fullstack/skills/plugin-guide/references/table.md +513 -0
  16. package/steering/nestjs-react-fullstack/skills/react-hook-best-practices/SKILL.md +118 -0
  17. package/steering/nestjs-react-fullstack/skills/server-builtins-file-storage-service/SKILL.md +177 -0
  18. package/steering/nestjs-react-fullstack/skills/user-management-best-practices/SKILL.md +142 -0
  19. package/steering/nestjs-react-fullstack/{skills → skills_local}/code-fix/SKILL.md +5 -19
  20. package/steering/nestjs-react-fullstack/{skills → skills_local}/coding-guide/SKILL.md +26 -148
  21. package/steering/nestjs-react-fullstack/tech.md +21 -0
@@ -0,0 +1,21 @@
1
+ # NestJS + React 全栈技术栈说明
2
+
3
+ 本 stack 对应 miaoda CLI 的 **application scene(MIAODA_APP_TYPE=3)**。
4
+
5
+ ## 技术构成
6
+
7
+ - **客户端**:Vite 7 + React 18 + TypeScript 5;shadcn/ui + Tailwind v4
8
+ - **服务端**:NestJS 10 + Express + Drizzle ORM + PostgreSQL
9
+ - **共享**:`shared/` 子目录放跨端类型 / 常量;客户端用 vite-tsconfig-paths 解析,服务端走 NestJS 编译输出
10
+ - **构建**:`@lark-apaas/fullstack-{vite-preset,nestjs-core,cli}` 三件套;本地 dev 由 `scripts/dev.js` 编排 server + client,本地纯净 dev 走 `scripts/dev-local.sh`
11
+
12
+ ## 关键 env
13
+
14
+ - `MIAODA_LOCAL_DEV=1`:本地 dev 总开关,开启 SDK 内置的 sandbox 反代 / cookie+webuser 兜底
15
+ - `FORCE_AUTHN_PREVIEW_SESSION_ID`:后端下发的 session id,SDK 自动拼成 sandbox cookie
16
+ - `SANDBOX_PUBLIC_URL`:沙箱公网域,反代 `/__runtime__/*` 的 target
17
+ - `CLIENT_BASE_PATH=/app/<app_id>/`:路径前缀,决定 React Router basename + Vite base
18
+
19
+ ## 待补 skills
20
+
21
+ 本目录 `skills/` 目前是 .gitkeep 占位。stack 专属编码规则(DTO 装饰器、ORM 用法、view-engine 模板等)后续按需补充。