From 15ebda23e3fd539a17032fa3656c14ccd150965a Mon Sep 17 00:00:00 2001 From: chengma Date: Sat, 15 Aug 2026 09:00:12 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BD=92=E6=A1=A3=E4=BB=BB=E5=8A=A1=20?= =?UTF-8?q?#233?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/task/233-档口入库码独立页面.md | 56 +++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 docs/task/233-档口入库码独立页面.md diff --git a/docs/task/233-档口入库码独立页面.md b/docs/task/233-档口入库码独立页面.md new file mode 100644 index 0000000..943d501 --- /dev/null +++ b/docs/task/233-档口入库码独立页面.md @@ -0,0 +1,56 @@ +# 233 Admin：实现档口入库码独立页面与列表交互 + +- 类型：需求 +- 父级大工单：#14 +- 所属 MVP / 版本：#224 +- 状态：已完成 +- 日期：2026-08-15 +- Gitea 工单： + +## 背景与目标 + +把用户确认的交互原型转换为 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)