# 233 Admin：实现档口入库码独立页面与列表交互

- 类型：需求
- 父级大工单：#14
- 所属 MVP / 版本：#224
- 状态：已完成
- 日期：2026-08-15
- Gitea 工单：<http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/233>

## 背景与目标

把用户确认的交互原型转换为 Admin 正式页面，作为 Excel 导入、确定性匹配和后续安全
回写的独立操作入口。

## 最终方案

- 在“客户端列表”后增加一级导航“档口入库码”，采用顶部工具条、中间可滚动表格、底部
  状态与分页的现有 Admin 三段式布局。
- 页面支持业务日期、状态、订单/档口/规格/入库码关键词组合筛选和 SQL 20 条分页；模块
  切换时只保存稳定筛选和页码，不保存勾选或弹窗。
- 导入、匹配、回写和重新核对均为带 CSRF 的 POST；导入临时文件总会删除，匹配会复用
  已有顺运宝会话且只执行 #232 的只读规划。
- 只有可回写行可勾选，二次确认明确显示总数和需要替换旧值的数量；需核对行显示独立入口。
  本工单只建立回写表单壳，实际远端写入由 #234 实现。
- UI 检查采用现有浅色后台设计，并补齐焦点恢复、禁用态、导入/匹配/回写提交反馈、固定
  表头和双向滚动；没有引入框架或构建流程。

## 改了哪些

- `admin/handler/web/inner_code.go`、`admin/handler/web/web.go`：增加页面、导入、匹配路由。
- `admin/repository/inner_code.go`、`admin/service/inner_code_page.go`：增加筛选、统计、分页和视图。
- `admin/templates/inner_code/list.html`、`admin/templates/partials/header.html`：增加正式工作台和导航。
- `admin/static/css/app.css`、`admin/static/js/app.js`：增加状态样式、表格布局和轻量表单联动。
- `admin/inner_code_template_test.go`、`admin/service/inner_code_page_test.go`：增加模板和状态门禁测试。

## 验收结果

| 验收标准 | 结果 |
|---|---|
| 独立 Tab 位于客户端列表之后并正确高亮 | 通过 |
| 日期、状态、关键词、清除和分页可组合 | 通过 |
| 导入和匹配为 CSRF POST 且有反馈 | 通过 |
| 只有可回写行可选，确认数量和旧值数量准确 | 通过 |
| 表格滚动、禁用态、焦点和提交加载反馈完整 | 通过（代码与模板检查） |

## 测试

- 执行的命令：`go test ./... -count=1`；`go vet ./...`；`git diff --check`；
  UI/UX 规则检索 `animation accessibility z-index loading`。
- 结果：全部通过；模板可解析，导航顺序、CSRF、选择门禁和状态选项均有自动化检查。
- **没验证到的部分**：未连接带 v23 表的隔离 MySQL 启动浏览器，因此未执行真实 1366×768
  截图验收；没有执行任何顺运宝回写。

## 相关提交

- `7665fd9` feat: 增加档口入库码独立页面 (#233)