# 智源AI 数字化基础设施架构方案 v1.2
> 📅 创建时间：2026年1月9日
> 🔄 更新时间：2026年1月14日
> 🎯 用途：指导P2业务系统开发的整体架构设计与实施路径
> 📦 配套文档：业务框架文档v2.2、数据架构设计文档v2.0、公司战略文档v1.3
> 🔧 核心系统：PostgreSQL数据库 + CRM系统 + API服务 + 企业官网
> 📁 项目结构：pnpm monorepo（apps/ + packages/）
> ✅ **当前状态**：Phase 1-4 核心功能已完成，Phase 5 官网开发中
---
## 一、架构设计总纲
### 1.1 核心设计原则
| 原则 | 说明 |
|-----|------|
| **合规优先** | 第一层接入服务与第二三层服务分离展示，规避平台风控 |
| **统一后台** | 全渠道客户数据统一管理，支撑升级路径追踪 |
| **最小可行** | 先跑通核心流程，再迭代扩展功能 |
| **可复用沉淀** | 所有设计可沉淀为模板，支撑业务规模化 |
### 1.2 三层业务与数字化配套映射
| 业务层级 | 服务内容 | 前端触点 | 后台支撑 | 合规风险 |
|---------|---------|---------|---------|---------|
| **第一层-接入服务** | 账号代注册、订阅代充、成品号销售 | 淘宝店铺 | CRM订单/交付/库存模块 | 高 |
| **第二层-配置服务** | Project配置、提示词优化、知识库搭建 | 企业官网 | CRM项目管理模块 | 低 |
| **第三层-Agent服务** | 定制Agent开发、业务自动化 | 企业官网 | CRM项目管理模块 | 低 |
---
## 二、官网架构策略（核心决策）
### 2.1 分离策略结论
**决策：分层展示 + 统一后台**
- 第一层服务 → 继续依托**淘宝店铺**（不在官网展示）
- 第二三层服务 → 在**企业官网**展示
- 全部客户数据 → **统一CRM**管理
### 2.2 分离策略依据
| 维度 | 分析 | 结论 |
|-----|------|------|
| **合规风险** | 账号销售涉及敏感词、灰色地带 | 不放官网 |
| **平台背书** | 淘宝提供交易保障、信用背书 | 第一层留淘宝 |
| **品牌形象** | 官网需专业、可信、技术导向 | 只展示二三层 |
| **SEO权重** | 统一域名集中权重 | 不建议分两个站 |
| **维护成本** | 两套系统维护成本翻倍 | 统一后台 |
### 2.3 总体架构图
┌─────────────────────────────────────────────────────────────────────┐ │ 智源AI 数字化基础设施架构 │ ├─────────────────────────────────────────────────────────────────────┤ │ │ │ 前端展示层（分离） 后台管理层（统一） │ │ ┌──────────────────┐ ┌───────────────────────────┐ │ │ │ 淘宝店铺 │ │ │ │ │ │ (第一层接入服务) │ │ 统一CRM系统 │ │ │ │ • 账号销售 │ ──────▶ │ • 客户管理 │ │ │ │ • 即时交付 │ │ • 订单管理 │ │ │ └──────────────────┘ │ • 库存管理 │ │ │ │ • 售后管理 │ │ │ ┌──────────────────┐ │ • 数据统计 │ │ │ │ 企业官网 │ │ │ │ │ │ (第二/三层服务) │ ──────▶ │ │ │ │ │ • 配置服务 │ └───────────────────────────┘ │ │ │ • Agent服务 │ │ │ │ │ • 品牌展示 │ ▼ │ │ └──────────────────┘ ┌───────────────────────────┐ │ │ │ PostgreSQL │ │ │ ┌──────────────────┐ │ 统一数据库 │ │ │ │ 私域触点 │ └───────────────────────────┘ │ │ │ (微信/企微) │ ──────▶ │ │ │ • 深度服务 │ │ │ │ • 续费跟进 │ │ │ └──────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────┘
---
## 三、企业官网内容架构
### 3.1 官网定位
| 维度 | 策略 |
|-----|------|
| **展示范围** | 只展示第二层（配置服务）和第三层（Agent服务） |
| **合规策略** | 全程规避敏感词：VPN、梯子、代购、代充、科学上网等 |
| **品牌调性** | 专业、可信、技术导向、解决方案导向 |
| **转化路径** | 浏览→了解→咨询→转私域→深度沟通→成交 |
### 3.2 页面结构
官网页面结构（第二/三层服务专属） │ ├── 首页 (/) │ ├── Hero区：品牌Slogan + 核心价值主张 │ ├── 服务概览：AI配置服务 + Agent定制服务 │ ├── 解决方案：按场景分类（内容创作、编程开发、企业应用） │ ├── 为什么选择我们：差异化优势 │ ├── 客户案例：成功案例展示 │ └── CTA：立即咨询 + 预约演示 │ ├── 服务页面 │ ├── /services/ai-configuration (AI配置服务) │ │ ├── Project配置服务 │ │ ├── 知识库搭建服务 │ │ ├── 提示词优化服务 │ │ └── 工作流设计服务 │ │ │ └── /services/agent-development (Agent定制服务) │ ├── 业务流程自动化 │ ├── 定制Agent开发 │ └── AI应用原型开发 │ ├── 解决方案页面 │ ├── /solutions/content-creators (内容创作者) │ ├── /solutions/developers (开发者) │ └── /solutions/enterprise (企业用户) │ ├── 案例页面 (/cases) │ └── 成功案例展示 │ ├── 关于我们 (/about) │ ├── 公司介绍 │ ├── 服务理念 │ └── 团队介绍（可选） │ ├── 常见问题 (/faq) │ └── FAQ列表 │ └── 联系我们 (/contact) ├── 咨询表单 ├── 微信二维码 └── 联系方式
### 3.3 首页内容规划
| 区块 | 内容 | 设计要点 |
|-----|------|---------|
| **Hero** | "让AI真正为您所用" + "专业的AI配置与定制服务，帮助您释放AI工具的全部潜力" | 突出价值主张，不提账号销售 |
| **服务概览** | 配置服务 + Agent服务 两大板块 | 用图标+简介+CTA |
| **场景方案** | 内容创作者 / 开发者 / 企业用户 三类 | 按用户画像分类引导 |
| **差异化** | 专业深耕 / 中文本土化 / 全程支持 / 效果导向 | 4个核心优势 |
| **案例** | 3-5个典型案例 | 待收集整理 |
| **CTA** | "预约免费咨询" + "添加微信" | 转私域为主 |
### 3.4 各服务页面内容属性
#### AI配置服务页面 (/services/ai-configuration)
| 内容模块 | 具体内容 |
|---------|---------|
| **页面标题** | AI配置服务 - 让AI工具真正适配您的工作 |
| **服务介绍** | 帮助您配置和优化AI工具，让Claude/ChatGPT等工具发挥最大效用 |
| **服务项目** | Project配置、知识库搭建、提示词优化、工作流设计 |
| **服务流程** | 需求沟通 → 方案设计 → 配置实施 → 效果验证 → 持续优化 |
| **适用场景** | 内容创作、代码开发、数据分析、客服自动化等 |
| **服务报价** | 按项目报价，提供免费咨询 |
| **CTA** | 预约免费咨询 |
#### Agent定制服务页面 (/services/agent-development)
| 内容模块 | 具体内容 |
|---------|---------|
| **页面标题** | Agent定制服务 - 用AI解决您的具体业务问题 |
| **服务介绍** | 根据您的业务需求，定制开发专属AI Agent，实现业务流程自动化 |
| **服务项目** | 需求理解Agent、方案设计Agent、快速原型Agent |
| **服务流程** | 需求调研 → 方案设计 → 原型开发 → 测试验证 → 交付上线 |
| **适用场景** | 业务流程自动化、智能客服、内容生成、数据处理等 |
| **服务报价** | 按项目评估报价 |
| **CTA** | 预约需求沟通 |
---
## 四、CRM系统功能架构
### 4.1 模块功能矩阵
| 模块 | 功能 | 优先级 | 支撑业务层 |
|-----|------|--------|----------|
| **仪表盘** | 今日概览、待办事项、趋势图表、库存预警 | P0 | 全部 |
| **客户管理** | 客户列表、详情、标签、分层、沟通记录 | P0 | 全部 |
| **订单管理** | 订单列表、详情、状态流转、退款处理 | P0 | 第一层 |
| **交付管理** | 待交付队列、交付操作、到期提醒 | P0 | 第一层 |
| **库存管理** | 库存列表、入库、预警、统计 | P0 | 第一层 |
| **售后管理** | 工单列表、工单处理、满意度 | P1 | 全部 |
| **数据统计** | 销售报表、客户分析、产品分析 | P1 | 全部 |
| **服务案例库** | 案例沉淀、模板库 | P2 | 第二三层 |
| **项目管理** | 配置服务项目跟踪 | P2 | 第二三层 |
### 4.2 CRM数据流转设计
┌─────────────────────────────────────────────────────────────────────────────┐ │ CRM数据流转示意图 │ ├─────────────────────────────────────────────────────────────────────────────┤ │ │ │ 淘宝订单 官网咨询 私域沟通 │ │ │ │ │ │ │ ▼ ▼ ▼ │ │ ┌──────────────────────────────────────────────────────────────────────┐ │ │ │ 客户识别层 │ │ │ │ 按微信号/手机号/旺旺ID 识别同一客户 │ │ │ └────────────────────────────────┬─────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌──────────────────────────────────────────────────────────────────────┐ │ │ │ 统一客户视图 │ │ │ │ • 基本信息 • 全渠道订单 • 全部沟通记录 • 服务历史 • 升级潜力标签 │ │ │ └────────────────────────────────┬─────────────────────────────────────┘ │ │ │ │ │ ┌─────────────────┼─────────────────┐ │ │ ▼ ▼ ▼ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ 第一层 │ │ 第二层 │ │ 第三层 │ │ │ │ 订单记录 │ → │ 服务项目 │ → │ 定制项目 │ │ │ └──────────┘ └──────────┘ └──────────┘ │ │ │ │ ↓ 升级信号识别 ↓ │ │ "用量不够" → Max升级 "不会配置" → 配置服务 │ │ "想做功能" → Agent服务 "团队使用" → 企业服务 │ │ │ └─────────────────────────────────────────────────────────────────────────────┘
### 4.3 客户升级信号识别规则
| 客户说的话 | 信号含义 | 推荐升级方向 | CRM标签 |
|------------|----------|--------------|---------|
| "用量不够" | 使用频繁 | 升级Max 5×/20× | upgrade_potential_max |
| "不会配置" | 需要帮助 | → 第二层配置服务 | upgrade_potential_l2 |
| "效果不好" | 需要优化 | → 第二层配置服务 | upgrade_potential_l2 |
| "想做XXX功能" | 有具体需求 | → 第三层Agent服务 | upgrade_potential_l3 |
| "团队想用" | 规模化需求 | → Team版本/企业服务 | upgrade_potential_enterprise |
| "想要质保" | 稳定性需求 | → 护航版 | upgrade_potential_escort |
| "长期使用" | 续费意向 | → 护航版长期套餐 | renewal_high |
| "批量采购" | 大客户 | → 私域深度服务 | vip_potential |
---
## 五、技术架构设计
### 5.1 技术栈选型
| 层级 | 技术选型 | 说明 | 状态 |
|-----|---------|------|------|
| **数据库** | PostgreSQL 15+ (本地开发) | 开发使用本地数据库 | ✅ 运行中 |
| **ORM** | Prisma | 类型安全，开发体验好 | ✅ 运行中 |
| **后端API** | Node.js + Fastify + TypeScript | 轻量高效，生态成熟 | ✅ 运行中 |
| **CRM前端** | Vite + React + Ant Design Pro | 企业级中后台方案，快速HMR | ✅ 运行中 |
| **官网前端** | Next.js 14 (App Router) | SSG静态生成，SEO友好 | 🔄 开发中 |
| **官网UI** | Tailwind CSS + shadcn/ui | 现代化、易维护 | ✅ 已配置 |
| **认证** | NextAuth.js | 简单可靠 | 📋 待实现 |
| **部署** | 待定 | 生产环境部署方案待确定 | 📋 待配置 |
> **说明**：开发环境已使用本地PostgreSQL替代Supabase，生产部署方案待确定。
### 5.2 项目目录结构
ZYOperations/ # 项目根目录 ├── apps/ # 应用目录 │ ├── website/ # 企业官网 (Next.js 14) │ │ └── app/ # App Router 页面 │ │ ├── page.tsx # 首页 │ │ ├── services/ # 服务页面 │ │ ├── learn/ # 学习中心 │ │ ├── solutions/ # 解决方案 │ │ ├── about/ # 关于我们 │ │ ├── contact/ # 联系我们 │ │ └── faq/ # 常见问题 │ ├── crm/ # CRM后台 (Vite + React) │ └── api/ # API服务 (Fastify) ├── packages/ # 共享包 │ └── database/ # Prisma数据库配置 ├── docs/ # 文档目录 │ ├── yuanshiwenjian/ # 原始文档 │ └── kaifawenjian/ # 开发文档 └── package.json # pnpm workspace配置
### 5.3 系统部署架构
┌─────────────────────────────────────────────────────────────────────────────┐ │ 部署架构 │ ├─────────────────────────────────────────────────────────────────────────────┤ │ │ │ 用户访问 │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────────────────┐ │ │ │ Vercel (前端托管) │ │ │ │ ┌─────────────────────┐ ┌─────────────────────┐ │ │ │ │ │ 企业官网 │ │ CRM后台 │ │ │ │ │ │ (Next.js SSG) │ │ (React SPA) │ │ │ │ │ │ zhiyuanai.cn │ │ crm.zhiyuanai.cn │ │ │ │ │ └─────────────────────┘ └─────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────────────────┐ │ │ │ Railway (后端托管) │ │ │ │ ┌─────────────────────────────────────────────────────────────┐ │ │ │ │ │ API Server │ │ │ │ │ │ (Node.js + Fastify) │ │ │ │ │ │ api.zhiyuanai.cn │ │ │ │ │ └─────────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────────────────┐ │ │ │ Supabase (数据库托管) │ │ │ │ ┌─────────────────────────────────────────────────────────────┐ │ │ │ │ │ PostgreSQL │ │ │ │ │ │ + 认证服务 + 存储服务 │ │ │ │ │ └─────────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────────────┘
### 5.4 域名规划
| 域名 | 用途 | 备案要求 | 状态 |
|-----|------|---------|------|
| zhiyuanai.cn | 企业官网 | 需要 | ⏳ 待注册 |
| crm.zhiyuanai.cn | CRM后台 | 需要 | ⏳ 待配置 |
| api.zhiyuanai.cn | API服务 | 需要 | ⏳ 待配置 |
---
## 六、实施路径规划
### 6.1 分阶段实施计划
| 阶段 | 周期 | 目标 | 产出物 | 验收标准 | 状态 |
|-----|------|------|--------|---------|------|
| **Phase 0** | - | 项目基础设施 | Monorepo结构、开发环境 | 可运行dev命令 | ✅ 完成 |
| **Phase 1** | Week 1-2 | 数据库+基础API | PostgreSQL表结构、CRUD API | API可调用 | ✅ 完成 |
| **Phase 2** | Week 3-4 | 订单+交付管理 | 订单管理页、交付管理页 | 可录入订单、执行交付 | ✅ 完成 |
| **Phase 3** | Week 5-6 | 客户+售后管理 | 客户管理页、工单管理页 | 可管理客户、处理工单 | ✅ 完成 |
| **Phase 4** | Week 7 | 数据统计仪表盘 | 仪表盘页面 | 数据可视化展示 | ✅ 完成 |
| **Phase 5** | Week 8-9 | 企业官网 | 官网全部页面 | 官网可访问 | 🔄 70% |
| **Phase 6** | Week 10 | 数据迁移+测试 | 系统上线 | 远程mydb数据迁移完成 | ⏳ 待启动 |
> ✅ **2025-01-12 更新**：Phase 1-4 核心功能已全部完成！新增功能：批量导入订单、Tier1订单管理、学习中心页面。
>
> **数据迁移说明**：原计划从Notion迁移，现改为整合远程mydb数据库（192.168.1.160）。
### 6.2 MVP功能范围
| 功能 | MVP必须 | 后期扩展 |
|-----|---------|---------|
| 客户列表/详情 | ✅ | 高级筛选、批量操作 |
| 订单列表/详情 | ✅ | 淘宝API自动同步 |
| 手工创建订单 | ✅ | - |
| 交付操作 | ✅ | 自动分配库存 |
| 库存管理 | ✅ | 预警自动通知 |
| 工单管理 | 简化版 | 工单模板、SLA |
| 仪表盘 | 基础版 | 自定义报表 |
| 官网首页 | ✅ | - |
| 官网服务页 | ✅ | - |
| 官网咨询表单 | ✅ | CRM集成 |
### 6.3 数据迁移计划
> **方案变更**：从Notion迁移改为整合远程mydb数据库
| 数据源 | 迁移到 | 迁移方式 | 状态 |
|--------|--------|----------|:----:|
| 远程mydb表结构 | Prisma schema | 整合到本地schema.prisma | ✅ 完成 |
| mydb.subscription_orders | 本地subscription_orders | 数据手动迁移 | ⏳ 待迁移 |
| mydb.accounts | 本地accounts | 数据手动迁移 | ⏳ 待迁移 |
---
## 七、关键决策记录
| 决策项 | 决策结果 | 决策依据 | 决策日期 |
|-------|---------|---------|---------|
| 官网是否分离 | 不分离，但内容分层 | 统一品牌认知，降低维护成本 | 2026-01-09 |
| 第一层服务入口 | 继续依托淘宝 | 平台背书、已有合规体系 | 2026-01-09 |
| 官网展示范围 | 只展示二三层服务 | 合规安全、专业形象 | 2026-01-09 |
| 后台系统 | 统一CRM | 跨渠道客户识别、升级追踪 | 2026-01-09 |
| 技术栈 | Node.js + Next.js + PostgreSQL | 生态成熟、开发效率高 | 2026-01-09 |
| 部署方案 | Vercel + Supabase + Railway | 免费额度覆盖初期需求 | 2026-01-09 |
| 实施优先级 | CRM先行，官网后置 | CRM直接支撑现有业务 | 2026-01-09 |
---
## 八、待办事项清单
| 序号 | 行动项 | 优先级 | 状态 | 截止日期 |
|-----|--------|--------|------|---------|
| 1 | 整理官网首页文案 | P1 | ⏳ 待启动 | - |
| 2 | 整理AI配置服务页文案 | P1 | ⏳ 待启动 | - |
| 3 | 整理Agent定制服务页文案 | P1 | ⏳ 待启动 | - |
| 4 | 收集1-3个客户案例 | P1 | ⏳ 待启动 | - |
| 5 | 域名注册与备案 | P2 | ⏳ 待启动 | - |
| 6 | 启动数据库设计实施 | P2 | ⏳ 待启动 | - |
| 7 | 官网视觉设计 | P2 | ⏳ 待启动 | - |
---
## 附录
### A. 相关文档索引
| 文档名称 | 用途 |
|----------|------|
| 01-公司战略文档 | 公司定位、客户画像、愿景里程碑 |
| 业务框架文档v2.0 | 三层业务架构、流程、指标定义 |
| 数据架构设计文档v1.0 | 数据库表设计、ER图、状态机 |
| 产品服务信息库 | 产品详细信息、价格、服务标准 |
### B. 版本记录
| 版本 | 日期 | 更新内容 |
|------|------|----------|
| v1.0 | 2026-01-09 | 初始版本，完成架构设计、官网规划、CRM功能、技术选型、实施路径 |
| v1.1 | 2026-01-10 | 同步实际开发进展：新增项目目录结构说明；更新技术栈状态；CRM改用Vite；新增Phase 0；更新各阶段状态 |
| v1.2 | 2025-01-12 | 重大进展更新：Phase 1-4标记完成；数据库改为本地PostgreSQL；数据迁移方案改为mydb整合；新增功能说明（批量导入、Tier1管理、学习中心） |
---
*文档维护：架构调整时更新*
*维护责任人：Feifei*
*最后更新：2025年1月12日*