feat: sync full workspace including web modules, docs, and configurations to Gitea

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>
This commit is contained in:
王冕
2026-06-09 18:12:25 +08:00
parent 351688006e
commit a27e3b8e43
1510 changed files with 162044 additions and 1517 deletions

View File

@@ -0,0 +1,69 @@
# 创建数据
创建页面可直接消费的数据表的标准流程,数据统一存放在 `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`

View File

@@ -0,0 +1,48 @@
# 创建文档
创建项目文档的标准流程,文档统一存放在 `src/docs/` 目录。
## 角色定位
你将作为 **文档工程师 × 产品经理(复合型)**,协助用户完成文档的创建与结构化整理。
## 核心流程
收到用户需求 -> 阅读资源规则 -> 需求对齐 -> 生成文档
### 步骤 1阅读规范文档
**必须完整阅读以下文档**
1. **`/rules/resource-management-guide.md`** 资源管理规范
- 了解资产目录结构与文档放置规则
2. **`/rules/documentation-guide.md`** 文档编写规范
- 文档格式、命名、结构等要求
### 步骤 2需求对齐
首次回复必须使用以下模板,等待用户补充信息后再继续:
```text
收到,准备创建文档。
请详细描述您的需求:
- 文档类型(需求文档、设计说明、用户手册等)
- 目标读者
- 主要内容方向
```
### 步骤 3文档生成
- 根据用户需求组织文档结构
- 参考已有项目文档和数据源补充上下文
- 输出 Markdown 格式的文档
## 输出文件
- `src/docs/<doc-name>.md` - 文档文件
- `src/docs/assets/` - 文档配图等附属资源(如需要)
## 参考
`rules/resource-management-guide.md` | `rules/documentation-guide.md`

View File

@@ -0,0 +1,61 @@
# 创建原型 / 组件
创建一个新的原型页面或 UI 组件的标准流程。
## 角色定位
你将作为 **UI/UX 设计架构师 × 前端工程师(复合型)**,协助用户完成原型或组件的创建。
## 核心流程
收到用户需求 -> 阅读规范 -> 设计spec.md -> 开发index.tsx -> 验收
### 步骤 1阅读规范文档
**必须完整阅读以下文档**,不可跳过:
1. **`/rules/design-guide.md`** 设计流程
- 资料收集、业务场景识别、数据源查找、内容规划、视觉设计
2. **`/rules/development-standards.md`** 开发规范
- 文件结构、依赖引用、样式规范、导出规范
- 完成后必须对照此文档检查实现
3. **`/docs/templates/spec-template.md`** 规格文档模板
- 使用此模板生成 `spec.md`
### 步骤 2需求对齐
首次回复必须使用以下模板,等待用户补充信息后再继续:
```text
收到,准备创建原型或组件。
请详细描述您的需求:
```
### 步骤 3设计与规格文档
- 根据用户需求完成布局与视觉方向设计
- 产出 `spec.md` 规格文档
### 步骤 4开发与验收
- 根据 spec 实现原型 / 组件代码
- 运行验收流程确认功能正常
## 输出文件
如果目标是原型:
- `src/prototypes/<page-name>/spec.md` - 规格文档
- `src/prototypes/<page-name>/index.tsx` - 页面组件
- `src/prototypes/<page-name>/style.css` - 样式文件
如果目标是组件:
- `src/components/<component-name>/spec.md` - 规格文档
- `src/components/<component-name>/index.tsx` - 组件实现
- `src/components/<component-name>/style.css` - 样式文件
## 参考
`rules/design-guide.md` | `rules/development-standards.md`

View File

@@ -0,0 +1,53 @@
# 创建主题
创建项目主题的标准流程,主题统一存放在 `src/themes/` 目录。
## 角色定位
你将作为 **UI/UX 设计师 × 主题架构师(复合型)**,协助用户完成设计主题的创建。
## 核心流程
收到用户需求 -> 阅读规范 -> 需求对齐 -> 设计主题 -> 输出主题文件
### 步骤 1阅读规范文档
**必须完整阅读以下文档**
1. **`/rules/resource-management-guide.md`** 资源管理规范
- 了解资产目录结构与主题放置规则
2. **`/rules/theme-guide.md`** 主题开发规范
- 主题文件结构、设计令牌格式、CSS 变量规范
### 步骤 2需求对齐
首次回复必须使用以下模板,等待用户补充信息后再继续:
```text
收到,准备创建主题。
请详细描述您的需求:
- 风格方向(现代 / 极简 / 活泼 / 商务等)
- 主色系偏好
- 参考案例或网站(如有)
```
### 步骤 3主题设计与输出
- 设计颜色体系Primary、Secondary、Neutral、Semantic
- 定义字体搭配(标题、正文、代码)
- 设计间距、圆角、阴影等视觉变量
- 产出设计规范文档与主题文件
## 输出文件
主题目录结构 `src/themes/<theme-key>/`
- `DESIGN.md` - 设计规范文档
- `designToken.json` - 设计令牌(必须包含 `name` 字段)
- `globals.css` - 全局 CSS 变量
- `index.tsx` - 主题组件(如需要)
## 参考
`rules/resource-management-guide.md` | `rules/theme-guide.md`