henrydiaosi/ai-framework/src

src/
├── modules/           # 功能模块
│   ├── auth/         # 认证模块
│   └── user/         # 用户模块
├── core/             # 核心模块
│   ├── database/     # 数据库连接
│   ├── logger/       # 日志服务
│   └── error/        # 错误处理
├── shared/           # 共享代码
│   ├── utils/        # 工具函数
│   └── types/        # 类型定义
└── index.ts          # 入口文件

module-name/
├── SKILL.md              # 模块文档
├── index.ts              # 模块入口，导出公共 API
├── controllers/          # 控制器层
├── services/             # 服务层
├── models/               # 数据模型
├── types/                # 类型定义
└── __tests__/            # 测试文件

// ✅ 正确：使用模块入口导入
import { AuthService, LoginDto } from '@/modules/auth';
// ❌ 错误：直接导入内部文件
import { AuthService } from '@/modules/auth/services/auth.service';

// ✅ 正确：使用统一的错误类型
import { ValidationError, NotFoundError } from '@/core/error';
throw new ValidationError('Invalid email format');
// ❌ 错误：使用通用 Error
throw new Error('Invalid email format');

modules/auth ──────┐
                   ├──> core/database
modules/user ──────┤
                   ├──> core/logger
                   └──> core/error