Agent-n8n/.serena/memories/exhibition_demo_data_folder_structure.md

Exhibition Demo 项目 Data 文件夹结构规范

概述

exhibition-demo 项目中存在两个 data 文件夹，各自有明确的用途和归档规范。

📁 src/data/ - 应用程序逻辑数据

用途

存放前端应用的配置数据和业务逻辑代码

内容结构

src/data/
├── terminalSimulations/     # 终端模拟逻辑（TypeScript）
│   ├── food.ts             # 食品订单班模拟
│   ├── wenlu.ts            # 文旅订单班模拟
│   └── ...                 # 其他订单班模拟
├── agents/                 # Agent 配置逻辑
└── orderClasses.json       # 订单班分类配置

特点

• 文件类型：TypeScript (.ts) / JavaScript (.js) / JSON (.json)
• 处理方式：会被 Vite 打包到应用中
• 访问方式：通过 import 导入到代码中使用

适合存放的内容

✅ TypeScript 配置文件 ✅ JavaScript 逻辑代码 ✅ JSON 配置数据 ✅ Agent 业务逻辑 ✅ 模拟数据生成代码

不适合存放的内容

❌ 图片文件 ❌ 文档文件 ❌ 静态资源 ❌ 头像图片

---

📁 public/data/ - 静态资源文件

用途

存放静态资源文件，通过 URL 直接访问

内容结构

public/data/
├── Agent_prompt/           # Agent 提示词文档
├── agent头像/              # Agent 头像图片
├── 会展策划/               # 会展相关资源
└── 订单班文档资料/         # 软链接 -> 项目根目录/data/订单班文档资料

特点

• 文件类型：图片 (.jpg/.png/.svg) / 文档 / 其他静态文件
• 处理方式：不会被打包，直接复制到构建输出目录
• 访问方式：通过 /data/... URL 路径在浏览器中访问

软链接说明

public/data/订单班文档资料 是一个符号链接，指向：

/Users/xiaoqi/Documents/Dev/Project/2025-09-08_n8nDEMO演示/data/订单班文档资料

重要: 此软链接已经创建，不需要重复创建。Vite 配置中已添加 fs.allow: ['..'] 允许访问。

适合存放的内容

✅ 图片文件（.jpg, .png, .svg, .webp） ✅ Agent 头像 ✅ 文档资料 ✅ Markdown 文件 ✅ 其他静态资源

不适合存放的内容

❌ TypeScript 代码 ❌ JavaScript 逻辑 ❌ JSON 配置（应放在 src/data/） ❌ 需要被打包的代码

---

🎯 快速判断规则

问自己：

1. 这是代码吗？ → 放 src/data/
2. 这是资源吗？ → 放 public/data/

示例判断

文件类型	存放位置	原因
food.ts	src/data/terminalSimulations/	业务逻辑代码
orderClasses.json	src/data/	配置数据
餐饮市场调研专家.jpeg	public/data/agent头像/	静态图片资源
Agent提示词.md	public/data/Agent_prompt/	文档资源
店面图片_正门.jpg	public/data/订单班文档资料/食品/...	文档配图

---

🔧 Vite 配置要求

为了让 public/data/ 中的软链接正常工作，vite.config.ts 必须包含：

export default defineConfig({
  server: {
    fs: {
      allow: ['..'],  // 允许访问父目录
    },
  },
  preview: {
    fs: {
      allow: ['..'],
    },
  },
})

---

⚠️ 违规提醒清单

如果发现以下情况，需要提醒用户：

src/data/ 违规情况

• 存放了图片文件（应移到 public/data/）
• 存放了文档文件（应移到 public/data/）
• 存放了头像文件（应移到 public/data/agent头像/）

public/data/ 违规情况

• 存放了 .ts 文件（应移到 src/data/）
• 存放了 .js 文件（应移到 src/data/）
• 存放了业务逻辑 JSON（应移到 src/data/）

---

📝 维护建议

1. 定期检查: 确保文件归档符合规范
2. 命名规范: 使用描述性文件名（如：店面图片_正门.jpg）
3. 路径引用:
   • src/data/ 使用 import 引用
   • public/data/ 使用 /data/... URL 引用
4. 软链接维护: 不要删除或重建已存在的软链接

---

最后更新

2025-10-01