# CRM 客户管理插件 — 实施计划

## Context

ERP 平台底座已完成 Phase 1-6 及 WASM 插件系统原型验证。本计划基于已批准的设计规格文档 `docs/superpowers/specs/2026-04-16-crm-plugin-design.md` v1.1，实施第一个行业插件——客户管理（CRM）。

设计规格经历了三组专家（架构师、UX 架构师、高级开发者）审查 + Spec 文档审查，所有 CRITICAL/HIGH 问题已修复。

## 关键决策回顾

- **插件形式**：WASM 插件（非内置 crate）
- **数据层**：5 个 JSONB 动态表，通过 Host API 操作
- **UI 层**：完全配置驱动，插件不写前端代码，新 UI 能力沉淀到基座组件库
- **策略**：先修基座再做插件
- **Skill 沉淀**：CRM 开发经验提炼为可复用 skill

## 实施步骤

### Step 1: 调用 writing-plans skill 创建详细实施计划

**操作**：调用 `writing-plans` skill，基于设计规格文档 `docs/superpowers/specs/2026-04-16-crm-plugin-design.md` 创建分 Phase 的详细实施计划。

**输入给 writing-plans 的上下文**：
- 设计规格文档路径：`docs/superpowers/specs/2026-04-16-crm-plugin-design.md`
- 三期划分：Phase 1（基座增强）→ Phase 2（CRM 插件核心）→ Phase 3（高级功能）
- 专家审查报告路径：
  - `plans/flickering-tinkering-pebble-agent-a409e20167941384b.md`（架构师）
  - `plans/flickering-tinkering-pebble-agent-a785dda8d2f4eeebc.md`（高级开发者）
  - `plans/flickering-tinkering-pebble-agent-ae1f1bf7d07977a2d.md`（UX 架构师）
- Skill 沉淀要求：CRM 完成后将开发经验提炼为可复用 skill

### Step 2: 按计划实施 Phase 1 — 基座增强

**前置条件**：Phase 1 是 CRM 插件的前置条件，必须先完成。

Phase 1 的关键交付物：
1. Bug 修复：唯一索引（`dynamic_table.rs`）、权限注册（`service.rs`）、数据 Handler 动态权限（`data_handler.rs`）
2. REST API 过滤/搜索/排序（`dynamic_table.rs` + `data_service.rs` + `data_handler.rs` + `dto.rs`）
3. Manifest schema 扩展（`manifest.rs`）
4. 前端 CRUD 增强 + detail 页面 + visible_when（`PluginCRUDPage.tsx` + `PluginDetailPage.tsx` + `pluginData.ts`）
5. 数据校验层

### Step 3: 按计划实施 Phase 2 — CRM 插件核心

**前置条件**：Phase 1 全部完成 + 验收通过。

Phase 2 的关键交付物：
1. CRM WASM 插件 Rust 代码（`crates/erp-plugin-crm/`）
2. CRM manifest（`plugin.toml`）
3. 前端 tree/timeline/tabs 通用页面组件
4. 侧边栏动态菜单集成

### Step 4: 按计划实施 Phase 3 — 高级功能

**前置条件**：Phase 2 全部完成 + 验收通过。

Phase 3 的关键交付物：
1. 前端 graph 页面类型（AntV G6）
2. 前端 dashboard 页面类型
3. Host API 扩展（db-count/db-aggregate）
4. 关系图谱 + 统计概览

### Step 5: 提炼插件开发 Skill

**前置条件**：Phase 2 完成后即可开始（Phase 3 可并行）。

将 CRM 开发经验提炼为可复用 skill，包含：
- 插件开发流程指南
- Manifest 配置模板
- Rust 插件脚手架
- 可用页面类型清单
- 测试检查清单

## 验证方式

每个 Phase 完成后执行设计规格中的验收标准检查，具体验收项见 `docs/superpowers/specs/2026-04-16-crm-plugin-design.md` 第 8 节。