foodie-server/specs/032-self-hosted-map-integration/tasks.md

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

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

• I009 旧 getLocationAddr/getAddr 自部署转换保留结构、10km范围及Google回滚；覆盖成功/失败不跨源与不读旧语言缓存，新增注释。
• I010 地图 nearby 最大半径支持旧入口10km，默认值、结果上限、新选址2km限制不变，补边界回归；真实大库超时已用现有GiST近邻索引修复，无DDL。
• I011 合并 test-202609v2 后执行后端定向与完整打包、地图测试，更新前端接入/现状/发布手册并纠正旧交付状态。
• 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 本地已验证，待发布）

• I001 共用开关、自部署鉴权/超时、闪送车型和时长。
• I002 外卖自部署矩阵与 Google 可回滚选择器。
• I003 普通/v2/多店距离运费快照与旧接口兼容。
• I004 双来源选址接口与前端接入文档。
• I005 门店地点同步、停用清理与索引发布步骤。
• I006 地图读令牌启动校验与发布检查。
• I007 两来源/回滚/故障业务回归、JDK21构建和地图测试（本地夹具，不含真实外部服务）。
• 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。
• 发布手册、前端接入、商家同步。无新增后端DDL；地图既有SQL仍由开发者手工执行。

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

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

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