新增订单收票付款交货跟进并完善使用升级手册

增加部分付款和部分交货状态、工作台筛选、权限校验、跟进记录及 v4 数据迁移;补充 Windows EXE 构建与验收脚本。附 16 页 PDF 使用升级手册及企业微信详细配置说明、生成脚本和测试截图。验证:76 项回归测试、EXE 浏览器验收与 PDF 逐页校验通过。
This commit is contained in:
reddaniel110
2026-09-16 13:40:43 +08:00
parent bf952196fa
commit 768b4705dc
28 changed files with 3783 additions and 43 deletions
+23 -2
View File
@@ -1,6 +1,6 @@
# 博特维采购订单管理系统
苏州博特维智能科技有限公司内部使用的采购单 / 委外生产订单系统。当前源码版本 v3,支持制单、单次审批、正式 PDF 归档、撤回、作废及变更重审。
苏州博特维智能科技有限公司内部使用的采购单 / 委外生产订单系统。当前源码版本 v4,支持制单、单次审批、正式 PDF 归档、撤回、作废、变更重审,以及付款、收票和交货跟进。
## 启动
@@ -19,6 +19,24 @@ python po_app/app.py 8080
**已有数据升级前,请阅读 [运行与升级说明](运行与升级说明.md)。** 程序会先备份旧数据库再执行增量迁移;重复单号会阻止升级,不能自动给历史单据改号。
完整操作步骤见 [v4 使用与升级手册(PDF,16 页)](output/pdf/博特维采购订单系统_v4_使用与升级手册.pdf)。第 10-12 页包含企业微信建群、创建机器人、获取 Webhook、系统配置、手机审批验收及问题排查。手册维护方法见 [手册源文件说明](docs/manual/README.md)。
## Windows 单文件 EXE
在 Windows 64 位电脑上使用 Python 3.11 打包。在项目根目录的 PowerShell 中执行:
```powershell
py -3.11 -m venv tools/out/build-venv
tools/out/build-venv/Scripts/python.exe -m pip install -r requirements-build.txt
cd po_app
../tools/out/build-venv/Scripts/python.exe -m PyInstaller --noconfirm --distpath ../dist --workpath ../build 博特维采购订单系统_单文件版.spec
cd ..
```
产物为 `dist/博特维采购订单系统_单文件版.exe`,使用时无需安装 Python。将 EXE 放在可写的固定文件夹,双击启动;首次初始化口令位于 EXE 同目录的 `instance/setup.token`。默认自动打开浏览器,可设置 `PO_OPEN_BROWSER=0` 关闭自动打开。
安装开发验收依赖后,可执行 `python tools/browser_smoke.py --exe dist/博特维采购订单系统_单文件版.exe`。脚本在临时目录中复制并运行 EXE,验证页面、建单、手机尺寸审批、Excel 导入导出、带章 PDF 及重启后的归档一致性。EXE 测试不启用企业微信发送;测试数据和截图位于 `tools/out/ui-check-*`。
## 主要能力
- 采购单和委外单,供应商/物料库、中文 XLS/XLSX 导入。
@@ -33,8 +51,10 @@ python po_app/app.py 8080
- 用户编辑、重置密码、启用和停用,以及旧会话失效。
- 随机部署密钥、表单 CSRF 校验、请求独立事务、单号唯一约束、重复建单和旧页面操作保护。
- 按状态、供应商、月份统计以及 Excel 台账导出。
- 已审批订单的预付款标记、收票与交货跟进;审批员或管理员登记付款状态与日期,支持部分付款、部分交货。
- 工作台按需预付款、已收票待付款、未交货、已付款未交齐等情况统计并跳转筛选,台账同步导出跟进状态。
图形审批章表示系统内部审批确认,不是第三方证书数字签名。金额分级、部门审批、企业微信个人定向通知、预算、到货和付款跟踪不在当前版本中。
图形审批章表示系统内部审批确认,不是第三方证书数字签名。金额分级、部门审批、企业微信个人定向通知、预算和逐笔资金对账不在当前版本中。付款与交货按整张订单标注状态,部分完成的明细可填写在备注中。
## 项目结构
@@ -44,6 +64,7 @@ po_app/
security.py 会话、认证、请求事务、首次设置
order_routes.py 制单及审批操作、PDF 和版本查看
order_logic.py 权限、校验、金额、提交快照
order_tracking.py 付款、收票和交货跟进、工作台分类筛选
notifications.py 企业微信群通知、事务队列与后台发送
notification_routes.py 管理员通知配置、测试通知和重试
models.py 数据模型及固定精度字段