Explorar o código

docs(openspec): 简化穴位定位任务清单

- 移除具体实施细节,保留概览
- 添加前置条件说明
- 精简穴位数据表格
- 更新状态为'规划中'
liaoxg hai 7 meses
pai
achega
d82fc2563a
Modificáronse 1 ficheiros con 60 adicións e 75 borrados
  1. 60 75
      openspec/changes/acupoint-location/tasks.md

+ 60 - 75
openspec/changes/acupoint-location/tasks.md

@@ -1,80 +1,65 @@
 # 任务清单:穴位定位功能
 
-## Wave 1: 数据层
-
-- [ ] 创建 `packages/shared/src/data/acupoints.json` 穴位数据库
-- [ ] 创建 `packages/shared/src/types/acupoint.ts` 类型定义
-- [ ] 创建 `packages/shared/src/utils/acupointCalculator.ts` 坐标计算算法
-- [ ] 编写穴位计算单元测试
-- [ ] 编写数据验证测试
-
-## Wave 2: API 层
-
-- [ ] 创建 `apps/api/src/routes/acupoints.ts` 路由
-- [ ] 实现 `GET /api/acupoints` 获取穴位列表
-- [ ] 实现 `GET /api/acupoints/:id` 获取单个穴位
-- [ ] 实现 `POST /api/acupoints/calculate` 计算穴位位置
-- [ ] 实现 `POST /api/acupoints/recommend` 症状推荐
-- [ ] 创建 API 文档
-
-## Wave 3: 前端可视化
-
-- [ ] 创建 `apps/web/src/components/MeridianGraph/` 目录
-- [ ] 实现 `MeridianGraph.tsx` 经络图主组件
-- [ ] 实现 `AcupointMarker.tsx` 穴位标记点
-- [ ] 实现 `AcupointTooltip.tsx` 穴位信息浮层
-- [ ] 创建 `apps/web/src/components/AcupointSelector/` 目录
-- [ ] 实现 `AcupointSelector.tsx` 穴位选择器
-- [ ] 实现 `AcupointCard.tsx` 穴位卡片
-- [ ] 创建经络图 SVG 资源
-
-## Wave 4: 集成
-
-- [ ] 创建 Zustand store: `useAcupointStore`
-- [ ] 集成用户信息模块
-- [ ] 集成艾灸方案模块
-- [ ] 创建穴位定位页面
-- [ ] 端到端测试
-
-## Wave 5: 验收
-
-- [ ] 验证 12 个穴位坐标计算正确
-- [ ] 验证经络图交互功能
-- [ ] 验证症状推荐逻辑
-- [ ] 验证与艾灸方案集成
-- [ ] 归档变更 `/opsx:archive acupoint-location`
-
-## 数据准备
-
-需要准备的穴位数据(12个):
-
-| ID | 穴位名称 | 相对大椎穴偏移 | 功效 |
-|----|----------|---------------|------|
-| dazhui | 大椎穴 | (0, 0) | 驱寒、祛湿、解表 |
-| shenzhu | 身柱穴 | (0, -7.5cm) | 止咳平喘、安神 |
-| zhiyang | 至阳穴 | (0, -15cm) | 宽胸理气 |
-| mingmen | 命门穴 | (0, -30cm) | 补肾壮阳 |
-| yaoyangguan | 腰阳关穴 | (0, -35cm) | 强腰健肾 |
-| fengmen | 风门穴 | (±4cm, -3cm) | 祛风解表 |
-| bingfeng | 秉风穴 | (±6cm, -8cm) | 祛风散寒 |
-| geshu | 膈俞穴 | (±4cm, -17cm) | 活血化瘀 |
-| baliao | 八髎穴 | (0, -33cm) | 调理下焦 |
-| feishu | 肺俞穴 | (±4cm, -10cm) | 化痰止咳 |
-| pishu | 脾俞穴 | (±4cm, -20cm) | 健脾养血 |
-| shenshu | 肾俞穴 | (±4cm, -22cm) | 补肾益气 |
-
-## 技能需求
-
-| 技能 | 用途 | 状态 |
-|------|------|------|
-| test-driven-development | TDD 开发 | 需安装 Superpowers |
-| design-taste-frontend | UI 设计 | 已安装 |
-| verification-before-completion | 验收测试 | 需安装 Superpowers |
+> **状态**: 规划中,待启动实施
+
+## 概述
+
+本功能基于用户体型数据实现智能穴位定位,支持经络图可视化和症状推荐。
+
+## 前置条件
+
+- [ ] 基础项目架构已搭建(pnpm workspace, TypeScript 配置)
+- [ ] 用户信息管理模块可用
+- [ ] 艾灸方案执行模块可用
+
+## 实施阶段
+
+### Wave 1: 数据层
+- 穴位数据库 JSON(12个常用穴位)
+- TypeScript 类型定义
+- 坐标计算算法
+
+### Wave 2: API 层
+- RESTful API 接口
+- 穴位计算服务
+- 症状推荐逻辑
+
+### Wave 3: 前端可视化
+- 经络图组件
+- 穴位交互功能
+- 选择器组件
+
+### Wave 4: 集成测试
+- 模块集成
+- 端到端测试
+- 验收测试
+
+## 穴位数据
+
+| 穴位 | 经络 | 相对偏移 | 功效 |
+|------|------|----------|------|
+| 大椎穴 | 督脉 | (0, 0) 基准 | 驱寒、祛湿 |
+| 身柱穴 | 督脉 | (0, -7.5cm) | 止咳平喘 |
+| 至阳穴 | 督脉 | (0, -15cm) | 宽胸理气 |
+| 命门穴 | 督脉 | (0, -30cm) | 补肾壮阳 |
+| 腰阳关穴 | 督脉 | (0, -35cm) | 强腰健肾 |
+| 风门穴 | 足太阳膀胱经 | (±4cm, -3cm) | 祛风解表 |
+| 秉风穴 | 手太阳小肠经 | (±6cm, -8cm) | 祛风散寒 |
+| 膈俞穴 | 足太阳膀胱经 | (±4cm, -17cm) | 活血化瘀 |
+| 八髎穴 | 足太阳膀胱经 | (0, -33cm) | 调理下焦 |
+| 肺俞穴 | 足太阳膀胱经 | (±4cm, -10cm) | 化痰止咳 |
+| 脾俞穴 | 足太阳膀胱经 | (±4cm, -20cm) | 健脾养血 |
+| 肾俞穴 | 足太阳膀胱经 | (±4cm, -22cm) | 补肾益气 |
 
 ## 验收标准
 
-- [ ] `pnpm test` 全部通过
-- [ ] 穴位坐标误差 ≤ 2cm
-- [ ] 经络图支持点击、缩放
-- [ ] 症状推荐覆盖率 80%+
-- [ ] API 响应时间 < 200ms
+- 穴位坐标误差 ≤ 2cm
+- 经络图支持点击、缩放交互
+- 症状推荐覆盖率 80%+
+- API 响应时间 < 200ms
+
+## 参考文档
+
+- 需求: `需求材料/艾灸椅功能定义-最新.xlsx`
+- 设计: `openspec/changes/acupoint-location/design.md`
+- 标准: GB/T 12346-2006《腧穴名称与定位》