fix(iam): 合伙人登录双拦截——子账号status=DISABLED 与主账号bindingStatus=PAUSED 均拒绝登录

fix(h5-partner): 微信OAuth回跳错误不再吞没，DISABLED提示可见
- 合伙人端 PartnerSessionContext 微信回跳 catch 原把后端「该账号已暂停使用，请联系客服人员」错误整体吞掉，导致 DISABLED 账号微信登录无任何反馈 - 改为用 toastError 显式提示，与短信路径一致（微信同理） Co-Authored-By: WorkBuddy <workbuddy@tencent.com>
2026-08-17 23:39:53 +08:00 · 2026-08-17 23:22:04 +08:00 · 2026-08-17 23:03:55 +08:00 · 2026-08-17 22:50:22 +08:00 · 2026-08-17 22:20:05 +08:00 · 2026-08-17 21:48:06 +08:00
13 changed files with 516 additions and 55 deletions
@@ -20,6 +20,7 @@ import {
 } from '../lib/api';
 import { fetchClientConfig, processPartnerWechatOAuthCallback } from '../lib/wechat-auth';
 import { isWechatEnv } from '../lib/weixin';
+import { toastError } from '../lib/toast';

 export type PartnerAccount = PartnerMe & {
  staffRole?: PartnerStaffRole;
@@ -115,7 +116,10 @@ export function PartnerSessionProvider({ children }: { children: ReactNode }) {
              }
              stripOAuthParamsFromLocation();
            }
-          } catch {
+          } catch (e) {
+            // 微信 OAuth 回跳后后端可能因账号暂停(DISABLED)等拒绝登录，
+            // 必须把错误显式提示出来，否则用户无任何反馈（与短信路径一致）。
+            toastError(e instanceof Error ? e.message : '微信登录失败');
            stripOAuthParamsFromLocation();
          }
        }
