CRM技能使用说明

初次互动

• 询问他们追踪什么：客户、潜在客户、投资者、工作联系人、社交网络——背景决定架构
• 询问他们的技术熟悉程度：电子表格、JSON、数据库——决定起始格式
• 创建~/crm/文件夹作为唯一事实来源

从文件开始，而非应用程序

• 首个版本使用JSON或CSV——在增加复杂度前验证数据模型
• 单个文件初始为contacts.json——除非必要，否则避免创建多个文件在他们使用文件至少一周前，不要建议网页应用
• 在文件感觉缓慢或受限前，不要建议数据库
• 最小联系人架构

id、姓名、邮箱、公司、电话、备注、标签、创建时间、更新时间——初始阶段无需更多

• 使用标签数组而非固定类别——灵活，无需更改架构
• 备注字段通常最有价值——鼓励自由形式的上下文记录
• 为id生成UUID，而非自增——确保合并和导入时的数据完整性
• Generate UUID for id, not auto-increment — survives merges and imports

何时添加互动记录文件

• 用户询问"我上次和X交谈是什么时候"——表明他们需要历史记录
• 通过contact_id关联的独立文件——不嵌套在联系人对象内
• 类型字段（笔记/邮件/通话/会议）便于后续筛选
• 务必包含日期——时间线视图至关重要

何时添加公司文件

• 同一公司存在多个联系人——需要分离的信号
• 多对多关系：单个人可能在不同时期任职多家公司
• 联系人中使用company_id——避免重复存储公司名称

何时添加交易/商机记录

• 用户提及"销售管道"、"阶段"、"成交日期"、"交易金额"
• 关联contact_id，可选关联company_id
• 阶段字段初期使用简单字符串——不要过度设计状态机

SQLite迁移触发条件

• 文件操作明显变慢（通常超过100个联系人时）
• 用户需要进行复杂查询和筛选
• 多用户需要访问权限（SQLite支持并发读取）
• 提供编写迁移脚本的服务——不要强制手动重新录入

渐进式时间线

• 第1周：仅联系人文件，验证用户是否会实际使用
• 第2周：当用户需要历史记录时添加互动记录功能
• 第3周：添加标签功能及搜索辅助脚本
• 第2个月：如有需要再添加公司文件
• 第3个月：如需追踪商机再添加交易文件
• 最后阶段：才考虑开发网页界面或更复杂的工具

前期不建议提供的功能

• 网页应用——会大幅增加开发范围，应先验证数据模型
• 邮件同步/集成——建议采用密送/转发工作流，简单得多
• 日历集成——初期手动记录即可
• 身份验证——单用户本地版CRM无需此功能
• 移动端应用——早期不值得为同步功能增加复杂度

值得提供的辅助脚本

• 命令行快速添加功能——降低使用阻力
• 跨文件搜索——grep/jq单行命令实现
• 时间戳压缩备份——迁移前必备功能
• 导出为CSV — 适合需要电子表格视图的用户

数据完整性习惯

• 进行任何批量编辑或迁移前先备份
• 添加联系人前检查重复邮箱
• 录入时验证邮箱格式
• 保留创建/更新时间戳 — 调试救星

按需同步

• 云文件夹（Dropbox/iCloud/Drive）实现多设备同步 — 最简便
• Git仓库管理版本历史 — 适合技术型用户
• 文件方案被证实不足前，勿建议复杂同步方案