【自学AI】11 在写代码之前，先把设计想清楚

1
import { Prop, Schema, SchemaFactory } from '@nestjs/mongoose';
2
import { Document, SchemaTypes, Types } from 'mongoose';
3

4
export type ResumeQuizResultDocument = ResumeQuizResult & Document;
5

6
/**
7
 * 题目难度枚举
8
 * 三个难度对应面试的三个阶段：热身 → 考察 → 探深度
9
 */
10
export enum QuestionDifficulty {
11
  EASY = 'easy',     // 基础题，约占 30%
12
  MEDIUM = 'medium', // 中等题，约占 50%
13
  HARD = 'hard',     // 高级题，约占 20%
14
}
15

16
/**
17
 * 题目类别枚举
18
 * 覆盖面试中常见的几种题型
19
 */
20
export enum QuestionCategory {
21
  TECHNICAL = 'technical',             // 技术能力（考察具体技术栈）
22
  PROJECT = 'project',                 // 项目经验（基于简历中的项目）
23
  PROBLEM_SOLVING = 'problem-solving', // 问题解决（算法、设计等）
24
  SOFT_SKILL = 'soft-skill',           // 软技能（沟通、协作等）
25
  BEHAVIORAL = 'behavioral',           // 行为面试（STAR 法则类）
26
  SCENARIO = 'scenario',               // 场景题（如果遇到 XX 情况你怎么做）
27
}
28

29
/**
30
 * 单个面试题目
31
 * _id: false 表示 MongoDB 不为子文档自动生成 _id
32
 */
33
@Schema({ _id: false })
34
export class InterviewQuestion {
35
  @Prop({ required: true })
36
  question: string; // 题目内容
37

38
  @Prop({ required: true })
39
  answer: string; // 参考答案
40

41
  @Prop({ enum: QuestionCategory, required: true })
42
  category: QuestionCategory; // 题目类别
43

44
  @Prop({ enum: QuestionDifficulty, required: true })
45
  difficulty: QuestionDifficulty; // 难度
46

47
  @Prop()
48
  tips?: string; // 回答技巧提示
49

50
  @Prop({ type: [String], default: [] })
51
  keywords?: string[]; // 关键词（方便前端高亮显示）
52

53
  @Prop()
54
  reasoning?: string; // 出题理由（帮助用户理解考察点）
55

56
  @Prop({ default: false })
57
  isFavorite?: boolean; // 用户是否收藏了这道题
58

59
  @Prop({ default: false })
60
  isPracticed?: boolean; // 用户是否已练习
61

62
  @Prop()
63
  practicedAt?: Date; // 练习时间
64

65
  @Prop()
66
  userNote?: string; // 用户自己的笔记
67
}
68

69
export const InterviewQuestionSchema =
70
  SchemaFactory.createForClass(InterviewQuestion);
71

72
/**
73
 * 技能匹配项
74
 * 用于展示用户技能和岗位要求的对比
75
 */
76
@Schema({ _id: false })
77
export class SkillMatch {
78
  @Prop({ required: true })
79
  skill: string; // 技能名称（如 "NestJS"、"微服务架构"）
80

81
  @Prop({ required: true })
82
  matched: boolean; // 用户简历中是否有这个技能
83

84
  @Prop()
85
  proficiency?: string; // 熟练度描述（如 "熟练"、"了解"、"缺失"）
86
}
87

88
export const SkillMatchSchema = SchemaFactory.createForClass(SkillMatch);

1
import { Prop, Schema, SchemaFactory } from '@nestjs/mongoose';
2
import { Document, SchemaTypes, Types } from 'mongoose';
3

4
export type ConsumptionRecordDocument = ConsumptionRecord & Document;
5

6
/**
7
 * 消费类型枚举
8
 * 每种功能对应一个类型，方便按功能统计消费
9
 */
10
export enum ConsumptionType {
11
  RESUME_QUIZ = 'resume_quiz',               // 简历押题（本篇实现）
12
  SPECIAL_INTERVIEW = 'special_interview',   // 专项面试（后续实现）
13
  BEHAVIOR_INTERVIEW = 'behavior_interview', // 行测+HR 面试（后续实现）
14
  AI_INTERVIEW = 'ai_interview',             // AI 模拟面试（后续实现）
15
}
16

17
/**
18
 * 消费状态枚举
19
 * 这是一个状态机：pending → success 或 failed
20
 * 失败时自动退还配额
21
 */
22
export enum ConsumptionStatus {
23
  PENDING = 'pending',     // 处理中（已扣费，AI 正在生成）
24
  SUCCESS = 'success',     // 成功（生成完成，配额正常扣除）
25
  FAILED = 'failed',       // 失败（已自动退款，配额已退还）
26
  CANCELLED = 'cancelled', // 用户主动取消
27
}
28

29
/**
30
 * 消费记录 Schema
31
 */
32
@Schema({ timestamps: true })
33
export class ConsumptionRecord {
34
  @Prop({ required: true, unique: true })
35
  recordId: string; // 消费记录唯一 ID（用于幂等性检查）
36

37
  @Prop({
38
    type: SchemaTypes.ObjectId,
39
    ref: 'User',
40
    required: true,
41
    index: true,
42
  })
43
  user: Types.ObjectId;
44

45
  @Prop({ required: true, index: true })
46
  userId: string; // 字符串形式，便于直接查询，不需要 populate
47

48
  @Prop({ required: true, enum: ConsumptionType, index: true })
49
  type: ConsumptionType;
50

51
  @Prop({
52
    required: true,
53
    enum: ConsumptionStatus,
54
    default: ConsumptionStatus.PENDING,
55
  })
56
  status: ConsumptionStatus;
57

58
  @Prop({ required: true })
59
  consumedCount: number; // 消费的次数（通常为 1）
60

61
  @Prop()
62
  description?: string; // 消费描述（如 "生成简历押题 - Java 后端开发"）
63

64
  @Prop()
65
  createdAt: Date;
66
}
67

68
export const ConsumptionRecordSchema =
69
  SchemaFactory.createForClass(ConsumptionRecord);