@agile-team/wl-skills-kit 1.0.0

package/files/demo/produce/aiflow/mmwr-customer-detail/api.md

@@ -0,0 +1,67 @@
+# 客户详情 接口约定
+
+> 服务: sale | 资源: customerArchive
+> 页面类型: 多 Tab 只读详情页（7 基础 Tab + 企业核实 + 6 扩展 Tab）
+
+## 1. 获取客户详情
+
+```
+GET /sale/customerArchive/getById?id={id}
+```
+
+Response 结构同 [customer-apply-change/api.md](../customer-apply-change/api.md)，
+额外包含 `verificationInfo` 字段：
+
+```json
+{
+  "verificationInfo": {
+    "companyName": "string",
+    "legalPerson": "string",
+    "companyStatus": "string",
+    "creditCode": "string",
+    "registeredCapital": "string",
+    "establishDate": "string",
+    "companyType": "string",
+    "region": "string",
+    "registrationAuthority": "string",
+    "businessScope": "string"
+  }
+}
+```
+
+## 2. 企业核实确认
+
+```
+POST /sale/customerArchive/verify
+```
+
+Request: `{ id: string }`
+
+---
+
+## 3. 扩展 Tab 列表接口
+
+所有接口均为 `GET` 请求，参数 `customerId={id}`，返回 `data: Array`。
+
+| Tab        | 接口路径                                  |
+| ---------- | ----------------------------------------- |
+| 不良记录   | `/sale/customerArchive/badRecord/list`    |
+| 里程碑事件 | `/sale/customerArchive/milestone/list`    |
+| 询单需求   | `/sale/customerArchive/inquiry/list`      |
+| 跟进记录   | `/sale/customerArchive/followUp/list`     |
+| 客诉记录   | `/sale/customerArchive/complaint/list`    |
+| 历史销量   | `/sale/customerArchive/historySales/list` |
+
+### 各接口 Response 字段
+
+**不良记录**: contractNo, badType, badInfo, createDate, status
+
+**里程碑事件**: recordDate, milestoneType(首次接触/首次询单/首次合同), detail
+
+**询单需求**: steelType, size, price, quantity, remark, tradeCondition, paymentMethod
+
+**跟进记录**: activityDate, activityNo, activityTitle, activityContent, createBy
+
+**客诉记录**: complaintDate, complaintNo, complaintSubject, handleContent, handleDate, handleBy
+
+**历史销量记录**: steelGrade, spec, unit, orderQty, orderAmount, outboundQty, outboundAmount, settlementQty, settlementAmount

package/files/demo/produce/aiflow/mmwr-customer-detail/data.ts

