feat: add frontend development guidelines and structure documentation

- Introduced API guidelines for interface contracts and request handling.
- Added design tokens usage guidelines for consistent styling across the project.
- Established DTO guidelines for defining request parameters and response data types.
- Created frontend structure guidelines to clarify directory organization and code placement rules.
- Compiled a comprehensive frontend development guideline document covering various aspects of the development process.
- Implemented quality guidelines to ensure code maintainability and adherence to best practices.
This commit is contained in:
yuxuanhui
2026-07-25 22:20:25 +08:00
commit 91861565bb
78 changed files with 5001 additions and 0 deletions
+66
View File
@@ -0,0 +1,66 @@
---
id: ARTIFACT-MODEL-AI-RD-WORKFLOW
type: standard
status: draft
created: 2026-06-29
---
# 产物模型
## 基本原则
每个需求产物都是一个可追踪 artifact。目录结构用于人工导航,frontmatter 用于机器读取和关联。
## 通用 frontmatter
```yaml
---
id: UR-20260629-001
case_id: REQ-20260629-001
type: user-requirement
stage: user-requirement
owner_role: PM
status: draft
source_ids:
- INTAKE-20260629-001
derived_ids:
- RA-20260629-001
- SA-20260629-001
skill:
name: pm-requirement-refine
version: 0.1.0
created: 2026-06-29
updated: 2026-06-29
---
```
## 产物类型
| type | 阶段 | 负责人 | 主要输入 | 主要输出 |
| --- | --- | --- | --- | --- |
| intake | 用户需求 | PM | 原始输入 | 需求背景、目标、问题陈述 |
| user-requirement | 用户需求 | PM | intake | UR |
| requirement-analysis | 用户需求 | PM | UR | RA |
| scenario-analysis | 用户需求 | PM | UR / RA | SA |
| objective-requirement | 研发需求 | SE | UR / RA / SA | OR |
| development-requirement | 研发需求 | SE | OR | DR |
| design-specification | 详细设计 | RD | OR / DR | DS |
| implementation-task | 编码 | RD / AI | DS | 开发任务、变更集 |
| test-plan | 测试 | QA / RD / AI | UR / OR / DR / DS | TP |
| test-case | 测试 | QA / RD / AI | TP / DS | TC |
## 状态
- `draft`:草稿。
- `reviewing`:评审中。
- `approved`:已通过评审。
- `rework`:需要返工。
- `implemented`:已实现。
- `verified`:已验证。
- `archived`:已归档。
## 关联方向
- `source_ids`:当前产物直接依赖的上游产物。
- `derived_ids`:由当前产物直接产出的下游产物。
- `case_id`:将同一需求链路下的所有产物绑定到一个需求实例。