# 032 任务（历史评估 + 双地图接入）

## 2026-10-28 追加（当前实现中）

- [x] I009 旧 getLocationAddr/getAddr 自部署转换保留结构、10km范围及Google回滚；覆盖成功/失败不跨源与不读旧语言缓存，新增注释。
- [x] I010 地图 nearby 最大半径支持旧入口10km，默认值、结果上限、新选址2km限制不变，补边界回归；真实大库超时已用现有GiST近邻索引修复，无DDL。
- [x] I011 合并 test-202609v2 后执行后端定向与完整打包、地图测试，更新前端接入/现状/发布手册并纠正旧交付状态。
- [x] V004 只读核对测试服务器版本/数据/实际双车型及矩阵，记录备份、升级、回退和真实验收差距；SQL不自动执行。

合并记录：本地地图分支 `23d808d0` 合入 v2 的 `bf5f34ac`。地图 master 当前 `7160933`；Git 实际记录优先于下方历史“未提交”表述。本轮前端地图页面不改。

### 2026-10-28 验证与发布记录

- 旧控制器回归先复现SELF_HOSTED仍构造GetArea；实现后通过。完整JDK21 reactor package成功：1540项（admin1367/system171/framework2），0失败/错误/跳过；随后补超大坐标指数防护，相关7项再测及package成功。地图66项Python测试与既有Node页面测试通过。
- 测试服务器原 `/route/matrix` 404。候选API先验证，发现台湾1031万条索引下旧10km附近排序触发10秒数据库超时；使用现有GiST geography KNN修复，附近距离统一球面口径（仅候选展示，非配送费依据）。真实EXPLAIN确认索引扫描与增量排序。
- 测试地图API已升级，汽车/机车真实矩阵、重复起点、附近/反查及边界通过；数据库、双OSRM及前端容器保持原ID，未执行DDL或修改业务数据。旧镜像和源文件备份在 `/opt/foodie-map-backups/20261028-api`，详见release-runbook。
- 两轮各40请求/4并发的公开台北样本验证通过，属于冒烟压力样本，不证明全境P99或正式容量。最终样本矩阵最大约61ms、搜索57ms、10km附近1090ms。
- 只读测试业务库：51个门店中24个坐标在台湾边界，571个地址中35个在台湾边界。以最近配对覆盖这59个点，得到52组；car和motorcycle各50成功/2个NO_ROUTE。不是历史订单路线重放，不把无路当坐标必定错误，不自动修业务数据。含坐标的CSV/详细报告只在私有备份及本地target，Git文档只记录汇总。
- 用户明确后端暂不发布：不部署foodie-server、不切业务字典。前端页面/单候选越界由前端人员处理；全境法规、动态条件限制、真实交通、正式并发P99、真实Google切流回滚和2组不可达的业务确认仍未验收，不能勾完成。

## 2026-10-23 双地图接入（2026-10-26 本地已验证，待发布）

- [x] I001 共用开关、自部署鉴权/超时、闪送车型和时长。
- [x] I002 外卖自部署矩阵与 Google 可回滚选择器。
- [x] I003 普通/v2/多店距离运费快照与旧接口兼容。
- [x] I004 双来源选址接口与前端接入文档。
- [x] I005 门店地点同步、停用清理与索引发布步骤。
- [x] I006 地图读令牌启动校验与发布检查。
- [x] I007 两来源/回滚/故障业务回归、JDK21构建和地图测试（本地夹具，不含真实外部服务）。
- [x] I008 手动部署、数据更新、体检、监控与回滚文档。
- [ ] V001 开发者执行 SQL（如有）、部署及真实双路网验收。
- [ ] V002 存量真实地址体检、并发性能与实际回滚演练。
- [ ] V003 前端接入及 App/平台/商家页面联调。

V001–V003 不随本地测试勾选。不自动 commit/push；历史评估记录如下。

2026-10-26 用户已追加明确要求提交并推送本轮代码，完成后后端切回test-202609v2、地图保持master。提交状态及SHA以Git日志为准；此操作不包含合并到v2或部署。

### 2026-10-26 验证证据

- JDK `C:/Users/99029/.jdks/graalvm-jdk-21.0.12+7.1`，`mvn -q -pl ruoyi-admin -am package` 退出0，产出ruoyi-admin.jar。受影响完整reactor测试：admin 1314、system 168、framework 2，合计 **1484**，失败/错误/跳过均0。
- 地图 `.venv/Scripts/python.exe -m unittest discover -s tests -p 'test_*.py'`：**64项通过**；`node tests/test_frontend.mjs`通过；两仓库`git diff --check`通过（地图spec存在Git自动换行提示，无差异格式错误）。
- 独立只读审查3项Important已修复并补回归：父子订单type绕过、旧直线报价与道路校验不一致、旧结算页反向算路。补了v2公里快照、缺失时长、HTTP前缀/令牌/POST/错误正文不泄露检查。
- 没有执行外部地图调用、业务数据库访问/迁移、真实同步/索引发布、部署、真实并发/地址/法规/App验收。没有提交/推送，无交付提交SHA。
- [发布手册](release-runbook.md)、[前端接入](frontend-app-integration.md)、[商家同步](merchant-map-sync.md)。无新增后端DDL；地图既有SQL仍由开发者手工执行。

日期：2026-10-12。范围见 [plan.md](plan.md)，不包含生产改造、部署或全量地图切换。

- [x] E001 核对本地/远端分支、部署源文件和容器内文件指纹，以及实际路线接口；API 与两个分支并非整体一致，已记录文件基线而非猜测发布提交。
- [x] E002 对照固定提交的 Valhalla 两种机车模型和 OSRM v5.27.1，分类已有、可迁移、不能等价迁移的规则，见 model-evaluation.md。
- [x] E003 执行真实 OSRM 小路网试验：35 项常规断言通过，1 项限制探针确认条件禁行未实现；生产文件不变，隔离容器和目录已清理。
- [x] E004 给出保留 OSRM 的静态规则适用范围、待改规则和未验证限制，更新评估记录及机器证据。

当前状态：已验证（仅本轮四项评估）。详见 [model-evaluation.md](model-evaluation.md) 和 [机器证据](evaluation/model-probe-results.json)。生产实现与部署未开始，未提交或推送。