合同编号自动生成台账

一、部署（服务器版）

1. 把本文件夹里的 index.html、login.php、api.php、auth_lib.php、config.php、.htaccess、backup.php 一起上传到服务器同目录；uploads/ 和 backups/ 文件夹也要创建（含各自的 .htaccess）。
2. 先在服务器面板创建 MySQL 数据库 m4491_hetong 及同名用户 / 密码；连接信息在 config.php 中配置，默认主机 mysql9.serv00.com。
3. 首次打开 login.php 登录后会自动建表并写入默认部门/地区。默认账号 admin / YpAdmin2026!，请尽快修改。

二、日常填写

1. 点「＋ 新增合同」追加一行，或在某行点「＋」在其上方插入。部门默认销售部、地区默认宁波、甲乙方默认乙方、状态默认已签署。
2. 序号、合同编号自动生成并锁定。改动自动保存到服务器。

三、签署日期（多种格式自动规范化）

1. 支持 20261010、2026.10.10、2026/10/10、2026-10-10、2026年10月10日，输完自动转为标准格式。

四、编号规则

1. 格式 YP-部门代码-地区代码-年月-甲乙标记-流水号，如 YP-XS-NB-2510-B001。甲方=A，乙方=B，与流水号连写。
2. 流水号同一「部门+地区+年月+甲/乙」组合内从 001 递增（甲乙分开计数）。已作废的合同编号保留不变、仍占流水号位。

五、搜索与筛选

1. 搜索框常驻顶部，输入即时过滤。点「高级筛选 ▼」展开下拉、日期范围、金额范围等条件。
2. 高级筛选中「搜索字段」可勾选搜索针对的字段（合同名称/服务项目/备注/扫描件/编号/部门/地区/甲乙方），默认全选。不勾选的字段不参与搜索匹配。
3. 筛选只影响显示，不改变数据。筛选状态下分页、全选均基于当前页的筛选结果。

六、合同状态

1. 每条合同有状态：草稿 / 已签署 / 已归档 / 已作废。已作废的行显示灰色+删除线，编号保留不变。

七、选择 / 批量操作

1. 表头方框全选/取消（仅当前页筛选结果）；工具栏「全选本页 / 反选本页 / 清空选择 / 正则选择」。
2. 选中后可：「批量修改」（甲乙方/部门/地区/服务项目/金额/签署日期/状态）、「生成文件名」、「批量删除」。
3. 批量删除会弹窗确认，删除后合同进入回收站（可恢复）。

八、回收站

1. 点「回收站」查看已删除的合同。每条可「恢复」或「彻底删除」。「清空回收站」一次性清除所有。

九、合同扫描件链接

1. 扫描件列默认显示文件名+可点击链接；点 ✎ 进入编辑态改文件名。「生成文件名」按规则自动生成。

十、备注栏（支持文字+多图）

1. 备注列支持文字 + 多张图片（最多 9 张，JPG/PNG/GIF/WebP，≤5MB）。点「编辑」打开编辑弹窗，可输入文字、上传图片、移除图片。
2. 图片存到服务器 uploads/ 目录，在备注列以缩略图展示，点击放大。

十一、导出与备份

1. 「导出 CSV / JSON」附 HMAC-SHA256 签名（防篡改）。CSV 末尾含 #SIGNATURE: 行，JSON 含 _signature 字段。
2. 「手动备份」生成完整 SQL 备份。建议设置 cron 每日自动执行 php backup.php?key=YOUR_KEY。

十二、金额显示

1. 金额列非编辑态显示千分位（如 174,000.00），点击编辑时显示原始数字。
2. 选中合同后顶部显示业绩合计：收入（乙方，正）／支出（甲方，负）／净额。甲方合同按支出计为负数，符合业绩统计口径。