表设计
staff_record
| user_id | ||
|---|---|---|
| record_type | 1:工作记录 2:战略记录 3:会商记录 |
|
| type | 1:日报 2:周报 3:月报 4:季度报 5:年报 |
|
| recordTime | ||
| attr_1 | ||
| attr_2 | ||
| attr_3 | ||
| attr_4 | ||
| attr_5 | ||
| score_1 | ||
| score_2 | ||
| score_3 | ||
| score_4 | ||
| score_5 | ||
| comment_1 | ||
| comment_2 | ||
| comment_3 | ||
| comment_4 | ||
| comment_5 | ||
接口列表
记录创建、查询、修改接口
记录删除接口
记录标记已读接口
记录打分接口
记录评论接口
新老接口对应该关系
| 新接口 | 地址 | 说明 | 对应旧接口 |
|---|---|---|---|
| 记录接口 | /api/staffrecord/record | 记录的查询、创建、修改接口 兼容工作小结论、战略总结、会商总结接口 |
/api/user/record /api/staffrecord/strategy /api/staffrecord/consult |
| 记录详情 | /api/staffrecord/record/id | /api/user/record/id /api/staffrecord/strategy/id /api/staffrecord/consult/id |
|
| 记录删除 | /api/staffrecord/delrecord | /api/user/delrecord /api/staffrecord/delstrategy /api/staffrecord/delconsult |
|
| 记录标记已读 | /api/staffrecord/markread | /api/user/markread /api/staffrecord/strategymarkread /api/staffrecord/consultmarkread |
|
| 打分 | /api/staffrecord/recordscore | /api/user/recordscore /api/staffrecord/strategyscore /api/staffrecord/consultscore |
|
| 评论 | /api/staffrecord/recordcomment | /api/user/recordcomment /api/staffrecord/strategycomment /api/staffrecord/consultcomment |
说明:
目前新接口 和 老接口 同时可用;
新接口完全兼容老接口的参数,详情、删除、标记已读、打分、评论的接口参数完全一样,只有记录的创建、修改、查询接口多了个 record_type参素 来区分 工作小结、战略总结、会商总结的类型
记录创建、查询、修改接口
/api/staffrecord/record
GET请求方法查询
参数说明
| 名称 | 类型 | 说明 | 备注 | 是否必须 |
|---|---|---|---|---|
| user_id | int | 员工id | 否,不传返回所有员工的 | |
| record_type | int | 大类型 1:工作记录 2:战略记录 3:会商记录 3:经验分享 |
默认全部 | |
| type | int | 1:日报 2:周报 3:月报 4:季度报 5:年报 |
否,默认全部 | |
| status | str | all:所有的 1:正常的 -1:删除的 |
否,默认1 | |
| start_time | string | 开始时间:2020-01-01 00:00:00 | 查询记录的时间在所给范围内的记录 | 否,默认全部 |
| end_time | string | 结束时间:2021-01-01 00:00:00 | ||
| page | 默认1 | |||
| count | 默认20 | |||
| group_ids | array | 员工分组的id,客传多个,比如[1,2,3] | 暂未支持 | 默认全部组 |
| read_status | int | 1:已读 0:未读 |
暂未支持 | 默认全部 |
| isTop | int | 1:置顶 0:未顶 |
2022.07.20 添加支持 | 默认全部 |
POST请求方法创建修改
参数说明
| 名称 | 类型 | 说明 | 备注 | 是否必须 |
|---|---|---|---|---|
| record_id | int | 工作记录id | 修改:必须 创建:不传 |
|
| user_id | int | 员工id | 是 | |
| record_type | int | 1:工作记录 2:战略记录 3:会商记录 4:经验分享 |
否,默认1 | |
| is_freeall | int | 1:对所有人公开 0:不是 |
否,默认0 | |
| type |
| int
| 1:日报
2:周报
3:月报
4:季度报
5:年报
经验分享不传此参数,默认1 |
| 否,默认1 |
| record_time | string | 工作记录 记录的时间
格式:
2020-12-11 00:00:02 | | 否,默认现在 |
| note | string | 备注 | | 否 |
| | | | | |
| effect | | 工作成效 | 日周月报,和原参数相同 | |
| problems | | 存在问题 | | |
| suggestion | | 意见建议 | | |
| workplan | | 工作计划 | | |
| achieve | | 工作成果 | | |
| | | | | |
| discover | | 发现能力(快) | 战略记录,和原参数相同 | |
| select | | 选题能力(准) | | |
| judge | | 分析研判能力(深) | | |
| review | | 反思复盘 | | |
| plan | | 下一步规划 | | |
| | | | | |
| macro | | 宏观态势 | 会商记录,和原参数相同 |
|
| micro | | 微观反应 | | |
| risk | | 风险提示 | | |
| measure |
| 应付策略 | |
|
| | | | | |
| isTop |
| 是否置顶 |
| 默认否 |
| title | str | 标题,经验分享的必填参数 | 经验分享 | 是 |
| contentHtml | str | 内容 | | 是 |
| attach_path | str | 附件的路径 | | 否 |
记录详情接口
/api/staffrecord/record/id
get
路径参数 id
记录删除接口
/api/staffrecord/delrecord
post
record_id
记录标记已读接口
/api/staffrecord/markread
post
record_id、user_id
记录打分点评接口
/api/staffrecord/recordscore
方法
参数说明
| record_id | int | 是 | ||
|---|---|---|---|---|
| macro_score | int | 0~10中的一个,包括0到10 | 否,默认是null | |
| micro_score | ||||
| risk_score | ||||
| measure_score | ||||
| macro_comment | str | 评论 | 否,默认是null | |
| micro_comment | ||||
| risk_comment | ||||
| measure_comment | ||||
| discover_score | ||||
| select_score | ||||
| judge_score | ||||
| review_score | ||||
| plan_score | ||||
| discover_comment | ||||
| select_comment | ||||
| judge_comment | ||||
| review_comment | ||||
| plan_comment | ||||
| effect_score | ||||
| problems_score | ||||
| suggestion_score | ||||
| workplan_score | ||||
| achieve_score | ||||
| effect_comment | ||||
| problems_comment | ||||
| suggestion_comment | ||||
| workplan_comment | ||||
| achieve_comment |
记录评论接口
/api/staffrecord/comment
请求方法
参数说明
| comment_id | int | 评论id | 创建:不传 删除:必须 |
|
|---|---|---|---|---|
| user_id | int | 员工id,评论人id | 是 | |
| record_id | int | 战略记录的id | 是 | |
| content | str | 评论的内容 | 是 |
