推广码模块，在后端增加文案表达

apps/admin-web/src/pages/promo/PromoCodeDetailPage.tsx

@@ -37,8 +37,33 @@ const descContentStyle: CSSProperties = {
   wordBreak: 'break-all',
 };
 
+const SCAN_HINT =
+  '按人次累计：每次扫码或带参进入记一次，未登录也计入；同一用户多次进入记多次。同一次打开内的重复上报、以及登录后补归因不重复计。不是按人去重。';
+
 const ATTRIBUTION_HINT =
-  '首次触达本推广码的用户。每人只归因一次、只归一个码：已登录用户扫码或带参进入时，若还没有归因记录，则记到本码；之后再扫其他码不会改。与「扫码注册」不同：注册只统计来源仍是自然量并被标记为本码的用户；已有其他来源（如分享）的用户仍可计入归因，但不计入扫码注册。';
+  '首次触达本推广码的用户，按人计：每人只归因一次、只归一个码。已登录扫码时，若还没有归因记录则记到本码；未登录先扫码、登录后再补记。之后再扫其他码不会改。未登录连续扫多个码时，登录后归到最后一次缓存的码。与「扫码注册」不同：已有分享等其他来源的用户仍可计入归因，但不计入扫码注册。';
+
+const REGISTER_HINT =
+  '用户来源仍是自然量时，才标记为本推广码。已有分享等其他来源的用户不计入，因此通常小于或等于归因用户数。';
+
+const ORDER_HINT = '下单时绑定当时的归因推广码，仅统计已完成订单。';
+
+const CONVERSION_HINT =
+  '已完成订单数 ÷ 扫码进入次数（人次）。同一人多次扫码会放大分母，未登录扫码也计入。';
+
+function StatHint({ label, hint }: { label: string; hint: string }) {
+  return (
+    <span>
+      {label}
+      <Tooltip title={hint} overlayInnerStyle={{ maxWidth: 360 }}>
+        <QuestionCircleOutlined
+          style={{ marginLeft: 6, color: 'rgba(0,0,0,0.45)' }}
+          onClick={(e) => e.stopPropagation()}
+        />
+      </Tooltip>
+    </span>
+  );
+}
 
 async function downloadQrcode(url: string, filename: string) {
   try {
@@ -221,20 +246,16 @@ export default function PromoCodeDetailPage() {
             style={{ cursor: 'pointer' }}
             onClick={() => navigate(`/promo-codes/${detail.id}?eventType=SCAN`)}
           >
-            <Statistic title="扫码进入次数" value={stats?.scanCount ?? detail.scanCount} />
+            <Statistic
+              title={<StatHint label="扫码进入次数" hint={SCAN_HINT} />}
+              value={stats?.scanCount ?? detail.scanCount}
+            />
           </Card>
         </Col>
         <Col xs={12} sm={6}>
           <Card size="small">
             <Statistic
-              title={
-                <span>
-                  归因用户数
-                  <Tooltip title={ATTRIBUTION_HINT} overlayInnerStyle={{ maxWidth: 360 }}>
-                    <QuestionCircleOutlined style={{ marginLeft: 6, color: 'rgba(0,0,0,0.45)' }} />
-                  </Tooltip>
-                </span>
-              }
+              title={<StatHint label="归因用户数" hint={ATTRIBUTION_HINT} />}
               value={stats?.attributionCount ?? 0}
             />
           </Card>
@@ -242,7 +263,7 @@ export default function PromoCodeDetailPage() {
         <Col xs={12} sm={6}>
           <Card size="small">
             <Statistic
-              title="扫码注册用户数"
+              title={<StatHint label="扫码注册用户数" hint={REGISTER_HINT} />}
               value={stats?.registerCount ?? stats?.sourceMarkedCount ?? 0}
             />
           </Card>
@@ -255,14 +276,7 @@ export default function PromoCodeDetailPage() {
             onClick={() => navigate(`/orders?promoCodeId=${detail.id}&status=COMPLETED`)}
           >
             <Statistic
-              title={
-                <span>
-                  订单数
-                  <Tooltip title="仅统计已完成订单" overlayInnerStyle={{ maxWidth: 280 }}>
-                    <QuestionCircleOutlined style={{ marginLeft: 6, color: 'rgba(0,0,0,0.45)' }} />
-                  </Tooltip>
-                </span>
-              }
+              title={<StatHint label="订单数" hint={ORDER_HINT} />}
               value={stats?.orderCount ?? detail.orderCount}
             />
           </Card>
@@ -270,7 +284,7 @@ export default function PromoCodeDetailPage() {
         <Col xs={12} sm={6}>
           <Card size="small">
             <Statistic
-              title="转化率"
+              title={<StatHint label="转化率" hint={CONVERSION_HINT} />}
               value={promoConversion(stats?.scanCount ?? detail.scanCount, stats?.orderCount ?? detail.orderCount)}
             />
           </Card>