Instruction file imported from postdare/mop (.cursor/rules/project.mdc). Copyright stays with the author.

Foundra Lab 项目规范

项目架构

全栈 AI 视频创作平台：

• 前端: Vue 3 + TypeScript + Vite + Pinia + TailwindCSS
• 后端: Next.js 14 + TypeScript + Prisma + SQLite
• AI: 火山引擎 Doubao / Minimax

核心原则

• 大道至简 - 代码简洁，避免过度设计
• 类型安全 - 消除 any，使用具体类型
• 单一职责 - 每个模块职责清晰
• 统一模式 - 遵循一致的代码风格

目录结构

frontend/src/
├── api/          # API 封装
├── components/   # 组件
├── composables/  # 组合式函数
├── config/       # 配置（按包组织）
├── lib/          # 核心工具（http, logger, rest）
├── stores/       # Pinia 状态
├── types/        # 类型定义
├── utils/        # 工具函数
└── views/        # 页面

backend/src/
├── app/api/      # API 路由
├── lib/          # 核心逻辑
│   ├── http/     # HTTP 响应/错误处理
│   ├── db/       # 数据库工具（types, where, transform）
│   ├── ai/       # AI 客户端
│   └── logger.ts # 日志服务
└── prisma/       # 数据库 Schema

数据模型

User → Project → Script
              → Element
              → Storyboard → Shot
              → Clip
     → Asset

端口

• 前端: 5173
• 后端: 3001