xh-medical-sign-web/AGENTS.md

医签通项目开发规范

本文件适用于 medical-sign 仓库及其子目录。子目录中的 AGENTS.md 可以补充更具体的应用规范。

项目结构

• clinical-web：医护端、电子病历嵌入端和管理端，电脑端优先。
• patient-h5：患者或家属使用的手机签署 H5，不是移动版电子病历。
• packages：两个应用稳定共用的接口客户端、类型和基础逻辑；不单独部署。
• 两个应用分别维护自己的 package.json、node_modules 和构建产物。

通用原则

• 以“患者 + 就诊 + 医嘱/项目 + 签署任务 + 文书版本 + 签署证据”为核心业务关系。
• 解释医生、实际签署人和协助操作人员必须分别建模和记录。
• 已签署的正式文书不可直接修改；追加内容应创建新的签署任务。
• 前端不替代后端完成权限、身份和签署有效性校验。
• 不在代码、日志或提交中写入 Token、密码、身份证号、完整病历等敏感信息。
• 不把 dist、node_modules、本地 .env 和临时文件提交到仓库。
• 未经明确要求，不执行 git commit、git push 或覆盖他人已有修改。

共享代码

• 只有在两个应用确实复用且接口已经稳定时，才将代码放入 packages。
• 应用内只通过明确的公共导出使用共享包，不直接依赖共享包的内部文件。
• 与单个应用强相关的页面、组件、Store 和接口，保留在对应应用中。

开发与验证

在对应应用目录执行其自己的脚本：

npm run dev
npm run lint
npm run format:check
npm run build

修改接口、状态或跨页面组件时，应同时更新相应的 TypeScript 类型和 README/开发说明。