FullAccess——Alpha 冲刺日志（Day 1）

一、今日目标与执行方式

本日从第三小次 V0.2 设计进入真实工程开发，目标是让数据库、后端和客户端能够共同运行，建立后续上报与派工业务的基础。首日范围包括：冲刺任务拆分和规范、隔离 PostgreSQL/PostGIS 环境、数据库迁移与开发账号、FastAPI 健康检查和真实登录、按角色隔离的只读接口、React 管理端、React Native / Expo 移动端及基础验证。

本轮实现和材料整理由用户委托 Codex 辅助执行。任务表中的八位成员是计划责任人，表中的归属不表示八人分别独立完成了生成工作，也不代替成员本人确认实际参与和投入。后续团队审阅、修改与验收应继续登记。

这一天的验收重点是真实基础连接与权限边界。新建上报、上传附件、派工、补充、完工和产品内模型调用属于后续任务；界面中没有完成的操作不能算作已经实现。

二、任务与环境验收

1. 首日任务对应关系

本轮建立 40 项本地 Sprint Backlog，初始估算合计 160 人时。首日包含 8 项，合计 28 估算人时。FA-xxx 是本地任务号，尚不能替代华为云的真实 Issue URL。

首日任务清单

七天冲刺计划

状态、权限与 AI 接入约束

2. 角色与隔离

无效或缺少身份返回 401；禁止使用该类资源返回 403；具体对象不可见可用 404 避免泄漏。状态与版本冲突使用 409；参数不合法使用 422；依赖不可用应清晰返回服务不可用结果。具体错误体以实现契约为准。

3. 状态枚举与关键规则

• event.current_work_order_id 与有效工单双向一致；非 open 事件不能有有效工单。
• 工作者“无法处理”：工单转为 unable，事件仍 open，当前工单保持；管理员可回复继续或改派。不得自动等同于取消工单。
• 管理员标信息不足：事件转 blocked_info，取消当前有效工单并保留原因，清空当前引用；保留或建立真实可回复的补充请求。
• 适用补充到达后，blocked_info 可恢复 open 并触发新分析；不自动派工，不复活旧工单。completed / no_need 不被旧补充恢复。
• merged 是合并旧壳；回执和回复要解析报告当前归属，不能沿旧事件直接更新。
• 合并保留进度靠前的有效工单；pending 与 unable 同档，同档按事件时间、ID 稳定排序。人工 not_same 保留并通过来源集合传播。
• 回执文案由事件、有效工单和请求计算；“待补充”“处理中”“分析中”不能作为新的事件枚举写入。

4. 地理空间与 AI 契约

地理位置沿用 area_id、place_id、location。V0.2 的位置为 geography(Point,4326)，地理距离按米计算；50 米条件直接传 50，不可混用经纬度角度换算。候选筛选还须处理同区域、同场所、事件状态、排除自身、永久人工否定、稳定排序及候选上限；单纯距离筛选不能代表完整候选逻辑。

AI 仅产生建议。调用在业务事务外，输入去身份化；输出经结构校验、候选归属检查、版本和配置有效性检查后保存。超时、解析失败、旧版本和失效租约结果不能发布为可采纳建议，人工流程仍应可继续。Day 1 只建立契约与待验证项，不宣称模型已经真实调用成功。

2. 环境与执行结果

以下结果来自本轮实际执行。后端使用真实隔离数据库，客户端使用本机 Chrome 验证。

后端测试原始日志

.....................................                                    [100%]
============================== warnings summary ===============================
.venv\Lib\site-packages\fastapi\testclient.py:1
  E:\软件工程作业\第三次项目作业\myriad-提交工作区\.venv\Lib\site-packages\fastapi\testclient.py:1: StarletteDeprecationWarning: Using `httpx` with `starlette.testclient` is deprecated; install `httpx2` instead.
    from starlette.testclient import TestClient as TestClient  # noqa

-- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
37 passed, 1 warning in 16.15s

版本与执行记录