@@ -0,0 +1,286 @@
+import { getAction, postAction } from "@jhlc/common-core/src/api/action";
+import { ElMessage, ElMessageBox } from "element-plus";
+import { useRouter } from "vue-router";
+
+export const API_CONFIG = {
+  getById: "/sale/tempCustomerArchive/getById",
+  save: "/sale/tempCustomerArchive/save",
+  convert: "/sale/tempCustomerArchive/convert",
+  assign: "/sale/tempCustomerArchive/assign",
+  claim: "/sale/tempCustomerArchive/claim",
+  recycle: "/sale/tempCustomerArchive/recycle",
+  returnBack: "/sale/tempCustomerArchive/return"
+} as const;
+
+export const OPTS = {
+  useOrg: [
+    { label: "不锈钢接单中心", value: "不锈钢接单中心" },
+    {
+      label: "江阴华新特殊合金材料有限公司",
+      value: "江阴华新特殊合金材料有限公司"
+    },
+    { label: "採瞒管理中心", value: "採瞒管理中心" },
+    { label: "烟台华鑫再生资源有限公司", value: "烟台华鑫再生资源有限公司" }
+  ],
+  product: [
+    { label: "热轧", value: "热轧" },
+    { label: "盘元", value: "盘元" },
+    { label: "冷精", value: "冷精" },
+    { label: "汽车", value: "汽车" }
+  ],
+  customerType: [
+    { label: "SYCSR001-交易客户", value: "SYCSR001-交易客户" },
+    { label: "SYCSR002-直采客户", value: "SYCSR002-直采客户" }
+  ],
+  customerLevel: [
+    { label: "一般客户（A1）", value: "一般客户（A1）" },
+    { label: "重要客户（A2）", value: "重要客户（A2）" },
+    { label: "战略客户（A3）", value: "战略客户（A3）" }
+  ],
+  currency: [
+    { label: "CNY", value: "CNY" },
+    { label: "USD", value: "USD" }
+  ],
+  followType: [
+    { label: "客户拜访", value: "客户拜访" },
+    { label: "电话跟进", value: "电话跟进" },
+    { label: "邮件跟进", value: "邮件跟进" }
+  ]
+};
+
+export interface FollowRecord {
+  id: string;
+  useOrg: string;
+  product: string;
+  type: string;
+  activityDate: string;
+  activityCode: string;
+  activityTitle: string;
+  activityContent: string;
+  attachment: string;
+  createTime: string;
+}
+
+export interface TempCustomerForm {
+  id: string;
+  customerName: string;
+  convertStatus: string;
+  tempCode: string;
+  formalCode: string;
+  useOrg: string;
+  product: string;
+  lastFollowPerson: string;
+  lastFollowDate: string;
+  creator: string;
+  createTime: string;
+  customerType: string;
+  customerLevel: string;
+  businessLicense: string;
+  contactPerson: string;
+  contactPhone: string;
+  companyPhone1: string;
+  companyPhone2: string;
+  companyFax: string;
+  position: string;
+  email: string;
+  address: string;
+  consignee: string;
+  deliveryContact: string;
+  deliveryAddress: string;
+  currency: string;
+  taxRate: string;
+  bankType: string;
+  bankAccountName: string;
+  bankAccount: string;
+  bankBranch: string;
+  invoiceHeader: string;
+  taxNumber: string;
+  invoiceEmail: string;
+  invoicePhone: string;
+  invoiceAddress: string;
+  followRecords: FollowRecord[];
+}
+
+export function createMockData(): TempCustomerForm {
+  return {
+    id: "mock-001",
+    customerName: "烟台华新不锈钢智能化深加工基地",
+    convertStatus: "未转换",
+    tempCode: "10001170",
+    formalCode: "10001170",
+    useOrg: "不锈钢接单中心",
+    product: "热轧",
+    lastFollowPerson: "郭松",
+    lastFollowDate: "",
+    creator: "郭松",
+    createTime: "",
+    customerType: "SYCSR001-交易客户",
+    customerLevel: "一般客户（A1）",
+    businessLicense: "",
+    contactPerson: "潘灵连",
+    contactPhone: "18174058864",
+    companyPhone1: "18174058864",
+    companyPhone2: "18174058864",
+    companyFax: "18174058864",
+    position: "采购",
+    email: "2140309447@qq.com",
+    address: "上海市宝山区富锦路885号",
+    consignee: "潘灵连",
+    deliveryContact: "18174058864",
+    deliveryAddress: "上海市宝山区富锦路885号",
+    currency: "CNY",
+    taxRate: "--",
+    bankType: "中国工商银行股份有限公司",
+    bankAccountName: "江苏金恒信息科技股份有限公司",
+    bankAccount: "1001 1538 1900 3292 075",
+    bankBranch: "中国工商银行股份有限公司七台河兴煤支行",
+    invoiceHeader: "江苏金恒信息科技股份有限公司",
+    taxNumber: "91310000631696382C",
+    invoiceEmail: "2140309447@qq.com",
+    invoicePhone: "18174058864",
+    invoiceAddress: "上海市宝山区富锦路885号",
+    followRecords: [
+      {
+        id: "1",
+        useOrg: "",
+        product: "",
+        type: "客户拜访",
+        activityDate: "2024-01-01",
+        activityCode: "CV20241119003-07",
+        activityTitle: "客户拜访商业洽谈",
+        activityContent: "******",
+        attachment: "查看附件",
+        createTime: "2024-01-01 20:00"
+      },
+      {
+        id: "2",
+        useOrg: "",
+        product: "",
+        type: "客户拜访",
+        activityDate: "2024-01-01",
+        activityCode: "CV20241119003-07",
+        activityTitle: "客户拜访商业洽谈",
+        activityContent: "******",
+        attachment: "查看附件",
+        createTime: "2024-01-01 20:00"
+      },
+      {
+        id: "3",
+        useOrg: "",
+        product: "",
+        type: "客户拜访",
+        activityDate: "2024-01-01",
+        activityCode: "CV20241119003-07",
+        activityTitle: "客户拜访商业洽谈",
+        activityContent: "******",
+        attachment: "查看附件",
+        createTime: "2024-01-01 20:00"
+      }
+    ]
+  };
+}
+
+export function useTempCustomerDetail() {
+  const router = useRouter();
+  const loading = ref(false);
+  const form = reactive<TempCustomerForm>(createMockData());
+
+  async function loadDetail(id: string) {
+    loading.value = true;
+    try {
+      const res = await getAction(API_CONFIG.getById, { id });
+      if (res?.data) Object.assign(form, res.data);
+    } finally {
+      loading.value = false;
+    }
+  }
+
+  async function handleSave() {
+    loading.value = true;
+    try {
+      const res = await postAction(API_CONFIG.save, { ...form });
+      if (res?.code === 200) ElMessage.success("保存成功");
+    } finally {
+      loading.value = false;
+    }
+  }
+
+  function handleTempSave() {
+    ElMessage.info("暂存功能开发中");
+  }
+
+  async function handleConvert() {
+    ElMessageBox.confirm("确定将该临时客户转化为正式客户？", "提示", {
+      type: "info"
+    })
+      .then(async () => {
+        loading.value = true;
+        try {
+          const res = await postAction(API_CONFIG.convert, { ids: [form.id] });
+          if (res?.code === 200) {
+            ElMessage.success("转化成功");
+            router.back();
+          }
+        } finally {
+          loading.value = false;
+        }
+      })
+      .catch(() => {});
+  }
+
+  function handleAssign() {
+    ElMessage.info("分配功能开发中");
+  }
+  function handleClaim() {
+    ElMessage.info("认领功能开发中");
+  }
+  function handleRecycle() {
+    ElMessage.info("回收功能开发中");
+  }
+  function handleReturn() {
+    ElMessage.info("退回功能开发中");
+  }
+
+  function addFollowRecord() {
+    form.followRecords.push({
+      id: Date.now().toString(),
+      useOrg: "",
+      product: "",
+      type: "客户拜访",
+      activityDate: "",
+      activityCode: "",
+      activityTitle: "",
+      activityContent: "",
+      attachment: "",
+      createTime: ""
+    });
+  }
+
+  function removeFollowRecord(index: number) {
+    ElMessageBox.confirm("确定删除该跟进记录？", "提示", { type: "warning" })
+      .then(() => {
+        form.followRecords.splice(index, 1);
+      })
+      .catch(() => {});
+  }
+
+  function handleCancel() {
+    router.back();
+  }
+
+  return {
+    loading,
+    form,
+    loadDetail,
+    handleSave,
+    handleTempSave,
+    handleConvert,
+    handleAssign,
+    handleClaim,
+    handleRecycle,
+    handleReturn,
+    addFollowRecord,
+    removeFollowRecord,
+    handleCancel
+  };
+}

