FullAccess——Myriad 换组交接

同一处设施故障可能收到多份上报。Myriad 的处理流程是先保留每份原始上报，再由区域管理员判断是否合并、安排维修，最后把完工结果送回每位相关上报者。接手这套系统时，先从一次真实的报修闭环开始，再进入各自负责的模块。

目录

一、换组安排

陈海滨在 Alpha 收尾阶段负责公共契约、集成回归和演示交付，相关记录见仓库中的 docs/alpha-backlog.md。换组时，由他向 FullAccess 留组成员说明公共模块的维护入口、当前验证范围和在办事项。Beta 的公共契约、迁移和合并由组内认领的集成负责人接续。陈材臻的首项工作聚焦环境复现和报修主流程。

二、交给接手者的版本与材料

代码基线为 CodeArts master 的 5d997ce，数据库迁移头为 0004。 Alpha 版接通了 40 项业务 HTTP 操作、2 项健康检查和 WebSocket。Alpha 最终记录为 183 项后端测试通过，另有浏览器和 iOS 模拟器证据。Android 构建成功，原生运行遇到模拟器系统界面卡死后停止验证。真机相机、现场定位和生产环境仍待验证。

第一次读代码时可沿三个对象查找记录。原始上报在 report，管理员判断和组织处理的对象是 event，工作者执行的任务在 work_order。看到一条完成回执时，沿这三个对象可以查到原始描述、处理决定和完工凭证。

三、接手者独立启动

使用 Node 24、pnpm 11.18.0、Python 3.13、uv 和 Docker。在仓库根目录执行：

uv sync --frozen
uv run python scripts/configure_dev.py
pnpm install --frozen-lockfile
docker compose -f infra/compose.dev.yaml up -d --wait db
uv run alembic upgrade head

分别在四个终端启动 API、后台进程、管理端和移动 Web。首次走查使用默认关闭模型外呼的开发配置。

uv run uvicorn myriad.main:app --host 127.0.0.1 --port 8000
uv run python -m myriad.worker
pnpm dev:admin
pnpm --filter @myriad/mobile web

移动 Web 终端先设置 $env:EXPO_PUBLIC_API_URL = 'http://127.0.0.1:8000'。API 检查地址为 http://127.0.0.1:8000/api/v1/health/ready，管理端默认端口为 5173，移动 Web 以启动日志显示的地址为准。地图选点需要按运行手册配置高德参数。首次建库可按试点配置说明导入区域并创建测试管理员。

11 月 13 日的 Windows 复测中，API 与独立 PostgreSQL/PostGIS 测试库正常运行，Edge 能登录管理端。默认启动方式下 WebSocket 连接失败，管理端实测仍通过 5 秒轮询更新。用兼容的 Python 事件循环重新启动 API 后，已验证 WebSocket 握手并收到变更通知。后续在实际交付环境分别检查两种刷新路径。

四、交接当天怎么走

五、接收确认与 Beta 首项工作

Beta 开工时，陈材臻先验证两种容易影响报修结果的情况。异常场景是写入成功后客户端丢失响应，用原请求重试，核对只生成一条上报。边界场景是两位同学上报同一处故障，管理员合并后一张工单处理完毕，两位同学各自看到原始记录和完成回执。后续在站会上按 Issue 和复验结果同步进展。