feat: inherit channel report requirements

src/apps/admin/AdminEnterpriseSignaturesPage.tsx

@@ -1,6 +1,6 @@
 import { useEffect, useMemo, useState } from 'react';
 import { ChevronDown, ChevronRight, Edit3, FileText, Info, Plus, Search, Trash2, Upload } from 'lucide-react';
-import { adminApi, type ClientSmsApplication, type ClientSmsSignature, type FileRef, type TenantOption } from '@/api/adminApi';
+import { adminApi, type ApplicationReportField, type ClientSmsApplication, type ClientSmsSignature, type FileRef, type TenantOption } from '@/api/adminApi';
 import { Breadcrumb, Button, FileActions, Input, Modal, Pagination, Select, Tabs, Tag, Textarea } from '@/components/ui';
 import { displayFileName } from '@/utils/fileName';
 import { formatDateTime } from '@/utils/dateTime';
@@ -26,9 +26,11 @@ type DrainageInfo = {
   telecom: CarrierStatus;
   submittedAt: string;
   remark: string;
+  reportValues: ReportValues;
 };
 
 type UploadedFileRef = FileRef;
+type ReportValues = Record<string, string | UploadedFileRef | null>;
 
 type SignatureProfile = {
   basis: string;
@@ -55,6 +57,7 @@ type SignatureFormState = {
   mobile: CarrierStatus;
   unicom: CarrierStatus;
   telecom: CarrierStatus;
+  reportValues: ReportValues;
 };
 
 const statusLabelMap: Record<CarrierStatus, string> = {
@@ -88,6 +91,7 @@ function readDrainagePayload(signature: ClientSmsSignature) {
       telecom: normalizeCarrierStatus(carrierStatus.telecom, fallbackStatus),
     },
     signatureProfile: normalizeSignatureProfile(profile, signature),
+    signatureReportValues: normalizeReportValues(payload.signatureReportValues),
     links: links.map((item) => ({
       id: String(item.id ?? `drain-${Date.now()}`),
       siteName: String(item.siteName ?? ''),
@@ -107,12 +111,22 @@ function readDrainagePayload(signature: ClientSmsSignature) {
       telecom: normalizeCarrierStatus(item.telecom, 'filing'),
       submittedAt: String(item.submittedAt ?? ''),
       remark: String(item.remark ?? ''),
+      reportValues: normalizeReportValues(item.reportValues),
     })),
   };
 }
 
-function buildDrainagePayload(carrierStatus: { mobile: CarrierStatus; unicom: CarrierStatus; telecom: CarrierStatus }, links: DrainageInfo[], signatureProfile?: SignatureProfile) {
-  return { carrierStatus, links, signatureProfile };
+function buildDrainagePayload(carrierStatus: { mobile: CarrierStatus; unicom: CarrierStatus; telecom: CarrierStatus }, links: DrainageInfo[], signatureProfile?: SignatureProfile, signatureReportValues?: ReportValues) {
+  return { carrierStatus, links, signatureProfile, signatureReportValues };
+}
+
+function normalizeReportValues(value: unknown): ReportValues {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return {};
+  return Object.fromEntries(Object.entries(value as Record<string, unknown>).map(([key, item]) => [key, normalizeUploadedFile(item) ?? String(item ?? '')]));
+}
+
+function hasMissingRequiredReportValue(fields: ApplicationReportField[], values: ReportValues) {
+  return fields.some((field) => field.required && !values[field.code]);
 }
 
 function normalizeUploadedFile(value: unknown): UploadedFileRef | null {
@@ -224,6 +238,67 @@ function SignatureUploadBox({
   );
 }
 
+function DynamicReportFields({ fields, onChange, title, values }: { fields: ApplicationReportField[]; onChange: (code: string, value: string | UploadedFileRef | null) => void; title: string; values: ReportValues }) {
+  const [explanationOpen, setExplanationOpen] = useState(false);
+  if (fields.length === 0) return null;
+  const channels = Array.from(new Map(fields.flatMap((field) => field.channels).map((channel) => [channel.id, channel])).values());
+  const groups = Array.from(new Map(channels.map((channel) => [channel.groupId, channel.groupName])).entries());
+  const requiredCount = fields.filter((field) => field.required).length;
+  return (
+    <section>
+      <div className="report-requirement-heading">
+        <h3>{title}</h3>
+        <Button icon={<Info size={15} />} onClick={() => setExplanationOpen(true)} size="sm" variant="ghost">为什么需要这些资料？</Button>
+      </div>
+      <div className="signature-alert">
+        <Info size={18} />
+        <span>当前要求由 {groups.length} 个通道组、{channels.length} 个通道合并生成，共 {fields.length} 项，其中 {requiredCount} 项必填。保存时会固化本次要求快照。</span>
+      </div>
+      <div className="signature-form-grid">
+        {fields.map((field) => {
+          const channelHint = field.channels.map((channel) => channel.name).join('、');
+          const requiredChannels = field.required ? field.channels.filter((channel) => channel.required).map((channel) => channel.name).join('、') : '';
+          const label = `${field.required ? '* ' : ''}${field.name}`;
+          const hint = field.required
+            ? `由 ${requiredChannels} 要求，至少一个通道配置为必填`
+            : `适用通道：${channelHint}`;
+          return field.fieldType === 'file' || field.fieldType === 'image' ? (
+            <div key={field.id}>
+              <SignatureUploadBox compact file={typeof values[field.code] === 'object' ? values[field.code] as UploadedFileRef : null} label={label} onUploaded={(file) => onChange(field.code, file)} />
+              <small className="report-field-source">{hint}</small>
+            </div>
+          ) : (
+            <div key={field.id}>
+              <Input label={label} onChange={(event) => onChange(field.code, event.target.value)} placeholder={field.description ?? `请输入${field.name}`} required={field.required} value={typeof values[field.code] === 'string' ? values[field.code] as string : ''} />
+              <small className="report-field-source">{hint}</small>
+            </div>
+          );
+        })}
+      </div>
+      <Modal footer={<Button onClick={() => setExplanationOpen(false)}>我知道了</Button>} onClose={() => setExplanationOpen(false)} open={explanationOpen} size="xl" title="这些资料从哪里来？">
+        <div className="report-requirement-explanation">
+          <p>资料要求按“企业应用 → 通道组 → 通道 → 通道报备字段”实时计算；相同字段只填写一次，但会按来源通道分别用于报备。</p>
+          {groups.map(([groupId, groupName]) => (
+            <section className="report-source-group" key={groupId}>
+              <h4>通道组：{groupName}</h4>
+              {channels.filter((channel) => channel.groupId === groupId).map((channel) => (
+                <div className="report-source-channel" key={channel.id}>
+                  <strong>{channel.name}（{channel.code}）</strong>
+                  <ul>
+                    {fields.filter((field) => field.channels.some((source) => source.id === channel.id)).map((field) => (
+                      <li key={field.id}>{field.name} · {field.channels.find((source) => source.id === channel.id)?.reportType === 'both' ? '签名和引流共用' : field.channels.find((source) => source.id === channel.id)?.reportType === 'signature' ? '签名报备' : '引流信息报备'} · {field.channels.find((source) => source.id === channel.id)?.required ? '必填' : '选填'}</li>
+                    ))}
+                  </ul>
+                </div>
+              ))}
+            </section>
+          ))}
+        </div>
+      </Modal>
+    </section>
+  );
+}
+
 function SignatureFormModal({
   applications,
   item,
@@ -247,9 +322,19 @@ function SignatureFormModal({
     mobile: payload?.carrierStatus.mobile ?? 'filing',
     unicom: payload?.carrierStatus.unicom ?? 'filing',
     telecom: payload?.carrierStatus.telecom ?? 'filing',
+    reportValues: payload?.signatureReportValues ?? {},
   });
+  const [reportFields, setReportFields] = useState<ApplicationReportField[]>([]);
   const tenantApplications = applications.filter((application) => application.tenantId === form.tenantId && application.status !== 'deleted');
 
+  useEffect(() => {
+    if (!form.applicationId) {
+      setReportFields([]);
+      return;
+    }
+    adminApi.listApplicationReportFields(form.applicationId, 'signature').then(setReportFields).catch(() => setReportFields([]));
+  }, [form.applicationId]);
+
   function update<Key extends keyof SignatureFormState>(key: Key, value: SignatureFormState[Key]) {
     setForm((current) => ({ ...current, [key]: value }));
   }
@@ -258,12 +343,16 @@ function SignatureFormModal({
     setForm((current) => ({ ...current, profile: { ...current.profile, [key]: value } }));
   }
 
+  function updateReportValue(code: string, value: string | UploadedFileRef | null) {
+    setForm((current) => ({ ...current, reportValues: { ...current.reportValues, [code]: value } }));
+  }
+
   return (
     <Modal
       footer={(
         <>
           <Button onClick={onClose} variant="ghost">取消</Button>
-          <Button disabled={!form.tenantId || !form.name} onClick={() => onSubmit(form)}>保存</Button>
+          <Button disabled={!form.tenantId || !form.name || hasMissingRequiredReportValue(reportFields, form.reportValues)} onClick={() => onSubmit(form)}>保存</Button>
         </>
       )}
       onClose={onClose}
@@ -347,12 +436,15 @@ function SignatureFormModal({
           </div>
         </section>
 
+        <DynamicReportFields fields={reportFields} onChange={updateReportValue} title="应用通道签名报备资料" values={form.reportValues} />
+
       </div>
     </Modal>
   );
 }
 
-function DrainageFormModal({ item, onClose, onSubmit }: { item?: DrainageInfo; onClose: () => void; onSubmit: (item: DrainageInfo) => void }) {
+function DrainageFormModal({ applicationId, item, onClose, onSubmit }: { applicationId?: string | null; item?: DrainageInfo; onClose: () => void; onSubmit: (item: DrainageInfo) => void }) {
+  const [reportFields, setReportFields] = useState<ApplicationReportField[]>([]);
   const [form, setForm] = useState<DrainageInfo>(() => item ?? {
     id: `drain-${Date.now()}`,
     siteName: '',
@@ -372,18 +464,28 @@ function DrainageFormModal({ item, onClose, onSubmit }: { item?: DrainageInfo; o
     telecom: 'filing',
     submittedAt: formatDateTime(new Date()),
     remark: '',
+    reportValues: {},
   });
 
+  useEffect(() => {
+    if (!applicationId) return;
+    adminApi.listApplicationReportFields(applicationId, 'drainage').then(setReportFields).catch(() => setReportFields([]));
+  }, [applicationId]);
+
   function update<Key extends keyof DrainageInfo>(key: Key, value: DrainageInfo[Key]) {
     setForm((current) => ({ ...current, [key]: value }));
   }
 
+  function updateReportValue(code: string, value: string | UploadedFileRef | null) {
+    setForm((current) => ({ ...current, reportValues: { ...current.reportValues, [code]: value } }));
+  }
+
   return (
     <Modal
       footer={(
         <>
           <Button onClick={onClose} variant="ghost">取消</Button>
-          <Button disabled={!form.url} onClick={() => onSubmit(form)}>保存</Button>
+          <Button disabled={!form.url || hasMissingRequiredReportValue(reportFields, form.reportValues)} onClick={() => onSubmit(form)}>保存</Button>
         </>
       )}
       onClose={onClose}
@@ -410,19 +512,11 @@ function DrainageFormModal({ item, onClose, onSubmit }: { item?: DrainageInfo; o
             </ol>
           </div>
           <div className="signature-form-grid">
-            <SignatureUploadBox compact file={form.field1File} label="* 字段名称1" onUploaded={(file) => update('field1File', file)} />
-            <Input label="* 字段名称2" onChange={(event) => update('field2', event.target.value)} placeholder="请输入字段2内容" value={form.field2 ?? ''} />
-            <Input label="* 字段名称3" onChange={(event) => { update('field3', event.target.value); update('siteName', event.target.value); }} placeholder="请输入公司名称" value={form.field3 ?? form.siteName} />
-            <Input label="字段名称4" onChange={(event) => update('field4', event.target.value)} placeholder="请输入统一社会信用代码" value={form.field4 ?? ''} />
-            <Input label="* 字段名称5" onChange={(event) => update('field5', event.target.value)} placeholder="请输入法人姓名" value={form.field5 ?? ''} />
-            <Input label="字段名称6" onChange={(event) => update('field6', event.target.value)} placeholder="请输入法人身份证号" value={form.field6 ?? ''} />
-            <SignatureUploadBox compact file={form.field7File} label="字段名称7" onUploaded={(file) => update('field7File', file)} />
-            <Input label="* 字段名称8" onChange={(event) => update('field8', event.target.value)} placeholder="请输入责任人身份证号" value={form.field8 ?? ''} />
-            <Input label="* 字段名称9" onChange={(event) => update('field9', event.target.value)} placeholder="请输入责任人姓名" value={form.field9 ?? ''} />
-            <Input label="* 字段名称10" onChange={(event) => update('field10', event.target.value)} placeholder="请输入责任人手机号" value={form.field10 ?? ''} />
+            <Input label="* 站名称" onChange={(event) => update('siteName', event.target.value)} placeholder="请输入站名称" value={form.siteName} />
             <Input label="提交时间" onChange={(event) => update('submittedAt', event.target.value)} value={form.submittedAt} />
             <Textarea className="signature-form-grid__wide" label="备注" onChange={(event) => update('remark', event.target.value)} rows={4} value={form.remark} />
           </div>
+          <DynamicReportFields fields={reportFields} onChange={updateReportValue} title="应用通道引流信息报备资料" values={form.reportValues} />
         </section>
       </div>
     </Modal>
@@ -544,7 +638,7 @@ export function AdminEnterpriseSignaturesPage() {
       mobile: state.mobile,
       unicom: state.unicom,
       telecom: state.telecom,
-    }, existingPayload.links, state.profile);
+    }, existingPayload.links, state.profile, state.reportValues);
     try {
       if (existing) {
         await adminApi.updateEnterpriseSignature(existing.id, {
@@ -579,7 +673,7 @@ export function AdminEnterpriseSignaturesPage() {
       ? payload.links.map((current) => current.id === item.id ? item : current)
       : [item, ...payload.links];
     await adminApi.updateEnterpriseSignature(signatureId, {
-      drainageInfo: buildDrainagePayload(payload.carrierStatus, links, payload.signatureProfile),
+      drainageInfo: buildDrainagePayload(payload.carrierStatus, links, payload.signatureProfile, payload.signatureReportValues),
     });
     setDrainageModal(null);
     setExpandedSignatureId(signatureId);
@@ -597,7 +691,7 @@ export function AdminEnterpriseSignaturesPage() {
       if (signature) {
         const payload = readDrainagePayload(signature);
         await adminApi.updateEnterpriseSignature(signature.id, {
-          drainageInfo: buildDrainagePayload(payload.carrierStatus, payload.links.filter((item) => item.id !== deleteTarget.id), payload.signatureProfile),
+          drainageInfo: buildDrainagePayload(payload.carrierStatus, payload.links.filter((item) => item.id !== deleteTarget.id), payload.signatureProfile, payload.signatureReportValues),
         });
       }
     }
@@ -740,6 +834,7 @@ export function AdminEnterpriseSignaturesPage() {
       {signatureReport ? <SignatureReportModal item={signatureReport} onClose={() => setSignatureReport(null)} /> : null}
       {drainageModal ? (
         <DrainageFormModal
+          applicationId={signatures.find((item) => item.id === drainageModal.signatureId)?.applicationId}
           item={drainageModal.item}
           onClose={() => setDrainageModal(null)}
           onSubmit={(item) => { void saveDrainage(drainageModal.signatureId, item); }}