xj-study 0.1.0__py3-none-any.whl

xj_study/admin.py

@@ -0,0 +1,67 @@
+from django.contrib import admin
+
+from .models import StudySubject, StudyStage, StudyUnit, StudyTask, StudyUserSubject, StudyUserStage, StudyUserUnit, StudyUserTask
+
+
+@admin.register(StudySubject)
+class StudySubjectAdmin(admin.ModelAdmin):
+    list_display = ("id", "name", "enable", "subject_total_score", "subject_pass_score", "subject_weight_score", "open_time", "close_time", "publish_time", "icon", "sort", "create_time", "update_time")
+    list_filter = ("enable",)
+    search_fields = ("name",)
+    list_editable = ("name", "enable", "subject_total_score", "subject_pass_score", "subject_weight_score", "icon", "sort")
+
+
+@admin.register(StudyStage)
+class StudyStageAdmin(admin.ModelAdmin):
+    list_display = ("id", "subject", "name", "enable", "course_book", "stage_total_score", "stage_pass_score", "stage_weight_score", "open_time", "close_time", "publish_time", "icon", "sort", "create_time", "update_time")
+    list_filter = ("enable", "subject")
+    search_fields = ("name", "course_book")
+    list_editable = ("name", "enable", "course_book", "stage_total_score", "stage_pass_score", "stage_weight_score", "icon", "sort")
+
+
+@admin.register(StudyUnit)
+class StudyUnitAdmin(admin.ModelAdmin):
+    list_display = ("id", "stage", "name", "enable", "unit_total_score", "unit_pass_score", "unit_weight_score", "credit", "open_time", "close_time", "publish_time", "icon", "sort", "create_time", "update_time")
+    list_filter = ("enable", "stage")
+    search_fields = ("name", "unit_description")
+    list_editable = ("name", "enable", "unit_total_score", "unit_pass_score", "unit_weight_score", "credit", "icon", "sort")
+
+
+@admin.register(StudyTask)
+class StudyTaskAdmin(admin.ModelAdmin):
+    list_display = ("id", "unit", "name", "enable", "exam_url", "thread_id", "task_total_score", "task_pass_score", "task_weight_score", "time_limit", "open_time", "close_time", "publish_time", "icon", "sort", "create_time", "update_time")
+    list_filter = ("enable", "unit")
+    search_fields = ("name", "exam_url", "thread_id")
+    list_editable = ("name", "enable", "exam_url", "thread_id", "task_total_score", "task_pass_score", "task_weight_score", "time_limit", "icon", "sort")
+
+
+@admin.register(StudyUserSubject)
+class StudyUserSubjectAdmin(admin.ModelAdmin):
+    list_display = ("id", "user_id", "user_uuid", "subject", "user_subject_score", "user_subject_weight", "is_pass", "icon", "sort", "create_time", "update_time")
+    list_filter = ("is_pass", "subject")
+    search_fields = ("user_uuid",)
+    list_editable = ("user_subject_score", "is_pass", "icon", "sort")
+
+
+@admin.register(StudyUserStage)
+class StudyUserStageAdmin(admin.ModelAdmin):
+    list_display = ("id", "user_id", "user_uuid", "stage", "user_stage_score", "user_stage_weight", "is_pass", "icon", "sort", "create_time", "update_time")
+    list_filter = ("is_pass", "stage")
+    search_fields = ("user_uuid",)
+    list_editable = ("user_stage_score", "is_pass", "icon", "sort")
+
+
+@admin.register(StudyUserUnit)
+class StudyUserUnitAdmin(admin.ModelAdmin):
+    list_display = ("id", "user_id", "user_uuid", "unit", "user_unit_score", "user_unit_weight", "is_pass", "icon", "sort", "create_time", "update_time")
+    list_filter = ("is_pass", "unit")
+    search_fields = ("user_uuid",)
+    list_editable = ("user_unit_score", "is_pass", "icon", "sort")
+
+
+@admin.register(StudyUserTask)
+class StudyUserTaskAdmin(admin.ModelAdmin):
+    list_display = ("id", "user_id", "user_uuid", "task", "user_task_score", "user_task_weight", "is_pass", "start_time", "finish_time", "icon", "sort", "create_time", "update_time")
+    list_filter = ("is_pass", "task")
+    search_fields = ("user_uuid",)
+    list_editable = ("user_task_score", "is_pass", "icon", "sort")

