AI 全栈开发实战手册

# 项目上下文## 技术栈- 前端：Vue 3 + TypeScript + Vite + Pinia- 后端：Node.js + NestJS + TypeORM- 数据库：MySQL 8.0 + Redis## 目录结构- src/api/        前端接口封装- src/components/ 前端组件- server/src/     后端源码- server/src/entity/  数据库实体## 约定- 时间字段统一 snake_case：created_at, updated_at- 响应格式：{ code, message, data }- 错误码：0 成功，非 0 失败

## 任务生成一个「用户列表」组件## 技术栈Vue 3 + TypeScript + <script setup> + Element Plus## API 契约（来自设计文档）GET /api/users?page=1&pageSize=10响应：{ code: 0, data: { list: User[], total: number } }User 字段：id, nickname, avatar, created_at## 要求1. 使用 useFetch 封装的请求方法2. 分页用 el-pagination3. 加载态用 el-skeleton4. 时间字段 created_at 用 dayjs 格式化为 YYYY-MM-DD5. 空数据展示 el-empty## 约束- 不引入新的依赖- 遵循项目现有命名规范

## 任务实现用户注册接口## API 契约POST /api/auth/register请求体：{ username, password, nickname }响应：{ code: 0, message: 'ok', data: { token, user } }## 数据模型users 表：id, username(唯一), password(加密), nickname, created_at## 技术栈与框架[Node + NestJS / Java + Spring Boot / PHP + ThinkPHP]## 要求1. 密码用 bcrypt 加密存储2. username 查重，重复返回业务错误3. 成功签发 JWT4. 参数校验失败返回统一错误格式

// auth.controller.ts@Post('register')async register(@Body() dto: RegisterDto) {  return this.authService.register(dto)}// auth.service.tsasync register(dto: RegisterDto) {  const exists = await this.userRepo.findOneBy({ username: dto.username })  if (exists) throw new BusinessException('用户名已存在')  const hash = await bcrypt.hash(dto.password, 10)  const user = await this.userRepo.save({ ...dto, password: hash })  const token = this.jwtService.sign({ sub: user.id })  return { token, user }}

@PostMapping("/register")public Result<AuthVO> register(@Valid @RequestBody RegisterDTO dto) {    if (userService.existsByUsername(dto.getUsername())) {        throw new BusinessException("用户名已存在");    }    User user = userService.register(dto);    String token = jwtUtil.generateToken(user.getId());    return Result.ok(new AuthVO(token, user));}

public function register(Request $request){    $data = $request->validate([        'username' => 'require|unique:users',        'password' => 'require|min:6',    ]);    $data['password'] = password_hash($data['password'], PASSWORD_BCRYPT);    $user = User::create($data);    $token = Jwt::encode(['sub' => $user->id]);    return json(['code' => 0, 'data' => ['token' => $token, 'user' => $user]]);}

## 鉴权要求1. JWT 放在 Authorization: Bearer <token> 头2. 中间件统一解析 token，挂载当前用户到请求上下文3. 角色：admin / member，admin 可访问 /admin/* 路由4. token 过期返回 code=401，权限不足返回 code=403

## 校验规则（三端统一）- username：3-20 位，字母数字下划线- password：6-32 位，至少含字母和数字- nickname：1-30 位，任意字符

## 任务设计「旅游线路」相关的表结构## 业务实体与关系- 线路 line：一个线路属于一个分类 category（多对一）- 线路有多个行程日 itinerary（一对多）- 用户可收藏线路（多对多，通过收藏表）- 用户可下单 order（用户与线路多对多，通过订单表）## 要求1. 所有表统一含 id, created_at, updated_at2. 金额字段用 DECIMAL(10,2)3. 状态字段用 TINYINT + 注释枚举值4. 外键关系用索引保证，不强制物理外键

## 查询需求查询「本周热门线路 Top10」，口径：- 热门 = 订单数（已支付状态）- 时间范围 = 本周（周一 0 点至今）- 结果字段：线路名、封面、价格、订单数- 按订单数倒序，不足 10 条则全返回

