# 艾灸椅智能穴位定位系统 > 智能艾灸理疗系统 - 基于体型数据的精准穴位定位 --- ## 项目概述 艾灸椅智能穴位定位系统是艾灸椅项目的核心子系统，负责根据用户体型数据计算穴位位置，并通过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寸 | 调理下焦 | --- ## 开发环境 | 环境 | 地址 | 账号 | |------|------|------| | 生产环境 | https://ajy.danclub.cn | admin / admin123 | | 测试环境 | 本地开发 | - | --- ## License ISC --- ## 文档版本 | 版本 | 日期 | 说明 | |------|------|------| | v1.0.0 | 2026-06-02 | 初始版本：补充用户场景、角色定义、蓝图规划、阶段设计 | | v0.9.0 | - | 基础功能开发完成 |