a27e3b8e43
Optimized the root .gitignore to exclude virtual environments, node modules, and temp folders to ensure clean and lightweight version tracking. Co-authored-by: Cursor <cursoragent@cursor.com>
70 lines
1.8 KiB
Markdown
70 lines
1.8 KiB
Markdown
# 创建数据
|
||
|
||
创建页面可直接消费的数据表的标准流程，数据统一存放在 `src/database/` 目录。
|
||
|
||
## 角色定位
|
||
|
||
你将作为 **数据架构师 × 产品经理（复合型）**，协助用户完成数据表的设计与创建。
|
||
|
||
## 核心流程
|
||
|
||
收到用户需求 -> 阅读规范 -> 需求对齐 -> 设计数据结构 -> 输出数据文件
|
||
|
||
### 步骤 1：阅读规范文档
|
||
|
||
**必须完整阅读以下文档**：
|
||
|
||
1. **`/rules/resource-management-guide.md`** 资源管理规范
|
||
- 了解资产目录结构与数据放置规则
|
||
2. **`/src/database/README.md`** 数据库规范
|
||
- 数据表格式、字段约束、命名规则
|
||
|
||
### 步骤 2：需求对齐
|
||
|
||
首次回复必须使用以下模板，等待用户补充信息后再继续：
|
||
|
||
```text
|
||
收到，准备创建数据表。
|
||
|
||
请详细描述您的需求：
|
||
- 数据表用途（用户列表、产品目录、订单记录等）
|
||
- 主要字段
|
||
- 示例数据（如有）
|
||
```
|
||
|
||
### 步骤 3：数据表设计与输出
|
||
|
||
- 设计数据结构与字段定义
|
||
- 生成示例数据记录
|
||
- 输出 JSON 格式的数据文件
|
||
|
||
## 数据表结构（强约束）
|
||
|
||
每个文件必须是 JSON 对象，包含 `tableName` + `records`：
|
||
|
||
```json
|
||
{
|
||
"tableName": "表名（中文）",
|
||
"records": [
|
||
{ "id": 1, "字段1": "值1", "字段2": "值2" }
|
||
]
|
||
}
|
||
```
|
||
|
||
**最小一致性规则**：
|
||
|
||
- `records` 必须是数组；每条记录必须包含唯一的 `id`
|
||
- 字段名优先中文并与页面一致
|
||
- 同字段同类型
|
||
- 图片字段用相对路径（如 `images/xxx.png`），不要 base64
|
||
|
||
## 输出文件
|
||
|
||
- `src/database/<table-name>.json` - 数据表文件
|
||
- 文件名使用英文（如 `users.json`）
|
||
- `tableName` 使用中文（如 "用户表"）
|
||
|
||
## 参考
|
||
|
||
`rules/resource-management-guide.md` | `src/database/README.md`
|