@cherishxn/agent-scaffold 0.0.0-stage → 1.1.0

package/templates/react-nest-antd/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 qinchaomeishenmeshi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/templates/react-nest-antd/README.md

@@ -0,0 +1,64 @@
+## 运行
+
+需要 Node.js 24、Docker 和该模板的运行时（见 project.json 与下方说明）。
+
+```bash
+npm run setup
+npm run dev
+```
+
+`setup` 安装依赖，然后显式启动本地 PostgreSQL、迁移并创建 A/B 开发账号。首次生成随机密码，登录信息在 Git 忽略的 `.scaffold-local-credentials`；不是生产默认密码。已有 `.env` 时保留配置，请仅使用本地开发实例。
+
+默认数据库端口为 54329、API 为 8000、Web 为 5173（Next 为 3000）。首次 setup 可用 `POSTGRES_PORT`、`PORT`、`WEB_PORT` 环境变量指定空闲端口；后续沿用 `.env`。
+
+页面名称与简介来自根 project.json；英文名用于目录和工程标识。基础示例只包含个人记录功能，不因简介自动新增业务。
+
+## 验证
+
+安装前可只检查工具；doctor 不会安装依赖或启动服务：
+
+```bash
+npx @cherishxn/agent-scaffold@__CLI_VERSION__ doctor --dir . --tools-only --json
+```
+
+安装依赖后，先做快速检查，再按需要验证完整业务：
+
+```bash
+npm run check
+npx @cherishxn/agent-scaffold@__CLI_VERSION__ doctor --dir . --json
+npx @cherishxn/agent-scaffold@__CLI_VERSION__ verify --dir . --profile baseline --json
+npx @cherishxn/agent-scaffold@__CLI_VERSION__ report --dir . --json
+```
+
+`check` 顺序执行类型、Lint、构建，任一步失败即停止；它不创建数据库、不执行迁移或业务测试。
+
+verify 创建自己的临时 PostgreSQL 并注入连接，不使用开发 DATABASE_URL；完成后释放本次容器。单独运行项目命令时需要显式提供本地环境：
+
+```bash
+node scripts/project.mjs typecheck
+node scripts/project.mjs lint
+node scripts/project.mjs build
+node scripts/project.mjs test:native
+node scripts/project.mjs test:api
+node scripts/project.mjs test:e2e
+node scripts/project.mjs api:generate
+```
+
+接口：docs/openapi.json；结构：docs/PROJECT.md；规则：AGENTS.md。修改契约后运行 npm run api:generate 更新 TypeScript 类型。npm run api:check 在临时目录重新生成并只读比较，check/verify 自动执行；test:api 同时按 OpenAPI 检查真实响应状态、必填字段和类型。验证不会自动修改源码。
+
+## 认证边界
+
+JWT 模板只在浏览器内存保存 Token，页面刷新需重新登录；退出清除内存，不声称服务器撤销旧 JWT。Session 模板使用 HttpOnly Cookie 和同源写入校验，退出后 Session 失效。所有记录访问由服务端按当前用户过滤。
+
+## 容器构建
+
+按模板提供的 Dockerfile 构建，配置自己的数据库和秘密；构建与本地验证不代表生产部署或业务验收通过。不要把 `.env`、凭据文件或运行报告加入镜像/版本库。
+
+## 视觉设计
+
+UI 开发前读根目录 DESIGN.md 和内置 design-contract Skill。`design/tokens.json`、`widgets.json`、`structure.json` 与公共 CSS 是组件库无关的设计源；`web/src/ui.tsx` 是所选组件库适配器；`workspace-model.ts` 管理业务。修改源后执行 `npm run design:sync`，再运行只读漂移检查 `npm run design:check` 和浏览器契约检查 `npm run design:verify`。后者临时创建测试入口，验证全部声明的组件状态及页面（桌面/移动端），输出 `reports/design-check/result.json`，结束后清理入口。需要已安装依赖及 Playwright Chromium。build/typecheck/lint 同样检查漂移。当前项目的 PASS 仅证明已选适配器；新增库须保持共享规范和业务不变，添加适配器、依赖及框架绑定，并在脚手架完整矩阵中复验。
+
+## 本模板
+
+技术栈：react-nest；UI：antd。需要 pnpm + Node.js 24。
+后端镜像：docker build backend；前端构建产物位于 web/dist，生产需要同源反向代理 /api 到后端。

