@cherishxn/agent-scaffold 0.0.0-stage → 1.1.0

package/templates/react-nest-shadcn/design/widgets.json

@@ -0,0 +1,233 @@
+{
+  "schemaVersion": 1,
+  "acceptance": {
+    "positionTolerance": 0.6,
+    "exact": [
+      "color",
+      "radius",
+      "iconGeometry"
+    ],
+    "viewports": [
+      {
+        "width": 1440,
+        "height": 1000
+      },
+      {
+        "width": 375,
+        "height": 812
+      }
+    ]
+  },
+  "widgets": {
+    "button": {
+      "parts": [
+        "root",
+        "label"
+      ],
+      "variants": [
+        "primary",
+        "secondary",
+        "danger"
+      ],
+      "states": [
+        "default",
+        "hover",
+        "active",
+        "focus",
+        "disabled",
+        "loading"
+      ],
+      "styles": {
+        "height": "{components.button-primary.height}",
+        "paddingX": "{spacing.s16}",
+        "paddingY": "{spacing.s8}",
+        "borderWidth": "{spacing.s1}",
+        "fontSize": "{typography.button.fontSize}",
+        "fontWeight": "{typography.button.fontWeight}",
+        "lineHeight": "{typography.button.lineHeight}",
+        "radius": "{components.button-primary.rounded}"
+      },
+      "behavior": {
+        "keyboard": [
+          "Enter",
+          "Space"
+        ],
+        "loading": "disabled-with-status-label",
+        "icon": "none"
+      }
+    },
+    "input": {
+      "parts": [
+        "root"
+      ],
+      "variants": [
+        "text",
+        "email",
+        "password"
+      ],
+      "states": [
+        "default",
+        "hover",
+        "focus",
+        "disabled",
+        "invalid",
+        "readonly"
+      ],
+      "styles": {
+        "height": "{spacing.control-min}",
+        "paddingX": "{spacing.s12}",
+        "paddingY": "{spacing.s8}",
+        "borderWidth": "{spacing.s1}",
+        "fontSize": "{typography.body.fontSize}",
+        "lineHeight": "24px",
+        "radius": "{components.input.rounded}"
+      },
+      "behavior": {
+        "keyboard": "native-text-editing",
+        "passwordVisibility": "always-masked",
+        "autocomplete": "caller-provided",
+        "validation": "business-owned"
+      }
+    },
+    "textarea": {
+      "parts": [
+        "root"
+      ],
+      "variants": [
+        "default"
+      ],
+      "states": [
+        "default",
+        "hover",
+        "focus",
+        "disabled",
+        "invalid",
+        "readonly"
+      ],
+      "styles": {
+        "paddingX": "{spacing.s12}",
+        "paddingY": "{spacing.s8}",
+        "borderWidth": "{spacing.s1}",
+        "fontSize": "{typography.body.fontSize}",
+        "lineHeight": "24px",
+        "radius": "{rounded.md}"
+      },
+      "behavior": {
+        "keyboard": "native-multiline-editing",
+        "resize": "vertical"
+      }
+    },
+    "alert": {
+      "parts": [
+        "root",
+        "icon",
+        "message"
+      ],
+      "variants": [
+        "error",
+        "success"
+      ],
+      "states": [
+        "default"
+      ],
+      "styles": {
+        "paddingX": "{spacing.s16}",
+        "paddingY": "{spacing.s12}",
+        "gap": "{spacing.s8}",
+        "iconSize": "16px",
+        "fontSize": "14px",
+        "lineHeight": "22px",
+        "borderWidth": "1px",
+        "radius": "{rounded.md}"
+      },
+      "behavior": {
+        "errorRole": "alert",
+        "successRole": "status",
+        "dismiss": "none"
+      }
+    },
+    "badge": {
+      "parts": [
+        "root",
+        "label"
+      ],
+      "variants": [
+        "default"
+      ],
+      "states": [
+        "default"
+      ],
+      "styles": {
+        "paddingX": "{spacing.s10}",
+        "paddingY": "{spacing.s3}",
+        "fontSize": "12px",
+        "lineHeight": "18px",
+        "borderWidth": "1px",
+        "radius": "{rounded.full}"
+      },
+      "behavior": {
+        "interactive": false
+      }
+    },
+    "panel": {
+      "parts": [
+        "root"
+      ],
+      "variants": [
+        "default"
+      ],
+      "states": [
+        "default"
+      ],
+      "styles": {
+        "padding": "{components.panel.padding}",
+        "borderWidth": "1px",
+        "radius": "{components.panel.rounded}"
+      },
+      "behavior": {
+        "interactive": false
+      }
+    },
+    "field": {
+      "parts": [
+        "root",
+        "label",
+        "control"
+      ],
+      "variants": [
+        "default"
+      ],
+      "states": [
+        "default"
+      ],
+      "styles": {
+        "gap": "{spacing.s8}",
+        "marginY": "{spacing.s22}",
+        "fontSize": "{typography.label.fontSize}",
+        "fontWeight": "{typography.label.fontWeight}",
+        "lineHeight": "22px"
+      },
+      "behavior": {
+        "label": "explicit-for-control"
+      }
+    }
+  },
+  "icons": {
+    "error": {
+      "viewBox": "0 0 24 24",
+      "strokeWidth": 2,
+      "paths": [
+        "M12 3 2 21h20L12 3Z",
+        "M12 9v5",
+        "M12 17h.01"
+      ]
+    },
+    "success": {
+      "viewBox": "0 0 24 24",
+      "strokeWidth": 2,
+      "paths": [
+        "M20 6 9 17l-5-5"
+      ]
+    }
+  }
+}

