1

_docs/sql/001_biz_schema.sql

@@ -1,6 +1,15 @@
 -- WechatAdminWeb 订阅模块业务表（MySQL 8+）
--- 业务用户物理表名：biz_user（与 Sequelize 模型 biz_user、freezeTableName 一致）
--- 执行前请确认库名；与 api/model/biz_*.js 字段一致
+-- 执行前请确认库名；字段与 api/model/biz_*.js 中 tableName 完全一致：
+--
+--   Sequelize 模型名          物理表名（本文件与其它 _docs/sql）
+--   ----------------         ----------------
+--   biz_user                 biz_user
+--   biz_plan                 biz_plans
+--   biz_subscription         biz_subscriptions
+--   biz_api_token            biz_api_token
+--   biz_usage_monthly        biz_usage_monthly
+--
+-- 另见：biz_audit_log（003_biz_audit.sql）、biz_api_call_log（biz_api_call_log.sql）
 
 SET NAMES utf8mb4;
 

_docs/sql/002_subscription_menu_seed.sql

@@ -1,5 +1,6 @@
 -- =============================================================================
--- sys_menu 订阅模块菜单插入脚本（字段与 api/model/sys_menu.js 一致）
+-- 表 sys_menu（与 api/model/sys_menu.js 模型同名；执行前以 information_schema 确认实际表名）
+-- 订阅模块菜单插入脚本（字段与模型一致）
 -- path：不含斜杠（与首页 path=home 等约定一致）；component 仍为 subscription/xxx 供前端映射
 -- 执行前请备份。若已存在同名「订阅管理」父菜单，请先删除子菜单再删父级，或改下面名称。
 -- 若数据库表另有 created_at / updated_at 等列，请在 INSERT 中补全或给默认值。

_docs/sql/003_biz_audit.sql

@@ -1,4 +1,5 @@
 -- 审计日志（关键操作留痕）
