源码目录与业务模块

目录导航

路径（相对 ui/frontend）	职责
`src/pages/`、`src/pages.json`	页面与分包注册
`src/components/`	基础、布局与业务组件
`src/services/view-models/`	页面消费模型与刷新
`src/services/repositories/`	数据读取、归一与快照
`src/services/actions/`	写入装配、幂等、补偿与回读
`src/services/api/`	Duogex、BFF 等通道封装
`src/services/auth/`、`src/store/user.js`	身份、令牌与会话
`src/composables/`	页面刷新、加载和共享生命周期能力
`src/utils/routes.js`	路由语义与守卫声明
`src/styles/theme.scss`	主题与布局 token
`scripts/`、`test/scripts/`	构建、门禁与可复用测试

例如修改活动报名：先查活动详情页使用的 view-model，再进入 activity-signup-actions.js 找写入与状态校验，最后查看对应 repository 和合同测试。不要仅按页面名称新建另一套请求服务。

修改一个列表展示字段时，依次追踪页面 → view-model → mapper/repository → 数据合同；写入逻辑则从 action 追到 API facade 或 BFF。跨域业务还要检查共享状态、通知和刷新失效范围。

模块内 docs/README.md 路由当前实现、发布缺口、组件清单、客户端治理、领域模型与测试指南。历史原型只用于追溯，不覆盖当前运行实现。新能力优先复用现有组件与业务入口。