完善配送端列表头像展示

docs/07-配送点管理系统需求.md

@@ -93,6 +93,7 @@ Global:
 - 资质支持新增、编辑、启停和归档。
 - 删除均为归档；存在未完成订单时禁止归档人员。
 - 不允许创建安装、运维、仓管、调度员或质控角色账号。
+- 配送人员列表不得展示数据库自增 ID；联系电话之后显示 32px 圆形头像缩略图，头像仅通过当前配送点 JWT 范围内的受保护接口懒加载。无头像或读取异常时显示默认头像，不得从列表响应读取或暴露头像 URI。
 
 ### 4.4 用户管理
 
@@ -102,6 +103,7 @@ Global:
 - 配送点不能将用户迁移到其他配送点或其他气站。
 - 归档用户时同时归档地址及服务关系。
 - 用户存在未完成订单、未关闭工单、钱包余额、可提现余额或待处理提现时禁止归档。
+- 用户账户列表沿用配送人员列表的受控头像缩略图、默认头像、限流缓存和自增 ID 隐藏规则。
 
 ### 4.5 合同管理
 

docs/操作日志_配送点独立资源页面_20260822.md

@@ -19,6 +19,9 @@
 7. 依据 5173 页面重新对齐灰色页面底、面包屑、分区卡片、详情信息网格、双列表单和底部操作区。
 8. 将配送人员和用户账户的头像文本框替换为 5173 头像摘要卡片，新增上传、预览、恢复默认头像和配送点范围鉴权读取能力。
 9. 修正配送人员、用户编辑接口：没有提交头像字段时保留旧头像，避免编辑其他资料时误清空。
+10. 配送人员和用户账户列表增加 32px 受控头像缩略图，复用 5173 的懒加载、并发 6、当前页缓存、取消和 Blob URL 回收策略。
+11. 删除全部标准资源列表的数据库自增 ID 列，只保留系统唯一标识；同时把该规则加入自动检查。
+12. 配送人员头像读取补充 `role_code = delivery` 范围限制，并新增 SQL 范围测试。
 
 ## 操作后状态
 
@@ -28,6 +31,7 @@
 
 - 新增：`src/views/resource/` 下 5 个记录页组件与组合函数。
 - 新增：`src/views/shared/ResourceListPage.vue`。
+- 新增：`ProtectedAvatarThumbnail.vue`、`protected-list-avatar-loader.ts` 和配送人员角色范围测试。
 - 新增：`src/router/routes/modules/resource-route-builder.ts`。
 - 新增：`src/api/resource-display.ts`、`resource-navigation.ts`、`resource-record-form.ts`。
 - 修改：`platform.ts`、`ResourcePage.vue`、`resources.ts`、路由类型、资源契约和包脚本。
@@ -45,12 +49,13 @@
 - `contract:check`：通过，18 个资源与后端契约一致。
 - `profile:check`：通过，资料专用只读页未回退。
 - `type:check`：通过。
-- `build`：通过，2628 个模块完成生产构建。
-- `go test ./internal/logic/delivery`：通过。
+- `build`：通过，2632 个模块完成生产构建。
+- `go test ./internal/logic/delivery ./internal/routers`：通过，包含配送人员头像角色范围测试。
 - `lint`：通过；仅报告项目既有警告，未产生失败项。
 - 浏览器回归：工作人员列表、详情、编辑、正式新建地址、返回链路、未保存保护、配送订单新建页、支付列表均通过。
 - 布局回归：工作人员详情、编辑和配送订单新建页已在应用内浏览器逐页截图检查，与 5173 的页面结构和响应式断点一致。
 - 头像回归：配送人员新建、编辑页已确认不再显示头像文本框，头像选择按钮、格式大小提示、默认头像和身份摘要均正常；后端头像路由测试通过。
+- 列表头像回归：配送人员、用户账户显示受控圆形头像，其他资源不生成无效头像列；数据库 ID 列已从全部标准列表移除；点击刷新后头像重新加载正常。
 
 ## 风险评估
 

docs/项目文档_配送点独立资源页面_v1.0.md

@@ -24,6 +24,7 @@ frontend/delivery_admin/
 └── src/
     ├── api/
     │   ├── resource-display.ts        # 中文字段、状态和详情值展示
+    │   ├── avatar.ts                  # 头像上传与配送点鉴权读取
     │   ├── resource-navigation.ts     # 独立页面路由和安全返回地址
     │   └── resource-record-form.ts    # 表单初始化、字段白名单和校验
     ├── router/routes/modules/
@@ -37,7 +38,9 @@ frontend/delivery_admin/
     │   ├── use-resource-avatar.ts     # 头像预览、上传和清除状态
     │   └── use-unsaved-record.ts      # 未保存离开保护
     └── views/shared/
-        └── ResourceListPage.vue       # 跳转独立页面的标准列表
+        ├── ResourceListPage.vue       # 跳转独立页面的标准列表
+        ├── ProtectedAvatarThumbnail.vue # 32px 受控头像缩略图
+        └── protected-list-avatar-loader.ts # 懒加载、限流、缓存和取消
 ```
 
 ## 4. 核心实现
@@ -50,6 +53,8 @@ frontend/delivery_admin/
 
 配送人员和用户账户参考 5173 使用头像身份摘要卡片。新建、编辑时点击头像可选择不超过 2 MB 的 JPG/PNG 文件，保存时先上传到受控头像目录，再把返回 URI 写入资源；详情页通过配送点范围鉴权接口读取头像。未选择新头像时不会清空已有头像。
 
+配送人员和用户账户列表同样参考 5173：联系电话后显示 32px 圆形头像，最多并发 6 个鉴权请求，接近可视区域才加载；当前页缓存结果，刷新或离页时取消请求并释放 Blob URL。404、网络错误和图片解码失败均回退本地默认头像。全部标准资源列表隐藏数据库自增 ID，只展示可复制的系统唯一标识。
+
 `resource-record-form.ts` 为五类可编辑资源声明后端更新字段白名单，防止用户名、合同编号等只读字段出现在编辑页或被无效提交。
 
 支付与退款资源统一使用后端正式名称 `payment_order`、`payment_refund`，菜单地址仍保持 `/finance/payments`、`/finance/refunds`，避免接口路径不一致导致 404。
@@ -73,8 +78,9 @@ npm.cmd run build
 - 删除已停用的抽屉式 `CrudListPage.vue`。
 - 修复支付、退款资源与后端契约名称不一致的问题。
 - 新增 17/9/5 页面能力矩阵自动检查。
+- 新增配送人员、用户账户的受控头像缩略图，并移除全部标准列表的数据库自增 ID。
 - 保持配送点资料专用只读页面和现有公共后端接口不变。
 
 ## 7. 已知边界
 
-独立页面只使用配送端已存在的关系查询和 CRUD 能力，不引入平台端头像上传、合同附件上传、平台角色或跨组织账户摘要接口。普通头像和附件 URI 字段仍按原后端文本契约展示或填写。
+独立页面只使用配送端数据范围内的关系查询和 CRUD 能力；头像复用公共受控上传入口，并通过配送点专属鉴权接口读取。不引入合同附件上传、平台角色或跨组织账户摘要接口，附件 URI 字段仍按原后端文本契约展示或填写。