package/templates/react-nest-shadcn/docs/PROJECT.md

@@ -0,0 +1,32 @@
+## 当前范围
+
+基础示例：登录、退出、个人记录列表/详情/新建/编辑/删除，以及服务端用户隔离。项目简介是用途说明，真实业务细节和额外验收条件尚未确认。
+
+## 工程事实
+
+project.json 标识技术栈和 UI；web/ 是界面或 Next 全栈应用；独立后端位于 backend/。scripts/project.mjs 提供实际安装、开发、测试、构建命令。数据库结构以迁移为准，接口见 docs/openapi.json 和生成的 docs/api.d.ts。
+
+后续需求在团队已有权威来源或本文记录，不要求接入特定任务平台。名称和简介来自创建输入，修改 project.json 可更新界面展示。
+
+
+## 从任务找到改动位置
+
+先核对 project.json 的实际技术栈；以下路径只描述本项目。读取命中的实现和调用方后再修改，不将基础示例自动扩展成用户未要求的业务。
+
+| 任务 | 入口 | 改动约束 |
+| --- | --- | --- |
+| 页面交互 | `web/src/App.tsx`、`web/src/workspace-model.ts` | 业务状态放模型，页面负责绑定；身份结束时清空用户数据。 |
+| 设计与组件 | `DESIGN.md`、`design/`、`web/src/ui.tsx` | 先改共享设计意图，再改适配器；按 design-contract 执行同步与浏览器检查。 |
+| API 与身份隔离 | `backend/src/app.module.ts`、`backend/src/password.ts` | 查询始终限定当前用户；JWT 保留在浏览器内存。 |
+| 模型与迁移 | `backend/prisma/schema.prisma`、`backend/prisma/migrations/` | 新增 Prisma 迁移，保留已经运行过的迁移。 |
+| 后端回归 | `backend/test/api.test.ts` | 用真实 PostgreSQL 验证数据和越权行为。 |
+| HTTP 契约 | `docs/openapi.json`、`docs/api.d.ts`、`tests/contract.spec.ts` | 修改输入输出时同步契约与真实 HTTP 回归；用 api:generate 生成类型。 |
+| 用户流程 | `tests/ui.spec.ts` | 覆盖真实操作、持久化和失败反馈，测试仅使用专用数据。 |
+| 启动与依赖 | `package.json`、`scripts/project.mjs`、`compose.yaml` | 使用锁文件和项目命令；配置、账号及运行报告留在本地。 |
+
+## 修改与验证
+
+1. 将当前需求转成可观察行为与失败场景，复用现有契约和测试入口。
+2. 做能贯通当前需求的最小改动，先运行相关检查；`npm run check` 按类型、Lint、构建快速失败。
+3. API、数据、认证或完整交付使用 README 中的 `verify`，它创建隔离数据库执行原生/API/浏览器检查。UI 还需运行设计契约检查。
+4. 查看差异并报告实际结果。类型或构建通过不等于业务通过；历史报告为 STALE 时按当前内容复验。