Web_BLV_OA_Exam_Prod/.opencode/100-business/domain.yaml

domains:
  - name: "User"
    description: "参与答题的用户"
    entities:
      - name: "User"
        description: "用户信息实体"
        attributes:
          - name: "id"
            type: "string"
            description: "用户唯一标识"
          - name: "name"
            type: "string"
            description: "用户姓名，2-20位中英文"
          - name: "phone"
            type: "string"
            description: "手机号，11位数字"
          - name: "password"
            type: "string"
            description: "登录密码 (敏感字段，仅管理员可见；当前版本为明文存储)"
          - name: "createdAt"
            type: "datetime"
            description: "创建时间"
      - name: "UserGroup"
        description: "用户组 (Note: The User Group feature (including management, assignment, and mixed selection) is implemented but currently UNTESTED. Missing Audit Log feature for User Group changes.)"
        attributes:
          - name: "id"
            type: "string"
            description: "用户组唯一标识"
          - name: "name"
            type: "string"
            description: "用户组名称"
          - name: "description"
            type: "string"
            description: "用户组描述"
          - name: "isSystem"
            type: "boolean"
            description: "是否为系统内置组 (如: 全体用户)"
          - name: "createdAt"
            type: "datetime"
            description: "创建时间"
        rules:
          - "All Users (全体用户) special group: Auto-join for new users; Cannot be deleted or modified; Users cannot exit."

  - name: "Question"
    description: "题库管理"
    entities:
      - name: "QuestionCategory"
        description: "题目类别"
        attributes:
          - name: "id"
            type: "string"
            description: "类别唯一标识"
          - name: "name"
            type: "string"
            description: "类别名称 (例如：通用/网络/数据库等)"
          - name: "createdAt"
            type: "datetime"
            description: "创建时间"
      - name: "Question"
        description: "题目实体"
        attributes:
          - name: "id"
            type: "string"
            description: "题目唯一标识"
          - name: "content"
            type: "string"
            description: "题目内容"
          - name: "type"
            type: "enum"
            values: ["single", "multiple", "judgment", "text"]
            description: "题型"
          - name: "category"
            type: "string"
            description: "题目类别名称 (默认：通用)"
          - name: "options"
            type: "json"
            description: "选项内容 (JSON格式)"
          - name: "answer"
            type: "string"
            description: "标准答案"
          - name: "score"
            type: "integer"
            description: "分值"
          - name: "createdAt"
            type: "datetime"
            description: "创建时间"

  - name: "Exam"
    description: "考试科目与考试任务"
    entities:
      - name: "ExamSubject"
        description: "考试科目 (一套出题规则)"
        attributes:
          - name: "id"
            type: "string"
            description: "科目唯一标识"
          - name: "name"
            type: "string"
            description: "科目名称"
          - name: "totalScore"
            type: "integer"
            description: "总分"
          - name: "timeLimitMinutes"
            type: "integer"
            description: "答题时间限制(分钟)，默认60"
          - name: "typeRatios"
            type: "json"
            description: "题型比重 (single/multiple/judgment/text)"
          - name: "categoryRatios"
            type: "json"
            description: "题目类别比重 (categoryName -> ratio)"
          - name: "createdAt"
            type: "datetime"
            description: "创建时间"
          - name: "updatedAt"
            type: "datetime"
            description: "更新时间"
      - name: "ExamTask"
        description: "考试任务 (给用户分派某个科目)"
        attributes:
          - name: "id"
            type: "string"
            description: "任务唯一标识"
          - name: "name"
            type: "string"
            description: "任务名称"
          - name: "subjectId"
            type: "string"
            description: "关联科目ID"
          - name: "startAt"
            type: "datetime"
            description: "开始答题时间"
          - name: "endAt"
            type: "datetime"
            description: "截止答题时间"
          - name: "createdAt"
            type: "datetime"
            description: "创建时间"
      - name: "ExamTaskUser"
        description: "任务参与用户"
        attributes:
          - name: "id"
            type: "string"
            description: "关联唯一标识"
          - name: "taskId"
            type: "string"
            description: "任务ID"
          - name: "userId"
            type: "string"
            description: "用户ID"
          - name: "assignedAt"
            type: "datetime"
            description: "分派时间"

  - name: "Quiz"
    description: "答题业务"
    entities:
      - name: "QuizRecord"
        description: "答题记录"
        attributes:
          - name: "id"
            type: "string"
            description: "记录唯一标识"
          - name: "userId"
            type: "string"
            description: "用户ID"
          - name: "totalScore"
            type: "integer"
            description: "总得分"
          - name: "correctCount"
            type: "integer"
            description: "正确题数"
          - name: "totalCount"
            type: "integer"
            description: "总题数"
          - name: "createdAt"
            type: "datetime"
            description: "答题时间"
      - name: "QuizAnswer"
        description: "单题答题详情"
        attributes:
          - name: "id"
            type: "string"
            description: "答案唯一标识"
          - name: "recordId"
            type: "string"
            description: "关联的答题记录ID"
          - name: "questionId"
            type: "string"
            description: "题目ID"
          - name: "userAnswer"
            type: "string"
            description: "用户提交的答案"
          - name: "isCorrect"
            type: "boolean"
            description: "是否正确"
          - name: "score"
            type: "integer"
            description: "该题得分"

  - name: "System"
    description: "系统配置"
    entities:
      - name: "SystemConfig"
        description: "系统全局配置"
        attributes:
          - name: "id"
            type: "string"
            description: "配置唯一标识"
          - name: "configType"
            type: "string"
            description: "配置类型键"
          - name: "configValue"
            type: "string"
            description: "配置值 (通常为JSON字符串)"
          - name: "updatedAt"
            type: "datetime"
            description: "更新时间"

  - name: "Backup"
    description: "数据备份与恢复"
    entities:
      - name: "BackupRestore"
        description: "数据导出与导入"
        attributes:
          - name: "dataType"
            type: "enum"
            values: ["users", "questions", "records", "answers"]
            description: "数据类型"
          - name: "action"
            type: "enum"
            values: ["export", "restore"]
            description: "操作类型"