---
description: >
  端到端功能开发技能。当需要从数据库到 API 到 UI 全链路开发完整功能时激活。
  编排 database-migration、api-scaffold、component-scaffold 等技能协同工作。
alwaysApply: false
---

# Full Feature Workflow

> 本文件是精简执行摘要。完整流程、模板和深度参考见：
> Read `.cursor/skills/full-feature/SKILL.md`

依赖技能：`component-scaffold`、`vue-testing`

## 执行流程

### Phase 1: 规划

拆分功能为子任务：
- 数据层：数据模型和数据库变更
- 后端 API：Controller / Service / Repository
- 前端 UI：组件和页面
- 测试：每层测试

输出执行计划后确认再开始。

### Phase 2: 数据层

1. 生成迁移：`php bin/hyperf.php gen:migration create_<table>_table`
2. 编写迁移（遵循高并发表设计规范）
3. 执行迁移 + 生成 Model
4. 补充 Model 关联和类型转换

参考：Cursor 已通过 `skill-database-migration` 规则自动加载。
如需模板细节，Read `.cursor/skills/database-migration/references/migration-patterns.md`

### Phase 3: 后端 API 层

1. Controller（接收请求）→ Service（业务逻辑）→ Repository → FormRequest
2. 注册路由 + 挂载中间件
3. 编写 PHPUnit 测试

参考：Cursor 已通过 `skill-backend-scaffold` 规则自动加载。
如需模板细节，Read `.cursor/skills/api-scaffold/references/code-templates.md`

### Phase 4: 前端 UI 层

1. 封装 API 接口（`src/api/<module>/`）
2. 创建列表页 + 表单组件 + 详情页
3. 配置 Vue Router 路由
4. 连接 Pinia Store（如需跨页面状态）

参考：Cursor 已通过 `skill-component-scaffold` 和 `skill-vue-page` 规则自动加载。
如需模板细节，Read `.cursor/skills/component-scaffold/references/component-templates.md`

### Phase 5: 集成验证

1. 后端测试：`composer test`
2. 前端 Lint：`npm run lint`
3. 手动测试 CRUD 全路径

### Phase 6: 收尾

更新文档（data-model.md、api-contracts.md）→ Git commit

## 执行原则

- **自底向上**：数据层 → 后端 API → 前端 UI
- **每步验证**：每个 Phase 完成后运行测试
- **可中断**：每个 Phase 独立可提交

## 验证

- [ ] 后端测试全部通过
- [ ] 前端 ESLint 无报错
- [ ] 功能端到端可用（CRUD 全路径）
- [ ] 代码遵循项目现有模式
- [ ] 文档已更新