• 工程分支：sprint/day1-20261023。
• 已验收工程提交：deff100cf504abbc577f03a6e94486fd744ba517。
• 提交标题：feat(day1): 建立真实数据库与三角色只读工程。
• 提交作者/执行者：Codex，AI 代理受用户委托；不代表成员分别独立提交。
• 本地任务映射：FA-001—FA-008，详见任务 JSON 中的逐项证据。
• 远端推送：未执行成功。自动审批拒绝向现有华为云地址传送项目源码，理由是缺少用户对该外部目的地的明确授权；未换用其他方式绕过。代码保留在本地分支。
• 现有配置地址：项目华为云仓库。此处记录配置，不代表本轮代码已在远端可访问。
• 合并、CSDN 发表、远端 Issue 创建与课程提交：尚未执行。

后端实测为 37 项通过，客户端三项构建检查通过，浏览器 10 项检查通过。材料与截图在后续文档提交中保存；不要以本地任务编号冒充远端 Issue 编号。

查看本地提交：

git show --stat deff100
git log --oneline sprint/day1-20261023

三、真实工程成果说明

1. 数据库：把设计变成可执行迁移

迁移文件保留第三小次 V0.2 SQL 的原始内容，迁移器负责外层事务、互斥锁与版本登记。再次运行时核对已执行版本和校验和；已应用文件被改动时拒绝继续，后续结构变更应新增迁移。这能避免把多次执行脚本误当成多次完成数据库建设。

隔离开发配置采用明确标注的演示区域和模拟坐标，不伪装成学校真实地理围栏。seed 不创建上报、事件、工单、消息或模型结果。首日页面出现“暂无上报 / 暂无工单 / 暂无事件”，应与真实数据库的空业务表一致；不能为了截图充实就写入假报修，再称为真实用户使用结果。

权限测试需要的事件和工单由测试夹具临时建立，并在事务结束后回滚。用于证明区域和本人隔离的测试数据，与长期保留的开发配置分开说明。

2. 后端：区分服务活性和真正就绪

接口统一使用 /api/v1 前缀。

密码按随机盐哈希保存，登录响应仅包含 token 和公开身份字段；JWT 验证签名、发行方、受众和有效期，并重新查询当前账号状态。角色与区域由后端数据决定，不信任客户端声称的角色。

首日接口连接使用同步 psycopg，没有把尚未使用的 SQLAlchemy + asyncpg 写成实际技术实现。产品内 AI 模型调用也没有因使用 Codex 辅助开发就自动完成。

3. 管理端与移动端

管理端保留登录、事件与人员两类只读页面，接入真实 API，区分加载中、空数据、请求失败和身份过期。没有业务事件时保持空列表；人员页面用于核对区域开发配置和工种。

移动端采用一个 React Native / Expo 工程，登录后根据账号角色进入上报者或工作者界面。首日上报者可查看本人上报列表，工作者可查看本人工单列表。页面通过 Expo Web 验证时，应准确写“浏览器运行与 API 联调”，不能写成 Android、iOS 真机安装、系统相机权限或地图 SDK 都已通过。

四、运行截图与验证证据

以下 6 张页面图来自本次工程实际运行，另附燃尽图和验证汇总，共 8 张。浏览器共完成 10 项检查，页面脚本异常为 0；具体检查记录及采集时间原始值如下。发表到 CSDN 时需上传图片并替换地址。

浏览器检查记录（原始字段）

recorded_at：2026-10-23T11:01:56.530Z。表中“—”表示该条记录没有相应字段。

browser_errors：[]。

limitations 原始记录：

• 移动端截图来自Expo Web；未进行Android/iOS原生真机验证
• 首日未实现上报、派工和完工写入流程

图 1：登录界面

说明：记录当前工程登录界面和真实请求入口。登录成功与错误密码处理的结果，还需要对应 API 或浏览器检查记录支持。

图 2：管理端事件列表