package/templates/react-nest-antd/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,18 @@
+# Template sources and licenses
+
+Templates are maintained derivatives, not unmodified upstream distributions. Exact bundled files are hashed in templates/catalog.json; npm/uv/pnpm/Bun locks pin dependency resolution. Initialization is offline and never invokes upstream generators.
+
+| Source | Fixed reference | Use / modifications | License |
+| --- | --- | --- | --- |
+| fastapi/full-stack-fastapi-template | b1125d8839482cb7bbae603ddc6d0081bf87532e | SQLModel/Alembic/JWT/pwdlib foundation; reduced accounts, replaced sample feature with owner-scoped records, retained Bun frontend | MIT, licenses/fastapi.txt |
+| nestjs/typescript-starter | a122dea65cd0610ee205d7765ed46f9d73629141 | Nest module/bootstrap foundation; added Prisma, JWT/Guard, Jest/Supertest; no deployment tooling | MIT, licenses/nest.txt |
+| Spring Initializr | starter.zip fetched 2026-10-19; Maven Wrapper and Java layout | Generator returned unresolved 4.1.1.RELEASE; parent adjusted to stable Maven Central 3.5.16, Session/JPA/Flyway/CRUD added | Apache-2.0 wrapper, licenses/spring.txt |
+| create-next-app | npm 16.4.2 | Official App Router/TypeScript baseline; Better Auth + Prisma + records; no remote fonts | MIT, licenses/next.txt |
+| shadcn/ui | Button/Input pattern, pinned source reference in licenses/sources.json | Adapted local CVA/Slot controls with Tailwind; retained copy ownership | MIT, licenses/shadcn.txt |
+| Ant Design | npm 6.6.6 | Installed dependency; no copied source | MIT (package license) |
+
+Package dependencies carry their own licenses. Generated apps include these notices; template authors must carry applicable notices when changing upstream-derived files. Names and marks remain their respective owners'.
+
+## Design and workflow reference
+
+VinkyDev/vibestart at commit `5768fc561340422bf7736499fe69b1aae263790a` (MIT) informed the preview, task-oriented Agent guidance, quick checks and template-layer collision rules. These changes are independently implemented for Agent Scaffold; no VibeStart source, bundled skills, branding or UI assets are redistributed. The source review and selected adaptations are recorded in docs/reference/VIBESTART-REVIEW.md.

package/templates/react-nest-antd/backend/Dockerfile

@@ -0,0 +1,12 @@
+FROM node:24-alpine
+RUN corepack enable && corepack prepare pnpm@10.28.2 --activate
+WORKDIR /app
+COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
+COPY prisma ./prisma
+RUN pnpm install --frozen-lockfile && pnpm exec prisma generate
+COPY tsconfig*.json ./
+COPY src ./src
+RUN pnpm run build
+ENV HOST=0.0.0.0
+EXPOSE 8000
+CMD ["node", "dist/main.js"]

package/templates/react-nest-antd/backend/eslint.config.mjs

@@ -0,0 +1,3 @@
+import js from '@eslint/js';
+import ts from 'typescript-eslint';
+export default ts.config(js.configs.recommended,...ts.configs.recommended,{languageOptions:{parserOptions:{tsconfigRootDir:import.meta.dirname}},ignores:['dist/**','node_modules/**']});

package/templates/react-nest-antd/backend/jest.config.cjs

@@ -0,0 +1 @@
+module.exports={testEnvironment:'node',extensionsToTreatAsEsm:['.ts'],transform:{'^.+\\.tsx?$':['ts-jest',{useESM:true,tsconfig:{module:'ES2022',moduleResolution:'node'}}]},testMatch:['**/test/**/*.test.ts'],reporters:['default',['jest-junit',{outputDirectory:process.env.SCAFFOLD_REPORT_DIR||'../reports',outputName:'native.xml'}]]};

package/templates/react-nest-antd/backend/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "__NAME_EN__-api",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src test scripts",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js --runInBand",
+    "start": "node dist/main.js"
+  },
+  "dependencies": {
+    "@nestjs/common": "12.2.0",
+    "@nestjs/core": "12.2.0",
+    "@nestjs/platform-express": "12.2.0",
+    "@nestjs/jwt": "12.0.3",
+    "@nestjs/swagger": "12.0.2",
+    "@prisma/client": "6.19.3",
+    "reflect-metadata": "0.2.2",
+    "rxjs": "7.8.2",
+    "zod": "4.6.7"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3",
+    "prisma": "6.19.3",
+    "tsx": "4.23.15",
+    "@types/node": "24.19.2",
+    "@types/express": "5.0.6",
+    "@nestjs/testing": "12.2.0",
+    "jest": "29.7.0",
+    "ts-jest": "29.4.15",
+    "@types/jest": "29.5.14",
+    "supertest": "7.3.1",
+    "@types/supertest": "7.2.1",
+    "jest-junit": "16.0.0",
+    "eslint": "9.39.5",
+    "@eslint/js": "9.39.5",
+    "typescript-eslint": "8.71.2"
+  }
+}