@@ -71,16 +71,24 @@ function formatPartnerError(e: unknown): string {
  if (text.includes('合伙人账号不存在') || text.includes('未找到合伙人账号')) {
    return '未找到合伙人账号';
  }
-  if (text.includes('合伙人账号已停用') || text.includes('账号已停用')) {
-    return '合伙人账号已暂停，无法登录';
+  if (
+    text.includes('合伙人账号已停用') ||
+    text.includes('账号已停用') ||
+    text.includes('暂停使用')
+  ) {
+    return '该账号已暂停使用，请联系客服人员';
  }
  return text;
 }

 function formatWechatError(e: unknown): string {
  const text = e instanceof Error ? e.message : '微信登录失败';
-  if (text.includes('合伙人账号已停用') || text.includes('账号已停用')) {
-    return '合伙人账号已暂停，无法登录';
+  if (
+    text.includes('合伙人账号已停用') ||
+    text.includes('账号已停用') ||
+    text.includes('暂停使用')
+  ) {
+    return '该账号已暂停使用，请联系客服人员';
  }
  if (text.includes('首次登录') || text.includes('手机验证码')) {
    return '该微信尚未绑定合伙人账号，请先使用手机验证码登录，登录后将自动关联微信';
@@ -112,6 +112,10 @@ export default function HomePage() {

  const [authError, setAuthError] = useState('');

+  const [showOpenModal, setShowOpenModal] = useState(false);
+
+  const [opening, setOpening] = useState(false);
+
  const pendingScanStartedRef = useRef(false);


@@ -309,6 +313,12 @@ export default function HomePage() {

    setScanMsg('');

+    // 门店临时闭店/休息中（非营业状态）时，点击扫码直接提示，不进入扫码流程
+    if (status !== 'OPEN') {
+      setShowOpenModal(true);
+      return;
+    }
+
    if (!isWechatEnv()) {

      setScanMsg('请在微信内打开门店端进行扫码核销');
@@ -349,6 +359,25 @@ export default function HomePage() {



+  async function openStoreAndContinue() {
+    if (opening) return;
+    setOpening(true);
+    try {
+      await request('SHOP_H5', '/shop/store/status', {
+        method: 'PUT',
+        body: JSON.stringify({ status: 'OPEN' }),
+      });
+      setShowOpenModal(false);
+      setScanMsg('');
+      void loadDashboard(); // 刷新门店状态为营业中，扫码按钮可再次使用
+    } catch (e) {
+      setShowOpenModal(false);
+      setScanMsg(e instanceof Error ? e.message : '开启营业失败');
+    } finally {
+      setOpening(false);
+    }
+  }
+
  async function startWechatAuth() {

    setAuthLoading(true);
@@ -615,6 +644,33 @@ export default function HomePage() {

      />

+      {showOpenModal && (
+        <div className="shop-redeem-modal" role="dialog" aria-modal="true">
+          <div className="shop-redeem-modal-card">
+            <h4 className="shop-redeem-modal-title">门店休息中</h4>
+            <p className="shop-redeem-modal-desc">门店目前休息中无法核销，是否开启营业？</p>
+            <div className="shop-redeem-modal-actions">
+              <button
+                type="button"
+                className="shop-redeem-modal-cancel"
+                disabled={opening}
+                onClick={() => setShowOpenModal(false)}
+              >
+                取消
+              </button>
+              <button
+                type="button"
+                className="shop-redeem-modal-confirm"
+                disabled={opening}
+                onClick={() => void openStoreAndContinue()}
+              >
+                {opening ? '开启中…' : '确认开启'}
+              </button>
+            </div>
+          </div>
+        </div>
+      )}
+
    </PullToRefresh>

  );
@@ -20,6 +20,8 @@ export default function PhoneRedeemPage() {
  const [msg, setMsg] = useState('');
  const [loading, setLoading] = useState(false);
  const [confirmCooldown, setConfirmCooldown] = useState(0);
+  const [showOpenModal, setShowOpenModal] = useState(false);
+  const [opening, setOpening] = useState(false);

  useEffect(() => {
    request<Record<string, unknown>>('SHOP_H5', '/shop/store')
@@ -36,15 +38,7 @@ export default function PhoneRedeemPage() {
    return () => window.clearTimeout(timer);
  }, [confirmCooldown]);

-  async function sendConfirmSms() {
-    if (!/^1\d{10}$/.test(phone.trim())) {
-      setMsg('请输入正确的手机号');
-      return;
-    }
-    if (storeClosed) {
-      setMsg('门店未营业，无法核销');
-      return;
-    }
+  async function prepareDirectRedeem() {
    const value = Number(amount);
    if (!Number.isFinite(value) || value <= 0) {
      setMsg('请输入有效核销金额');
@@ -69,6 +63,37 @@ export default function PhoneRedeemPage() {
    }
  }

+  async function sendConfirmSms() {
+    if (!/^1\d{10}$/.test(phone.trim())) {
+      setMsg('请输入正确的手机号');
+      return;
+    }
+    if (storeClosed) {
+      setShowOpenModal(true);
+      return;
+    }
+    await prepareDirectRedeem();
+  }
+
+  async function openStoreAndContinue() {
+    if (opening) return;
+    setOpening(true);
+    try {
+      await request('SHOP_H5', '/shop/store/status', {
+        method: 'PUT',
+        body: JSON.stringify({ status: 'OPEN' }),
+      });
+      setStoreClosed(false);
+      setShowOpenModal(false);
+      await prepareDirectRedeem();
+    } catch (e) {
+      setShowOpenModal(false);
+      setMsg(e instanceof Error ? e.message : '开启营业失败');
+    } finally {
+      setOpening(false);
+    }
+  }
+
  async function confirmRedeem() {
    if (!prepared) {
      setMsg('请先发送核销验证码');
@@ -114,7 +139,7 @@ export default function PhoneRedeemPage() {

      <main className="shop-redeem-main">
        {storeClosed && (
-          <p className="shop-redeem-error" style={{ marginBottom: 12 }}>门店当前未营业，无法核销</p>
+          <p className="shop-redeem-error" style={{ marginBottom: 12 }}>门店目前休息中无法核销，开启营业后可继续</p>
        )}

        <section className="shop-redeem-card">
@@ -181,7 +206,7 @@ export default function PhoneRedeemPage() {
                <button
                  type="button"
                  className="shop-phone-code-btn"
-                  disabled={loading || confirmCooldown > 0 || storeClosed || !canSendCode}
+                  disabled={loading || confirmCooldown > 0 || !canSendCode}
                  onClick={() => void sendConfirmSms()}
                >
                  {confirmCooldown > 0 ? `${confirmCooldown}s` : '发送验证码'}
@@ -205,6 +230,33 @@ export default function PhoneRedeemPage() {
          </div>
        </section>
      </main>
+
+      {showOpenModal && (
+        <div className="shop-redeem-modal" role="dialog" aria-modal="true">
+          <div className="shop-redeem-modal-card">
+            <h4 className="shop-redeem-modal-title">门店休息中</h4>
+            <p className="shop-redeem-modal-desc">门店目前休息中无法核销，是否开启营业？</p>
+            <div className="shop-redeem-modal-actions">
+              <button
+                type="button"
+                className="shop-redeem-modal-cancel"
+                disabled={opening}
+                onClick={() => setShowOpenModal(false)}
+              >
+                取消
+              </button>
+              <button
+                type="button"
+                className="shop-redeem-modal-confirm"
+                disabled={opening}
+                onClick={() => void openStoreAndContinue()}
+              >
+                {opening ? '开启中…' : '确认开启'}
+              </button>
+            </div>
+          </div>
+        </div>
+      )}
    </div>
  );
 }
@@ -29,6 +29,8 @@ export default function RedeemConfirmPage() {
  const [storeClosed, setStoreClosed] = useState(false);
  const [failCount, setFailCount] = useState(0);
  const [showWeakNet, setShowWeakNet] = useState(false);
+  const [showOpenModal, setShowOpenModal] = useState(false);
+  const [opening, setOpening] = useState(false);

  useEffect(() => {
    request<Record<string, unknown>>('SHOP_H5', '/shop/store')
@@ -48,34 +50,37 @@ export default function RedeemConfirmPage() {
    setToken(scanned);
  }, [searchParams, navigate]);

-  useEffect(() => {
+  async function loadPreview() {
    if (!token.trim()) {
      setPreview(null);
      return;
    }
-    request<Preview>('SHOP_H5', '/shop/redeem/preview', {
-      method: 'POST',
-      body: JSON.stringify({ token }),
-    })
-      .then(setPreview)
-      .catch(async (e) => {
-        setPreview(null);
-        setMsg(e instanceof Error ? e.message : '无法预览核销码');
-        const report = await reportRedeemFailure(token, 'preview', e);
-        if (report?.thresholdReached) {
-          setFailCount(report.failCount);
-          setShowWeakNet(true);
-        } else if (report) {
-          setFailCount(report.failCount);
-        }
+    try {
+      const p = await request<Preview>('SHOP_H5', '/shop/redeem/preview', {
+        method: 'POST',
+        body: JSON.stringify({ token }),
      });
+      setPreview(p);
+      setMsg('');
+    } catch (e) {
+      setPreview(null);
+      setMsg(e instanceof Error ? e.message : '无法预览核销码');
+      const report = await reportRedeemFailure(token, 'preview', e);
+      if (report?.thresholdReached) {
+        setFailCount(report.failCount);
+        setShowWeakNet(true);
+      } else if (report) {
+        setFailCount(report.failCount);
+      }
+    }
+  }
+
+  useEffect(() => {
+    void loadPreview();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
  }, [token]);

-  async function confirm() {
-    if (storeClosed) {
-      setMsg('门店未营业，无法核销');
-      return;
-    }
+  async function doConfirm() {
    if (!token.trim()) {
      setMsg('请先扫码获取核销码');
      return;
@@ -103,6 +108,36 @@ export default function RedeemConfirmPage() {
    }
  }

+  async function confirm() {
+    if (storeClosed) {
+      setShowOpenModal(true);
+      return;
+    }
+    await doConfirm();
+  }
+
+  async function openStoreAndContinue() {
+    if (opening) return;
+    setOpening(true);
+    try {
+      await request('SHOP_H5', '/shop/store/status', {
+        method: 'PUT',
+        body: JSON.stringify({ status: 'OPEN' }),
+      });
+      setStoreClosed(false);
+      setShowOpenModal(false);
+      setMsg('');
+      // 开张后重新拉取预览（门店已 OPEN，后端不再拦截），再继续核销
+      await loadPreview();
+      await doConfirm();
+    } catch (e) {
+      setShowOpenModal(false);
+      setMsg(e instanceof Error ? e.message : '开启营业失败');
+    } finally {
+      setOpening(false);
+    }
+  }
+
  const previewAmount = preview?.amount ?? 0;
  const userLabel = preview?.user?.nickname || preview?.user?.phone || '—';

@@ -117,7 +152,7 @@ export default function RedeemConfirmPage() {

      <main className="shop-redeem-main">
        {storeClosed && (
-          <p className="shop-redeem-error" style={{ marginBottom: 12 }}>门店当前未营业，无法核销</p>
+          <p className="shop-redeem-error" style={{ marginBottom: 12 }}>门店目前休息中无法核销，开启营业后可继续</p>
        )}
        <section className="shop-redeem-card">
          <div className="shop-redeem-banner">
@@ -189,13 +224,13 @@ export default function RedeemConfirmPage() {
                <button
                  type="button"
                  className={`shop-redeem-confirm-btn${loading ? ' success' : ''}`}
-                  disabled={loading || storeClosed || !preview}
+                  disabled={loading || (!preview && !storeClosed)}
                  onClick={() => void confirm()}
                >
                  <span className="material-symbols-outlined shop-fill-icon">
                    {loading ? 'sync' : 'check_circle'}
                  </span>
-                  <span>{loading ? '正在核销...' : preview ? `确认核销 ¥${formatAmount(previewAmount)}` : '加载中…'}</span>
+                  <span>{loading ? '正在核销...' : preview ? `确认核销 ¥${formatAmount(previewAmount)}` : storeClosed ? '确认核销' : '加载中…'}</span>
                </button>
                <p className="shop-redeem-hint">请核对金额后点击确认</p>
              </>
@@ -213,6 +248,33 @@ export default function RedeemConfirmPage() {
          </span>
        </div>
      </main>
+
+      {showOpenModal && (
+        <div className="shop-redeem-modal" role="dialog" aria-modal="true">
+          <div className="shop-redeem-modal-card">
+            <h4 className="shop-redeem-modal-title">门店休息中</h4>
+            <p className="shop-redeem-modal-desc">门店目前休息中无法核销，是否开启营业？</p>
+            <div className="shop-redeem-modal-actions">
+              <button
+                type="button"
+                className="shop-redeem-modal-cancel"
+                disabled={opening}
+                onClick={() => setShowOpenModal(false)}
+              >
+                取消
+              </button>
+              <button
+                type="button"
+                className="shop-redeem-modal-confirm"
+                disabled={opening}
+                onClick={() => void openStoreAndContinue()}
+              >
+                {opening ? '开启中…' : '确认开启'}
+              </button>
+            </div>
+          </div>
+        </div>
+      )}
    </div>
  );
 }
@@ -1519,6 +1519,7 @@
  z-index: 40;
  background: var(--color-surface);
  border-bottom: 1px solid var(--color-surface-container-highest);
+  padding: 0 var(--space-page);
 }

 .shop-records-range-tabs {
@@ -1897,8 +1898,8 @@
 }

 .shop-withdraw-btn {
-  width: 100%;
-  margin-top: 12px;
+  width: calc(100% - 2 * var(--space-page));
+  margin: 12px var(--space-page) 0;
  height: 44px;
  border: none;
  border-radius: 12px;
@@ -1916,11 +1917,80 @@

 .shop-withdraw-msg {
  margin-top: 10px;
+  padding: 0 var(--space-page);
  font-size: 13px;
  color: var(--color-aged-amber);
  text-align: center;
 }

+/* ─── 休息中核销·开张确认弹窗 ─── */
+.shop-redeem-modal {
+  position: fixed;
+  inset: 0;
+  z-index: 1000;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 24px;
+  background: rgba(0, 0, 0, 0.45);
+}
+
+.shop-redeem-modal-card {
+  width: 100%;
+  max-width: 320px;
+  background: var(--color-surface);
+  border-radius: var(--radius-lg, 16px);
+  padding: 24px;
+  box-shadow: 0 8px 30px rgba(0, 0, 0, 0.2);
+}
+
+.shop-redeem-modal-title {
+  margin: 0 0 8px;
+  font-family: var(--font-headline);
+  font-size: 17px;
+  font-weight: 600;
+  color: var(--color-on-surface);
+}
+
+.shop-redeem-modal-desc {
+  margin: 0 0 20px;
+  font-size: 14px;
+  line-height: 1.5;
+  color: var(--color-on-surface-variant);
+}
+
+.shop-redeem-modal-actions {
+  display: flex;
+  gap: 12px;
+}
+
+.shop-redeem-modal-cancel,
+.shop-redeem-modal-confirm {
+  flex: 1;
+  padding: 11px 0;
+  border: none;
+  border-radius: 999px;
+  font-size: 15px;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+.shop-redeem-modal-cancel {
+  background: var(--color-surface-container, #ececec);
+  color: var(--color-on-surface-variant);
+}
+
+.shop-redeem-modal-confirm {
+  background: var(--color-primary, #8b1a1a);
+  color: #fff;
+}
+
+.shop-redeem-modal-cancel:disabled,
+.shop-redeem-modal-confirm:disabled {
+  opacity: 0.6;
+  cursor: not-allowed;
+}
+
 /* ─── 门店套餐 ─── */
 .shop-packages-page .shop-records-main {
  padding-bottom: 24px;
@@ -7,8 +7,13 @@ type ProductCarouselProps = {
  alt: string;
  variant?: 'home' | 'detail' | 'store';
  previewable?: boolean;
-  /** cover=aspectFill 裁剪铺满；contain=aspectFit 缩放完整显示（门店门头固定区） */
-  imageFit?: 'cover' | 'contain';
+  /**
+   * cover=aspectFill 裁剪铺满（固定高度，可能裁切）
+   * contain=aspectFit 完整显示（固定高度，可能留白）
+   * adaptive=widthFix 按图片真实比例自适应高度，完整显示不裁剪（门店套餐详情用）
+   *   依赖 swiper 原生 auto-height：海报有多高，轮播就有多高，无裁切。
+   */
+  imageFit?: 'cover' | 'contain' | 'adaptive';
 };

 /** 商品/门店轮播（对齐 h5 ProductCarousel 三变体） */
@@ -24,7 +29,8 @@ export default function ProductCarousel({
  const prefix =
    variant === 'store' ? 'store-detail-carousel' : variant === 'home' ? 'home-carousel' : 'detail-carousel';
  const isContain = imageFit === 'contain';
-  const wrapClass = `${prefix}-wrap${isContain ? ` ${prefix}-wrap--contain` : ''}`;
+  const isAdaptive = imageFit === 'adaptive';
+  const wrapClass = `${prefix}-wrap${isContain ? ` ${prefix}-wrap--contain` : ''}${isAdaptive ? ` ${prefix}-wrap--adaptive` : ''}`;

  function previewAt(index: number) {
    const urls = slides.filter(Boolean);
@@ -38,6 +44,8 @@ export default function ProductCarousel({
      <Swiper
        className={prefix}
        circular={slides.length > 1}
+        autoHeight={isAdaptive}
+        {...(variant === 'detail' && slides.length > 1 ? { autoplay: true, interval: 3500 } : {})}
        onChange={(e) => setActiveIndex(e.detail.current)}
      >
        {slides.map((src, index) => (
@@ -46,7 +54,7 @@ export default function ProductCarousel({
              <Image
                className={`${prefix}-image`}
                src={src}
-                mode={isContain ? 'aspectFit' : 'aspectFill'}
+                mode={isAdaptive ? 'widthFix' : isContain ? 'aspectFit' : 'aspectFill'}
                alt={alt}
                onClick={previewable ? () => previewAt(index) : undefined}
              />
@@ -66,6 +74,9 @@ export default function ProductCarousel({
          ))}
        </View>
      ) : null}
+      {variant === 'detail' && slides.length > 1 ? (
+        <View className={`${prefix}-counter`}>{activeIndex + 1}/{slides.length}</View>
+      ) : null}
    </View>
  );
 }
@@ -26,7 +26,7 @@ function normalizeContactPhone(raw: string): string {
 }

 /**
- * 脱敏展示：手机 138****8000；座机保留区号，如 0379-****888。
+ * 脱敏展示：手机 138****8000；座机隐藏本地号中间四位，如 0379-12****78。
 * 门店详情电话展示用（拨号仍走 toDialablePhone 明文）。
 */
 export function maskPhone(phone: string) {
@@ -45,9 +45,16 @@ export function maskPhone(phone: string) {
    const areaLen = digits.startsWith('01') || digits.startsWith('02') ? 3 : 4;
    const area = digits.slice(0, areaLen);
    const local = digits.slice(areaLen);
-    const keepTail = Math.min(4, Math.max(2, local.length - 4));
-    const maskedLocal =
-      local.length <= 4 ? '*'.repeat(local.length) : `${'*'.repeat(local.length - keepTail)}${local.slice(-keepTail)}`;
+    // 隐藏本地号中间四位（保留区号，本号前后各留若干位）：0379-12345678 → 0379-12****78
+    let maskedLocal: string;
+    if (local.length <= 4) {
+      maskedLocal = '*'.repeat(local.length);
+    } else {
+      const keep = local.length - 4;
+      const head = Math.max(1, Math.floor(keep / 2));
+      const tail = keep - head;
+      maskedLocal = `${local.slice(0, head)}${'*'.repeat(4)}${local.slice(local.length - tail)}`;
+    }
    const joiner = main.includes('-') ? '-' : '';
    return ext ? `${area}${joiner}${maskedLocal}-${ext}` : `${area}${joiner}${maskedLocal}`;
  }
@@ -143,6 +143,7 @@ export default function StorePackageDetailPage() {
                alt={pkg.name}
                variant="detail"
                previewable
+                imageFit="adaptive"
              />
            </View>
          ) : null}
@@ -18,6 +18,19 @@
  overflow: hidden;
 }

+/* adaptive 模式（方案 A）：删除固定 1:1 比例与固定高度，
+   改用 swiper 原生 auto-height + image widthFix，海报有多高轮播就有多高，无裁切 */
+.detail-carousel-wrap--adaptive {
+  aspect-ratio: auto;
+  overflow: visible;
+}
+
+.detail-carousel-wrap--adaptive .detail-carousel,
+.detail-carousel-wrap--adaptive .detail-carousel-item,
+.detail-carousel-wrap--adaptive .detail-carousel-image {
+  height: auto;
+}
+
 .detail-carousel {
  width: 100%;
  height: 100%;
@@ -57,6 +70,20 @@
  background: var(--color-heritage-red);
 }

+.detail-carousel-counter {
+  position: absolute;
+  right: 12px;
+  bottom: 12px;
+  z-index: 2;
+  padding: 2px 10px;
+  font-size: 12px;
+  line-height: 1.5;
+  color: #fff;
+  background: rgba(0, 0, 0, 0.5);
+  border-radius: 999px;
+  pointer-events: none;
+}
+
 .product-detail-info {
  padding: var(--space-md) var(--space-page) var(--space-lg);
 }
@@ -74,6 +74,21 @@
  background: #fff;
 }

+/* 套餐详情图右下角 1/N 计数（detail 变体复用 .detail-carousel-counter） */
+.detail-carousel-counter {
+  position: absolute;
+  right: 12px;
+  bottom: 12px;
+  z-index: 2;
+  padding: 2px 10px;
+  font-size: 12px;
+  line-height: 1.5;
+  color: #fff;
+  background: rgba(0, 0, 0, 0.5);
+  border-radius: 999px;
+  pointer-events: none;
+}
+
 .store-detail-info-card {
  margin: 0 var(--space-page) 16px;
  position: relative;
@@ -304,12 +304,34 @@ export class AuthService {
    }
  }

+  /**
+   * 合伙人账号可登录态校验（统一闸门）：
+   * 1) 账号自身 status !== ACTIVE（DISABLED，含子账号）→ 拦截
+   * 2) 所属主账号 bindingStatus !== ACTIVE（PAUSED，城市合伙人绑定暂停）→ 拦截
+   * 子账号的绑定状态以父主账号为准。
+   */
+  private async assertPartnerAccountActive(account: {
+    id: bigint;
+    status: string;
+    isPrimary: number;
+    bindingStatus?: string | null;
+  }): Promise<void> {
+    if (account.status !== 'ACTIVE') {
+      throw new BadRequestException('该账号已暂停使用，请联系客服人员');
+    }
+    const primary =
+      account.isPrimary === 1 ? account : await this.resolvePrimaryAccount(account.id);
+    if (primary.bindingStatus && primary.bindingStatus !== 'ACTIVE') {
+      throw new BadRequestException('该合伙人合作已暂停，请联系客服人员');
+    }
+  }
+
  private async assertPartnerAccountByPhone(phone: string) {
    const account = await this.prisma.partnerAccount.findUnique({
      where: { phone },
    });
    if (!account) throw new BadRequestException('未找到合伙人账号');
-    if (account.status !== 'ACTIVE') throw new BadRequestException('合伙人账号已停用');
+    await this.assertPartnerAccountActive(account);
    return account;
  }

@@ -1061,7 +1083,7 @@ export class AuthService {
      where: { phone: normalizedPhone },
    });
    if (!account) throw new BadRequestException('未找到合伙人账号');
-    if (account.status !== 'ACTIVE') throw new BadRequestException('合伙人账号已停用');
+    await this.assertPartnerAccountActive(account);
    await this.syncTestFlagByPhone(normalizedPhone);
    const primary = await this.resolvePrimaryAccount(account.id);
    await this.prisma.partnerAccount.update({
@@ -1723,9 +1745,7 @@ export class AuthService {
      throw new BadRequestException('首次登录请使用手机验证码，登录后将自动关联微信');
    }

-    if (account.status !== 'ACTIVE') {
-      throw new BadRequestException('合伙人账号已停用');
-    }
+    await this.assertPartnerAccountActive(account);

    account = await this.prisma.partnerAccount.update({
      where: { id: account.id },
@@ -0,0 +1,128 @@
+# 杜康好客 · v3.4.18 门店体验与登录态优化
+
+> **2026-08-17** · mini-user `3.4.18` / h5-partner / h5-shop / API
+> 目标：用户小程序端门店电话与套餐图体验优化；城市合伙人「暂停」账号禁止登录；门店端结算页留白对齐与「休息中能否开张核销」交互。
+
+## 范围
+
+| 项 | 交付 |
+|----|------|
+| A. mini-user 门店座机电话脱敏 | `maskPhone` 统一「中间四位隐藏」；门店详情已调用 |
+| B. mini-user 套餐详情图 1/5 + 自动轮播 | `ProductCarousel` detail 变体 autoplay + 右下角 `1/5` 计数 |
+| C. 合伙人账号暂停禁止登录（双拦截） | 账号 `status=DISABLED` 或主账号 `bindingStatus=PAUSED` → 登录/发码/微信均拒，提示「该账号已暂停使用」或「该合伙人合作已暂停」 |
+| D. 门店端 申请提现 / 筛选栏留白对齐 | `WithdrawPage` 左右内边距统一 `--space-page` |
+| E. 门店端 门店休息中 → 是否开启营业 | 门店 PAUSED 时点击首页「扫码核销」即弹「是否开启营业？」，不进入扫码流程 |
+| F. mini-user 门店套餐图片自适应完整显示 | `ProductCarousel` 新增 `imageFit="adaptive"`（widthFix + 动态高度），门店套餐详情不再裁剪 |
+
+## A. mini-user 门店座机电话脱敏（中间四位隐藏）
+
+门店对外电话 `store.phone`（= `contactPhone ?? loginPhone`，见 `server/.../common/compat/v31-compat.ts` 的 `resolveStoreContactPhone`）在门店详情以「电话: {maskPhone(...)}」展示（`apps/mini-user/src/pages/store-detail/index.tsx` ~L393-402）。
+
+- 脱敏规则（座机）：`区号 + 本地号前 2 位 + **** + 本地号后 2 位`，隐藏本地号中间四位。
+  - `0379-12345678` → `0379-12****78`
+  - `010-87654321` → `010-87****21`
+  - 无分机同理；手机号仍按 `138****8000` 不变。
+- 实现点：`apps/mini-user/src/lib/phone.ts` 的 `maskPhone` 座机分支（当前保留末 2~4 位）→ 改为保留首 2 + 末 2、中间以 `****` 替代。
+- 拨号仍走 `toDialablePhone`（明文），不受脱敏影响。
+- 无 Prisma / API 变更；仅前端 `maskPhone` 规则调整。
+
+## B. mini-user 套餐详情图 1/5 计数 + 自动轮播
+
+入口：`apps/mini-user/src/pages/store-package-detail/index.tsx` 渲染
+`<ProductCarousel images={imageUrls} variant="detail" previewable />`，图片来自 `GET /stores/:id` 的 `packages[index].imageUrls`（最多 20 张，由 `normalizeStorePackageImageUrls` 归一化）。
+
+- 组件：`apps/mini-user/src/components/ProductCarousel.tsx`
+  - `variant='detail'` 时给 `<Swiper>` 增加 `autoplay` + `interval`（建议 3500ms），仅 `slides.length > 1` 时生效（现有 `circular` 已满足）。
+  - 右下角叠加分页计数：`${activeIndex + 1}/${slides.length}`（白底圆角胶囊，绝对定位于 `.detail-carousel-wrap` 右下角）；保留原居中圆点（dots）或改为以右下计数为主。
+  - 单图（`slides.length === 1`）不展示计数、不开轮播。
+- 图片容器 `.store-package-detail-gallery` 预留右下角定位锚点（如需）。
+- 无 API / schema 变更。
+
+## C. 合伙人账号暂停禁止登录（双拦截：账号停用 + 合伙人绑定暂停）
+
+> 两个状态字段、两个枚举，**不要混**：
+> | 维度 | 字段 | 枚举 | 取值 |
+> |------|------|------|------|
+> | 登录账号启用状态 | `partner_account.status` | `AccountStatus` | `ACTIVE` / `DISABLED` |
+> | 城市合伙人绑定状态 | `partner_account.bindingStatus` | `CityPartnerStatus` | `ACTIVE` / `PAUSED` |
+> 列表（`admin/partners`）里能看到的是 `bindingStatus`；主账号自身 `status` 不在列表返回体（仅子账号 `children[].status` 有）。
+
+- 拦截规则（**主账号、子账号都拦**）：
+  1. 登录账号自身 `status !== 'ACTIVE'`（`DISABLED`，主账号 / 子账号均适用）→ 抛 `该账号已暂停使用，请联系客服人员`。
+  2. 所属**主账号** `bindingStatus !== 'ACTIVE'`（`PAUSED`，城市合伙人绑定暂停）→ 抛 `该合伙人合作已暂停，请联系客服人员`。
+     - 子账号的绑定状态以其**父主账号**为准（`resolvePrimaryAccount`）。
+- 后端统一闸门：新增 `assertPartnerAccountActive(account)`（`auth.service.ts` ~L307 后），一次性校验以上两条；由以下入口复用：
+  - `assertPartnerAccountByPhone`（~L320）：被 `checkPartnerPhone`（`POST /partner/auth/phone/check`）、发码预检 `assertSmsSendAllowed`（PARTNER_LOGIN / PARTNER_PROXY_ORDER 场景）调用 → 暂停账号在「手机号校验」阶段即被拦截，无法获取短信验证码。
+  - `loginPartner`（`POST /partner/auth/login/sms`，~L1063 后）。
+  - `loginPartnerWechat`（`POST /partner/auth/login/wechat`，~L1726 后）。
+- 前端 `apps/h5-partner/src/pages/LoginPage.tsx`：
+  - `formatPartnerError`（~L69）/ `formatWechatError`（~L84）：命中「已暂停 / 已停用」分支映射 `该账号已暂停使用，请联系客服人员`；其余未匹配错误（含 `该合伙人合作已暂停…`）原样透出 `return text`。
+- 枚举现状：`AccountStatus`（`schema.prisma` ~L244）与 `CityPartnerStatus`（~L203）均为既有，本次**无任何 Prisma 迁移**。
+- 统一文案：
+  - 账号停用：`该账号已暂停使用，请联系客服人员`
+  - 合伙人绑定暂停：`该合伙人合作已暂停，请联系客服人员`
+
+## D. 门店端 申请提现 / 筛选栏左右留白对齐
+
+页面：`apps/h5-shop/src/pages/WithdrawPage.tsx`（门店管理 / 结算提现）。
+
+- 申请提现按钮 `.shop-withdraw-btn`（~L135）：当前 `width:100%; margin-top:12px`，置于 `.shop-records-main`（无左右 padding）内，贴边满宽。
+- 下方筛选栏 `.shop-records-filters`（~L147，`position: sticky; top:0`）与 `.shop-records-status-chips`：当前左右 `padding:0`，chips 贴屏幕边缘。
+- 同页 `.shop-records-summary` / `.shop-records-list` / `.shop-records-list-head` 均使用页面级 token `var(--space-page)` 左右内缩。
+- 改动：`.shop-records-filters` 增加 `padding: 0 var(--space-page)`（sticky 背景保留）；申请提现按钮区域同样左右内缩 `var(--space-page)`（或其父容器加 `padding: 0 var(--space-page)`），使其与上下组件留白一致。仅样式调整，无逻辑 / API 变更。
+
+## E. 门店端 休息中核销 → 是否开启营业
+
+现状：`PhoneRedeemPage.tsx` / `RedeemConfirmPage.tsx` 拉取 `GET /shop/store`，`status !== 'OPEN'` 时 `storeClosed=true`，核销前拦截并报「门店未营业，无法核销」（服务端 `server/.../modules/redeem/redeem.service.ts` 的 `loadOpenStoreAccount` ~L117 亦硬校验「门店未营业」）。
+
+- **前置拦截（主路径 · 门店端首页 `HomePage`）**：门店状态非 `OPEN`（PAUSED 临时闭店 / 休息中）时，用户点击首页「扫码核销」按钮**立即**弹确认框「门店目前休息中无法核销，是否开启营业？」，**不进入扫码流程**：
+  - 确认 → 调用 `PUT /shop/store/status { status: 'OPEN' }`，成功后关闭弹窗并 `loadDashboard()` 刷新门店状态为营业中，用户可再次点击扫码。
+  - 取消 → 关闭弹窗，维持拦截。
+- **确认页兜底（次路径 · `RedeemConfirmPage`）**：若直接带核销码进入确认页且门店仍非 `OPEN`，点击「确认核销」时同样弹「是否开启营业？」，开张后重新拉取预览并继续核销（`doConfirm`）。
+- 边界：门店 `auditStatus !== 'APPROVED'` 时 `updateShopStatus` 会拒绝开张（抛「门店尚在总部审核中 / 审核未通过」），前端需捕获并提示该错误，不进入误开启。
+- 适用页：`HomePage`（门店端首页扫码入口，PAUSED 时点击即弹窗）、`RedeemConfirmPage`（扫码核销确认页兜底）、`PhoneRedeemPage`（手机号核销）。
+- 后端无需改动（开张接口与硬校验已存在）。
+
+## 关键接口 / 文件
+
+| 位置 | 说明 |
+|------|------|
+| `apps/mini-user/src/lib/phone.ts` `maskPhone` | 座机脱敏规则改为「中间四位隐藏」 |
+| `apps/mini-user/src/pages/store-detail/index.tsx` | 门店详情电话展示（已用 maskPhone） |
+| `apps/mini-user/src/components/ProductCarousel.tsx` | detail 变体 autoplay + 右下 `1/5` 计数 |
+| `apps/mini-user/src/pages/store-package-detail/index.tsx` | 套餐详情图渲染 |
+| `GET /stores/:id` | 门店 / 套餐数据（无变更） |
+| `server/.../modules/iam/auth.service.ts` `loginPartner` / `assertPartnerAccountByPhone` / `assertSmsSendAllowed` | 合伙人登录 / 发码非 ACTIVE 抛「该账号已暂停使用，请联系客服人员」 |
+| `apps/h5-partner/src/pages/LoginPage.tsx` `formatPartnerError` / `formatWechatError` | 暂停文案 |
+| `apps/h5-shop/src/pages/WithdrawPage.tsx` + `styles.css` `.shop-records-filters` / `.shop-records-status-chips` / `.shop-withdraw-btn` | 左右留白对齐 `--space-page` |
+| `apps/h5-shop/src/pages/PhoneRedeemPage.tsx` / `RedeemConfirmPage.tsx` | 休息中弹「是否开启营业？」 |
+| `apps/h5-shop/src/pages/StatusPage.tsx` `requestToggle` / `confirmToggle` | 复用开张调用 |
+| `PUT /shop/store/status` `GET /shop/store` | 切换营业 / 读取门店（已存在） |
+
+## F. mini-user 门店套餐图片自适应完整显示（不裁剪）
+
+门店套餐详情（`apps/mini-user/src/pages/store-package-detail/index.tsx`）的 `ProductCarousel` 此前用 `variant="detail"` 默认 `imageFit="cover"`（= `aspectFill`），配合 `.detail-carousel-wrap` 的固定 `aspect-ratio: 1` 与 `overflow:hidden`，非正方形图片被裁切 → 用户反馈「图片没显示全」。
+
+- 新增 `imageFit="adaptive"` 模式（仅作用于门店套餐详情）：
+  - `Image` 改用 `mode="widthFix"`，按图片真实比例缩放、完整显示、不裁剪。
+  - 组件挂载时实测容器宽度（`Taro.createSelectorQuery().select('.detail-carousel-wrap--adaptive').boundingClientRect`），图片 `onLoad` 拿到自然宽高后按 `容器宽 × (自然高/自然宽)` 计算每张幻灯片渲染高度，赋给 `<Swiper>` 内联 `height`，实现轮播高度自适应（多图比例不一也能逐张适配，带 0.2s 过渡）。
+  - 未加载前兜底高度为 `容器宽 × 0.75`（约 3:4）。
+- 样式：`product-detail.css` 增加 `.detail-carousel-wrap--adaptive`，覆盖基类固定 `aspect-ratio:1` 与 `overflow:hidden`（`aspect-ratio:auto; overflow:visible`），并令 `.detail-carousel-image` 高度为 `auto`。
+- `autoplay`（3.5s）/ `1/5` 计数（feature B）在 adaptive 下保持不变。
+- 仅门店套餐详情传 `imageFit="adaptive"`；门店头图（`variant="store"` 仍 `contain`）、商品详情（`cover`）不受影响。
+
+## 验收
+
+- [ ] 门店详情座机显示形如 `0379-12****78`（中间四位隐藏），手机号仍 `138****8000`；拨打为明文。
+- [ ] 套餐详情图多张时右下角显示 `1/5` 分页计数，并自动轮播（约 3.5s 切换）；单图不计数、不轮播；点击仍可预览。
+- [ ] 合伙人**账号** `status=DISABLED`（主账号或子账号）时：短信登录与微信登录均被拦截，提示「该账号已暂停使用，请联系客服人员」，无法进入。
+- [ ] 合伙人**绑定** `bindingStatus=PAUSED`（主账号）时：无论用主账号还是其任一子账号登录，均被拦截，提示「该合伙人合作已暂停，请联系客服人员」。
+- [ ] 以上拦截在「手机号校验（`phone/check`）」阶段即生效，暂停账号拿不到短信验证码。
+- [ ] 门店管理（结算提现）页：申请提现按钮与筛选栏左右留白与其他区块一致（统一 `--space-page`），不再贴边。
+- [ ] 门店休息中（PAUSED）时：点击门店端首页「扫码核销」按钮**立即**弹「门店目前休息中无法核销，是否开启营业？」，**不进入扫码流程**；确认开启后门店状态刷新、可再次扫码；取消则维持拦截；未过审门店开张被拒时给出对应提示。
+- [ ] 门店套餐详情图片按真实比例完整显示、不再被裁切（轮播高度随图自适应）；自动轮播与 `1/5` 计数仍正常。
+- [ ] A 仅 `maskPhone` 规则、C/D/E 仅前端样式 / 交互；均无需 Prisma 迁移（C 复用 `DISABLED`）。
+
+## HQ 开发计划
+
+创建版本 `v3.4.18` 并关联本迭代任务；发版前再合并发布（mini-user 升 `3.4.18`）。
Author	SHA1	Message	Date
jacy	48d6900ab6	fix(iam): 合伙人登录双拦截——子账号status=DISABLED 与主账号bindingStatus=PAUSED 均拒绝登录 CI / verify (push) Has been cancelled Details	2026-08-17 23:39:53 +08:00
jacy	5ca9aa00aa	fix(h5-partner): 微信OAuth回跳错误不再吞没，DISABLED提示可见 CI / verify (push) Has been cancelled Details - 合伙人端 PartnerSessionContext 微信回跳 catch 原把后端「该账号已暂停使用，请联系客服人员」错误整体吞掉，导致 DISABLED 账号微信登录无任何反馈 - 改为用 toastError 显式提示，与短信路径一致（微信同理） Co-Authored-By: WorkBuddy <workbuddy@tencent.com>	2026-08-17 23:22:04 +08:00
jacy	c0d04ee500	fix(h5-shop): 门店 PAUSED 时点击扫码即弹窗，前置到首页 CI / verify (push) Has been cancelled Details - 门店临时闭店/休息中（非 OPEN）点击首页「扫码核销」立即弹「门店目前休息中无法核销，是否开启营业」，不进入扫码流程 - 开张成功后刷新门店状态，可再次扫码 - 修正此前“扫码后才提示”的方案偏差；文档 E 节同步更新 Co-Authored-By: WorkBuddy <workbuddy@tencent.com>	2026-08-17 23:03:55 +08:00
jacy	3ac008a217	fix(h5-shop): 修复闭店/休息中扫码核销弹窗不触发 CI / verify (push) Has been cancelled Details - 根因：门店非OPEN时后端 preview 拦截，preview 为 null 导致确认按钮 disabled，弹窗永远触发不了 - RedeemConfirmPage：storeClosed 时确认按钮可点→弹开张框；开张后重拉预览并继续核销 - 弹窗文案对齐「门店目前休息中无法核销，是否开启营业」 Co-Authored-By: WorkBuddy <workbuddy@tencent.com>	2026-08-17 22:50:22 +08:00
jacy	cd1e9ae488	refactor(mini-user): 门店套餐图改用 swiper auto-height 自适应（方案A） CI / verify (push) Has been cancelled Details - 移除手算高度逻辑，自适应模式启用 swiper 原生 autoHeight - image 保持 mode=widthFix，完整展示不裁切 - 删除 .detail-carousel-wrap 固定比例/高度的覆盖依赖 Co-Authored-By: WorkBuddy <workbuddy@tencent.com>	2026-08-17 22:20:05 +08:00
jacy	18147e157f	fix(mini-user): 门店套餐图片自适应完整显示，不再裁剪 CI / verify (push) Has been cancelled Details - ProductCarousel 新增 imageFit="adaptive"（widthFix + 动态高度） - 门店套餐详情按图片真实比例自适应高度，完整显示不裁剪 - 补充 v3.4.18 文档 F 项 Co-Authored-By: WorkBuddy <workbuddy@tencent.com>	2026-08-17 21:48:06 +08:00
jacy	f7c94b4f16	Merge commit '984dec79ee1944e2c21ed2e564cac09ae893afa3' into dev_jacy	2026-08-17 21:40:44 +08:00
jacy	cc750dc1d6	feat: v3.4.18 门店体验与登录态优化 - mini-user 门店座机电话中间四位脱敏（保留区号与前后位） - mini-user 套餐详情图增加 1/N 计数与自动轮播 - h5-partner 账号暂停(DISABLED)禁止登录并提示客服 - h5-shop 提现/筛选栏左右留白与页面一致 - h5-shop 休息中核销改为弹「是否开启营业」并支持开张后继续 Co-Authored-By: WorkBuddy <workbuddy@tencent.com>	2026-08-17 21:34:40 +08:00