init: 博特维采购订单系统 v1.0 源码

2026-09-10 16:18:15 +08:00
commit 6327ef7641
35 changed files with 4029 additions and 0 deletions
@@ -0,0 +1,77 @@
+# 博特维采购订单管理系统 v1.0
+
+基于贵司两个 Excel 模板（采购合同模板 / 委外生产订单模板）开发的本地采购订单管理系统：
+制单 → 主管审核 → 经理批准 → 导出 PDF。
+
+## 一、启动
+
+三种方式，任选其一：
+
+1. **单文件 EXE（推荐分发）**：`dist\博特维采购订单系统_单文件版.exe`（36.7 MB），拷到任意文件夹双击即用，免 Python 环境
+2. **文件夹版 EXE（启动最快）**：`dist\博特维采购订单系统\` 整个文件夹，双击里面的 exe 秒开
+3. **源码运行**：双击 `启动.bat`，或命令行 `python app.py 8080`
+
+访问地址 http://127.0.0.1:8080；局域网其他电脑把 `127.0.0.1` 换成本机 IP（需放行 8080 端口）。
+EXE 版数据在 exe 同级自动生成的 `instance\po.db`，备份即复制该文件夹。
+
+> 源码方式依赖：Flask、SQLAlchemy、reportlab、openpyxl、xlrd（`pip install -r requirements.txt`）
+
+## 二、初始账号
+
+| 账号 | 密码 | 角色 | 权限 |
+|---|---|---|---|
+| admin | admin123 | 系统管理员 | 全部功能，含用户/供应商/物料维护 |
+| maker | 123456 | 制单员 | 新建、编辑、提交订单 |
+| reviewer | 123456 | 主管审核 | 审核通过或驳回 |
+| approver | 123456 | 经理批准 | 批准后订单生效、可出正式 PDF |
+
+> 正式使用前请在「用户」页改掉默认密码。
+
+## 三、流程
+
+```
+制单员新建订单 → 填写抬头与明细 → 提交
+        ↓
+主管审核（通过 / 驳回并填原因）
+        ↓
+经理批准（通过 / 驳回并填原因）
+        ↓
+状态 = 已批准 → 导出 PDF（无水印，带审核人姓名与时间）
+```
+
+- 草稿 / 待审核 / 待批准状态导出的 PDF 会带斜向水印（草稿、待审核等），避免误用
+- 被驳回的订单回到制单员名下，可修改后再次提交
+- 每个动作都会写入「审核记录」，可追溯
+
+## 四、功能说明
+
+| 功能 | 说明 |
+|---|---|
+| 两种单据 | 采购单 / 委外生产订单共用数据，版式按原模板分别套打 |
+| Excel 导入明细 | 编辑页上传 .xls/.xlsx，自动识别表头（代码/规格/单位/数量/单价/交期/备注）；行数不限，PDF 自动分页 |
+| 供应商库 | 制单时下拉带入名称、联系人、电话、税号、银行、付款方式 |
+| 物料库 | 明细行下拉带入代码、规格、单位、单价 |
+| 金额大写 | 合计自动转人民币大写（壹万贰仟叁佰肆拾伍元整） |
+| 历史查询 | 按单号、供应商、状态、单据类型、日期区间筛选 |
+| 统计 | 按状态 / 供应商 / 月份汇总金额 |
+| 台账导出 | 一键导出全部订单为 Excel |
+
+## 五、PDF 版式
+
+完全复刻原 Excel 模板：
+
+1. 公司名 + 单据名称（采购单 / 委外生产订单）
+2. 抬头区：左供方（供应商、联系人、电话、付款方式、税号、银行帐号、开户银行）、右需方（需方、联系人、电话、税点、税号、采购单号、采购日期）
+3. 明细表 9 列：序号、物料代码、物料规格、单位、数量、含税单价、金额、交期、备注（列宽取自原模板，两种单据各自比例）
+4. 合计：小写 + 人民币大写 + 元整
+5. 备注条款 9 条 + 交货地点（苏州工业园区星汉街 5 号腾飞新苏工业坊 B 幢 5 楼 05-06 单元 胡乃琛 13913172516）
+6. 签署区：制单 / 主管审核 / 经理批准（含姓名与时间）+ 双方盖章栏
+7. 页脚：单据类型、单号、页码、打印时间
+
+明细超过一页时自动分页并重复表头，合计与条款跟随在最后一页。
+
+## 六、数据文件
+
+- 数据库：`instance/po.db`（SQLite，整个文件夹复制即可备份）
+- 导出的 PDF：`exports/`
+- 上传的明细文件：`uploads/`