修复招聘会详情图片与展位数据契约

docs/test-reports/job-fair/2026-07-25/bugs/FIX-STATUS.md

@@ -0,0 +1,84 @@
+# 2026-07-25 招聘会缺陷处理状态
+
+更新时间：2026-07-25
+
+本文件汇总本目录 29 项缺陷的代码处理结果。表单语义、键盘交互和展示层修复已写入 `shz-admin`；接口契约、图片地址和展位图数量修复已写入 `shz-backend`。测试数据库本轮只能走受保护只读流程，但 HighGo 客户端路径不可用，因此没有执行任何数据清理或写入 SQL。
+
+## 已完成代码修复
+
+| 缺陷 | 处理结果 |
+| --- | --- |
+| BUG-002 | 求职者招聘会搜索框补充稳定 `id/name/aria-label/autocomplete`。 |
+| BUG-003 | 公共线上招聘会详情 DTO、MyBatis 映射和查询补齐主办、协办、承办单位及详情页依赖的公开字段。 |
+| BUG-004 | 企业端线上招聘会时间范围和标题查询字段补充稳定语义属性。 |
+| BUG-005 | 企业端户外招聘会标题、举办单位及其他查询字段补充稳定语义属性。 |
+| BUG-007 | 户外招聘会报名改为二次确认后才发送写请求，与线上报名流程一致。 |
+| BUG-008 | 户外“报名岗位”弹窗的岗位名称、学历和经验筛选字段补充稳定语义属性。 |
+| BUG-010 | 跨域统计 RangePicker 的开始、结束输入补充独立 `id` 和可访问名称。 |
+| BUG-011 | 企业端联盟城市管理查询字段补充 `id/name/aria-label/autocomplete`。 |
+| BUG-012 | 管理端线上招聘会时间范围和标题查询字段补充稳定语义属性。 |
+| BUG-013 | 管理端空头像改用仓库内置默认头像，并为头像加载失败提供本地回退，避免继续依赖已失效的外部默认图。 |
+| BUG-015 | 管理端线上招聘会详情的岗位学历和经验字段改用字典中文标签；未知编码显示“待配置”，不再显示裸编码。 |
+| BUG-016 | 管理端户外招聘会筛选字段补充稳定语义属性。 |
+| BUG-017 | 管理端户外参会企业名称、报名时间和审核状态筛选字段补充稳定语义属性。 |
+| BUG-018 | 已签到/未签到两个企业列表使用独立且可区分的企业名称字段标识。 |
+| BUG-019 | 企业退订查询字段补充稳定语义属性。 |
+| BUG-020 | 参会岗位名称、企业、学历和经验筛选字段补充稳定语义属性。 |
+| BUG-021 | 参会人员姓名查询字段声明 `autocomplete="off"`，并补充稳定字段标识。 |
+| BUG-022 | 设备码查询和新增设备码字段补充稳定语义属性。 |
+| BUG-023 | 场地类型、场地名称筛选字段补充稳定语义属性。 |
+| BUG-024 | 新增场地弹窗的类型、名称、面积、展位数量、联系电话、地址、线路、机构、备注和经办信息字段补充稳定语义属性及单位提示。 |
+| BUG-025 | 管理端统计日期 RangePicker 的开始、结束输入补充独立 `id` 和可访问名称。 |
+| BUG-026 | 机构列表及新增/编辑表单补充稳定字段标识。 |
+| BUG-027 | 管理端联盟城市管理查询和编辑字段补充稳定语义属性。 |
+| BUG-028 | 跨域城市选择改为可聚焦按钮，支持 Tab、Enter、Space，并通过 `aria-pressed` 暴露选中状态。 |
+
+## 已做代码防护，但历史数据或业务口径待确认
+
+### BUG-001：标题年份与举办日期不一致
+
+历史线上招聘会和户外招聘会记录中的真实年度不能从现有接口事实推断。本轮没有擅自修改标题或日期。请确认以下事项后再决定是否生成测试数据修正 SQL：
+
+1. 线上 `jobFairId=1032` 的真实年度和应保留的标题；
+2. 户外 `id=8` 的真实年度和应保留的标题；
+3. 是否允许管理端新增/编辑时对标题中显式四位年份与举办日期年份不一致进行阻止，还是只提示并允许保存。
+
+### BUG-006：户外招聘会图片回环地址
+
+前端所有 PC 图片入口已通过 `normalizePublicUrl` 处理；后端 CMS 列表、详情和公共 H5 接口也会把历史回环地址替换为当前公开 origin。新增/编辑接口拒绝 `localhost`、`127.0.0.1`、`0.0.0.0` 和 `::1` 图片地址，避免继续污染数据。
+
+测试库中的历史 `id=14` 图片字段仍未执行清理，因为本轮未获得测试数据库写入授权且受保护 HighGo 客户端路径不可用。请确认是否由数据管理员重新上传/清理该记录，并确认公开图片代理路径。
+
+### BUG-009：展位数量口径不一致
+
+后端列表和详情新增 `boothMapCount`，返回实际招聘会展位图数量；管理端同时显示“展位数量”（配置容量）和“展位图数量”（实际展位图），并继续显示已预定数量。这样不会用未经确认的方式覆盖历史 `boothCount`。
+
+请确认历史场地/招聘会配置容量的业务口径：
+
+1. `boothCount` 应表示场地配置容量，保留历史值；
+2. `boothCount` 应与展位图数量一致，由数据管理员按实际模板修正；
+3. 另定义“可报名容量”字段，配置容量和展位图数量均保留。
+
+### BUG-013：头像历史地址
+
+代码已提供本地默认图和加载失败回退，但如果用户资料本身保存了失效的自定义头像，浏览器仍可能先发起一次该地址请求。是否清理历史用户头像地址需要数据管理员确认，本轮不修改用户数据。
+
+## 必须产品确认后继续的功能/数据问题
+
+### BUG-014：线上/线下招聘会类型冲突
+
+求职者端入口、公开详情字段和管理端字典对同一招聘会的类型语义不一致。不能在没有业务确认时把 `jobFairId=1050` 的类型值改为线上或线下，也不能擅自修改全局字典。请确认真实类型及统一规则后，再继续修改数据或接口契约。
+
+### BUG-029：跨域区域选择后的岗位/就业信息闭环
+
+当前代码已有 `JobsTab` 和 `GET /api/cms/publicJobFair/cross-domain-jobs`，但“各地市就业信息”页签被明确注释隐藏；城市选择目前只更新本地状态。恢复岗位页签并让选择/清除触发岗位查询属于功能恢复，会改变管理员和企业端页面结构。请确认：
+
+1. 恢复“各地市就业信息”页签，并按所选城市调用现有接口；或
+2. 废弃城市筛选入口，改为统计用途说明；或
+3. 采用新的产品交互和接口口径。
+
+## 测试数据与环境说明
+
+- BUG-007 复现阶段曾对测试企业与户外招聘会产生一条“待审核”报名写入；本轮没有擅自撤销或删除，需测试数据管理员按业务流程处理。
+- 测试 HighGo 只读查询脚本无法找到服务器上的 HighGo `psql` 客户端，因此历史数据状态未通过数据库重新核对。
+- 正式环境 SQL 未执行，生产环境未部署。