采购数字化台账 · 交割一页纸
版本 2026-09-05 · 9.1 起日常数据以系统录入为主；源表重大变更时可由 admin 应急全量灌注（须输入确认词）。
登录地址：业务域名首页（需账号） · 管理员可打开本页：/handbook.html
1. 账号与密码
各角色账号由系统管理员创建分配。初始密码不向本手册写入，请向管理员索取；首次登录后请使用顶栏「修改密码」自行改密。
| 角色 | 典型用途 |
|---|
| 管理员 | 用户/项目部/全量导入（应急） |
| 老板 / 总经理 | 看全部、导出核对 |
| 财务 | 付款登记、票据、供应商汇总 |
| 采购 / 仓管 | 录入与维护授权范围内采购明细 |
| 供应商 | 只读查看与本供应商相关数据 |
2. 日常怎么用（9.1 起）
- 新增：物料/菜品/物流页右上角「+ 新增…」，填完保存。
- 收货/开票/付款：列表勾选即行级保存（无需每次点「重新加载」）；供应商页「付款/明细」支持两种方式：登记付款并分摊（记剩余应付）与批量标记已付（整笔清零并重记流水）。
- 凭证：行内「操作 → 凭证」上传扫描件；上传/删除会升版本号，他人点「重新加载」时会感知变更。
- 给老板核对：顶栏「核对资料」→ 独立选项目部/月份/类型 → 解压打开「核对首页.html」。
- 导出 Excel：明细 Sheet 可作增量导入模板（admin 预览导入）；汇总 Sheet 仅备份。
- 待办中心：点击行定位到列表正确页并高亮；未付金额按「剩余应付」统计。
- 付款双轨：①登记分摊（部分付款，超额会拒绝）；②批量/列表勾选已付（整笔清零并写全额分摊）。取消已付会同步清除分摊流水。供应商付款弹窗可「填入勾选合计」。
2.1 并发与冲突 / 安全
- 「强制同步」必须携带版本号；缺省或不一致会拒绝（409）。
- 付款登记、凭证、供应商合并、行级勾选均会升版本。
- 新账号 / 管理员重置密码后，首次登录必须改密（Esc 无法跳过；未改密前 API 拒绝业务操作）。
- 列表勾选「付款」与供应商批量已付：仅财务/管理层可用。
3. 禁止事项
- 禁止用历史整月 Excel 盲目叠加导入（admin 增量导入须指定项目部并预览）。
- 禁止在未备份时点系统管理「全量 data.json 覆盖」——该操作会清空付款分摊与凭证元数据，仅 admin 应急且须输入确认词「确认灌注」。
- 供应商名称尽量用主数据规范名，避免「聚星 / 聚星公司-阮」混用。
4. 备份与回滚（管理员）
- 清洗前备份示例：
/tmp/pms_backup_pre_clean_20260831.sql
- 日常脚本：
bash /opt/pms/scripts/backup_daily.sh（密码从 /opt/pms/.env 读取；输出 /opt/pms/backups/，保留约 14 份）
- 部署脚本
deploy.sh 会写入 cron：30 2 * * * …/backup_daily.sh
- 全量灌注后可选清理 uploads 孤儿：
bash /opt/pms/scripts/cleanup_uploads_orphans.sh --apply（先不加 --apply 预览）
- 回滚：停止写入后导入备份 SQL，再重启 api 容器。
5. 交割检查清单
- □ 数据已全量清洗，无「项目部为空」脏行
- □ 老板/财务/采购账号能登录
- □ 试录一条物料并勾选付款
- □ 试下载一次核对资料包
- □ 各账号已修改默认密码（新账号首次登录会强制弹改密）
← 返回系统