feat(cache): 建立字典缓存快照（T-103）

progress.md

@@ -159,3 +159,16 @@
 - 验证：`go build ./...` 通过。
 - 联调：使用本地未入库脚本中的沙箱凭据和身份证，仅在临时 Go 程序内读取；先 JKDA00002 取一条档案主数据，再调用公开查询。结果：Find `code=01 count=1`；责任医生 `code=01 count>0`；机构 `code=01 count>0`；网格 `code=01 count>0`。未输出真实身份证、机构码、医生姓名或密钥。
 - 说明：药品目录查询本次完成客户端封装和单测，T-101 验收要求未要求真实药品目录联调；后续需要用药品关键字/拼音码时再补真实样本。
+
+## 2026-07-07 T-103 字典缓存
+
+- 状态：DONE
+- 变更：新增 `cache/dictionary.go` 与 `cache/dictionary_test.go`；建立 `DictionarySnapshot` 内存快照，支持按名称反查 `regionCode`、`manaDoctorId`、`manaUnitId`；新增 `DictionaryService.Refresh`，从 T-101 公开查询结果刷新内存快照，并通过可选 `PersistentStore` 保存。
+- 变更：`mapping.PHISHealthRecord` 增加 `RegionName`、`ManaDoctorName`、`ManaUnitName`；`MapContext` 增加 `MasterDataLookup`，当 PHIS 未直接提供平台码时，映射层可通过主数据快照反查补齐必填主数据。
+- RED：`go test ./cache -count=1` 初次失败，缺少 `NewDictionarySnapshot`、`NewDictionaryService`、`RefreshParams`、`DictionarySnapshot`；`go test ./mapping -run TestMapHealthRecordUsesMasterDataLookupWhenCodesMissing -count=1` 初次失败，缺少名称字段与 `MasterData` 上下文。
+- GREEN：补最小实现后，`go test ./cache -count=1` 通过；`go test ./mapping -run TestMapHealthRecordUsesMasterDataLookupWhenCodesMissing -count=1` 通过。
+- 验证：`go test ./cache ./mapping -count=1` 通过。
+- 验证：`go test ./...` 通过。
+- 验证：`go build ./...` 通过。
+- 决策：T-103 不引入 Redis 客户端依赖，只定义可选持久化接口；持久化失败被忽略，内存快照仍刷新，满足“redis 不可用不阻断”。
+- 下一步：T-206（健康档案 Create/Update + 创建请求契约）。