📱 二手机 & 耳机库存 · 完整操作指南 v2.0
腾讯云 2phone/ 目录 · 入库 · 出库 · 已售 · 耳机 · 三表联动
一、系统架构
所有数据文件路径：/opt/1panel/.../index/2phone/{2,3,4,5}.md
系统动态读取 .md 文件生成页面，改数据不动程序（只改 .md，不动 .php）
各分区表格结构
| 分区 | 列数 | 列字段 |
|---|
| 2.md 手机（A-F区） | 9列 | 序号|品牌型号|内存/存储|颜色|数量|成本|售价|来源|备注 |
| 5.md 耳机 | 6列 | 序号|品牌型号|颜色|数量|成本|售价 |
二、入库操作流程
- 下载云端最新版：SSH scp 或 SFTPGo 下载最新 2.md / 5.md
- 确定序号：检查 2~5.md 所有文件中最大序号，加1（不是本分区最大序号）
- 追加记录：在分隔线
---|---| 之前插入新行
- 格式：
序号|品牌型号|内存/存储|颜色|数量|成本|售价|来源|备注
- 一次性修改：用 Python 脚本精准定位，禁止 sed 全局替换
- 上传更新：scp 或 SFTP 上传覆盖
- 验证：打开 https://nickys.cn/2phone/2.php 确认
三、出库/删除操作
- 从 2.md 删除已售记录
- 追加到 3.md 已售清单，备注格式：
买家名 YYYY-MM-DD
- 保留完整记录（谁、多少、什么时候）
- 涉及欠款 → 同步更新 debt.html（赊账追加借出）
- 操作完后必须：排序 → 重排序号 → 发链接确认
出库后必做三件事：
① 手动排序（iPhone按代数倒序，其他字母序）
② 重排序号（从1开始连续）
③ 发链接给老张确认
四、耳机页面（5.md）操作
- 耳机出库：删除行→重排→已售追加（含完整序列号SN）
- 结账只改状态，不删除记录
- 独立序号体系，不与 2.md 共用
五、已售清单（3.md）更新规则
- 追加记录（不删除已有）
- 备注末尾必须加日期
YYYY-MM-DD
- 标题规则：每条已售机器单独一行
- 与 debt.html 联动：如果买家未结清，需同步在 debt.html 追加欠款记录
六、三表联动规则
| 场景 | 3.md操作 | CRM操作 | debt.html操作 |
|---|
| 现结（已转） | 改未结→已转 | 记录交易 | 不动 |
| 赊账（未结） | 追加已售记录 | 记录交易 | 追加借出 |
| 到账通知 | 改未结→已转 | 更新 | 追加还款 |
七、编辑铁律
- 云端优先：编辑前必须先下载云端最新版，编辑后上传并清除本地缓存
- 改数据不动程序：改 .md / .html / .json（数据），不动 .php（程序逻辑）
- 备注加日期：每条操作备注末尾必须加 YYYY-MM-DD 日期
- 用Python精准定位：按序列号+买家名定位，禁止 sed 全局替换（误伤其他记录）
- 禁止空白行：空白行会导致PHP表格断裂
- 改名后型号一致性：2.md和3.md同步改
- 操作完发链接：改完后把相关页面的纯文本链接发给老张确认
八、常见Bug与陷阱
| Bug | 说明 |
|---|
| stock_manager.py add 参数错位 | 第三个参数覆盖备注字段导致价格错位 |
| sed全局替换误伤 | 相同的数字/文字在多条记录中会被误改 |
| 空白行导致表格断裂 | PHP解析遇到空行就结束当前表格 |
| 改名后型号不一致 | 2.md改了但3.md没有同步改 |