feat(store): benefit coupon usage rules and show env photos on store detail

Add benefitUsageRule on store create/edit (HQ + partner) and C-end detail between intro and env gallery.

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

apps/admin-web/src/lib/storeCreate.ts

@@ -14,6 +14,7 @@ export type StoreCreateForm = {
   latitude?: number | null;
   longitude?: number | null;
   intro?: string;
+  benefitUsageRule?: string;
   openTime?: string;
   closeTime?: string;
   openTime2?: string;
@@ -48,6 +49,7 @@ export function validateStoreCreateStep1(
     | 'phone'
     | 'address'
     | 'intro'
+    | 'benefitUsageRule'
     | 'openTime'
     | 'closeTime'
     | 'openTime2'
@@ -88,6 +90,9 @@ export function validateStoreCreateStep1(
     const len = form.intro.trim().length;
     if (len < 2 || len > 500) return '门店简介须为 2~500 字';
   }
+  if (form.benefitUsageRule?.trim() && form.benefitUsageRule.trim().length > 1000) {
+    return '好客权益券使用规则最多 1000 字';
+  }
   return null;
 }
 

apps/admin-web/src/pages/StoresPage.tsx

@@ -504,6 +504,7 @@ export default function StoresPage() {
               }
             : {}),
           intro: values.intro?.trim() || undefined,
