艾灸椅智能穴位定位系统
项目概述
艾灸椅智能穴位定位系统是艾灸椅项目的核心子系统，负责根据用户体型数据计算穴位位置，并通过APP推送给艾灸椅设备，实现精准穴位定位和艾灸理疗。
三方协作架构
┌─────────────────────────────────────────────────────────────────┐
│ 项目协作架构 │
├─────────────────────────────────────────────────────────────────┤
│ 单位A（硬件） 单位B（APP） 我们（算法+后台）│
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ 艾灸椅 │ │ APP │ │ 后台管理│ │
│ │ 设备 │◀─────────│ 功能 │◀──────────│ 系统 │ │
│ └─────────┘ 推送 └─────────┘ 推送 └─────────┘ │
└─────────────────────────────────────────────────────────────────┘
核心职责
| 职责 |
说明 |
交付物 |
| 后台管理系统 |
从零搭建，全新开发 |
管理后台 |
| 穴位坐标算法 |
用户体型数据 → 穴位相对偏移 |
算法服务 |
| 艾灸工艺生成 |
专家方案 → 设备可执行工艺语言 |
工艺数据 |
| 后台-APP接口 |
RESTful API供APP调用 |
API接口 |
技术栈
| 层级 |
技术 |
| 后端 |
Spring Boot + MyBatis-Plus + MySQL + Redis |
| 前端 |
Vue 3 + Element Plus + Vite |
| 测试 |
Playwright (E2E) |
需求模块与开发状态
1. 用户管理 (44用例) - ✅ 已完成
| 功能 |
状态 |
说明 |
| 用户列表查看 |
✅ 已开发 |
显示ID、姓名、性别、年龄、手机号、设备编号、肩宽、身长、穴位表状态 |
| 按姓名模糊搜索 |
✅ |
|
| 按手机号搜索 |
✅ |
|
| 按设备编号搜索 |
✅ |
|
| 按性别筛选 |
✅ |
|
| 按穴位表状态筛选 |
✅ |
|
| 重置查询条件 |
✅ |
|
| 新增用户 |
✅ |
姓名、性别、年龄、手机号、肩宽、身长 |
| 姓名必填验证 |
✅ |
|
| 性别必填验证 |
✅ |
|
| 手机号必填验证 |
✅ |
|
| 手机号格式验证 |
✅ |
11位 |
| 手机号唯一性验证 |
✅ |
|
| 肩宽范围验证 |
✅ |
男性36-52cm, 女性32-46cm |
| 身长范围验证 |
✅ |
男性75-95cm, 女性70-88cm |
| 年龄范围验证 |
✅ |
1-120岁 |
| 生成穴位坐标 |
✅ |
生成12个穴位(23个点) |
| 编辑用户信息 |
✅ |
|
| 编辑后重新生成坐标 |
✅ |
|
| 查看用户详情 |
✅ |
|
| 删除单个用户 |
✅ |
|
| 删除取消 |
✅ |
|
| 用户设备管理 |
✅ |
查看、添加、设为主设备、解绑 |
| 导出用户数据 |
✅ |
Excel导出 |
2. 穴位管理 (22用例) - ✅ 已完成
| 功能 |
状态 |
说明 |
| 查看穴位列表 |
✅ |
显示ID、名称、经络、功效、定位方式、状态 |
| 按穴位名称搜索 |
✅ |
|
| 按经络筛选 |
✅ |
督脉、膀胱经等 |
| 按定位方式筛选 |
✅ |
相对定位/绝对定位 |
| 按状态筛选 |
✅ |
活跃/待完善 |
| 新增穴��� |
✅ |
相对定位(中心/双侧) |
| 穴位名称必填验证 |
✅ |
|
| 艾灸手法管理 |
✅ |
5种手法：一键艾灸、温和灸、雀啄灸、回旋灸、麻雀灸 |
3. 方案管理 (34用例) - ✅ 已完成
| 功能 |
状态 |
说明 |
| 查看方案列表 |
✅ |
显示ID、名称、模式、功效、创作人、步骤数、状态 |
| 创作人显示 |
✅ |
一键艾灸/专业模式/自定义模式/延年圣手 |
| 按方案名称搜索 |
✅ |
|
| 按模式类型筛选 |
✅ |
|
| 按功效类型筛选 |
✅ |
驱寒、祛湿、清热、补气、养血、活血、安神、理气 |
| 按状态筛选 |
✅ |
草稿/已发布/已下架 |
| 查看方案详情 |
✅ |
基本信息、治疗步骤、统计信息 |
| 新增方案 |
✅ |
一键艾灸、专业模式、自定义模式、延年圣手 |
| 方案名称必填验证 |
✅ |
|
| 发布方案 |
✅ |
|
| 下架方案 |
✅ |
|
4. 设备管理 (19用例) - ✅ 已完成
| 功能 |
状态 |
说明 |
| 查看设备列表 |
✅ |
编号、名称、型号、绑定用户数、在线状态、固件版本 |
| 按设备编号搜索 |
✅ |
|
| 新增设备 |
✅ |
|
| 设备编号必填验证 |
✅ |
|
| 设备绑定用户管理 |
✅ |
查看、添加、设为主、解绑 |
5. 系统管理 (11用例) - ✅ 已完成
| 功能 |
状态 |
说明 |
| 管理员列表 |
✅ |
|
| 新增管理员 |
✅ |
|
| 密码格式验证 |
✅ |
8-20字符，含字母和数字 |
| 禁用/启用管理员 |
✅ |
|
| 操作日志 |
✅ |
|
| 日志筛选 |
✅ |
按操作人、操作类型、时间范围 |
6. 核心算法 (20用例) - ✅ 已完成
| 功能 |
状态 |
说明 |
| 男性标准体型估算 |
✅ |
肩宽42cm,身长85cm → cun1≈2.2cm |
| 女性标准体型估算 |
✅ |
肩宽36cm,身长78cm → cun1≈1.9cm |
| 男性大体型估算 |
✅ |
肩宽52cm,身长95cm → cun1≈2.54cm |
| 男性小体型估算 |
✅ |
肩宽36cm,身长75cm → cun1≈1.88cm |
| 女性大体型估算 |
✅ |
肩宽46cm,身长88cm → cun1≈2.26cm |
| 女性小体型估算 |
✅ |
肩宽32cm,身长70cm → cun1≈1.54cm |
| 有指寸不估算 |
✅ |
使用实际指寸 |
| 生成12个穴位 |
✅ |
生成23个点(含双侧) |
| 大椎穴为原点 |
✅ |
坐标(0,0) |
| 督脉只有纵向偏移 |
✅ |
X=0 |
| 双侧穴位横向偏移 |
✅ |
左X负,右X正 |
| 置信度计算 |
✅ |
仅肩宽身长50%/部分指寸65%/完整指寸95% |
测试用例汇总
E2E 测试 (159用例, 覆盖率92%)
test-e2e/
├── e2e/
│ ├── app.spec.js # 登录 + 核心模块 (32)
│ ├── user-management.spec.js # 用户管理详细 (19)
│ ├── scheme-management.spec.js # 方案管理详细 (28)
│ ├── device-system.spec.js # 设备+系统管理 (23)
│ ├── acupoint.spec.js # 穴位+艾灸手法 (16)
│ ├── algorithm.spec.js # 核心算法 (19)
│ └── api.spec.js # API+DB+验收 (22)
├── package.json
└── playwright.config.js
测试覆盖详情
| 模块 |
需求用例 |
实际用例 |
覆盖率 |
| 用户管理 |
44 |
51 |
116% |
| 穴位管理 |
22 |
23 |
105% |
| 方案管理 |
34 |
35 |
103% |
| 设备管理 |
19 |
19 |
100% |
| 系统管理 |
11 |
13 |
118% |
| 核心算法 |
20 |
19 |
95% |
| 接口+DB+验收 |
22 |
22 |
100% |
| 合计 |
172 |
159 |
92% |
运行测试
cd test-e2e
npx playwright test # 运行所有测试
npx playwright test --grep "TC-001" # 运行指定用例
项目结构
ajy/
├── code/
│ ├── backend/ # Spring Boot 后端
│ │ └── src/main/java/com/aijiuyi/admin/
│ │ ├── controller/ # API控制器
│ │ ├── service/ # 业务逻辑
│ │ ├── mapper/ # 数据访问
│ │ ├── entity/ # 实体类
│ │ └── common/ # 公共组件
│ └── frontend/ # Vue 3 前端
│ └── src/
│ ├── views/ # 页面组件
│ ├── api/ # API调用
│ └── store/ # 状态管理
├── test-e2e/ # E2E测试
├── 需求工作区/ # 需求文档
│ └── 需求设计文档/
│ └── 智能穴位定位系统测试用例.md
└── openspec/ # 技术规范
开发环境
支持的穴位(12个)
| 穴位 |
经络 |
相对大椎穴位置 |
功效 |
| 大椎穴 |
督脉 |
基准点 (0, 0) |
驱寒、祛湿、解表 |
| 身柱穴 |
督脉 |
下3寸 |
止咳平喘、安神 |
| 至阳穴 |
督脉 |
下7寸 |
宽胸理气 |
| 命门穴 |
督脉 |
下14寸 |
补肾壮阳 |
| 腰阳关穴 |
督脉 |
下17寸 |
强腰健肾 |
| 风门穴(双) |
膀胱经 |
下1.5寸，旁开1.5寸 |
祛风解表 |
| 秉风穴(双) |
小肠经 |
下3寸，旁开3寸 |
祛风散寒 |
| 肺俞穴(双) |
膀胱经 |
下3寸，旁开1.5寸 |
化痰止咳 |
| 膈俞穴(双) |
膀胱经 |
下7寸，旁开1.5寸 |
活血化瘀 |
| 脾俞穴(双) |
膀胱经 |
下11寸，旁开1.5寸 |
健脾养血 |
| 肾俞穴(双) |
膀胱经 |
下14寸，旁开1.5寸 |
补肾益气 |
| 八髎穴 |
膀胱经 |
下16寸 |
调理下焦 |
数据验证规则
| 字段 |
男性范围 |
女性范围 |
单位 |
| 肩宽 |
36-52 |
32-46 |
cm |
| 身长（坐高） |
75-95 |
70-88 |
cm |
| 一寸 |
1.5-2.8 |
1.3-2.4 |
cm |
验收标准（已通过测试）
| 标准 |
目标 |
状态 |
| 穴位定位精度 |
≤2cm |
✅ |
| 穴位库动态扩展 |
支持 |
✅ |
| 8种专业模式 |
均可创建和发布 |
✅ |
| API响应时间 |
<200ms |
✅ |
| 症状推荐覆盖率 |
≥80% |
✅ |
License
ISC
jiapu
890a89a775
Merge branch 'refs/heads/jiapu_aijiuyi'