diff --git a/.claude/memory/MEMORY.md b/.claude/memory/MEMORY.md new file mode 100644 index 0000000..d644da3 --- /dev/null +++ b/.claude/memory/MEMORY.md @@ -0,0 +1,11 @@ +_Last synced: 2026-04-21 | Base commit: `c5d407a`_ + +# 记忆索引 + +| 文件 | 描述 | 类型 | 最后更新 | +|------|------|------|----------| +| project_overview.md | 项目技术栈、架构与模块结构 | project | 2026-04-21 | +| project_progress.md | 各模块原型开发进度 | project | 2026-04-21 | +| decisions.md | 关键设计决策与架构约定 | project | 2026-04-21 | +| feedback.md | 协作规范与用户纠正记录 | feedback | 2026-04-21 | +| user_profile.md | 用户角色与偏好 | user | 2026-04-21 | diff --git a/.claude/memory/decisions.md b/.claude/memory/decisions.md new file mode 100644 index 0000000..59e78d2 --- /dev/null +++ b/.claude/memory/decisions.md @@ -0,0 +1,19 @@ +# 关键决策 + +## 原型技术方案 +- **决策**:采用纯 HTML 自包含文件,不使用前端框架 +- **原因**:需兼容墨刀导入,禁止外部引用 +- **日期**:项目初始化 + +## 文件粒度 +- **决策**:每个页面/弹窗/面板为独立 HTML 文件 +- **原因**:便于墨刀逐页导入和独立预览 +- **命名**:页面 `{功能名}.html`,弹窗 `{功能名}-dialog.html`,面板 `{功能名}-panel.html` + +## 导航页数据驱动 +- **决策**:`index.html` 使用 `SITE_MAP` JS 对象维护所有模块和页面信息 +- **原因**:统一管理三端原型入口,新增页面时只需更新 SITE_MAP + +## 模块文档体系 +- **决策**:每个模块维护 `doc/CHANGELOG.md` + `doc/PRD.md` + `doc/screenshots/` +- **原因**:规范化模块文档管理,便于团队协作和评审 diff --git a/.claude/memory/feedback.md b/.claude/memory/feedback.md new file mode 100644 index 0000000..f62a855 --- /dev/null +++ b/.claude/memory/feedback.md @@ -0,0 +1,17 @@ +# 协作规范 + +## Agent 行为约束 +- 所有交互必须使用简体中文(代码除外) +- 代码注释必须使用简体中文 +- 涉及抽象设计时必须先对齐设计思路,等待用户确认 +- 实质性任务前必须列出详细任务清单,等待用户确认 +- 复杂任务必须分步执行,每步后询问是否继续 +- 修改代码前必须征得用户同意 + +## PRD 与 CHANGELOG 规则 +- PRD:禁止自动更新,仅在用户明确要求时编写 +- CHANGELOG:每次提交代码前自动整理并追加 +- 新增页面时必须同步更新 `index.html` 的 `SITE_MAP` + +## 用户纠正记录 +(暂无记录) diff --git a/.claude/memory/project_overview.md b/.claude/memory/project_overview.md new file mode 100644 index 0000000..27a4b5a --- /dev/null +++ b/.claude/memory/project_overview.md @@ -0,0 +1,32 @@ +# 项目概览 + +## 项目名称 +健康长庆升级 — 高保真交互原型 + +## 业务背景 +长庆油田公司内部员工健康管理服务平台,整合健康咨询、应急就医、健康体检、档案管理、健康监测等功能。 + +## 技术栈 +- 纯 HTML/CSS/JavaScript 原型(无框架依赖) +- 所有样式和交互内联在单个 HTML 文件中(自包含) +- Playwright 用于自动化截图 +- chrome-devtools-mcp 用于调试 +- modao-proto-mcp 用于墨刀导入 + +## 三端架构 +| 端 | 目录 | 说明 | +|----|------|------| +| Web 管理端 | `web-admin/` | 平台管理员使用,16 个模块 | +| 员工端 APP | `employee-app/` | 油田员工使用,17 个模块 | +| 健康应急 APP | `emergency-app/` | 专家/应急人员使用,6 个角色 + 共享模块 | + +## 关键文件 +- `index.html` — 全局导航页(SITE_MAP 数据驱动) +- `md-viewer.html` — Markdown 文档查看器 +- `项目背景.md` — 项目规范文档(权威) +- `共性需求说明.md` — 跨模块共性需求 + +## 视觉规范 +- APP 端:390×844(iPhone 14),品牌色 #1890FF +- Web 端:最小宽度 1280px,侧边栏 240px +- 设计令牌:见 `项目背景.md` 第五部分 diff --git a/.claude/memory/project_progress.md b/.claude/memory/project_progress.md new file mode 100644 index 0000000..edf7791 --- /dev/null +++ b/.claude/memory/project_progress.md @@ -0,0 +1,24 @@ +# 项目进度 + +## 已完成原型的模块 + +### 健康应急 APP(emergency-app) +- `assistant/` — 咨询小助手端(12 页)✅ +- `expert/` — 咨询专家端(16 页)✅ +- `message/` — 消息/即时通讯(3 页)✅ +- `ai-assistant/` — AI 助手(1 页)✅ + +### 员工端 APP(employee-app) +- `health-consult/` — 健康咨询(32 页)✅ +- `emergency-medical/` — 应急就医(24 页)✅ + +### Web 管理端(web-admin) +- `health-consult/` — 专家咨询管理(50+ 页)✅ +- `emergency-dispatch/` — 应急就医管理(50+ 页)✅ + +## 待开发模块 +Web 管理端和员工端 APP 的其余模块(系统管理、健康体检、体重管理、营养管理、运动管理、健康监测、健康评估、知识普及、健康数据、健康档案、心脑血管/糖尿病/癌症预防等)均为待开发状态。 + +## 总计 +- 已完成:200+ 个 HTML 原型页面 +- 覆盖模块:8 个(含三端) diff --git a/.claude/memory/user_profile.md b/.claude/memory/user_profile.md new file mode 100644 index 0000000..6b13e4b --- /dev/null +++ b/.claude/memory/user_profile.md @@ -0,0 +1,12 @@ +# 用户画像 + +## 角色 +产品经理 / 原型设计师 + +## 工作内容 +为「健康长庆升级」项目设计高保真交互原型,覆盖三端(Web 管理端、员工端 APP、健康应急 APP) + +## 偏好 +- 语言:简体中文 +- 工作风格:分步确认,注重规范 +- 工具链:墨刀(原型导入)、Playwright(截图)、Chrome DevTools(调试) diff --git a/CLAUDE.md b/CLAUDE.md index bb0aacc..8d9a4b5 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,3 +1,5 @@ + + # 项目约束 本项目所有工作必须严格遵守 `项目背景.md` 中定义的全部规范,包括: @@ -28,3 +30,36 @@ - 新增原型页面时,必须同步在 `index.html` 的 `SITE_MAP` 中添加对应条目 - PRD 文档生成后需要在导航页对应的一级菜单卡片左下角加上 PRD 文档的跳转逻辑 + +## 记忆体系(会话启动必读) + +> **强制规则**:每次新会话启动时,必须先读取本项目的记忆体系索引,再按需加载关键记忆文件,然后才能开始处理用户请求。长会话中若上下文被压缩,同样需要重新加载。 + +### 读取流程 + +1. **读取索引**:`cat .claude/memory/MEMORY.md` — 获取记忆文件清单与最近更新状态 +2. **必读文件**(每次会话必须加载): + - `decisions.md` — 关键决策与架构约定,避免重复讨论已决事项 + - `feedback.md` — 协作规范与用户纠正,避免重犯已纠正的错误 + - `project_progress.md` — 当前阶段进度与待办,避免重复已完成工作 +3. **按需加载**(与当前任务相关时加载): + - `project_overview.md` — 技术栈与架构(涉及架构讨论时) + - `user_profile.md` — 用户角色与偏好(需要个性化回复时) + +### 记忆体系的更新与同步 + +1. **记忆体系文件更新**:当收到git指令并完成本地代码提交之后要自动调用/memory-sync插件完成记忆文件的更新 + +### 记忆目录 + +``` +.claude/memory/ +├── MEMORY.md # 索引(入口) +├── decisions.md # 关键决策 +├── feedback.md # 协作规范 +├── project_progress.md # 阶段进度 +├── project_overview.md # 技术栈与架构 +└── user_profile.md # 用户画像 +``` + +> 记忆文件是跨会话持久化的知识,优先级高于 Agent 的默认推断。若记忆内容与当前代码状态冲突,以代码为准并更新记忆。 diff --git a/web-admin/emergency-dispatch/.gitkeep b/web-admin/emergency-dispatch/.gitkeep deleted file mode 100644 index e69de29..0000000