Project Structure Guide

项目目录结构与文件组织规范。

Core Directories

Route Groups

app/
├── (auth)/      # Login, register
├── (main)/      # Dashboard, settings
├── (marketing)/ # Landing, pricing
└── (admin)/     # Admin panel

Forbidden Directories

• •src/ - Conflicts with App Router
• •shared/ - Use components/common
• •helpers/ - Use lib/utils
• •services/ (root) - Must be in lib/services

File Naming

• •Directories: kebab-case (user-profile/)
• •Components: kebab-case.tsx (user-card.tsx)
• •Services: [name].service.ts
• •Types: types.ts

Example: Add User Feature

app/(main)/users/
├── page.tsx
└── [id]/page.tsx

components/common/users/
├── user-table.tsx
└── user-filters.tsx

lib/services/user/
├── user.service.ts
├── types.ts
└── index.ts

Modularization Rules