企业官网建设流程全解析

Craftplan 是一款开源、可自托管的手作 D2C 小微生意 ERP 软件，内置完整的 CRM 客户管理模块：为每位客户维护多个地址（账单与配送分离）、查看订单历史、统计消费数据，并能一键导出 CSV。本指南带你 10 分钟上手 Craftplan 客户管理的全部核心功能。

快速上手：打开客户数据库

进入Manage → Customers即可看到全部客户列表，按姓氏排序，支持分页浏览。列表展示每位客户的姓名、唯一参考编号（CUS_前缀）、邮箱、电话和客户类型（Individual 个人 / Company 公司）：

点击右上角New Customer弹出表单，可填写：

• 🏷️类型：个人（Individual）或公司（Company）
• 👤姓名与联系方式：First name、Last name、Email、Phone
• 📮地址：账单地址（Billing）与配送地址（Shipping）各一套

邮箱和电话有唯一性约束，重复录入会被自动校验拦截。客户数据模型定义在 customer.ex，列表与创建/编辑界面实现见 index.ex 和 form_component.ex。

多地址管理：账单地址与配送地址分开填写

Craftplan 的客户支持双地址结构，每套地址包含街道、城市、州/省、邮编、国家 5 个字段（街道/城市/国家至少填一项即可通过校验）：

两套地址可以完全不同——比如给客户公司开票、但货寄到家里，互不干扰。地址作为内嵌结构体（Embedded Resource）保存在客户记录中，代码见 address.ex；创建订单时可直接选择客户已有地址，无需重复录入。

💡 小技巧：按Ctrl+K（macOS 为Cmd+K）唤起命令面板，输入客户姓名或邮箱即可秒跳客户档案，比手动翻页快得多。

订单历史：客户档案内的下单记录

打开任意客户详情页，顶部有Details / Orders / Statistics三个标签页。切到Orders页，即可看到该客户的完整订单历史：

每行订单展示：

• Reference：订单唯一编号
• Status：订单状态徽章
• Created at：下单时间
• Delivery Date：承诺交付日期
• Total：订单总额

点击任意一行可直达订单详情或编辑页；点击页面上的New Order按钮，会自动带上当前客户跳转到新订单表单，省去手动搜索客户的步骤。订单模块的完整生命周期说明见 orders.md。

客户统计数据：找出你的高价值客户

切到Statistics标签页，系统自动聚合两项核心指标：

• 📊Total Orders：该客户历史下单总数
• 💰Total Spent：该客户累计消费总额（按订单商品金额求和）

统计值由聚合查询实时计算（见 customer.ex 中的total_orders与total_orders_value聚合定义），无需手工维护。定期查看这些数字，帮你快速识别回头客与高价值客户，制定复购运营策略。页面实现见 show.ex。

CSV 导出：把客户数据带出去

需要对接外部 CRM、邮件列表或做报表？进入Manage → Settings的导入/导出区，可把全部客户导出为 CSV，包含reference、type、first_name、last_name、email、phone六列，可直接用 Excel 或 Google Sheets 打开：

导出逻辑代码位于 customers.ex。反向操作同样支持 CSV 批量导入客户，方便迁移旧数据。

进阶：API 访问与权限控制

• 🔌API：客户资源同时暴露 JSON:API（/customers路由）与 GraphQL 接口（list_customers/create_customer等），可用 API Key 做自动化对接
• 🔐权限：基于策略的细粒度授权——admin拥有全部权限，staff可读可删，公开侧仅允许按邮箱查询客户（供结账流程使用），详见 customer.ex 中的 policies 定义

更多官方说明请参考 customers.md 客户文档页。掌握多地址、订单历史与统计这三件套，你的客户管理就可以完全交给 Craftplan 了。