package/files/demo/produce/aiflow/mmwr-customer-detail/index.scss

@@ -0,0 +1,139 @@
+.temp-customer-detail {
+  padding: 0 !important;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+}
+
+.temp-customer-detail .title-bar {
+  padding: 10px 16px 8px;
+  background: #f5f7fa;
+  border-bottom: 1px solid #e4e7ed;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+    flex-shrink: 0;
+  }
+
+.temp-customer-detail .title-bar .customer-name {
+  font-size: 15px;
+  font-weight: 600;
+  color: #303133;
+}
+.temp-customer-detail .title-bar .status-tag {
+  font-size: 12px;
+}
+
+.temp-customer-detail .page-toolbar {
+  padding: 8px 16px;
+  border-bottom: 1px solid #e4e7ed;
+  background: #fff;
+  flex-shrink: 0;
+  display: flex;
+  gap: 8px;
+}
+
+.temp-customer-detail .detail-form {
+  flex: 1;
+  overflow-y: auto;
+  padding: 0 16px 16px;
+}
+
+.temp-customer-detail .header-info {
+  padding: 12px 0 4px;
+  border-bottom: 1px solid #f0f2f5;
+  margin-bottom: 8px;
+}
+
+.temp-customer-detail .form-section {
+  margin-top: 16px;
+}
+
+.temp-customer-detail .form-section .section-title {
+  font-size: 13px;
+  font-weight: 600;
+  color: #303133;
+  padding: 0 0 8px 10px;
+  border-left: 3px solid var(--el-color-primary);
+  margin-bottom: 12px;
+}
+
+.temp-customer-detail .name-field {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+
+.temp-customer-detail .name-field .el-input {
+  flex: 1;
+}
+
+.temp-customer-detail .name-field .name-badge {
+  background: #e8f4ff;
+  color: #409eff;
+  font-size: 11px;
+  font-weight: 600;
+  padding: 2px 5px;
+  border-radius: 3px;
+  white-space: nowrap;
+  cursor: pointer;
+}
+
+.temp-customer-detail .upload-box {
+  width: 100%;
+  height: 88px;
+  border: 1px dashed #d9d9d9;
+  border-radius: 4px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  background: #fafafa;
+}
+
+.temp-customer-detail .upload-box:hover {
+  border-color: var(--el-color-primary);
+}
+
+.temp-customer-detail .upload-box .upload-placeholder {
+  text-align: center;
+}
+
+.temp-customer-detail .upload-box .upload-icon {
+  font-size: 20px;
+  color: #c0c4cc;
+  line-height: 1;
+  margin-bottom: 4px;
+}
+
+.temp-customer-detail .upload-box .upload-text {
+  font-size: 12px;
+  color: #909399;
+}
+
+.temp-customer-detail .link-text {
+  color: #409eff;
+  text-decoration: none;
+}
+
+.temp-customer-detail .link-text:hover {
+  text-decoration: underline;
+}
+
+.temp-customer-detail .add-row-btn {
+  margin-top: 8px;
+  padding: 6px 12px;
+  color: #409eff;
+  cursor: pointer;
+  font-size: 13px;
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.temp-customer-detail .add-row-btn:hover {
+  color: #66b1ff;
+}
+.temp-customer-detail .el-form-item {
+  margin-bottom: 10px;
+}