# Project: 展会策划 AI 多智能体协作演示系统 + n8n 中文版工作流平台
_Last updated: 2025-09-28_

## Pinned（仅高置信"必须遵守"写入；受保护不可修订）
- ⚠️ 必须使用 pnpm（不能用 npm/yarn）
- ⚠️ n8n 命令在 n8n-n8n-1.109.2/ 目录执行
- ⚠️ 提交前必须运行 lint 和 typecheck
- ⚠️ Git 提交到 My_N8N 分支（自动化）
- ⚠️ n8n 运行端口: 5678，展会演示系统运行端口: 4173，食品订单班运行端口: 4174
- ⚠️ 项目核心目标：演示 AI 多智能体协作进行展会策划，基于 n8n 工作流平台

## Decisions（按时间顺序追加，历史不可改）
- 2025-09-07: 确定使用 n8n-1.109.2 版本进行完整中文化（理由：成熟稳定版本，功能完整）
- 2025-09-08: 决定创建展会策划 AI 多智能体演示系统（理由：展示AI协作能力）
- 2025-09-08: 采用 React 18 + TypeScript + Tailwind CSS 技术栈（理由：现代化前端架构）
- 2025-09-09: 创建专门的展会展示页面集合（理由：完整的展示体验）
- 2025-09-26: 创建 duoduo_Multiple_Agents 分支用于多智能体展示（理由：功能演示需要）
- 2025-09-28: 确定食品订单班采用"青莳轻食"中高端轻食店铺经营案例（理由：强调营养科学和食品安全差异化）
- 2025-09-28: 将采用基于文旅订单班的成功模板进行快速复制开发策略（理由：已验证框架可实现90%代码复用）

