doublex001
|
65f138bae2
|
refactor: 收敛 14 处重复声明的映射表与业务规则
接 4.14 / 4.15 的同一类缺陷排查。那两批治的是「同一个事实两处取值不同」，
本批治它的另一半：**取值当时相同，但同一张映射表 / 同一段业务规则被抄了多份**。
后者平时看不出来，代价有两个：改一处漏一处；以及测试锁的是**没人渲染的那份**。
本批不改任何取值，属纯重构 —— 已逐条核对 git diff 的删除行，无一色值被改。
修法：14 处本地声明 → 6 张单一来源的表
- 评级 → 文字色 **5 份 → 1**：growth / jobs / ability / assessment 四处同名同值
（三处叫 LEVEL_TEXT_COLOR、一处叫 LEVEL_COLOR），hr-evaluation 另有一份中文键版。
- 霍兰德六型 → 强调色 3 份 → 1（介绍 / 答题 / 结果三页各一份 TYPE_COLORS）。
- 语义色名 → 色值 3 份 → 1（企业看板 / 面试评分 / AI 面试各一份 COLOR_TOKENS）。
- 文章缩略图 2 种写法 → 1：成长页是 {violet:{bg,color}} 对象表，详情页则拆成
THUMBNAIL_BG + THUMBNAIL_COLOR 两份平行 Record。
- 社保基数 clamp **3 份 → 1**：权威那份在接口层 computeSalaryResult 里，另两份在
计算器页（一个同名 helper + handleSelectCity 内联）。提取时把 city 提成**显式参数** ——
页面内联那份的成因正是 helper 读的是 inputs.city（旧城市），而切城市要用新城市的上限，
所以「简化成调用 helper」会静默算错城市。
- 时间戳 → 「月-日 时:分」2 份 → 1：utils.formatDateTime 收 ISO 串、页面 formatRecordTime
收时间戳，格式逐字节相同。formatDateTime 改为接受 string | number。
副作用（正向的）：时间戳版本原先不判 NaN，坏值会渲染出「NaN-NaN NaN:NaN」，现返回空串。
- 手机号脱敏 2 份 → 1：登录页内联的那段与 api.maskPhone 逐字节相同，而
carrier-login.test.ts 里那条 describe 的名字就是「脱敏在接口层，页面不自己切字符串」，
《运营商一键登录接入方案.md》也写明「页面不做脱敏」—— 页面违反了它自己的约定。
- 企业端发布页自持的学历 / 工作类型选项表接回 src/constants（工作类型的编码与标签
成对定义，标签列表由它派生，避免「有编码没标签」的悬空项）。
放置位置按职责定，不是就近塞：颜色映射进 theme（该文件自己写着「色值是本文件独占的职责」，
且已有 templateAccentColors 先例）；clamp 进 api 层（AGENTS.md 规定业务规则在接口层，
权威那份本来就在那里）；时间格式化进 utils；选项词表进 constants。
一处是**派生**而不是搬家
hr-evaluation 的键是中文评级（'优秀'），不是 JobLevel —— 根因是数据层
EvaluationDimension.level 声明为 string 且直接下发中文评级。这是「同一事实、两个键域」，
把字面量搬个地方等于把「两份同值」换成「两份同值、只是搬了家」。故 levelLabelTextColors
按引用派生自 jobLevelTextColors，将来换色只改一处。断言锁的是关系（同键同值），不是字面量。
刻意**不**合并的两处
- 经验要求：constants 的 EXPERIENCE_OPTIONS 是**筛选**项（含「不限」、不含「1年以内」），
发布页那份是**必填要求**（含「1年以内」、无「不限」），不是同一个事实。已加反向锁
把差异写死，防止后来者按名字想当然地合并。
- DIMENSION_LEVEL（profile.tsx）不在收敛范围：键的是 DimensionScore['level']（只有两档），
且「良好」用 textSecondary 而非另外五处的 primary。两处对同一档取色确实不同，
属需要产品定夺的配色分歧，**未擅自统一**，已记入《项目开发状态.md》4.16。
测试
- 新增 shared-color-maps.test.ts（26 例）。断言分两类：**关系**（中文评级表与
jobLevelTextColors 同键同值、各表内部色值互不相同、计算器养老金额可由 clampSocialBase
反推、formatDateTime 两种入参格式一致）与**接线锁**（读源码断言 14 处旧声明名不再出现、
页面必须引用新表名）—— 值对了但页面不读表，缺陷照旧。
- 灵敏度验证：一次性注入 6 个缺陷（重建旧声明 + input.city 换成 '北京' +
levelLabelTextColors 改回字面量），**6 例如期全红**，逐字还原后 grep 确认 0 残留。
- 一处如实记录：clamp 那条接线锁**第一版是写错的** —— 断言「页面不得出现 socialBaseUpper」，
而页面本来就该读它展示「基数范围 ¥x – ¥y（城市）」。错的是断言不是代码，已改为精确锁
「上下限字段与 Math.min/Math.max 同现」（那才是旧版内联 clamp 的形状）。
另有一次 edit 吃掉了 `const DIM_COLORS =` 后的空格，已复原到与 HEAD 逐字节一致。
如实记录：一份子代理报告的三条说法未通过核对
- 称 DIMENSION_LEVEL 重复声明 —— 不成立，全仓只有 profile.tsx 一处。
- 称 THUMBNAIL_* 重复「×2」—— 不精确，实为一个对象表 + 两份平行 Record（两种写法）。
- 给的 clamp 行号不准，且**没提权威那份在 api.ts**。
与既有一贯口径一致：代理报告是模型输出、不是证据，每条都独立 grep + 逐行读过才动手。
实测（Android 模拟器 emulator-5554，截图核对，非代码走查）
- 本批取值未变，真机的价值在「没崩、没落到兜底」：成长页三个缩略图色系全部解析；
HR 评价「优秀」「良好」都有色、无一落兜底灰；企业看板统计四宫格与快捷入口
**五个语义色各不相同**（若有键写错会静默全变蓝，多色并存即证明未落兜底）；
发布页学历 5 项 / 经验 6 项 / 工作类型 4 项且选中态正确；薪资格算器切城市后
提示与区间正确更新。
- 未验到的：clamp 本身未在真机制造出越界值 —— 社保基数输入框**逐键 clamp**，
手工输入停不到目标值（既有交互，非本批改动），故 clamp 语义以单测 + 注入为准；
岗位列表 / 能力 / 测评的评级色、霍兰德三页六型色、面试两页语义色、登录页掩码手机号、
薪资历史记录时间格式 —— 均有类型约束或测试锁盖住，但本轮未逐屏截图。
仍未做（需产品定夺，未自行选择）
- 「良好」一档在个人页与其余五处取色不同（灰 vs 蓝），统一只改一行。
- JobExperienceRequirement 的「1年以内」是死值（全仓仅见于类型声明，mock 数据没用过、
筛选表也没这项），留还是删。
- 数据层 color: string 未收紧成联合类型，故 semanticColorTokens 的键只能保持
Record<string, string>，代价是数据层写错色名会静默落到 ?? colors.primary。已在注释与
测试里把「这是刻意的」写死，根治属另一批。
门槛：tsc 0 / eslint 0 / 26 文件 365 例全绿（较 4.15 的 339 例 +26）/ check-routes 0 /
check:affordances 0 / check:icons 0（194 文件、1357 字形）/ check-backend-stubs 140
|
1 month ago |
