客户CRM系统产品系统Vibe Coding

面向保险、理财等个人销售从业者。

一、立项原因与要解决的产品问题
这类从业者绝大多数是"一个人的团队"，客户名单散落在微信聊天、纸质记事本和 Excel 表格里，跟进到哪一步全凭记忆，很容易漏跟、断跟。而市面上成熟的 CRM 多为企业采购、按坐席收费，功能偏向团队协作与销售漏斗，个人使用过重；免费工具又普遍要求注册账号、数据上云，客户姓名、电话这类敏感信息存在隐私顾虑，不少从业者因此不敢用。

二、行业场景与业务背景
本项目的目标是一款"个人就能用起来、数据只存在自己手机上"的轻量客户管理工具：无需注册登录、无需联网、不上传任何数据，安装即用。核心解决三件事——客户档案集中管理、跟进节奏不遗漏、沉默名单能按条件反查出来重新激活。

项目共 10 个功能模块：

1. 客户档案：姓名、联系方式、等级（ABCD）、来源、地域、标签、喜好、成交方向，支持模糊搜索与多维筛选；
2. 跟进日志：记录活动方式（见面/电话/微信/其他）、活动项目、日期、地点与内容，客户详情页按时间线展示；
3. 保单管理：一位客户可挂多份保单，涵盖保单号、保额、保费、缴费年限等 13 个字段；
4. 今日工作台：ABCD 分层人数、今日需联系清单、今日活动，以及日/周/月/季成交统计；
5. 条件反查：按"活动方式 + 客户分类 + 活动项目"组合筛选，把长期沉默的客户重新找出来；
6. 附件资料：支持图片与 PDF/Word/Excel 文件，图片可在应用内直接预览；
7. 批量导入：Excel/CSV 双格式，可下载导入模板，逐行校验并生成错误报告，自动建立客户与保单；
8. 字典管理：客户来源、地域、标签、活动项目、活动方式等 9 类下拉选项可自行增删维护；
9. 数据备份：一键导出/导入 JSON 备份，附件文件本体一并打包，换机不丢数据；
10. 隐私政策：应用内可随时查看，与商店上架声明保持一致。

主要功能描述：整体为单机应用形态，无需注册登录，全部数据保存在手机本地、无需联网，围绕"建档 — 跟进 — 提醒 — 反查 — 备份"形成个人客户经营的完整闭环。

我独立负责从技术选型、前端开发、鸿蒙适配到上架审核的全流程。

一、我负责的具体任务
需求梳理与原型设计、前端全部页面与组件开发、本机数据层设计、鸿蒙壳工程搭建与适配、应用图标与商店素材制作、隐私政策与上架材料准备、审核驳回问题的定位与修复。

二、技术栈与架构
前端：Vue 3 + TypeScript + Vite + Vant 4 组件库。
数据层：通过接口抽象层隔离数据源，同一套 UI 可在"本机数据库 / 云端"两种后端之间切换；单机版数据全部落在 IndexedDB，并按 IndexedDB → localStorage → 内存三级降级兜底。
鸿蒙侧：DevEco Studio + ArkTS 工程，通过 ArkWeb 组件加载打包进 rawfile 的离线网页包。

三、实现亮点与难点
① 为满足"不联网"要求，在构建期把云端相关模块整体别名替换为占位实现，避免动态 import 被静态打进产物，最终包内零网络代码、不申请网络权限；
② Vue 的响应式 Proxy 无法结构化克隆写入 IndexedDB，统一在写入前做数据摊平，解决了"保存客户失败"的问题；
③ 网页端的文件下载在 ArkWeb 中默认不生效，通过注册下载委托并接入系统文件选择器，补齐了"选目录 → 保存 → 结果提示"的完整链路；
④ 移动端布局适配按 360 / 390 / 430 三种视口做量化验收，修掉了选择器因宽度不足换行错位、以及横向筛选行末尾文字被裁切的问题。

项目已按"单机应用"形式提交华为应用市场审核（该类应用可免 APP 备案），全流程自主完成。