# shen-gui-tu

**Repository Path**: loozoo/shen-gui-tu

## Basic Information

- **Project Name**: shen-gui-tu
- **Description**: 「申归途」是一款面向抑郁症康复期患者的移动端支持工具，聚焦**复发预防**这一关键环节。通过每日六维自评追踪、用药管理、上海本地资源导航、危机干预和认知行为疗法自助课程，帮助患者在巩固期和维持期保持稳定，降低复发风险。

本项目为 **TRAE × 脉脉「AI 无限职场」SOLO 挑战赛** 公益赛道「Hello AI 科技致善」参赛作品。
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2026-05-03
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 申归途

> 抑郁症全程复发预防服务

「申归途」是一款面向抑郁症康复期患者的移动端支持工具，聚焦**复发预防**这一关键环节。通过每日六维自评追踪、用药管理、上海本地资源导航、危机干预和认知行为疗法自助课程，帮助患者在巩固期和维持期保持稳定，降低复发风险。

本项目为 **TRAE × 脉脉「AI 无限职场」SOLO 挑战赛** 公益赛道「Hello AI 科技致善」参赛作品。

## 核心问题

抑郁症复发率高达 **50%-85%**，首次复发后再次复发概率超 **70%**，三次及以上发作后达 **90%**。50% 患者存在服药依从性问题，出院后几乎无复发预防工具覆盖，存在"断崖式"支持断裂。

## 核心功能

| 模块 | 功能 | 说明 |
|------|------|------|
| 🏠 预警仪表盘 | 综合评分 + 7天趋势 | 基于六维加权评分（睡眠/情绪/躯体/动力/认知/社交），四级风险分级 |
| 📋 每日签到 | 30秒快速自评 | 6个维度各5级评分，支持备注，数据持久化存储 |
| 💊 用药管理 | 服药打卡 + 依从率 | 药物增删、服药记录、月度依从率统计、正向反馈 |
| 📚 服务中心 | 上海本地资源 | 10家医院（区域筛选）、6条热线、4个社区中心、5项医保政策 |
| 🆘 危机干预 | 一键求助 + 呼吸练习 | 962525/400-161-9995 热线、4-7-8 呼吸放松法 |
| 📖 CBT课程 | 认知行为疗法自助 | 2门课程（5步+4步），步骤式学习，进度追踪 |
| 📝 WRAP计划 | 个人康复行动计划 | 5大模块手风琴编辑器，条目增删改，本地持久化 |

## 预警信号框架

复发通常提前1-2周甚至更早就开始出现信号：

| 排序 | 预警维度 | 典型表现 |
|------|---------|---------|
| 1 | **睡眠变化**（最早期、最敏感） | 入睡困难、凌晨早醒、白天精神不振 |
| 2 | **情绪变化** | 情感迟钝、易激惹、持续低落 |
| 3 | **躯体不适** | 不明原因头痛/头晕、胃肠不适、浑身没力气 |
| 4 | **动力下降** | 不想起床、不想吃饭、不想出门 |
| 5 | **认知功能下降** | 记性变差、注意力不集中 |
| 6 | **社交退缩** | 无意识减少社交、对关心感到厌倦 |

## 患者旅程四阶段

| 阶段 | 时间范围 | 支持强度 | 核心任务 |
|------|---------|---------|---------|
| **过渡期** | 出院后0-4周 | 高 | 建立安全网、熟悉工具、稳定状态 |
| **巩固期** | 第1-6个月 | 中高 | 技能训练、习惯养成、预警系统校准 |
| **维持期** | 第6-18个月 | 中 | 自我管理能力建设、社会功能恢复 |
| **自立期** | 第18个月以后 | 低 | 独立管理、预防性维护、助人自助 |

## 技术栈

- **React 18** — UI 框架
- **React Router v6** — HashRouter（离线文件协议兼容）
- **Vite 5** — 构建工具
- **CSS Modules** — 组件样式隔离，零外部运行时依赖
- **LocalStorage** — 无后端数据持久化

## 项目结构

```
yy/
├── .trae/
│   └── documents/                    # 项目文档
│       ├── 01-项目规划/              # 项目规划文档
│       ├── 02-测试/                  # 测试报告
│       ├── 03-功能模块方案/           # 各功能模块详细方案
│       ├── 04-品牌与视觉/             # Logo/Favicon 设计方案
│       └── 05-项目管理/              # 项目管理文档
├── docs/                          # 项目文档
│   ├── 申归途-抑郁症复发预防服务设计方案.md
│   ├── 抑郁症患者需求与APP工具现状分析报告.md
│   ├── 欢迎来到「AI 无限职场」SOLO 挑战赛.txt
│   ├── charts/                    # 8张分析图表
│   └── prototype/                 # 9个 HTML 交互原型
├── shen-gui-tu/                       # React 应用
│   ├── src/
│   │   ├── main.jsx                   # 应用入口
│   │   ├── App.jsx                    # 路由配置
│   │   ├── styles/                    # 主题变量 + 全局样式
│   │   ├── components/                # 共享组件（Layout/BottomNav/RiskGauge/CrisisButton/Toast）
│   │   ├── styles/                    # 主题变量 + 全局样式
│   │   ├── pages/                     # 8个页面组件
│   │   ├── hooks/                     # 自定义 Hooks（useLocalStorage/useCheckIn/useMedication/useRiskLevel）
│   │   ├── data/                      # 上海本地静态数据（医院/热线/社区/医保/CBT/WRAP）
│   │   └── utils/                     # 工具函数（风险计算/日期格式化）
│   ├── dist/                          # 生产构建输出
│   ├── index.html
│   ├── vite.config.js
│   ├── package.json
│   └── README.md
├── logo.png
├── logo_origin.png
├── LICENSE
└── README.md
```

## 快速开始

```bash
cd shen-gui-tu

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 生产构建
npm run build
```

## 设计文档

完整的项目文档位于 `docs/` 目录：

- **[需求分析报告](docs/抑郁症患者需求与APP工具现状分析报告.md)** — 9500万抑郁症患者的八大核心痛点与现有 APP 功能缺口分析
- **[服务设计方案](docs/申归途-抑郁症复发预防服务设计方案.md)** — 六大早期预警信号、六大核心模块、四阶段患者旅程地图
- **[UI 原型](docs/prototype/)** — 9轮确认的交互式 HTML 原型（全局设计系统 → 各页面 → 集成走查）
- **[分析图表](docs/charts/)** — 8张数据可视化图表

> 注：详细设计文档位于 `.trae/documents/` 目录下

## 设计规范

- **设计方向**：温暖治愈系
- **主色调**：#4A90D9（治愈蓝）
- **强调色**：#E8985E（温暖橙）
- **背景色**：#F8F6F2（暖白）
- **风险等级**：🟢 良好(≥65) / 🟡 关注(≥45) / 🟠 就医(≥25) / 🔴 紧急(<25)
- **移动端优先**：max-width 480px，触控区域 ≥ 44px

## 许可证

MIT