feat(mini-user): add configurable home banner and footer

HQ system settings WeChat mini config with OSS swiper/footer uploads; client-config exposes miniHome.

Co-authored-by: Cursor <cursoragent@cursor.com>

server/dukang-api/src/common/system-config/system-config.registry.ts

@@ -5,6 +5,7 @@ export const SYSTEM_CONFIG_GROUPS: SystemConfigGroupMeta[] = [
   { key: 'feature', label: '功能开关' },
   { key: 'sms', label: '短信' },
   { key: 'wechat', label: '微信' },
+  { key: 'wechat_mini', label: '微信小程序配置' },
   { key: 'oss', label: '对象存储 OSS' },
   { key: 'app', label: '应用链接' },
   { key: 'deploy', label: '发布部署' },
@@ -14,6 +15,7 @@ const G = {
   feature: 'feature',
   sms: 'sms',
   wechat: 'wechat',
+  wechat_mini: 'wechat_mini',
   oss: 'oss',
   app: 'app',
   deploy: 'deploy',
@@ -66,6 +68,23 @@ export const SYSTEM_CONFIG_FIELDS: SystemConfigFieldMeta[] = [
   { key: 'WX_PLATFORM_CERT', label: '微信平台公钥证书', group: G.wechat, type: 'textarea', secret: true, requiresRestart: true },
   { key: 'WX_PAY_NOTIFY_URL', label: '支付回调 URL', group: G.wechat, type: 'string', requiresRestart: false },
 
+  {
+    key: 'MINI_HOME_BANNERS',
+    label: '首页轮播图',
+    group: G.wechat_mini,
+    type: 'imageList',
+    requiresRestart: false,
+    description: '小程序商品首页顶部轮播，建议比例 15:8，最多 8 张',
+  },
+  {
+    key: 'MINI_HOME_FOOTER_URL',
+    label: '首页底部图',
+    group: G.wechat_mini,
+    type: 'image',
+    requiresRestart: false,
+    description: '小程序商品首页底部 footer，建议比例 15:4',
+  },
+
   { key: 'OSS_ACCESS_KEY_ID', label: 'OSS AccessKey ID', group: G.oss, type: 'password', secret: true, requiresRestart: true },
   { key: 'OSS_ACCESS_KEY_SECRET', label: 'OSS AccessKey Secret', group: G.oss, type: 'password', secret: true, requiresRestart: true },
   { key: 'OSS_BUCKET', label: 'OSS Bucket', group: G.oss, type: 'string', requiresRestart: true },

server/dukang-api/src/modules/common/client-config.controller.ts

@@ -1,4 +1,5 @@
 import { Controller, Get } from '@nestjs/common';
+import { parseMiniHomeBanners } from '@dukang/shared-types';
 import { SystemConfigService } from '../../common/system-config/system-config.service';
 
 @Controller('common')
@@ -8,12 +9,18 @@ export class ClientConfigController {
   @Get('client-config')
   clientConfig() {
     const cfg = this.systemConfig.getAppConfig();
+    const env = this.systemConfig.getMergedEnv();
+    const footer = (env.MINI_HOME_FOOTER_URL ?? '').trim();
     return {
       mockPay: cfg.mockPay,
       wechatPayEnabled: cfg.wechatPayEnabled,
       mockSms: cfg.mockSms,
       mockWechat: cfg.mockWechat,
       wxAuthorize: cfg.wxAuthorize,
+      miniHome: {
+        banners: parseMiniHomeBanners(env.MINI_HOME_BANNERS),
+        footerUrl: footer || null,
+      },
     };
   }
 }