Appearance
培训项目(管理端)
路径前缀:
/manage/project_plan*、/manage/project_plans*控制器:ApiV3Bundle\Controller\ProjectPlan\*ManageController全部接口需admin_project_plan_manage权限(除显式标注)。
项目分类与模板
分类列表
GET /manage/project_plans/categories响应:{ data: 分类列表 }
模板详情
GET /manage/project_plans/template/{templateId}响应:{ template: object }
项目列表与基础操作
列表
GET /manage/project_plans权限:admin_training_plan_manage
参数
| 字段 | 是否必须 | 描述 |
|---|---|---|
keyword string | 否 | 关键词 ? |
categoryId int | 否 | 分类筛选 ? |
status string | 否 | 状态 ? |
offset/limit | 否 | 分页 |
响应:{ data, paging }
普通方式创建项目
POST /manage/create_project_plan_by_ordinary参数(JSON Body)
| 字段 | 是否必须 | 描述 |
|---|---|---|
title string | 是 | 标题 |
categoryId int | 否 | 分类 ? |
cover object | 否 | 封面 ? |
startTime/endTime int | 否 | 起止时间 ? |
响应:{ projectPlan: object }
详情(发布配置)
GET /manage/project_plans/{projectPlanId}响应:{ projectPlan, publishConfig } ?
更新
PUT /manage/project_plans/{projectPlanId}参数:同 “创建” 字段,均可选
响应:更新后的项目对象
删除
DELETE /manage/project_plans/{projectPlanId}响应:{ success: bool }
设置展开显示
PUT /manage/project_plans/{projectPlanId}/set_is_show_expand参数:isShowExpand (bool)
发布
PUT /manage/project_plans/{projectPlanId}/publish关闭
PUT /manage/project_plans/{projectPlanId}/close复制
PUT /manage/project_plans/{projectPlanId}/copy归档
PUT /manage/project_plans/{projectPlanId}/archive取消归档
PUT /manage/project_plans/{projectPlanId}/cancel_archive学员通过
PUT /manage/project_plans/{projectPlanId}/students/pass参数(JSON Body):memberIds: int[] ?
评估配置
* /manage/project_plan/{projectPlanId}/evaluation_config说明:未指定 method(控制器:ProjectPlanManageController::evaluationConfigAction)
项目阶段(Stage)
| 方法 | 路径 | 动作 |
|---|---|---|
| POST | /manage/project_plans/{projectPlanId}/stages | 创建 |
| PUT | /manage/project_plans/{projectPlanId}/stages/{stageId} | 更新 |
| GET | /manage/project_plans/{projectPlanId}/stages/{stageId} | 详情 |
| DELETE | /manage/project_plans/{projectPlanId}/stages/{stageId} | 删除 |
通用参数:name、sort、startTime、endTime ?
项目 Item(培训项目下的资源/任务)
| 方法 | 路径 | 动作 |
|---|---|---|
| POST | /manage/project_plans/{projectPlanId}/items | 创建 |
| GET | /manage/project_plans/{projectPlanId}/items | 列表 |
| PUT | /manage/project_plans/{projectPlanId}/items/{itemId} | 更新 |
| GET | /manage/project_plans/{projectPlanId}/items/{itemId} | 详情 |
| DELETE | /manage/project_plans/{projectPlanId}/items/{itemId} | 删除 |
| GET | /manage/project_plans/{projectPlanId}/items_with_analyze | 列表(带统计) |
| PUT | /manage/project_plans/{projectPlanId}/manage_items/sort | 排序 |
| PUT | /manage/project_plans/{projectPlanId}/items/{itemId}/urge_to_learn | 催促学习 |
| GET | /manage/project_plans/{projectPlanId}/available_teachers | 可用讲师 |
| POST | /manage/project_plans/{projectPlanId}/teachers/{userId}/set | 设置某用户为讲师 |
通用参数:type (course/exam/homework/...)、title、targetId、stageId、sort ?
考试 Item 延期
| 方法 | 路径 | 描述 |
|---|---|---|
| PUT | /manage/project_plan/{projectPlanId}/item/{itemId}/exam/delay | 延长考试时间 |
| PUT | /manage/project_plan/{projectPlanId}/item_result/{itemResultId}/exam/delay | 延长某成员考试时间 |
通用参数:deadline int(时间戳)?
线下课程游戏任务
| 方法 | 路径 | 动作 |
|---|---|---|
| POST | /manage/project_plans/{projectPlanId}/items/{itemId}/offline_course_games | 添加 |
| DELETE | /manage/project_plans/{projectPlanId}/items/{itemId}/offline_course_games/{taskId} | 删除 |
线下课程作业任务
| 方法 | 路径 | 动作 |
|---|---|---|
| POST | /manage/project_plans/{projectPlanId}/items/{itemId}/offline_course_homeworks | 创建 |
| PUT | /manage/project_plans/{projectPlanId}/items/{itemId}/offline_course_homeworks/{taskId} | 更新 |
| DELETE | /manage/project_plans/{projectPlanId}/items/{itemId}/offline_course_homeworks/{taskId} | 删除 |
匹配可选线下课程
GET /manage/project_plans/{projectPlanId}/match_offline_courses创建签到地址
PUT /manage/project_plans/{projectPlanId}/address参数:latitude、longitude、address ?
项目成员
| 方法 | 路径 | 动作 |
|---|---|---|
| POST | /manage/project_plan/{id}/member/list | 成员列表(按筛选) |
| POST | /manage/project_plan/{id}/find_member_ids | 检索成员 ID |
| POST | /manage/project_plan/{projectPlanId}/member/remove | 移除成员 |
| GET | /manage/project_plans/{projectPlanId}/members/{memberId}/itemResults/{itemResultId} | 成员 item 学习详情 |
| POST | /manage/project_plans/{projectPlanId}/members/{memberId}/itemResults/{itemResultId}/adjust_deadlineTime | 调整截止时间 |
| POST | /manage/project_plans/{projectPlanId}/members/{memberId}/itemResults/{itemResultId}/urgeToLearn | 催学 |
| POST | /manage/project_plans/{projectPlanId}/members/{memberId}/adjust_passingStatus | 调整通过状态 |
| POST | /manage/project_plans/{projectPlanId}/members/batch_adjust_passingStatus | 批量调整通过状态 |
| GET | /manage/project_plans/{projectPlanId}/members/batch_check_passingStatus | 批量校验通过状态 |
| GET | /manage/project_plans/{projectPlanId}/members/batch_show_passingStatus | 批量展示通过状态 |
| POST | /manage/project_plans/{projectPlanId}/members/{memberId}/archive | 归档成员 |
| POST | /manage/project_plans/{projectPlanId}/members/{memberId}/cancel_archive | 取消归档 |
| POST | /manage/project_plans/{projectPlanId}/members/batch_archive | 批量归档 |
通用参数:memberIds、passingStatus、deadlineTime ?
学员监控 / 概览 / 导出
| 方法 | 路径 | 动作 |
|---|---|---|
| POST | /manage/project_plan/{id}/student_monitoring | 学员监控数据 |
| GET | /manage/project_plan/{id}/student_monitoring_header | 监控表头 |
| GET | /manage/project_plan/{id}/student_monitoring_tabbar | 监控 Tabbar |
| GET | /manage/project_plan/{id}/student_detail_export_header | 学员明细导出表头 |
| POST | /manage/project_plan/{id}/student_detail_export_data | 学员明细导出数据 |
| GET | /manage/project_plan/{id}/overview | 项目数据概览 |
| POST | /manage/project_plan/{id}/department_monitoring | 部门维度监控 |
| GET | /manage/project_plan/{projectPlanId}/student_report/{userId}/learning_record | 学员学习记录(管理) |
作业批改(管理)
| 方法 | 路径 | 动作 |
|---|---|---|
| GET | /manage/project_plan/{projectPlanId}/assignment/upload_token | 上传凭证 |
| GET | /manage/project_plans/assignment/{id}/list | 提交记录列表 |
| GET | /manage/project_plans/assignment/{id}/statistics | 作业统计 |
| POST | /manage/project_plans/assignment/{assignmentId}/batch_reviewer | 批量更换批改人 |
| POST | /manage/project_plans/assignment/result/{assignmentResultId}/change_review_result | 修改批改结果 |
| POST | /manage/project_plans/assignment/result/{assignmentResultId}/reject | 打回作业 |
| POST | /manage/project_plans/assignment/{assignmentId}/urge_to_not_submitted | 催促未提交 |
| POST | /manage/project_plans/assignment/{assignmentId}/urge_to_not_reviewed | 催促未批改 |
| GET | /manage/project_plan/item_result/{id}/assignment | 项目项学习结果对应作业 |
| POST | /manage/project_plan/assignment_result/{id}/set_excellent | 设为优秀 |
| POST | /manage/project_plan/assignment_result/{id}/cancel_excellent | 取消优秀 |
附件批量导出
| 方法 | 路径 | 动作 |
|---|---|---|
| GET | /project_plan/assignment/{assignmentId}/export/attachment/status | 查询导出状态 |
| POST | /project_plan/assignment/{assignmentId}/export/attachments | 触发导出 |
响应:{ taskId, status, downloadUrl? } ?
讲师与项目经理
| 方法 | 路径 | 动作 |
|---|---|---|
| GET | /manage/project_plan/{projectPlanId}/teacher | 项目讲师列表 |
| GET | /manage/project_plan/manager | 项目经理列表 |