初始化

缺陷：主题配色需要优化整体的同风格

.cursor/rules/Database-SQL.mdc

@@ -0,0 +1,27 @@
+---
+description: 数据库变更一律走按日 SQL 目录，禁止新建 PHP Migration
+alwaysApply: true
+---
+
+# 数据库变更约定（lgp-admin-plus-api）
+
+## 强制
+
+- **禁止**为表结构变更新建 `database/migrations/*.php`
+- **一律**落在：
+
+```
+database/sql/<YYYY-MM-DD>/01_简短英文名.sql
+database/sql/<YYYY-MM-DD>/02_....sql
+```
+
+- 当天目录不存在则新建；序号从 `01` 递增
+- 脚本尽量幂等（查 `information_schema` + `PREPARE`）
+- 系统表（`nl_*`）若影响全新安装：同步改 `public/nl_admin.sql`
+- 业务表（`cc_*`）：只写 `database/sql/`，**不进** `nl_admin.sql`
+- 上线由运维在目标库手工执行对应日期目录下的 SQL
+
+## 反例
+
+- `php artisan make:migration add_xxx_to_yyy` → 不要
+- 把 DDL 塞进 Seeder / 业务代码里临时跑 → 不要

database/sql/2026-08-14/01_cc_carousel_add_status.sql

@@ -0,0 +1,15 @@
+-- ============================================================
+-- cc_carousel 补 status 列（幂等）
+-- 新后台 CRUD / 启停开关依赖此列；老表从未有 status
+-- ============================================================
+
+SET @db := DATABASE();
+SET @exists := (
+    SELECT COUNT(*) FROM information_schema.COLUMNS
+    WHERE TABLE_SCHEMA = @db AND TABLE_NAME = 'cc_carousel' AND COLUMN_NAME = 'status'
+);
+SET @sql := IF(@exists = 0,
+    'ALTER TABLE `cc_carousel` ADD COLUMN `status` tinyint(1) NOT NULL DEFAULT 0 COMMENT ''状态 0显示 1隐藏'' AFTER `sort`',
+    'SELECT ''skip cc_carousel.status'' AS msg'
+);
+PREPARE stmt FROM @sql; EXECUTE stmt; DEALLOCATE PREPARE stmt;

database/sql/2026-08-14/02_nl_wx_app_create.sql

@@ -0,0 +1,36 @@
+-- ============================================================
+-- nl_wx_app 小程序应用配置表（幂等）
+-- 与 public/nl_admin.sql 末尾建表等价；已装库可单独执行本文件补表
+-- AppSecret 等敏感字段由后台加密入库，不要在本文件写明文密钥
+-- ============================================================
+
+SET @db := DATABASE();
+SET @exists := (
+    SELECT COUNT(*) FROM information_schema.TABLES
+    WHERE TABLE_SCHEMA = @db AND TABLE_NAME = 'nl_wx_app'
+);
+SET @sql := IF(@exists = 0,
+    'CREATE TABLE `nl_wx_app` (
+      `id` int UNSIGNED NOT NULL AUTO_INCREMENT,
+      `code` varchar(20) NOT NULL DEFAULT '''' COMMENT ''品牌标识 brm/wl'',
+      `name` varchar(50) NOT NULL DEFAULT '''',
+      `app_id` varchar(50) NOT NULL DEFAULT '''',
+      `app_secret` varchar(255) NOT NULL DEFAULT '''' COMMENT ''密文存储'',
+      `mch_id` varchar(50) NOT NULL DEFAULT '''' COMMENT ''微信支付商户号'',
+      `mch_key` varchar(255) NOT NULL DEFAULT '''' COMMENT ''APIv3 密钥，密文存储'',
+      `mch_serial_no` varchar(100) NOT NULL DEFAULT '''' COMMENT ''商户证书序列号'',
+      `mch_private_key` text NULL COMMENT ''商户私钥，密文存储'',
+      `platform_public_key` text NULL COMMENT ''微信支付平台证书公钥'',
+      `notify_url` varchar(255) NOT NULL DEFAULT '''' COMMENT ''支付回调地址'',
+      `template_code` varchar(50) NOT NULL DEFAULT '''' COMMENT ''默认装修模板 code'',
+      `status` tinyint NOT NULL DEFAULT 0 COMMENT ''0=启用 1=停用'',
+      `remark` varchar(255) NOT NULL DEFAULT '''',
+      `created_at` int NOT NULL DEFAULT 0,
+      `updated_at` int NOT NULL DEFAULT 0,
+      `deleted_at` int NOT NULL DEFAULT 0,
+      PRIMARY KEY (`id`) USING BTREE,
+      UNIQUE INDEX `uk_wx_app_code`(`code` ASC) USING BTREE
+    ) ENGINE = InnoDB CHARACTER SET = utf8mb4 COLLATE = utf8mb4_0900_ai_ci COMMENT = ''小程序应用配置'' ROW_FORMAT = DYNAMIC',
+    'SELECT ''skip nl_wx_app (already exists)'' AS msg'
+);
+PREPARE stmt FROM @sql; EXECUTE stmt; DEALLOCATE PREPARE stmt;

database/sql/2026-08-14/03_cc_wx_user_template_code.sql