SELECT l.id, l.name, l.cover, l.price, COUNT(o.id) AS order_countFROM line lLEFT JOIN `order` o  ON o.line_id = l.id AND o.status = 1                       -- 已支付 AND o.paid_at >= DATE_FORMAT(CURDATE(), '%Y-%m-%d 00:00:00')GROUP BY l.id, l.name, l.cover, l.priceORDER BY order_count DESCLIMIT 10

## 慢查询SELECT * FROM `order` WHERE user_id = 123 AND status = 1ORDER BY created_at DESC LIMIT 20## EXPLAIN 结果type=ALL, rows=500000（全表扫描）## 请给出1. 建议的联合索引及原因2. 为什么 user_id 单列索引不够

// TypeORM 实体@Entity('users')export class User {  @PrimaryGeneratedColumn()  id: number  @Column({ unique: true, length: 20 })  username: string  @Column({ name: 'created_at' })  createdAt: Date   // 显式映射 snake_case → camelCase}

{  "code": 0,  "message": "ok",  "data": {}}

## 任务给后端代码加 Swagger 注解，自动生成 OpenAPI 文档## 要求1. 每个接口标注 @ApiOperation 中文说明2. DTO 字段用 @ApiProperty 标注说明与示例3. 分组按模块：auth / user / line / order

## 任务为 passwordStrength 函数写单元测试## 函数逻辑密码强度校验：6 位以下=弱，6-11 位=中，12 位以上且含数字+字母=强## 要求覆盖：空密码、6 位边界、12 位边界、纯数字、纯字母、特殊字符

## 任务为 /api/auth/register 写接口测试## 契约POST /api/auth/register请求：{ username, password, nickname }成功：code=0, data.token 非空重复用户名：code=1001缺少字段：code=400## 要求用 supertest / 或 Postman 集合，覆盖上述三种情况

## 任务为用户「注册→登录→下单→支付」写 E2E 测试## 操作路径1. 打开注册页 → 填表单 → 提交2. 跳转登录 → 输入凭证 → 登录成功3. 进入线路详情 → 点「立即预订」4. 提交订单 → 模拟支付成功5. 断言订单状态变为「已支付」## 工具Playwright

## 任务为前端项目写 Dockerfile（多阶段构建）## 信息- 构建：pnpm install && pnpm build，产物在 dist/- 运行：Nginx 托管静态文件，支持 history 路由- 基础镜像：node:20-alpine 构建，nginx:alpine 运行

## 任务写 GitHub Actions 工作流## 要求1. push 到 master 触发2. 前端：pnpm build → 产物上传3. 后端：mvn package → 构建镜像4. 部署：SSH 到服务器执行部署脚本5. 失败时通知

## 任务写 Nginx 配置，实现前后端分离部署## 要求1. 静态文件 / 交给前端 build 产物2. /api/ 反向代理到后端 :80803. history 路由 fallback 到 index.html4. 上传文件 50MB 限制

## 任务写后端一键部署脚本## 流程1. 停止旧服务2. 备份旧 jar3. 上传新 jar4. 启动服务5. 健康检查（最多重试 5 次）6. 失败自动回滚

## 需求一个待办事项应用：用户注册登录，可增删改查自己的待办，支持标记完成、按状态筛选。## 请先产出1. 数据模型（表结构）2. API 契约3. 目录结构不要写任何代码。

CREATE TABLE users (  id INT AUTO_INCREMENT PRIMARY KEY,  username VARCHAR(20) UNIQUE NOT NULL,  password VARCHAR(100) NOT NULL,  created_at DATETIME DEFAULT CURRENT_TIMESTAMP);CREATE TABLE todos (  id INT AUTO_INCREMENT PRIMARY KEY,  user_id INT NOT NULL,  title VARCHAR(200) NOT NULL,  status TINYINT DEFAULT 0,        -- 0未完成 1已完成  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,  INDEX idx_user_status (user_id, status));

// 统一错误码（前后端各存一份，内容一致）export const ErrorCode = {  SUCCESS: 0,  PARAM_ERROR: 400,  UNAUTHORIZED: 401,  FORBIDDEN: 403,  NOT_FOUND: 404,  SERVER_ERROR: 500,  USER_EXISTS: 1001,  TODO_NOT_FOUND: 2001,} as const

# 前端 .envVITE_API_BASE=/api# 后端 .envDB_HOST=localhostJWT_SECRET=xxx# 部署（compose）API_BASE_URL=http://localhost:8080