tasks.md 2.7 KB

任务清单:穴位定位功能

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 test 全部通过
  • 穴位坐标误差 ≤ 2cm
  • 经络图支持点击、缩放
  • 症状推荐覆盖率 80%+
  • API 响应时间 < 200ms