@@ -0,0 +1,15 @@
+-- ============================================================
+-- cc_wx_user 补 template_code：经销商可绑定专属装修模板（幂等）
+-- 空字符串 = 跟随品牌默认模板
+-- ============================================================
+
+SET @db := DATABASE();
+SET @exists := (
+    SELECT COUNT(*) FROM information_schema.COLUMNS
+    WHERE TABLE_SCHEMA = @db AND TABLE_NAME = 'cc_wx_user' AND COLUMN_NAME = 'template_code'
+);
+SET @sql := IF(@exists = 0,
+    'ALTER TABLE `cc_wx_user` ADD COLUMN `template_code` varchar(50) NOT NULL DEFAULT '''' COMMENT ''经销商专属装修模板 code，空=跟随品牌默认'' AFTER `price_number`',
+    'SELECT ''skip cc_wx_user.template_code'' AS msg'
+);
+PREPARE stmt FROM @sql; EXECUTE stmt; DEALLOCATE PREPARE stmt;

database/sql/2026-08-14/04_nl_menu_dealer.sql

@@ -0,0 +1,50 @@
+-- ============================================================
+-- 菜单：客户中心下增加「经销商管理」（幂等）
+-- component/path 对齐前端 views/customer/dealer
+-- keep_alive：0=开启缓存；affix_tab：0=固定（输出到前端 meta 时取反）
+-- 注意：nl_menu 无 type/status 列，勿照搬其它脚手架字段
+-- ============================================================
+
+SET @db := DATABASE();
+SET @parent_id := (
+    SELECT id FROM nl_menu WHERE name = 'Customer' AND deleted_at = 0 LIMIT 1
+);
+
+SET @exists := (
+    SELECT COUNT(*) FROM nl_menu
+    WHERE name = 'CustomerDealer' AND deleted_at = 0
+);
+
+-- 插在「微信用户」后：sort=1；企业管理及之后在 menu-sync / 手工时再调序
+SET @sql := IF(@parent_id IS NOT NULL AND @exists = 0,
+    CONCAT(
+        'INSERT INTO `nl_menu` (`title`,`icon`,`name`,`path`,`component`,`redirect`,`keep_alive`,`hide_in_menu`,`affix_tab`,`badge`,`badge_type`,`badge_variants`,`iframe_src`,`pid`,`sort`,`query`,`created_at`,`updated_at`,`deleted_at`) VALUES (',
+        '''经销商管理'', ''lucide:handshake'', ''CustomerDealer'', ''/customer/dealer'', ''/customer/dealer/index'', '''', 1, 0, 1, '''', 0, 0, '''', ',
+        @parent_id,
+        ', 1, '''', UNIX_TIMESTAMP(), UNIX_TIMESTAMP(), 0)'
+    ),
+    'SELECT ''skip menu CustomerDealer'' AS msg'
+);
+PREPARE stmt FROM @sql; EXECUTE stmt; DEALLOCATE PREPARE stmt;
+
+-- 与 lgp_menu 口径一致：企业/清单/订单 sort 后移（仅当经销商菜单刚存在时幂等更新）
+UPDATE `nl_menu` SET `sort` = 2, `updated_at` = UNIX_TIMESTAMP()
+WHERE `name` = 'CustomerEnterprise' AND `deleted_at` = 0 AND `sort` < 2;
+UPDATE `nl_menu` SET `sort` = 3, `updated_at` = UNIX_TIMESTAMP()
+WHERE `name` = 'CustomerList' AND `deleted_at` = 0 AND `sort` < 3;
+UPDATE `nl_menu` SET `sort` = 4, `updated_at` = UNIX_TIMESTAMP()
+WHERE `name` = 'CustomerOrder' AND `deleted_at` = 0 AND `sort` < 4;
+
+-- 凡已拥有「微信用户」菜单的角色，同步挂上「经销商管理」（幂等）
+SET @menu_id := (SELECT id FROM nl_menu WHERE name = 'CustomerDealer' AND deleted_at = 0 LIMIT 1);
+SET @wx_user_menu_id := (SELECT id FROM nl_menu WHERE name = 'CustomerWxUser' AND deleted_at = 0 LIMIT 1);
+INSERT INTO `nl_role_menu_relations` (`role_id`, `menu_id`, `created_at`)
+SELECT r.role_id, @menu_id, UNIX_TIMESTAMP()
+FROM `nl_role_menu_relations` r
+WHERE @menu_id IS NOT NULL
+  AND @wx_user_menu_id IS NOT NULL
+  AND r.menu_id = @wx_user_menu_id
+  AND NOT EXISTS (
+      SELECT 1 FROM `nl_role_menu_relations` x
+      WHERE x.role_id = r.role_id AND x.menu_id = @menu_id
+  );

database/sql/2026-08-14/05_cc_category_add_sort.sql

@@ -0,0 +1,23 @@
+-- ============================================================
+-- cc_category 补 sort：分类排序（幂等）
+-- 数字越小越靠前；首次加列后若全为 0，用 id 回填保持原顺序
+-- ============================================================
+
+SET @db := DATABASE();
+SET @exists := (
+    SELECT COUNT(*) FROM information_schema.COLUMNS
+    WHERE TABLE_SCHEMA = @db AND TABLE_NAME = 'cc_category' AND COLUMN_NAME = 'sort'
+);
+SET @sql := IF(@exists = 0,
+    'ALTER TABLE `cc_category` ADD COLUMN `sort` int NOT NULL DEFAULT 0 COMMENT ''排序，数字越小越靠前'' AFTER `pid`',
+    'SELECT ''skip cc_category.sort'' AS msg'
+);
+PREPARE stmt FROM @sql; EXECUTE stmt; DEALLOCATE PREPARE stmt;
+
+-- 仅当尚无任何非 0 排序值时回填（避免重复执行覆盖手工排序）
+SET @has_custom := (SELECT COUNT(*) FROM `cc_category` WHERE `sort` <> 0);
+SET @sql2 := IF(@has_custom = 0,
+    'UPDATE `cc_category` SET `sort` = `id`',
+    'SELECT ''skip cc_category.sort backfill'' AS msg'
+);
+PREPARE stmt2 FROM @sql2; EXECUTE stmt2; DEALLOCATE PREPARE stmt2;