xj_study/apis/study_stage_api.py

@@ -0,0 +1,47 @@
+# encoding: utf-8
+"""
+@project: study_stage_api
+@synopsis: 学习阶段API接口（列表 / 详情）
+"""
+from rest_framework.views import APIView
+from ..services.study_stage_service import StudyStageService
+from ..utils.custom_response import util_response
+from ..utils.request_params_wrapper import request_params_wrapper
+
+
+class StudyStageListAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取学习阶段列表
+        @param page: 页码，默认1
+        @param size: 每页数量，默认20
+        @param sort: 排序字段，默认-sort
+        @param search: 搜索关键词（名称/阶段描述模糊查询）
+        @param subject_id: 所属学科ID（精确查询）
+        @param enable: 是否启用（布尔）
+        """
+        data, error = StudyStageService.list(
+            query_params=request_params,
+            page=request_params.get('page', 1),
+            size=request_params.get('size', 20),
+            sort=request_params.get('sort', '-sort'),
+        )
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)
+
+
+class StudyStageAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取学习阶段详情（含关联单元列表）
+        @param id: 阶段ID
+        """
+        data, error = StudyStageService.detail(stage_id=request_params.get('id'))
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)

xj_study/apis/study_subject_api.py

@@ -0,0 +1,48 @@
+# encoding: utf-8
+"""
+@project: study_subject_api
+@synopsis: 学科API接口（列表 / 详情）
+"""
+from rest_framework.views import APIView
+from ..services.study_subject_service import StudySubjectService
+from ..utils.custom_response import util_response
+from ..utils.request_params_wrapper import request_params_wrapper
+
+
+class StudySubjectListAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取学科列表
+        @param page: 页码，默认1
+        @param size: 每页数量，默认20
+        @param sort: 排序字段，默认-sort
+                     可选值：id, -id, sort, -sort, name, -name, create_time, -create_time, update_time, -update_time
+        @param search: 搜索关键词（名称/学科描述模糊查询）
+        @param enable: 是否启用（布尔）
+        @param name: 学科名称（精确查询）
+        """
+        data, error = StudySubjectService.list(
+            query_params=request_params,
+            page=request_params.get('page', 1),
+            size=request_params.get('size', 20),
+            sort=request_params.get('sort', '-sort'),
+        )
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)
+
+
+class StudySubjectAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取学科详情（含关联阶段列表）
+        @param id: 学科ID
+        """
+        data, error = StudySubjectService.detail(subject_id=request_params.get('id'))
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)

xj_study/apis/study_task_api.py

