# Map AI Advisor：Herd 本地测试记录

2026-10-13。站点：`https://petav3.test/property/research?mode=advisor`。Herd 的 petav3 link 指向 `/Users/dadadineiyou/Documents/GitHub/petav3-dev-chen-integration`，PHP 8.4.21。此次仅操作本地开发环境，没有推送或执行生产部署。

## 本次实际通过

- 修复现有本地依赖未同步问题：按当前 composer.lock 补齐 21 个包；Passport 等类可自动加载，package:discover 成功。Composer 扫描旧文件曾阻塞，最终复用相同锁文件、相同源码的已验证自动加载映射；原映射留有备份。没有修改 AuthServiceProvider 或依赖锁文件。
- 首页、登录页 HTTP 200；未登录访问 Research 返回 302 到登录页。
- 在现有 Dev quick login 的 Admin 入口登录。实际本地账号显示 John Ong / super-admin；此浏览器结果不能代替普通管理员及会员的权限回归。
- AI Advisor 左侧聊天、右侧 Mapbox 地图正常显示；由 3D 切到 2D、切换 Light 底图、关闭 Landed 类型后显示 6/7 类型，页面无捕获到的控制台错误。
- 编辑并保存明确标记为 LOCAL HERD UI TEST 的需求：Mont Kiara、预算 RM700,000、报价 RM750,000、面积 1,000 sq ft、Built-up area。刷新后四项数值/口径仍分别保留，预算没有被报价覆盖。仅保存本地工作区，没有发送研究问题或调用真实生成模型。
- **实际 Herd checkout + Herd PHP：76 个 PHP 测试 / 639 个断言通过**。使用独立 `petav3_map_rag_20261013_testing`；所有 site/reference/master 测试连接都锁定 loopback 与 _testing 名称，缓存路径隔离；HTTP/模型响应为测试替身。未对旧本地业务副本运行 migrate:fresh。
- 同源码的 **75 个前端测试 / 15 文件**、client/SSR 构建、部署启动器隔离检查通过。Herd 前端产物已更新到匹配源码；旧产物保留在 `storage/app/deploy/herd-advisor-build-before-20261013`。
- 现有站点只读 `propertylab:advisor-prepare --check` 按预期返回 `rollout_file_required`，没有导入或激活草稿。

## 本地配置及恢复

原 .env 备份保存在用户私有 `~/.codex/local-test-backups/map-advisor-herd-20261013/.env.before`，权限 0600。只新增/设置：

```dotenv
CATALOGUE_USE_DEFAULT_CONNECTION=true
PROPERTYLAB_RESEARCH_ENABLED=true
PROPERTYLAB_KNOWLEDGE_ENABLED=false
AI_ADVISOR_LOCKED=true
```

Catalogue 原来使用未配置的 forge 账号；现在只读取本机站点副本。实际站点 DB 为 `petav3_test_production_20260814`，host=127.0.0.1；没有连接共享 master。启动过 Herd，并重启 PHP 8.4；生成的 Composer manifest/cache 和前端产物属于本地运行文件，未提交。

需要撤回这些本地配置时，恢复上述私有 .env 备份，再在该 checkout 执行 `herd php artisan config:clear`。不要将 .env 或备份提交到 Git。运行依赖应继续与现有锁文件保持一致。

## 尚未通过的部分

- 本地 Research 的 snapshot、schemes、monthly observations 均为 0。没有实际项目点、价格序列或真实图表；不能把默认 KLCC 底图说成 Mont Kiara 已定位，也未证明三个项目的映射。
- 用户确认没有测试专用 AI/embedding/Qdrant 配置。本次没有真实模型问答、embedding/index 接入、真实召回评测或知识引用的浏览器验收；这些功能的自动化回归使用测试替身。
- 当前知识功能保持关闭，知识表未迁移到旧本地业务副本；批准包、三项目映射、测试服务、真实固定 QA、延迟/成本和真实回滚仍需补齐。
- macOS Herd 不执行 Ubuntu 的 sudo/systemd 生产部署。启动器隔离测试不证明生产一条命令已经成功运行。

真实 RAG/生产验收缺项和部署前条件继续以 `DEPLOYMENT.md` 为准。此次记录的是本地环境修复、浏览器基本交互与隔离回归。
