艾灸椅智能穴位定位系统
智能艾灸理疗系统 - 基于体型数据的精准穴位定位
项目概述
艾灸椅智能穴位定位系统是艾灸椅项目的核心子系统，负责根据用户体型数据计算穴位位置，并通过APP推送给艾灸椅设备，实现精准穴位定位和艾灸理疗。
核心价值
- 精准定位：基于用户体型数据（肩宽、身长、指寸）计算穴位坐标，精度达≤2cm
- 智能算法：融合中医经络理论与现代测量技术，自动适应不同体型
- 三方协同：硬件（艾灸椅）+ 软件（APP）+ 算法服务（后台）完整闭环
用户场景
场景一：家庭用户首次使用
用户购买艾灸椅到家
↓
下载并安装APP，通过手机号+验证码登录
↓
添加家庭成员信息（姓名、性别、年龄、肩宽、身长）
↓
系统自动生成用户专属穴位对照表（12个穴位，23个定位点）
↓
绑定艾灸椅设备，开始使用
场景二：日常艾灸理疗
用户打开APP，连接已绑定的艾灸椅
↓
选择艾灸模式：
├── 一键艾灸（默认，系统预置）
├── 专业模式（驱寒/祛湿/清热等8种功效）
├── 自定义模式（自选穴位组合）
└── 延年圣手模式（专家方案，快捷键1-8）
↓
APP推送艾灸工艺（含穴位坐标）至艾灸椅
↓
艾灸椅自动定位，开始理疗
↓
理疗结束后查看历史记录
场景三：管理员运营
系统管理员登录后台管理系统
↓
日常运营：
├── 用户管理：查看用户列表、设备绑定、穴位表状态
├── 穴位管理：维护基础穴位库、艾灸手法
├── 方案管理：审核专家方案、管理发布状态
├── 设备管理：监控设备在线状态、固件版本
├── 内容管理：发布健康科普文章
└── 日志审计：追踪操作记录
场景四：专家方案创作
专家登录独立小程序/公众号（预留接口）
↓
创建艾灸理疗方案：
├── 选择功效类型（驱寒/祛湿/活血等）
├── 选择穴位组合（大椎穴、风门穴、肺俞穴等）
├── 设置治疗步骤（温度、时间、顺序）
├── 指定适用人群（性别、年龄范围）
↓
系统解析生成工艺语言
↓
发布方案至平台（待审核）
↓
审核通过后，用户可在延年圣手模式中选用
角色定义
三大核心角色
| 角色 |
描述 |
入口 |
主要功能 |
| 家庭用户 |
购买艾灸椅的个人或家庭成员 |
APP (iOS/Android/HarmonyOS) |
设备绑定、方案选择、穴位表管理、历史记录 |
| 系统管理员 |
平台运营人员，维护系统正常运转 |
后台管理系统 (Web) |
用户管理、设备管理、内容审核、运营监控 |
| 专家 |
中医领域专家，创作专业方案 |
小程序/公众号 (独立项目，待开发) |
方案创作、效果追踪、用户反馈 |
家庭用户子角色
| 子角色 |
说明 |
权限范围 |
| 户主 |
设备购买者，主账号 |
管理所有家庭成员、方案管理 |
| 家庭成员 |
共享设备的家庭用户 |
管理自己的档案和穴位表 |
管理员权限分级
| 角色 |
权限说明 |
| 超级管理员 |
系统全部权限，可管理其他管理员 |
| 普通管理员 |
用户/设备/内容管理，无权限管理 |
蓝图规划
整体愿景
┌─────────────────────────────────────────────────────────────┐
│ 艾灸椅智能定位生态系统 │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ 硬件 │────▶│ APP │────▶│ 后台 │ │
│ │ 艾灸椅 │◀────│ 控制 │◀────│ 算法 │ │
│ └─────────┘ └─────────┘ └─────────┘ │
│ │ │ │ │
│ └───────────────┴───────────────┘ │
│ │ │
│ ┌────▼────┐ │
│ │ 云端 │ │
│ │ 数据中枢│ │
│ └─────────┘ │
│ │ │
│ ┌──────────────┼──────────────┐ │
│ ▼ ▼ ▼ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 内容运营 │ │ 方案市场 │ │ 专家服务 │ │
│ └──────────┘ └──────────┘ └──────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
发展阶段
阶段一（已完成） 阶段二（规划中） 阶段三（远期）
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 核心功能闭环 │ ──▶ │ 生态化运营 │ ──▶ │ 智能化演进 │
│ │ │ │ │ │
│ • 基础定位 │ │ • 专家入驻 │ │ • AI推荐方案 │
│ • 方案管理 │ │ • 方案市场 │ │ • 体质辨识 │
│ • 设备控制 │ │ • 社区互动 │ │ • 远程问诊 │
│ • 内容管理 │ │ • 运营数据 │ │ • 养生指导 │
└──────────────┘ └──────────────┘ └──────────────┘
模块化扩展
| 模块 |
当前状态 |
扩展方向 |
| 用户档案 |
基础信息+体型数据 |
健康档案、体检报告、历史艾灸记录 |
| 穴位算法 |
12个穴位，23个定位点 |
更多穴位、更精细定位、自适应学习 |
| 方案管理 |
4种模式，预置+自定义 |
专家方案、热门推荐、用户分享 |
| 设备管理 |
单一设备绑定 |
多设备管理、设备共享、租赁模式 |
| 内容运营 |
文章发布 |
视频课程、直播讲解、用户笔记 |
| 通知推送 |
基础通知 |
养生提醒、复诊提醒、活动推送 |
阶段设计
阶段一：核心功能交付（已完成 ✅）
目标：建立核心闭环，实现"用户测量 → 算法定位 → 设备执行"完整流程。
交付内容
| 模块 |
功能 |
状态 |
| 后台管理系统 |
用户/设备/穴位/方案管理 |
✅ |
| 穴位定位算法 |
基于肩宽身长指寸计算穴位坐标 |
✅ |
| 艾灸工艺生成 |
方案 → 设备可执行指令 |
✅ |
| APP基础功能 |
登录、首页、方案选择、艾灸执行 |
✅ |
| E2E测试 |
159用例，覆盖率92% |
✅ |
核心流程
用户体型数据（肩宽、身长、指寸）
↓
穴位算法3.0
↓
生成穴位对照表（12穴位，23定位点）
↓
推送至艾灸椅设备
↓
设备定位大椎穴 → 计算偏移 → 执行艾灸
技术指标
| 指标 |
目标 |
实际 |
| 穴位定位精度 |
≤2cm |
✅ 达成 |
| 算法置信度 |
完整数据≥95% |
✅ 达成 |
| API响应时间 |
<200ms |
✅ 达成 |
| 方案同步速度 |
<3秒 |
✅ 达成 |
阶段二：生态化运营（规划中 🔄）
目标：从单一功能产品升级为健康服务平台。
规划内容
| 模块 |
功能描述 |
优先级 |
| 专家入驻 |
专家端小程序，支持方案创作与发布 |
P1 |
| 方案市场 |
专家方案展示、推荐、评价 |
P1 |
| 用户社区 |
艾灸心得分享、效果反馈 |
P2 |
| 运营后台 |
数据看板、用户画像、转化分析 |
P2 |
| 消息中心 |
系统通知、活动推送、专家回复 |
P2 |
专家端接口（预留）
| 接口 |
方法 |
说明 |
/api/expert/schemes/receive |
POST |
接收专家方案 |
/api/expert/schemes/{id} |
PUT |
更新方案 |
/api/expert/schemes |
GET |
方案列表 |
/api/expert/templates |
GET |
系统模板 |
/api/expert/acupoints |
GET |
穴位库 |
/api/expert/techniques |
GET |
手法库 |
阶段三：智能化演进（远期规划 📋）
目标：引入AI能力，提供个性化健康服务。
探索方向
| 方向 |
描述 |
技术依赖 |
| AI体质辨识 |
基于问卷+历史数据，辨识体质类型 |
机器学习 |
| 智能推荐 |
根据症状推荐方案，匹配度评分 |
推荐算法 |
| 远程问诊 |
专家线上问诊，开具方案 |
视频通话 |
| 养生指导 |
节气养生、个性化建议推送 |
知识图谱 |
技术架构
技术栈
| 层级 |
技术 |
说明 |
| 后端 |
Spring Boot + MyBatis-Plus + MySQL + Redis |
业务API服务 |
| 前端（管理后台） |
Vue 3 + Element Plus + Vite |
后台管理系统 |
| 前端（APP） |
UniApp (Vue3) |
iOS/Android/HarmonyOS跨平台 |
| 算法 |
Java SPI接口 |
穴位坐标计算插件化 |
| 测试 |
Playwright (E2E) |
159用例，覆盖率92% |
| 存储 |
MySQL + OSS（可选） |
结构化数据+文件存储 |
系统架构图
┌─────────────────────────────────────────────────────────────┐
│ 客户端层 │
├─────────────────┬─────────────────┬─────────────────────────┤
│ Web管理后台 │ UniApp (APP) │ 微信小程序(专家端) │
│ Vue 3 │ iOS/Android │ (预留，待开发) │
│ Element Plus │ HarmonyOS │ │
└────────┬────────┴────────┬────────┴──────────┬─────────────┘
│ │ │
└─────────────────┼────────────────────┘
│ HTTPS RESTful
▼
┌─────────────────────────────────────────────────────────────┐
│ 服务层 │
├─────────────────────────────────────────────────────────────┤
│ 用户服务 │ 方案服务 │ 设备服务 │ 内容服务 │ 算法服务 │
│ ──────── │ ──────── │ ──────── │ ──────── │ ──────── │
│ 用户档案 │ 方案管理 │ 设备绑定 │ 文章管理 │ 穴位计算 │
│ 设备关联 │ 方案发布 │ 在线状态 │ 审核流程 │ 工艺生成 │
│ 穴位表 │ 方案同步 │ 固件管理 │ 发布管理 │ 置信度 │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ 数据层 │
├─────────────────────────────────────────────────────────────┤
│ MySQL │ Redis │ OSS │
│ ─────────── │ ─────────── │ ─────────── │
│ 用户/方案/设备 │ 会话/缓存/限流 │ 封面/内容图片 │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ 艾灸椅设备层 │
│ ┌─────────────┐ 蓝牙BLE ┌─────────────┐ │
│ │ 灸疗椅 │◀──────────────▶│ APP │ │
│ │ (主控板) │ 推送工艺数据 │ (UniApp) │ │
│ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────┘
数据流
核心数据流
┌──────────────────────────────────────────────────────────────────┐
│ 体型数据输入 │
├──────────────────────────────────────────────────────────────────┤
│ │
│ 肩宽: 42cm (男性) │
│ 身长: 85cm │
│ 一寸: 2.2cm (系统估算) 或 用户实测 │
│ │
└──────────────────────────┬───────────────────────────────────────┘
│
▼ 融合计算 (算法3.0)
┌──────────────────────────────────────────────────────────────────┐
│ 穴位对照表生成 │
├──────────────────────────────────────────────────────────────────┤
│ │
│ 大椎穴 (0, 0) ← 基准点 │
│ 身柱穴 (0, -3) ← 纵向偏移 │
│ 至阳穴 (0, -7) │
│ 风门穴-左 (-1.5, -1.5) ← 双侧穴位 │
│ 风门穴-右 (+1.5, -1.5) │
│ ... │
│ 八髎穴 (0, -16) ← 身高缩放 │
│ │
│ 置信度: 95% (完整指寸数据) │
│ │
└──────────────────────────┬───────────────────────────────────────┘
│
▼ 推送至设备
┌──────────────────────────────────────────────────────────────────┐
│ 艾灸椅执行 │
├──────────────────────────────────────────────────────────────────┤
│ │
│ 1. 传感器检测大椎穴位置 │
│ 2. 计算: 穴位坐标 = 大椎穴位置 + 相对偏移 │
│ 3. 控制灸头移动至目标位置 │
│ 4. 执行艾灸（温度+时间+手法） │
│ │
└──────────────────────────────────────────────────────────────────┘
已支持功能
1. 用户管理 (44用例) ✅
用户档案管理、体型数据采集、穴位表生成、设备绑定
2. 穴位管理 (22用例) ✅
穴位库维护、艾灸手法配置（5种）、定位参数设置
3. 方案管理 (34用例) ✅
| 模式 |
说明 |
| 一键艾灸 |
系统预置，默认执行 |
| 专业模式 |
8种功效（驱寒/祛湿/清热/补气/养血/活血/安神/理气） |
| 自定义模式 |
用户自选穴位组合 |
| 延年圣手 |
专家方案同步至设备，快捷键1-8 |
4. 设备管理 (19用例) ✅
设备注册、用户绑定、主设备设置、在线状态监控
5. 系统管理 (11用例) ✅
管理员CRUD、角色权限、操作日志
6. 核心算法 (20用例) ✅
| 算法 |
说明 |
| 指寸估算 |
A路(肩宽权重) + B路(身长权重) 融合 |
| 背部一寸 |
双源融合计算标准背部一寸宽度 |
| 穴位坐标 |
Y轴(纵向) + X轴(横向) + 身高缩放 |
| 置信度 |
仅肩宽身长50% / 部分指寸65% / 完整指寸95% |
7. 内容管理 ✅
文章发布、审核流程、水印处理
项目结构
ajy/
├── code/
│ ├── backend/ # Spring Boot 后端
│ │ └── src/main/java/com/aijiuyi/admin/
│ │ ├── controller/ # REST API 控制器
│ │ ├── service/ # 业务逻辑层
│ │ ├── mapper/ # 数据访问层
│ │ ├── entity/ # 实体类定义
│ │ └── common/ # 公共组件
│ ├── frontend/ # Vue 3 管理后台
│ │ └── src/
│ │ ├── views/ # 页面组件
│ │ ├── api/ # API 调用封装
│ │ └── router/ # 路由配置
│ └── ajyApp/ # UniApp (APP端)
│ └── pages/ # APP 页面
├── test-e2e/ # Playwright E2E 测试
├── 需求工作区/ # 需求文档
│ ├── 需求材料/ # 原始需求（Excel/Word）
│ └── 需求设计文档/ # 设计文档（Markdown）
└── openspec/ # 技术规范与参考
测试覆盖
| 模块 |
需求用例 |
实际用例 |
覆盖率 |
| 用户管理 |
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% |
支持的穴位
| 穴位 |
经络 |
位置 |
功效 |
| 大椎穴 |
督脉 |
基准点 (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寸 |
调理下焦 |
开发环境
License
ISC
文档版本
| 版本 |
日期 |
说明 |
| v1.0.0 |
2026-06-02 |
初始版本：补充用户场景、角色定义、蓝图规划、阶段设计 |
| v0.9.0 |
- |
基础功能开发完成 |
liaoxg
cee81e7418
docs: 更新需求测试代码匹配度分析报告 v1.7.0 - 内容管理/日志/性能测试38条