## TODO（权威待办清单）
- [P1][OPEN][#1] 优化 Duoduo Agent 设计系统的用户交互体验
- [P1][OPEN][#2] 完善多智能体协作流程的错误处理机制
- [P2][OPEN][#3] 添加更多展会类型的模板支持
- [P2][OPEN][#4] 验证所有展示页面的可用性
- [P0][OPEN][#13] 开始实际开发食品订单班演示系统（Context：doc/订单班演示策划方案/食品订单班_轻食店铺经营方案.md）
- [P1][OPEN][#14] 准备食品订单班Agent头像和UI素材（Context：需要7个Agent形象设计）
- [P1][OPEN][#15] 实施食品订单班4天开发计划（Context：复用文旅订单班React框架，代码复用率90%）
- [P0][OPEN][#17] 设计每个订单班的专属AI Agent组合（Context：基于12个订单班场景）
- [P1][OPEN][#18] 基于文旅模板创建可复用开发框架（Context：支持快速部署新订单班）
- [P1][OPEN][#19] 实施Docker Compose统一部署方案（Context：多订单班系统集成管理）
- [P0][OPEN][#20] 优先开发3个重点订单班：财经商贸、智能开发、智能制造（Context：演示核心场景）

## In Progress
- [P1][DOING][#5] 维护和优化当前多智能体展示分支功能

## Done（最近完成的放前面）
- 2025-09-28: [#21] 完成所有12个订单班的文案资料准备（evidence：财经商贸、食品、智能开发、智能制造、视觉设计、交通物流、土木水利、大健康、能源、化工、环保订单班文案全部就绪）
- 2025-09-28: [#12] 完成食品订单班实施方案设计（evidence: doc/订单班演示策划方案/食品订单班_轻食店铺经营方案.md）
- 2025-09-26: [#6] 创建完整的项目历史记录和现状说明（evidence: progress.md 完整更新）
- 2025-09-09: [#7] 完成4个展会展示页面开发（evidence: web_frontend/web_result/pages/）
- 2025-09-09: [#8] 实现 Duoduo Agent 智能设计系统（evidence: operation.html）
- 2025-09-08: [#9] 开发7个专业AI Agent协作系统（evidence: web_frontend/exhibition-demo/）
- 2025-09-08: [#10] 创建展会策划68页方案生成功能（evidence: 3分钟生成完整方案）
- 2025-09-07: [#11] 完成 n8n 平台完整中文化（evidence: 3465行翻译完成）
- 2025-09-26: [#16] 创建项目基础结构和分支管理（evidence: git branch duoduo_Multiple_Agents）

## Risks & Assumptions
- Risk：多智能体系统复杂度高可能影响维护性（Mitigation：模块化设计，清晰的接口定义）
- Risk：n8n 版本更新可能导致中文化丢失（Mitigation：版本控制管理，定期备份）
- Risk：n8n 1.109.2 版本可能存在兼容性问题（Mitigation：使用标准安装流程和依赖锁定）
- Risk：12个订单班同时开发资源分散（Mitigation：优先开发3个重点订单班，模板化快速复制）
- Assumption：用户具备基本的n8n使用经验（Confidence: Medium）
- Assumption：展会策划需求相对标准化（Confidence: High）
- Assumption：开发环境支持 Node.js 和 pnpm 工具链（Confidence: High）
- Assumption：食品订单班基于文旅订单班框架，代码复用可达90%（Confidence: High）
- Assumption：订单班模板化开发可将总工期从6-7周缩短至4周（Confidence: High）

## Notes（简要要点）
- 2025-09-28: 项目战略调整：总工期从6-7周缩短至4周（因文档已全部就绪）
- 2025-09-28: 12个订单班文案完成情况：财经商贸、食品、智能开发、智能制造、视觉设计、交通物流、土木水利、大健康、能源、化工、环保订单班核心场景定义全部完成
- 2025-09-28: 开发优先级确定：先开发财经商贸、智能开发、智能制造3个重点订单班作为演示核心
- 2025-09-28: 技术策略确定：基于文旅订单班成功模板进行快速复制，实现代码复用率90%
- 2025-09-28: 部署策略：采用Docker Compose统一部署方案，支持多订单班系统集成管理
- 2025-09-26: 项目包含两个主要组成部分：n8n中文版平台 + AI多智能体展会策划演示系统
- 2025-09-26: 技术架构采用 Monorepo 结构，支持多个子系统协同开发
- 2025-09-26: Duoduo Agent 设计系统实现20小时交付（传统2周），95%设计准确率，80%成本节约
- 2025-09-26: 当前工作分支为 duoduo_Multiple_Agents，专门用于多智能体功能展示
- 2025-09-26: 项目起始于2025-09-07（n8n中文化），2025-09-08（展会系统开发）
- 2025-09-26: 项目采用 Monorepo 架构（pnpm workspaces + Turbo）
- 2025-09-26: 技术栈包含 Vue 3 + TypeScript + Vite + Pinia 前端，Node.js + Express + TypeORM 后端
- 2025-09-26: 包含四个主要展示页面：exhibition.html、marketing.html、operation.html、overview.html
- 2025-09-26: 配置了 progress-recorder 智能体用于项目记忆管理
- 2025-09-26: 重要矫正：data/智能开发/Agent/ 目录存放前端资源附件，非智能体资源；真正的Claude智能体配置在.claude/agents/目录
- 2025-09-28: 食品订单班方案已完成：基于"青莳轻食"案例，7个AI Agent（市场研究、营养配方、供应链、品牌策划、财务分析、运营管理、创业导师）
- 2025-09-28: 食品订单班核心差异化：强调营养科学+食品安全，食材溯源二维码，营养标签热量计算，品控10条标准
- 2025-09-28: 食品订单班技术实现：复用文旅订单班React框架，代码复用率90%，开发周期4天，独立部署端口4174

## Context Index（轻量索引）
- 项目结构: 2025-09-08_n8nDEMO演示/
  - n8n-n8n-1.109.2/ (中文版源码)
  - web_frontend/exhibition-demo/ (React多智能体演示)
  - web_frontend/web_result/ (展会HTML页面)
  - data/智能开发/Agent/ (项目附件：前端资源、字体等)
  - .claude/agents/ (Claude智能体配置)
  - doc/订单班演示策划方案/ (食品订单班方案文档)
  - doc/notion文档资料/食品/ (食品订单班素材来源)
- 运行命令:
  - n8n平台: cd n8n-n8n-1.109.2 && ./start.sh
  - 展会演示: cd web_frontend/exhibition-demo && pnpm preview
  - 食品订单班: 端口4174（待开发）
- 分支管理:
  - main (主分支)
  - My_N8N (个人开发分支)
  - Web_Create (Web创建分支)
  - duoduo_Multiple_Agents (当前：多智能体展示)
- 重要页面:
  - exhibition.html (会展智能页面)
  - marketing.html (营销推广页面)
  - operation.html (AI布局设计-重点页面)
  - overview.html (总览页面)