@@ -0,0 +1,85 @@
+# encoding: utf-8
+"""
+@project: study_task_api
+@synopsis: 单元任务API接口（列表 / 详情 / 新增 / 修改）
+"""
+from rest_framework.views import APIView
+from ..services.study_task_service import StudyTaskService
+from ..utils.custom_response import util_response
+from ..utils.request_params_wrapper import request_params_wrapper
+
+
+class StudyTaskListAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取单元任务列表
+        @param page: 页码，默认1
+        @param size: 每页数量，默认20
+        @param sort: 排序字段，默认-sort
+        @param search: 搜索关键词（名称/会话线程ID/任务描述模糊查询）
+        @param unit_id: 所属单元ID（精确查询）
+        @param enable: 是否启用（布尔）
+        @param thread_id: 会话线程ID（精确查询）
+        """
+        data, error = StudyTaskService.list(
+            query_params=request_params,
+            page=request_params.get('page', 1),
+            size=request_params.get('size', 20),
+            sort=request_params.get('sort', '-sort'),
+        )
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)
+
+
+class StudyTaskAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取单元任务详情
+        @param id: 任务ID
+        """
+        data, error = StudyTaskService.detail(task_id=request_params.get('id'))
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)
+
+    @request_params_wrapper
+    def post(self, *args, request_params, **kwargs):
+        """
+        新增单元任务
+        @param unit_id: 所属单元ID（必填）
+        @param name: 任务名称（必填）
+        @param task_description: 任务描述
+        @param exam_url: 考核回调地址
+        @param thread_id: 会话线程ID
+        @param enable: 是否启用
+        @param task_total_score: 任务总分
+        @param task_pass_score: 任务及格分
+        @param task_weight_score: 任务权重分（任务权重分 = (任务得分 ÷ 任务满分) × 任务权重分满分）
+        @param time_limit: 限时(秒)
+        @param open_time: 开放时间
+        @param close_time: 关闭时间
+        @param publish_time: 发布时间
+        @param icon: 图标
+        @param sort: 排序
+        """
+        data, error = StudyTaskService.create(params=request_params)
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data={"id": data})
+
+    @request_params_wrapper
+    def put(self, *args, request_params, **kwargs):
+        """
+        修改单元任务
+        @param id: 任务ID（必填）
+        @param 其它字段同新增
+        """
+        data, error = StudyTaskService.update(task_id=request_params.get('id'), params=request_params)
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data={"rows": data})

xj_study/apis/study_unit_api.py

@@ -0,0 +1,47 @@
+# encoding: utf-8
+"""
+@project: study_unit_api
+@synopsis: 学习单元API接口（列表 / 详情）
+"""
+from rest_framework.views import APIView
+from ..services.study_unit_service import StudyUnitService
+from ..utils.custom_response import util_response
+from ..utils.request_params_wrapper import request_params_wrapper
+
+
+class StudyUnitListAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取学习单元列表
+        @param page: 页码，默认1
+        @param size: 每页数量，默认20
+        @param sort: 排序字段，默认-sort
+        @param search: 搜索关键词（名称/描述模糊查询）
+        @param stage_id: 所属阶段ID（精确查询）
+        @param enable: 是否启用（布尔）
+        """
+        data, error = StudyUnitService.list(
+            query_params=request_params,
+            page=request_params.get('page', 1),
+            size=request_params.get('size', 20),
+            sort=request_params.get('sort', '-sort'),
+        )
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)
+
+
+class StudyUnitAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取学习单元详情（含关联任务列表）
+        @param id: 单元ID
+        """
+        data, error = StudyUnitService.detail(unit_id=request_params.get('id'))
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)

xj_study/apis/study_user_stage_api.py

@@ -0,0 +1,65 @@
+# encoding: utf-8
+"""
+@project: study_user_stage_api
+@synopsis: 用户阶段记录API接口（列表 / 详情 / 修改）
+@synopsis: 与外部用户系统不使用外键，仅用 user_id / user_uuid 关联
+"""
+from rest_framework.views import APIView
+from ..services.study_user_stage_service import StudyUserStageService
+from ..utils.custom_response import util_response
+from ..utils.request_params_wrapper import request_params_wrapper
+
+
+class StudyUserStageListAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取用户阶段记录列表
+        @param page: 页码，默认1
+        @param size: 每页数量，默认20
+        @param sort: 排序字段，默认-create_time
+        @param search: 搜索关键词（user_uuid模糊查询）
+        @param user_id: 用户ID（精确查询）
+        @param user_uuid: 用户UUID（精确查询）
+        @param stage_id: 阶段ID（精确查询）
+        @param is_pass: 是否通过（布尔）
+        """
+        data, error = StudyUserStageService.list(
+            query_params=request_params,
+            page=request_params.get('page', 1),
+            size=request_params.get('size', 20),
+            sort=request_params.get('sort', '-create_time'),
+        )
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)
+
+
+class StudyUserStageAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取用户阶段记录详情
+        @param id: 记录ID
+        """
+        data, error = StudyUserStageService.detail(record_id=request_params.get('id'))
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)
+
+    @request_params_wrapper
+    def put(self, *args, request_params, **kwargs):
+        """
+        修改用户阶段记录
+        @param id: 记录ID（必填）
+        @param user_stage_score: 用户阶段得分
+        @param is_pass: 是否通过
+        @param icon: 图标
+        @param sort: 排序
+        """
+        data, error = StudyUserStageService.update(record_id=request_params.get('id'), params=request_params)
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data={"rows": data})

