数据库管理 / 数据库升级 模块补丁 — 部署说明
==================================================

本压缩包包含「数据库管理」与「数据库升级」两个后台模块的改动，
适用于部署在 st-joyapparel.com 的站点（需运行 MySQL）。

一、包含文件
------------
app/Core/App.php                      新增 'db' 路由与 capability 映射
app/Core/Helper.php                   导航项 + 升级扫描/人类可读大小等辅助函数
app/Core/Installer.php                新增 applySqlFile() / ensureUpgradeLog()
app/Controllers/Admin/DatabaseController.php   数据库管理（浏览/编辑/新增/删除）
app/Controllers/Admin/UpgradeController.php    数据库升级（重写）
app/Views/admin/system.php            系统设置页（重写）
app/Views/admin/upgrade.php           数据库升级页（重写）
app/Views/admin/db_tables.php         数据库管理 - 表列表
app/Views/admin/db_browse.php         数据库管理 - 浏览/搜索/分页
app/Views/admin/db_form.php           数据库管理 - 编辑/新增表单
app/Views/layouts/admin.php           导航渲染（支持 badge 提示）
public/assets/css/admin.css           新增相关样式
install/upgrades/README.txt           升级包目录说明
install/upgrades/examples/001_example_add_field.sql  示例（不参与自动扫描）
install/upgrades/002_create_psi_order_tables.sql     ★ 服装厂成衣标准建表（6 订单/出库表 + psi_purchases 修复）

二、部署步骤
------------
1. 将压缩包内文件按相同目录结构覆盖上传到站点根目录对应位置。
2. 登录后台，进入「数据库升级」：
   - 首次进入会自动创建 db_upgrades 审计表。
   - 页面会提示有 1 个升级包（002_create_psi_order_tables.sql）可执行。
   - 点击执行后自动创建 6 张表 + 修复 psi_purchases 缺失列 + 服装厂字段。
3. PSI 订单功能即可正常使用（销售订单/采购订单/出库单全部可用）。
4. 进入「数据库管理」（仅 MySQL 模式可用）：
   - 可查看所有数据表、浏览/搜索数据、新增、编辑、删除记录。

三、注意事项
------------
- 升级包 SQL 文件请放在 install/upgrades/ 根目录；examples/ 子目录仅作示例，不会被自动扫描。
- 升级前请务必对数据库做备份。
- 若服务器 MySQL 版本较老（< 5.7），存储过程中 INFORMATION_SCHEMA 查询可能需调整。
- psi_purchases 的 product_id / supplier / brand 列补齐使用 PREPARE 动态检测，可安全重复执行。
