# 创建数据

创建页面可直接消费的数据表的标准流程，数据统一存放在 `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`