说明：首日 seed 没有创建业务事件，空列表是实际接口结果。区域隔离通过临时测试夹具验证，不凭空列表截图单独证明。

图 3：区域人员配置

说明：显示隔离演示区域中的开发师傅账号及工种，核对真实配置查询；不代表已经实现人员新增或改派操作。

图 4：上报者移动端

说明：React Native / Expo 的浏览器验证环境，读取当前上报者数据。上报写入、照片上传和地图交互仍按后续任务验收。

图 5：工作者移动端

说明：同一移动工程根据身份显示工作者任务界面，读取本人工单；首日业务为空，不代表已完成开始处理或完工上传。

图 6：FastAPI 接口文档

说明：展示当前服务的 8 个实际 API。另行读取的 health 与 ready 均返回 HTTP 200，后者确认数据库、PostGIS 和迁移已就绪，结果见验证报告。

图 7：验证结果汇总

说明：此页由实际验证 JSON 生成，是结果汇总，不伪装成终端或 IDE 截图；测试数量、版本和限制以原始记录为准。

燃尽图见第六节；真实站会照片见第七节。

五、遇到的实际问题及处理

本日得到的工程经验是：先验证真实运行环境，再依次确认数据库迁移、身份认证和客户端读取。界面能够打开、接口能够返回和权限隔离通过属于不同检查，需要各自留下证据。这是本轮 AI 辅助实施的过程总结，不代写成员个人心得。

六、燃尽图与剩余工作量

下表列出本地任务数据中用于燃尽统计的原始字段，以及燃尽历史记录。图表由 Matplotlib 生成；不是华为云看板导出的截图。

本地任务数据：用于燃尽统计的原始字段

initial_estimate_hours：160；estimate_unit：planned_person_hours_not_actual_timesheet。

燃尽历史原始记录

unit：remaining_estimated_person_hours。

baseline_note：2026-10-23启动前建立，未倒填2026-10-22事件。实际值须来自当日任务验收，未来为空。

null 为原始空值，表示尚未记录。

• 初始任务估算：160 人时。
• 首日计划范围：FA-001—FA-008，合计 28 估算人时。
• Day 1 实际剩余：132 估算人时。
• 首日八项技术任务均已通过验收，其他任务估算不变，剩余为 160−28＝132 人时。40 项中完成 8 项、待办 32 项；站会和本人反馈仍需补齐。

这些数值表示估算工作量，不表示八位成员实际投入了 28 小时，也不按 AI 执行时长换算人时。未来日期的实际点留空，真实投入另由成员填写。

七、当天站会记录

本节由团队按实际会议补充，不依据本地代码生成时间推断会议已经发生。

真实站会照片

八、成员进展、困难与明日安排

下表中的“本日工程进展”登记本轮共同成果及计划归属，实施方式为 AI 受委托辅助。各人真实参与程度、实际投入和个人心得尚需本人补充确认，不能据表直接计算个人贡献比例。

开发工作应附真实代码提交及任务链接；文档、测试工作附实际文件与记录。尚未创建远端 Issue 时明确保留本地任务号，不用 [提交记录] 这类无地址文本冒充可访问链接。

九、AI 技术员协作记录

本轮审阅还核对了迁移 SQL 与原设计是否一致、登录响应是否过滤密码、错误响应是否回显密码、查询是否在服务端限制范围。以上静态审查不能替代最终运行测试，成员对变更的人工复核也应另行登记。

十、下一步与提交状态

Day 2 优先实现真实上报写入、地点和附件检查、本人回执与管理端详情，继续开展权限及重试测试；模型和地图做最小真实验证。Day 4 的目标仍为人工完整主流程，11 月 5 日主要功能冻结、11 月 9 日项目基本完成的整体节点保持不变。

技术结果与图片已整理。本日发表前仍需补齐实际站会照片与会议记录、成员本人反馈/投入，并补远端任务及提交入口。材料生成、代码提交、远端推送、CSDN 发表和课程正式提交分别记录；本地准备稿不等于已交作业。