57 lines
2.8 KiB
Markdown
57 lines
2.8 KiB
Markdown
# 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)
|