xj_study/apis/study_user_subject_api.py

@@ -0,0 +1,65 @@
+# encoding: utf-8
+"""
+@project: study_user_subject_api
+@synopsis: 用户学科记录API接口（列表 / 详情 / 修改）
+@synopsis: 与外部用户系统不使用外键，仅用 user_id / user_uuid 关联
+"""
+from rest_framework.views import APIView
+from ..services.study_user_subject_service import StudyUserSubjectService
+from ..utils.custom_response import util_response
+from ..utils.request_params_wrapper import request_params_wrapper
+
+
+class StudyUserSubjectListAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取用户学科记录列表
+        @param page: 页码，默认1
+        @param size: 每页数量，默认20
+        @param sort: 排序字段，默认-create_time
+        @param search: 搜索关键词（user_uuid模糊查询）
+        @param user_id: 用户ID（精确查询）
+        @param user_uuid: 用户UUID（精确查询）
+        @param subject_id: 学科ID（精确查询）
+        @param is_pass: 是否通过（布尔）
+        """
+        data, error = StudyUserSubjectService.list(
+            query_params=request_params,
+            page=request_params.get('page', 1),
+            size=request_params.get('size', 20),
+            sort=request_params.get('sort', '-create_time'),
+        )
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)
+
+
+class StudyUserSubjectAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取用户学科记录详情
+        @param id: 记录ID
+        """
+        data, error = StudyUserSubjectService.detail(record_id=request_params.get('id'))
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)
+
+    @request_params_wrapper
+    def put(self, *args, request_params, **kwargs):
+        """
+        修改用户学科记录
+        @param id: 记录ID（必填）
+        @param user_subject_score: 用户学科得分
+        @param is_pass: 是否通过
+        @param icon: 图标
+        @param sort: 排序
+        """
+        data, error = StudyUserSubjectService.update(record_id=request_params.get('id'), params=request_params)
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data={"rows": data})

xj_study/apis/study_user_task_api.py

