docs: 添加 README中文说明文档

2026-09-10 16:57:25 +08:00
parent 6327ef7641
commit 4876d8805d
1 changed files with 134 additions and 0 deletions
@@ -0,0 +1,134 @@
+# 博特维采购订单管理系统
+
+> 苏州博特维智能科技有限公司 · 本地采购订单管理系统（采购单 / 委外生产订单）
+>
+> 制单 → 主管审核 → 经理批准 → 导出 PDF 的全流程本地化工具，按贵司现有 Excel 单据模板套打。
+
+---
+
+## 功能特性
+
+- **两种单据**：采购单、委外生产订单共用同一套数据，按原模板版式分别套打。
+- **两级审核**：制单员提交 → 主管审核 → 经理批准，每个动作写入审核记录，可追溯、可驳回。
+- **Excel 导入明细**：编辑页上传 `.xls` / `.xlsx`，自动识别表头（代码/规格/单位/数量/单价/交期/备注），行数不限，PDF 自动分页。
+- **供应商库 / 物料库**：制单时下拉带入名称、联系人、税号、单价等信息；支持行内编辑、停用/启用、删除，以及 Excel 批量导入（带模板下载）。
+- **金额大写**：合计自动转人民币大写（壹万贰仟叁佰肆拾伍元整）。
+- **审核盖章**：主管审核前须先「加盖审核章」，服务端二次校验，防止绕过；PDF 渲染红色审核专用章。
+- **历史查询与统计**：按单号 / 供应商 / 状态 / 单据类型 / 日期区间筛选；按状态、供应商、月份汇总金额。
+- **台账导出**：一键导出全部订单为 Excel。
+- **PDF 套打**：完全复刻原 Excel 模板版式，草稿/待审核状态带水印防止误用，已批准状态导出无水印正式版。
+
+## 技术栈
+
+| 层 | 技术 |
+|---|---|
+| 后端 | Python 3 + Flask 3 |
+| ORM | SQLAlchemy 2 |
+| 数据库 | SQLite（单文件 `po.db`，免部署） |
+| PDF | reportlab 4（中文套打 + 印章绘制） |
+| Excel | openpyxl 3 / xlrd 2 |
+| 打包 | PyInstaller（单文件版 / 文件夹版，免 Python 环境） |
+
+## 目录结构
+
+```
+po_app/
+├── app.py                       # 主程序（路由 / 业务逻辑 / 审核流程）
+├── models.py                    # 数据库模型（用户 / 订单 / 明细 / 供应商 / 物料）
+├── pdf_export.py                # PDF 套打 + 审核章绘制
+├── amount_cn.py                 # 金额转人民币大写
+├── requirements.txt             # 源码运行依赖
+├── 启动.bat                     # 双击即启（源码方式）
+├── templates/                   # Jinja2 模板
+├── static/                      # CSS / JS / 资源
+├── 博特维采购订单系统.spec         # 文件夹版打包配置
+├── 博特维采购订单系统_单文件版.spec # 单文件版打包配置
+├── 使用说明.md                  # 详细使用手册
+├── instance/                    # 运行时数据库（.gitignore 排除，不入库）
+├── exports/                     # 导出的 PDF（忽略）
+└── uploads/                     # 上传的明细文件（忽略）
+tools/                           # 开发期脚本：测试 / 打包验证 / git 推送
+```
+
+> 仓库仅含**源码与配置**；数据库、构建产物、运行时数据均经 `.gitignore` 排除，不入库。
+
+## 快速开始
+
+三种运行方式任选其一：
+
+1. **单文件 EXE（推荐分发）**
+   `po_app/dist/博特维采购订单系统_单文件版.exe`，拷贝到任意文件夹双击即用，免 Python 环境。
+
+2. **文件夹版 EXE（启动最快）**
+   复制 `po_app/dist/博特维采购订单系统/` 整个文件夹，双击其中的 exe 秒开。
+
+3. **源码运行**
+   安装依赖后双击 `po_app/启动.bat`，或命令行：
+
+   ```bash
+   cd po_app
+   pip install -r requirements.txt
+   python app.py 8080
+   ```
+
+访问地址 <http://127.0.0.1:8080>；局域网其他电脑把 `127.0.0.1` 换成宿主机的局域网 IP（需放行 8080 端口）。
+EXE 版数据落在 exe 同级的 `instance/po.db`，备份即复制该文件夹。
+
+## 初始账号
+
+| 账号 | 密码 | 角色 | 权限 |
+|---|---|---|---|
+| admin | admin123 | 系统管理员 | 全部功能，含用户 / 供应商 / 物料维护 |
+| maker | 123456 | 制单员 | 新建、编辑、提交订单 |
+| reviewer | 123456 | 主管审核 | 审核通过或驳回 |
+| approver | 123456 | 经理批准 | 批准后订单生效，可出正式 PDF |
+
+> ⚠️ 正式使用前请在「用户」页改掉默认密码。
+
+## 业务流程
+
+```
+制单员新建订单 → 填写抬头与明细 → 提交
+        ↓
+主管审核（通过 / 驳回并填原因）
+        ↓
+经理批准（通过 / 驳回并填原因）
+        ↓
+状态 = 已批准 → 导出 PDF（无水印，带审核人姓名与时间）
+```
+
+- 草稿 / 待审核 / 待批准状态导出的 PDF 带斜向水印，避免误用。
+- 被驳回的订单回到制单员名下，可修改后再次提交。
+
+## PDF 套打版式
+
+完全复刻原 Excel 模板：
+
+1. 公司名 + 单据名称（采购单 / 委外生产订单）
+2. 抬头区：左供方、右需方（含采购单号、采购日期、税点、税号等）
+3. 明细表 9 列：序号 / 物料代码 / 物料规格 / 单位 / 数量 / 含税单价 / 金额 / 交期 / 备注（列宽取自原模板）
+4. 合计：小写 + 人民币大写 + 元整
+5. 备注条款 + 交货地点（苏州工业园区星汉街 5 号腾飞新苏工业坊 B 幢 5 楼 05-06 单元）
+6. 签署区：制单 / 主管审核 / 经理批准（含姓名与时间）+ 双方盖章栏
+7. 页脚：单据类型、单号、页码、打印时间
+
+明细超过一页时自动分页并重复表头，合计与条款跟随在最后一页。
+
+## 数据文件与备份
+
+| 文件 | 说明 |
+|---|---|
+| `instance/po.db` | SQLite 主数据库，整个文件夹复制即备份 |
+| `exports/` | 导出的 PDF |
+| `uploads/` | 上传的明细文件 |
+
+## 重新打包说明（开发）
+
+```bash
+# 打包前务必先备份 instance/ 与 exports/，PyInstaller 重建文件夹版会清空 dist
+python -m PyInstaller "博特维采购订单系统[_单文件版].spec" --noconfirm --clean
+```
+
+## 许可
+
+本仓库为苏州博特维智能科技有限公司内部业务系统源码，仅供公司内部使用与维护。