+-- 模型：api/model/biz_audit_log.js  →  tableName: biz_audit_log
 SET NAMES utf8mb4;
 
 CREATE TABLE IF NOT EXISTS `biz_audit_log` (

_docs/sql/003_home_menu_seed.sql

@@ -1,5 +1,6 @@
 -- =============================================================================
--- sys_menu 首页（字段与 api/model/sys_menu.js、现有库中菜单数据格式一致）
+-- 表 sys_menu（与 api/model/sys_menu.js 模型同名；执行前以 information_schema 确认实际表名）
+-- 首页菜单（字段与模型、现有库中菜单数据格式一致）
 --
 -- 参考库中同类数据示例：
 --   path：首页为 home（无前导 /）；订阅子页为 /subscription/xxx

_docs/sql/004_migrate_biz_users_to_biz_user.sql

@@ -1,4 +1,5 @@
 -- =============================================================================
+-- 目标物理表名：biz_user（与模型 api/model/biz_user.js 的 tableName 一致；旧名 biz_users 仅为历史迁移说明）。
 -- 若早期已按旧版 001 建表 biz_users，而运行时报错查 biz_user，可执行本脚本迁移表名。
 -- 执行前备份数据库。若子表尚未创建，可跳过本脚本，直接 DROP biz_users 后重跑新版 001_biz_schema.sql。
 -- =============================================================================

_docs/sql/005_biz_timestamp_defaults_alter.sql

@@ -1,3 +1,4 @@
+-- 表名与 api/model 中 tableName 一致：biz_user、biz_plans、biz_subscriptions、biz_api_token、biz_usage_monthly、biz_audit_log
 -- 已有库若 `created_at` / `updated_at` 无默认值，插入会失败（模型已关闭 Sequelize timestamps 且未声明时间字段时依赖库默认值）。
 -- 按需对已有表执行（新库直接执行 001/003 即可，无需本文件）。
 

_docs/sql/alter_plan_api_permission.sql

@@ -1,3 +1,4 @@
+-- 模型 biz_plan → 表 biz_plans；模型 biz_usage_monthly → 表 biz_usage_monthly（与 api/model 中 tableName 一致）
 -- 在「与后端 app 相同」的 MySQL 库中执行（否则会一直报 Unknown column）。
 -- 可重复执行：若列已存在会报错，可忽略对应语句或改用 scripts/migrate_biz_plan_api_columns.js
 

_docs/sql/biz_api_call_log.sql

@@ -1,3 +1,6 @@
+-- 模型：api/model/biz_api_call_log.js  →  tableName: biz_api_call_log
+SET NAMES utf8mb4;
+
 CREATE TABLE IF NOT EXISTS `biz_api_call_log` (
   `id` BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
   `user_id` BIGINT UNSIGNED NOT NULL COMMENT '业务用户ID',

_docs/sql/seed_biz_plans.sql

@@ -0,0 +1,96 @@
+-- 套餐示例数据（表 biz_plans，模型 biz_plan / api/model/biz_plan.js）
+-- 执行库须与项目 NODE_ENV 对应库一致；若表无 allowed_apis / api_call_quota 请先执行 alter_plan_api_permission.sql
+-- plan_code 唯一：重复执行会主键/唯一冲突，可先 DELETE WHERE plan_code IN (...) 或改用下面「按编码更新」段落
+
+SET NAMES utf8mb4;
+
+-- ========== 1）插入三条示例套餐 ==========
+INSERT INTO `biz_plans` (
+  `plan_code`,
+  `plan_name`,
+  `monthly_price`,
+  `auth_fee`,
+  `account_limit`,
+  `active_user_limit`,
+  `msg_quota`,
+  `mass_quota`,
+  `friend_quota`,
+  `sns_quota`,
+  `enabled_features`,
+  `allowed_apis`,
+  `api_call_quota`,
+  `status`
+) VALUES
+(
+  'plan_junior',
+  '初级版',
+  299.00,
+  0.00,
+  3,
+  50,
+  3000,
+  100,
+  200,
+  100,
+  JSON_ARRAY('登录', '好友', '消息', '管理'),
+  JSON_ARRAY('/login/GetLoginStatus', '/login/DeviceLogin', '/message/SendText', '/friend/GetContactList'),
+  50000,
+  'active'
+),
+(
+  'plan_senior',
+  '高级版',
+  899.00,
+  0.00,
+  20,
+  500,
+  50000,
+  2000,
+  5000,
+  2000,
+  JSON_ARRAY(
+    '登录', '好友', '消息', '群聊', '朋友圈', '小程序', '管理',
+    '设备', '收藏', '视频号', '标签', '支付', '企业微信', '商店', '其他', 'Ws'
+  ),
+  NULL,
+  500000,
+  'active'
+),
+(
+  'plan_custom',
+  '定制版',
+  0.00,
+  0.00,
+  9999,
+  9999,
+  0,
+  0,
+  0,
+  0,
+  NULL,
+  NULL,
+  0,
+  'active'
+);
+
+-- ========== 2）仅当列已存在时：按 plan_code 幂等覆盖（无则 INSERT 需自行补全列）==========
+-- 若你已手工删过上面 INSERT，可用下面语句改已有编码的数据：
+
+-- UPDATE `biz_plans` SET
+--   `plan_name` = '初级版',
+--   `monthly_price` = 299.00,
+--   `msg_quota` = 3000,
+--   `api_call_quota` = 50000,
+--   `allowed_apis` = JSON_ARRAY('/login/GetLoginStatus', '/message/SendText'),
+--   `status` = 'active'
+-- WHERE `plan_code` = 'plan_junior';
+
+-- ========== 3）常用维护语句 ==========
+-- 下架套餐
+-- UPDATE `biz_plans` SET `status` = 'inactive' WHERE `plan_code` = 'plan_junior';
+
+-- 某套餐改为「全接口 + 不限次数」（接口层 allowed_apis=null、api_call_quota=0 表示不限制）
+-- UPDATE `biz_plans` SET `allowed_apis` = NULL, `api_call_quota` = 0 WHERE `plan_code` = 'plan_senior';
+
+-- 清空测试套餐（谨慎：有外键订阅时可能拦截）
+-- DELETE FROM `biz_plans` WHERE `plan_code` IN ('plan_junior', 'plan_senior', 'plan_custom');

_docs/订阅模块实施计划.md

@@ -77,7 +77,7 @@
 
 新建迁移或 SQL 脚本（建议 `_docs/sql/` 或 `migrations/`，与团队习惯一致）包含：
 
-- `biz_users`（或 `users`，注意与 `sys_user` 后台账号区分 — **建议业务客户表用前缀 `biz_`**，避免与系统用户混淆）
+- `biz_user`（与模型 `api/model/biz_user.js` 的 `tableName` 一致；与 `sys_user` 后台账号区分）
 - `biz_plans`
 - `biz_subscriptions`（字段含 `renew_mode`、`payment_channel`、`payment_ref` 等）
 - `biz_api_token`（`token_hash`、`plan_id` 可选冗余）
@@ -100,7 +100,7 @@
 
 | 需求路径 | 实现前缀 |
 |----------|----------|
-| `POST /admin/users` | `POST /admin_api/users` 或 `/admin_api/biz_users` |
+| `POST /admin/users` | `POST /admin_api/biz_user/page` 等（以实际 controller 为准） |
 | `GET /admin/users` | `GET /admin_api/users` |
 | `GET /admin/users/{id}` | `GET /admin_api/users/:id` |
 | `PUT /admin/users/{id}` | `PUT /admin_api/users/:id` |

api/model/biz_api_call_log.js

@@ -42,7 +42,12 @@ module.exports = (db) => {
         defaultValue: Sequelize.NOW,
       },
     },
-   
+    {
+      tableName: "biz_api_call_log",
+      freezeTableName: true,
+      timestamps: false,
+      underscored: true,
+    }
   );
   return biz_api_call_log;
 };

api/model/biz_api_token.js

@@ -31,6 +31,12 @@ module.exports = (db) => {
       expire_at: { type: Sequelize.DATE, allowNull: false },
       last_used_at: { type: Sequelize.DATE, allowNull: true },
     },
+    {
+      tableName: "biz_api_token",
+      freezeTableName: true,
+      timestamps: false,
+      underscored: true,
+    }
   );
   // biz_api_token.sync({ force: true });
   return biz_api_token;

api/model/biz_usage_monthly.js

@@ -29,6 +29,8 @@ module.exports = (db) => {
       },
     },
     {
+      tableName: "biz_usage_monthly",
+      freezeTableName: true,
       timestamps: false,
       underscored: true,
     }