cmautobuy/docs/task/233-档口入库码独立页面.md

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)