|
|
@@ -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《腧穴名称与定位》
|