零件仓管小助手 · 电脑主库
========================================

Windows 桌面程序，不用安装，解压就能用。
配合手机 App「零件仓管小助手」使用：手机负责扫码出入库，
电脑负责集中存数据、查数据、改数据、备份。


一、怎么开始
----------------------------------------
双击  warehouse-server.exe  （或「启动.bat」）

第一次打开时程序会自动：
  · 建好数据库（在 data 目录里）
  · 随机生成一个同步密钥

左边五个菜单：

  数据管理    查看 / 搜索 / 新增 / 修改 / 删除数据，可导出 CSV
  手机连接    显示两个二维码，手机扫一下就能连
  历史版本    查看历史存档，一键回滚
  设置        改密钥、改端口、改公网地址，启停同步服务
  同步日志    看哪台手机什么时候连过、做了什么


二、手机怎么连
----------------------------------------
1. 电脑上打开本程序，点「手机连接」
2. 手机 App 里进「数据同步」，选「中心主库模式」
3. 点「扫主库二维码」，扫电脑屏幕上的二维码
4. 地址、端口、密钥会自动填好，直接点同步

手机和电脑连同一个 WiFi —— 扫「内网二维码」。
人在外面用手机流量 —— 扫「外网二维码」
（前提：路由器已把 9527 端口映射到这台电脑）。


三、数据在哪（重要）
----------------------------------------
全部数据都在两个地方，都自动生成，不需要你管：

  data\warehouse.db     数据库，你的全部数据都在这个文件里

  备份\                  每天第一次打开程序时自动备份一份到
                         data\备份\，文件名带日期，最多留最近 30 份

换电脑、重装，只要把 data 目录整个拷过去就行。


四、常见问题
----------------------------------------
【打开后数据是空的？】
  正常，说明是新库。新建物品或从手机同步过来就有了。

【第一次运行时弹防火墙提示？】
  一定要点「允许」，否则手机连不上。

【手机连不上？】
  · 两边要连同一个 WiFi，或者路由器做了端口映射
  · 「设置」里确认同步服务是「运行中」
  · 密钥要一模一样（让手机重新扫一次二维码最省事）
  · 检查 Windows 防火墙有没有拦 9527 端口
  · 手机如果用流量，必须扫「外网二维码」，且路由器要做端口映射

【端口 9527 被占用了，起不来？】
  到「设置」里改成别的端口（比如 9528），
  手机 App 里也改成一样的。

【想换同步密钥？】
  「设置」里点重新生成，然后手机重新扫二维码。


五、给别人拷贝 / 换电脑
----------------------------------------
拷整个文件夹过去，双击 exe 就能跑。
不需要装 Qt，不需要装任何运行库。

注意：
  · 如果只想给对方一个干净的、没有你数据的程序，
    就删掉 data 目录和 config.json 再拷。
    程序下次启动会自动重建，并生成新密钥。
  · 如果想把数据一起带过去，就连 data 目录一起拷。


六、技术说明
----------------------------------------
· Qt 6.11.2 / MinGW / C++17，零第三方依赖
· 同步协议与手机 App 完全一致：9527 端口
  /ping  /info  /export  /import
· 二维码是内置编码器画的，不联网也能生成
· 数据库结构与手机 App 完全对应，两边可直接交换数据
· 程序图标与手机 App 一致
