社区论坛
交流工具使用、配置与问题一、功能名称
数据库维护 · 启动 · 更新（桌面端基础能力，非单一 feature_id）
涵盖 Excel 数据库加载、程序启动版本校验、在线更新流程。
二、实现逻辑
- 启动器
APP.py / ToolsLauncher初始化DatabaseManager加载数据库.xlsx services/version_gate.py对比version/version.json与本地 VERSION- 菜单：重新加载数据库、检测更新、打开输出目录
- 客户端登录
api/login.php校验账号与权限签名
三、数据 / 字段 / 配置支撑
数据库.xlsx各 sheet（备货物流信息、产品数据库、海外仓地址库、渠道表、VAT、商检数据库）version/version.json：version、download_url- 官网
.env、config/app.php：JWT、注册策略 - 用户表 users、权限 roles/role_permissions
四、使用教程
- 每次改 Excel 后，菜单点「重新加载数据库」。
- 首次启动需联网完成版本校验；过低版本会提示下载新包。
- 在官网注册 → 管理员审核 → 客户端用 api/login 登录。
- pending 用户只能上网站，不能进客户端；active 且未过期方可使用工具。
- 输出文件默认在
output/{出厂日期}/。
五、常见异常
| 异常情况 | 解决方法 |
|---|---|
| 启动时「加载数据库失败」/「数据库文件不存在: 数据库.xlsx」 | 将 数据库.xlsx 放在程序根目录；确认文件名正确。 |
| 「数据库缺少必需的子表: …」 | 在 Excel 中补全缺失的工作表（备货物流信息、产品数据库、海外仓地址库等）。 |
| 重新加载时「数据库 Excel 被占用，沿用旧缓存」 | 关闭正在编辑 数据库.xlsx 的 Excel/WPS 窗口，再点「重新加载数据库」。 |
| 「重新加载数据库失败」 | 查看错误详情；常见为文件损坏或路径不可读。 |
| 「无法校验版本」/「版本校验未就绪」 | 检查网络连接及 version/version.json 中的版本检查 URL 是否可访问。 |
| 版本过低强制退出 | 按提示下载并安装新版本客户端。 |
| 客户端登录失败（pending 用户） | 账号待管理员审核；审核通过且状态为 active 后方可登录客户端。 |
| 账号已过期 | 联系管理员续期；个人中心可查看到期时间。 |
全部回复 (0)
暂无回复，来抢沙发吧。
登录 后可回复