Appearance
开发人员端
前端 · 后端 · API · 交付
开发人员以“契约一致、权限可验证、敏感数据不落盘”为原则维护安归。产品页面说明以实际实现为准，接口契约以 Apifox 为准。
前端工作React 页面、路由、角色导航、错误呈现和前端测试。
后端工作Actix API、认证、案件授权、数据库迁移与审计。
接口联调认证、字段裁剪、状态机、错误码和 OpenAPI 对齐。
权威 API 入口打开 Apifox 文档 ↗
前端
技术栈：React 19、TypeScript、Vite、React Router、HeroUI、Tailwind CSS。页面位于 frontend/src/pages，API 封装位于 frontend/src/api。
| 路由 | 对应页面 |
|---|---|
/ | 总览 |
/family | 家属端 |
/command、/command/cases/:caseId | 指挥端与案件详情 |
/volunteer | 志愿者端 |
/learning、/admin/learning | 学习中心与内容治理 |
/profile | 个人资料 |
客户端导航只是体验层：服务端必须继续校验案件成员关系和角色。401 清除会话并回登录，403、404、409 以不泄露敏感数据的方式反馈给用户。
powershell
npm install --prefix frontend
npm run dev:frontend
npm run lint:frontend
npm run build:frontend
npm --prefix frontend run test后端
技术栈：Rust 2024、Actix Web、SeaORM。源码位于 src/；认证使用 Argon2id、数据库会话和令牌哈希，案件访问由 case_memberships 约束。
powershell
$env:DATABASE_URL = "sqlite://data/angui.db?mode=rwc"
npm run migrate:up
npm run migrate:status
npm run dev:backend
npm run check:backend
npm run test:backend数据库迁移必须显式运行。演示账号初始化只允许 development、preview 或 test 环境，并需显式开启 ANGUI_ALLOW_DEMO_BOOTSTRAP=1。
联调检查清单
- 登录后调用
/api/auth/me验证会话与身份。 - 按角色、案件成员关系覆盖
401、403、404。 - 覆盖线索、任务、摘要和学习内容的状态机，客户端不能越过确认或发布操作。
- 核对分页、字段裁剪、审计脱敏和重复提交的
409行为。 - 新增字段时同步更新前端类型、Apifox、OpenAPI、错误提示和本手册。
不要使用真实数据调试。 日志、截图、测试夹具和文档中均不得出现真实密钥、个人信息或案件材料。
文档交付检查
powershell
npm run docs:dev
npm run docs:build发布前确认内部链接可访问，页面状态标记准确，产品文案与实际权限、API 返回和前端导航一致。