+          benefitUsageRule: values.benefitUsageRule?.trim() || undefined,
           openTime: values.openTime?.trim() || '10:00',
           closeTime: values.closeTime?.trim() || '22:00',
           ...(values.openTime2?.trim() && values.closeTime2?.trim()
@@ -585,6 +586,7 @@ export default function StoresPage() {
             name: d.name,
             phone: d.phone,
             intro: d.intro,
+            benefitUsageRule: d.benefitUsageRule,
             coverUrl: d.coverUrl,
             address: d.address,
             district: d.district,
@@ -688,6 +690,7 @@ export default function StoresPage() {
                 phone: v.phone,
                 coverUrl: v.coverUrl,
                 intro: v.intro,
+                benefitUsageRule: v.benefitUsageRule ?? null,
                 district: v.district,
                 address: v.address,
                 avgPrice: v.avgPrice,
@@ -797,7 +800,14 @@ export default function StoresPage() {
               <Form.Item name="coverUrl" label="封面图">
                 <OssUpload bizType="STORE_TITLE" mediaType="IMAGE" />
               </Form.Item>
-              <Form.Item name="intro" label="介绍"><Input.TextArea rows={4} /></Form.Item>
+              <Form.Item name="intro" label="介绍"><Input.TextArea rows={4} showCount maxLength={500} /></Form.Item>
+              <Form.Item
+                name="benefitUsageRule"
+                label="好客权益券使用规则"
+                extra="展示在用户端门店详情「门店详情」下方"
+              >
+                <Input.TextArea rows={4} placeholder="选填，最多1000字" showCount maxLength={1000} />
+              </Form.Item>
               <Form.Item name="district" label="区县"><Input /></Form.Item>
               <Form.Item name="address" label="详细地址"><Input /></Form.Item>
               <Space wrap style={{ width: '100%' }}>
@@ -1031,6 +1041,13 @@ export default function StoresPage() {
               <Form.Item name="intro" label="门店简介">
                 <Input.TextArea rows={3} placeholder="选填，2~500字" showCount maxLength={500} />
               </Form.Item>
+              <Form.Item
+                name="benefitUsageRule"
+                label="好客权益券使用规则"
+                extra="展示在用户端门店详情"
+              >
+                <Input.TextArea rows={3} placeholder="选填，最多1000字" showCount maxLength={1000} />
+              </Form.Item>
           </div>
           <div style={{ display: createStep === 1 ? 'block' : 'none' }}>
               <Typography.Paragraph type="secondary">

apps/h5-partner/src/lib/storeDraft.ts

@@ -22,6 +22,8 @@ export type StoreDraftForm = {
   categoryParentId: string;
   categoryId: string;
   intro: string;
+  /** 好客权益券使用规则 */
+  benefitUsageRule: string;
   coverUrl: string;
   envPhotoUrls: string[];
   contractUrl: string;
@@ -61,6 +63,7 @@ export const defaultStoreForm = (): StoreDraftForm => ({
   categoryParentId: '',
   categoryId: '',
   intro: '',
+  benefitUsageRule: '',
   coverUrl: '',
   envPhotoUrls: ['', '', ''],
   contractUrl: '',
@@ -155,6 +158,7 @@ export function validateStoreStep1(
     | 'avgPrice'
     | 'categoryId'
     | 'intro'
+    | 'benefitUsageRule'
   >,
 ): string | null {
   if (!form.regionCodes || form.regionCodes.length < 3) return '请选择省 / 市 / 区县';
@@ -185,10 +189,13 @@ export function validateStoreStep1(
     if (Number.isNaN(n) || n < 0) return '人均费用须为非负数字';
   }
   if (!form.categoryId.trim()) return '请选择店铺类型';
-    if (form.intro.trim()) {
-      const len = form.intro.trim().length;
-      if (len < 2 || len > 500) return '门店简介须为 2~500 字';
-    }
+  if (form.intro.trim()) {
+    const len = form.intro.trim().length;
+    if (len < 2 || len > 500) return '门店简介须为 2~500 字';
+  }
+  if (form.benefitUsageRule.trim().length > 1000) {
+    return '好客权益券使用规则最多 1000 字';
+  }
   return null;
 }
 

apps/h5-partner/src/pages/StoreCreatePage.tsx

@@ -536,6 +536,7 @@ export default function StoreCreatePage() {
           categoryId: form.categoryId.trim(),
 
           intro: form.intro.trim() || undefined,
+          benefitUsageRule: form.benefitUsageRule.trim() || undefined,
 
           coverUrl: form.coverUrl.trim() || undefined,
 
@@ -936,6 +937,26 @@ export default function StoreCreatePage() {
 
             </div>
 
+            <div className="partner-field">
+
+              <label>好客权益券使用规则</label>
+
+              <textarea
+                rows={4}
+                placeholder="选填，展示在用户端门店详情，最多1000字"
+                maxLength={1000}
+                value={form.benefitUsageRule}
+                onChange={(e) => patchForm({ benefitUsageRule: e.target.value })}
+              />
+
+              <div style={{ textAlign: 'right', marginTop: 4 }}>
+
+                <span className="label-md text-muted">{form.benefitUsageRule.length} / 1000</span>
+
+              </div>
+
+            </div>
+
           </section>
 
           <div className="partner-info-banner">

apps/h5-partner/src/pages/StoreDetailPage.tsx

@@ -45,6 +45,7 @@ export default function StoreDetailPage() {
     phone: '',
     address: '',
     intro: '',
+    benefitUsageRule: '',
     latitude: '',
     longitude: '',
   });
@@ -66,6 +67,7 @@ export default function StoreDetailPage() {
       phone: String(data.phone || ''),
       address: String(data.address || ''),
       intro: String(data.intro || ''),
+      benefitUsageRule: String(data.benefitUsageRule || ''),
       latitude: data.latitude != null && data.latitude !== '' ? String(data.latitude) : '',
       longitude: data.longitude != null && data.longitude !== '' ? String(data.longitude) : '',
     });
@@ -162,6 +164,7 @@ export default function StoreDetailPage() {
           phone: form.phone.trim(),
           address: form.address.trim(),
           intro: form.intro.trim(),
+          benefitUsageRule: form.benefitUsageRule.trim() || null,
           ...(form.latitude.trim() && form.longitude.trim()
             ? {
                 latitude: Number(form.latitude),
@@ -396,6 +399,20 @@ export default function StoreDetailPage() {
               <span className="label-md text-muted">{form.intro.length} / 500</span>
             </div>
           </div>
+          <div className="partner-field">
+            <label>好客权益券使用规则</label>
+            <textarea
+              disabled={readOnly}
+              rows={4}
+              placeholder="选填，展示在用户端门店详情，最多1000字"
+              maxLength={1000}
+              value={form.benefitUsageRule}
+              onChange={(e) => setForm({ ...form, benefitUsageRule: e.target.value })}
+            />
+            <div style={{ textAlign: 'right', marginTop: 4 }}>
+              <span className="label-md text-muted">{form.benefitUsageRule.length} / 1000</span>
+            </div>
+          </div>
         </section>
 
         <section className="partner-form-card" style={{ margin: '0 0 16px' }}>

apps/mini-user/src/pages/store-detail/index.tsx

@@ -29,6 +29,7 @@ type Store = {
   district?: string;
   phone?: string;
   intro?: string | null;
+  benefitUsageRule?: string | null;
   coverUrl?: string | null;
   carouselUrls?: string[] | null;
   media?: StoreMedia[] | null;
@@ -173,6 +174,7 @@ export default function StoreDetailPage() {
   ]);
 
   const intro = store.intro?.trim() || '';
+  const benefitRule = store.benefitUsageRule?.trim() || '';
 
   function previewEnv(index: number) {
     if (!envPhotos.length) return;
@@ -248,6 +250,13 @@ export default function StoreDetailPage() {
         </View>
       ) : null}
 
+      {benefitRule ? (
+        <View className="store-detail-section">
+          <Text className="store-detail-section-title">好客权益券使用规则</Text>
+          <Text className="store-detail-intro">{benefitRule}</Text>
+        </View>
+      ) : null}
+
       {envPhotos.length > 0 ? (
         <View className="store-detail-section">
           <Text className="store-detail-section-title">店内环境</Text>