erp/plans/flickering-tinkering-pebble.md

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 节。