@@ -0,0 +1,89 @@
+# encoding: utf-8
+"""
+@project: study_user_task_api
+@synopsis: 用户任务记录API接口（列表 / 详情 / 开启 / 提交结果）
+@synopsis: 与外部用户系统不使用外键，仅用 user_id / user_uuid 关联
+"""
+from rest_framework.views import APIView
+from ..services.study_user_task_service import StudyUserTaskService
+from ..utils.custom_response import util_response
+from ..utils.request_params_wrapper import request_params_wrapper
+
+
+class StudyUserTaskListAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取用户任务记录列表
+        @param page: 页码，默认1
+        @param size: 每页数量，默认20
+        @param sort: 排序字段，默认-create_time
+        @param search: 搜索关键词（user_uuid模糊查询）
+        @param user_id: 用户ID（精确查询）
+        @param user_uuid: 用户UUID（精确查询）
+        @param task_id: 任务ID（精确查询）
+        @param is_pass: 是否通过（布尔）
+        """
+        data, error = StudyUserTaskService.list(
+            query_params=request_params,
+            page=request_params.get('page', 1),
+            size=request_params.get('size', 20),
+            sort=request_params.get('sort', '-create_time'),
+        )
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)
+
+
+class StudyUserTaskAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取用户任务记录详情（含 task_snapshot 任务快照）
+        @param id: 记录ID
+        """
+        data, error = StudyUserTaskService.detail(record_id=request_params.get('id'))
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)
+
+
+class StudyUserTaskStartAPI(APIView):
+
+    @request_params_wrapper
+    def post(self, *args, request_params, **kwargs):
+        """
+        开启一条用户任务记录（学生开始作答时调用）
+        @param user_id: 用户ID（必填）
+        @param user_uuid: 用户UUID（必填）
+        @param task_id: 任务ID（必填）
+        """
+        data, error = StudyUserTaskService.start(params=request_params)
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data={"id": data})
+
+
+class StudyUserTaskSubmitAPI(APIView):
+
+    @request_params_wrapper
+    def post(self, *args, request_params, **kwargs):
+        """
+        提交用户任务结果（外部考核回调整份提交 / 听写逐题进度同步）
+        整份回调：
+        @param id: 记录ID（必填）
+        @param user_task_score: 用户任务得分
+        @param is_pass: 是否通过
+        @param task_snapshot: 任务快照（学生测试JSON数据）
+        逐题进度（每完成一题计1分，答题记录合并进 task_snapshot 并级联累加权重）：
+        @param id: 记录ID（必填，由 user_task_start 返回）
+        @param answer: 单题结果 {word_id, lemma?, input?, status: correct|wrong, listens?, accuracy?, proficiency?}
+        @param total: 任务总题量（可选，同步为任务满分，实现「多少题即多少分」）
+        @param wordbook_id: 词集ID（可选，记录进快照溯源）
+        """
+        data, error = StudyUserTaskService.submit(record_id=request_params.get('id'), params=request_params)
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data={"rows": data})

xj_study/apis/study_user_unit_api.py

@@ -0,0 +1,65 @@
+# encoding: utf-8
+"""
+@project: study_user_unit_api
+@synopsis: 用户单元记录API接口（列表 / 详情 / 修改）
+@synopsis: 与外部用户系统不使用外键，仅用 user_id / user_uuid 关联
+"""
+from rest_framework.views import APIView
+from ..services.study_user_unit_service import StudyUserUnitService
+from ..utils.custom_response import util_response
+from ..utils.request_params_wrapper import request_params_wrapper
+
+
+class StudyUserUnitListAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取用户单元记录列表
+        @param page: 页码，默认1
+        @param size: 每页数量，默认20
+        @param sort: 排序字段，默认-create_time
+        @param search: 搜索关键词（user_uuid模糊查询）
+        @param user_id: 用户ID（精确查询）
+        @param user_uuid: 用户UUID（精确查询）
+        @param unit_id: 单元ID（精确查询）
+        @param is_pass: 是否通过（布尔）
+        """
+        data, error = StudyUserUnitService.list(
+            query_params=request_params,
+            page=request_params.get('page', 1),
+            size=request_params.get('size', 20),
+            sort=request_params.get('sort', '-create_time'),
+        )
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)
+
+
+class StudyUserUnitAPI(APIView):
+
+    @request_params_wrapper
+    def get(self, *args, request_params, **kwargs):
+        """
+        获取用户单元记录详情
+        @param id: 记录ID
+        """
+        data, error = StudyUserUnitService.detail(record_id=request_params.get('id'))
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data=data)
+
+    @request_params_wrapper
+    def put(self, *args, request_params, **kwargs):
+        """
+        修改用户单元记录
+        @param id: 记录ID（必填）
+        @param user_unit_score: 用户单元得分
+        @param is_pass: 是否通过
+        @param icon: 图标
+        @param sort: 排序
+        """
+        data, error = StudyUserUnitService.update(record_id=request_params.get('id'), params=request_params)
+        if error:
+            return util_response(data=data, msg=error)
+        return util_response(data={"rows": data})

xj_study/apps.py

@@ -0,0 +1,8 @@
+from django.apps import AppConfig
+
+
+class StudyConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'xj_study'
+    verbose_name = 'Ⅳ 学习系统'
+    sort = 14