3.5 KiB
3.5 KiB
局域网 Web 看板(2026-10-16)
用户已明确:本地部署供局域网同事使用;订单匹配依据后续提供的表格,邮件模板与产品线群组后续提供;每日两次时间和发送方式可设置。界面使用现成开源 UI,不自行设计组件体系。
UI 选型
实际检索并核对官方资料:
| 方案 | 官方来源 | 适用取舍 |
|---|---|---|
| Tabler | https://tabler.io/admin-template 、 https://preview.tabler.io/ 、 https://github.com/tabler/tabler | MIT 开源版提供 Bootstrap 5 后台布局、卡片、表格、设置页;可直接接入现有 Node 程序,采用此方案 |
| Ant Design Pro | https://github.com/ant-design/ant-design-pro | MIT,React 企业后台完整模板,适合大型前端工程;本项目当前不需要引入整套 Umi 构建工具链 |
| Vben Admin | https://doc.vben.pro/ | MIT,Vue 企业管理框架,可选多种 UI,当前项目接入成本高于 Tabler |
使用 npm 分发的 @tabler/core,保留许可证和归属信息,不购买或复制 Pro 专属素材。资源全部从本机提供,不使用远端 CDN、在线字体或演示业务数据。沿用现成 Tabler 页面布局和组件,仅替换中文业务字段和数据绑定。
本阶段可交付功能
- 独立 Web 服务(默认 18766,与扩展回环服务 18765 分开),可配置局域网监听。
- 首次从部署机创建管理员,后续账号登录;管理员创建操作员/只读账号。普通浏览访问不含扩展配对密钥。
- 看板显示真实 PDF 导出记录、任务状态、接入缺项、计划时间;不添加虚构订单和发送成功记录。
- 每日两次时间、周末、逐单/产品线汇总、错过时段策略可保存;时区 Asia/Shanghai,未接通业务与邮件服务时明确未启用发送。
- 模板草稿和产品线收件群组可编辑保存,表格映射待真实样表后接入。
- 持久化设置、用户、导出记录和操作记录,重启保留;并发修改使用版本校验防止静默覆盖。
- 保留现有扩展导出,成功/失败状态同步到 Web 记录,并可在登录后下载已完成 PDF。
本阶段不假定的内容
订单扫描/匹配、210 上传、邮件发送不能在表格、模板和渠道未提供时伪造实现或启用。看板显示配置就绪程度,现有配置表单是后续连接器的输入,不代表连接器已联调。后续依据样表补充导入、列映射和匹配预览。
验证
先写测试验证持久化、配置验证、版本冲突、账号权限、首次设置限制、跨站请求拒绝和 PDF 记录/下载;通过后使用浏览器检查桌面与窄屏看板、设置保存和非管理员界面。保留原 PDF 回归测试。
调度参考:青龙面板
2026-10-16 按用户要求核对 https://github.com/whyour/qinglong 。官方 README 列出任务日志、秒级定时、通知、移动端与内置 API;演示入口跳至登录页,未进入其受保护功能。当前仅作架构和交互参考,不声称已部署或集成青龙。
后续调度按“任务定义 → 执行批次 → 日志”组织:任务名、时间/cron、启停状态、上次结果、下次时间;提供手动运行、日志与失败重试。日常使用保留每天两次的简单设置,cron 作为高级模式。BPM 采集、PDF 整理、210 归档、邮件批次划分步骤;同一任务防重叠,邮件按订单/版本/收件组记录发送状态,避免重启或重试重复发送。上述执行器功能尚未实现。