客户盘点管理平台-盘客系统

【立项目标与背景】 客户线索越来越贵、越来越杂，而一线在接待中形成的判断长期散落在录音、业务台账和个人记忆里：销售只能靠手填字段，管理者只看到结果数字，看不到客户为什么来、卡在哪、为什么走。本系统面向客户经营场景，把客户主档、行为轨迹、接待录音与交易流水沉淀为统一的客户资产，再用大模型把非结构化的接待过程转成结构化判断，让一线少填、管理者看得准、经营决策有依据。

【核心功能模块】 1、一线移动端：今日名单、客户检索、接待记录与判断录入、录音与接待报告、跟进记录、回访进度。 2、现场录音与 AI 解析：可穿戴录音设备一键启停，音频上传后完成转写与结构化解析，自动生成接待报告和客户画像并回流客户资产。 3、管理端：经营概览、客户列表与全景、客户动态（好/坏信号）、团队与人员对比、判断一致性、成交与流失分析、录音管理、权限与项目配置。 4、数据底座：既有业务台账文件的自动导出导入、客户唯一标识匹配、字段标准化与敏感信息脱敏。

【业务流程与功能路径】 一线接待时启停录音 → 音频自动上传并转写解析，生成报告与客户画像 → 一线在名单中补充本次判断与需求 → 管理者在管理端做客户盘点，并核对上下级判断差异 → 系统按到访、判断、成交、流失各自的事件时间生成经营看板与周期复盘，支持同口径下钻与导出。

【整体架构与技术栈】 系统分四层：①双端前端，管理端用 React+Vite+TypeScript+Ant Design，移动端用 Vue+Vite+TypeScript+Vant，两端独立维护页面与路由，服务端数据统一走 TanStack Query，客户端状态分别用 Zustand/Pinia；②API 网关，基于 FastAPI 实现统一登录（企业 SSO）、内网与公网双入口的 Host 与路径隔离、固定后端服务的同路径反向代理和可信身份头注入，静态资源由 CDN 承载；③业务后端，JDK 8+Spring Boot/Cloud 多模块 Maven 工程，MyBatis-Plus 多数据源（MySQL 及分析型数据库）、Redis 缓存、Kafka 审计日志，复用配置中心、服务注册发现、监控告警与链路追踪等基础设施组件；④上游能力，含可穿戴录音设备、语音转写与结构化解析服务、既有业务系统的数据导出。

【我负责的部分与结果】 端到端负责从业务口径到代码落地：后端核心领域服务与数据接入（经营看板、成交与流失分析、判断与客户全景、外部台账同步、录音链路）、网关边界与登录态、双端关键页面联调、测试与上线回归。系统已双端上线，沉淀客户主档 70 余字段、万级客户记录，成交与流失分析各 80 余字段；AI 客户评估在离线评测中 Top20% 客户覆盖约六成成交、AUC 0.76。

【难点与解法】 1、现场录音设备不可靠：启停耗时不可控、离线丢指令、同一设备必须严格先停后开。做法是全过程状态留证 + 网络退避重试（开录最多 3 次；停止不放弃，每 30 秒补发）+ 同设备启停串行 + 前端只暴露“开启/结束/失败原因”三态，生产开录中位数 1.3 秒、P95 2.5 秒。2、上游业务系统无稳定接口：只能网页导出文件，且有登录风控。做法是进程内单飞、会话按账号而非租户复用、账号级登录锁、按唯一键增量刷新（先共享读再 upsert）、手机号仅留后四位、敏感列整列不入库，并通过用户中心接口反查补全客户唯一标识。3、经营口径极易拼错：同一天的到访、录入、管理判断、成交来自不同事件。做法是全链路按各自事件时间统计，卡片、下钻名单与导出保持同一筛选条件，0 与“—”严格区分，交易状态统一为多值状态机并支持退房回退。4、双入口安全：内网管理端与公网移动端共用一套产物和网关实例，但必须互不可达。做法是按 Host 拆分两套网关子应用 + 路由白名单，网关注入并覆盖身份头，业务后端再做数据权限校验。