更新管理端用户详情弹窗，新增 VIP 手动设置功能，支持到期日、展示名、项目、联系方式和简介的编辑。优化 VIP 相关接口，确保用户状态和资料更新功能正常，增强用户体验。调整文档，明确 VIP 设置的必填项和格式要求。

soul-api/scripts/add-vip-activated-at.sql

@@ -0,0 +1,13 @@
+-- 新增 users.vip_activated_at：成为 VIP 时间，用于排序（后付款/后设置在前）
+-- 执行：mysql -u user -p database < add-vip-activated-at.sql
+-- 若列已存在会报错，可忽略
+
+ALTER TABLE users ADD COLUMN vip_activated_at DATETIME NULL COMMENT '成为VIP时间，付款=pay_time，手动=now，排序用';
+
+-- 可选：为已有 VIP 用户回填 vip_activated_at（取该用户最近一次 vip 订单的 pay_time）
+-- UPDATE users u
+-- SET u.vip_activated_at = (
+--   SELECT MAX(o.pay_time) FROM orders o
+--   WHERE o.user_id = u.id AND o.product_type = 'vip' AND o.status = 'paid'
+-- )
+-- WHERE u.is_vip = 1 AND u.vip_activated_at IS NULL;

soul-api/scripts/add-vip-roles-and-fields.sql

@@ -0,0 +1,25 @@
+-- 1. 新建 vip_roles 表
+CREATE TABLE IF NOT EXISTS vip_roles (
+  id INT AUTO_INCREMENT PRIMARY KEY,
+  name VARCHAR(50) NOT NULL UNIQUE COMMENT '角色名称',
+  sort INT DEFAULT 0 COMMENT '下拉展示顺序，越小越前',
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+) COMMENT '超级个体固定角色';
+
+-- 2. 插入默认角色（UNIQUE name 防重复）
+INSERT IGNORE INTO vip_roles (name, sort) VALUES
+  ('创始人', 1),
+  ('投资人', 2),
+  ('产品经理', 3),
+  ('技术负责人', 4),
+  ('运营总监', 5),
+  ('销售总监', 6),
+  ('市场总监', 7),
+  ('合伙人', 8),
+  ('顾问', 9),
+  ('品牌主理人', 10);
+
+-- 3. users 表新增 vip_sort、vip_role
+ALTER TABLE users ADD COLUMN vip_sort INT NULL COMMENT '手动排序，越小越前';
+ALTER TABLE users ADD COLUMN vip_role VARCHAR(50) NULL COMMENT '角色：从 vip_roles 选或手动填写';