refactor: 清理web_result冗余文件夹并修复路径引用
详细说明: - 删除web_result下的3个冗余文件夹(会展策划/Agent_prompt/agent头像) - 所有资源已整合到订单班文档资料/文旅目录 - 更新11个文件中的122处路径引用 - 修复wenlu.ts的TypeScript类型声明 - 添加AgentOutput类型导入 影响文件: - web_result/index.html (30处路径更新) - web_result/order-classes/wenlu/*.html (62处更新) - web_result/js/router.js (1处更新) - exhibition-demo/src/data/terminalSimulations/wenlu.ts (类型修复) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Yep_Q
151
.serena/memories/exhibition_demo_data_folder_structure.md
Normal file
151
.serena/memories/exhibition_demo_data_folder_structure.md
Normal file
@@ -0,0 +1,151 @@
|
||||
# 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 必须包含：
|
||||
|
||||
```typescript
|
||||
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
|
||||
Reference in New Issue
Block a user