项目管理系统后端: 一个用于管理学员项目的系统

原作者: [db:作者] 来自: 网络收藏邀请

开源软件名称：

项目管理系统后端

开源软件地址：

https://gitee.com/d718781500/student_product_manager_system

开源软件介绍：

学员项目管理系统api接口

使用须知!!:本接口采用jwt数据安全措施,如果想正常获取数据,请先登入,并且保证每次请求传送authorization请求头,携带登入之后返回的的token

管理系统后台v2.0.1更新公告:增加权限控制,角色列表获取,权限菜单获取增加获取用户功能优化拦截中间件优化路径不匹配返回权限错误的问题修复静态资源需要登入而获取不到的情况修复图片上传不显示问题文档更新详情请访问 https://gitee.com/d718781500/student_product_manager_system

使用

补齐依赖

npm install

或者

yarn

开启服务**

npm start

base:http://www.chst.vip

测试账号:lbw 密码:555

1.天气模块(新)

天气每隔8小时会同步一次,每天0点必定同步一次

获取天气

接口详情	请求方式	地址
天气	get	/weather/getWeather

参数	是否必填	说明
key	否	key的取值为all,传了则返回所有历史天气
city	否	查询的城市名字,不能带市,比如南京,次数一分钟查询一次

修改天气账户信息(仅root有权限)

天气账户有可能变更,所以提供修改接口

接口详情	请求方式	地址
修改天气账户	get	/weather/updateWeatherCount

参数	是否必填	说明
version	是	请求api的版本,有不同的天气比如v61
appid	是	appid账号生成的id
appsecret	是	账户生成的secret

2.上传图片

增加上传图片,所有的图片都可以通过这个接口上传

接口详情	请求方式	地址
上传图片	post	/upload/uploadImg

参数	是否必填	说明
img	是	图片文件

3.学员模块

获取登入日志

接口详情	请求方式	地址
获学登入日志	get	/getloginlog

参数	是否必填	说明
page	否	页码
count	否	每次返回几条默认返回10

成功返回值

{    "status": 200,    "state": true,    "msg": "success",    "data": [        {            "_id": "5cd964db16bd6f346879cf77",            "username": "cxk",            "lastLogin": {                "loginTime": "2019/05/13 20:36:26",                "ip": ""            },            "nowLogin": {                "ip": "",                "loginTime": "2019/05/13 20:36:43"            },            "__v": 0        },        {            "_id": "5cd964ca16bd6f346879cf76",            "username": "cxk",            "lastLogin": {                "loginTime": "2019/05/13 20:36:00",                "ip": ""            },            "nowLogin": {                "ip": "",                "loginTime": "2019/05/13 20:36:26"            },            "__v": 0        }    ]}

获取班级列表

接口详情	请求方式	地址
班级列表	get	/students/getclasses

成功返回值

{    "status": 200,    "state": true,    "data": [        "H51901",        "H51902"    ]}

获取学员信息

接口详情	请求方式	地址
获学员信息	get	/students/getstulist

参数	是否必填	说明
page	否	页码
count	否	每次返回几条
class	否	默认是全部班级的数据

成功返回值

{    "status": 1,    "state": true,    "msg": "请求成功",    "total": 2,    "data": [        {            "_id": "5cd3c534e1e75b0ea034cf83",            "name": "谭鹏",            "headimgurl":"",            "age": "21",            "class": "H51901",            "city": "重庆",            "degree": "专科",            "productUrl": "地址",            "description": "O(∩_∩)O哈哈~",            "cTime": "2019/05/09 02:14:12",            "sId": "WWLN97178546",            "__v": 0        }    ]}

增加学员信息

接口详情	请求方式	接口地址
增加学员信息	post	/students/addstu

参数	是否必填	描述
class	是	班级
name	是	学员的名字
age	是	学员的年龄
city	是	目前居住的城市
degree	是	学历
productUrl	是	项目地址
description	是	一句话对自己的评价
headimgurl	否	头像

增加成返回值

{    "status": 1,    "state": true,    "msg": "添加成功"}

删除学员信息

接口详情	请求方式	接口地址
删除学员信息	get	/students/delstu

参数	是否必填	描述
sId	是	当前学员id

// 删除成功{  "status": 1,  "state": true,  "msg": "删除成功"}

修改学员信息

接口详情	请求方式	接口地址
修改用户密码	post	/students/updatestu

参数	是否必填	描述
sId	是	用户Id
token	是	token值
name	否	学员的名字
age	否	学员的年龄
city	否	目前居住的城市
degree	否	学历
productUrl	否	项目地址
description	否	一句话对自己的评价
headimgurl	否	头像

搜索学员

接口详情	请求方式	地址
搜索学员	get	/students/searchstu

参数	是否必填	描述
key	否	传入学员的姓名
count	否	请求的条数(默认全部返回)
page	否	页码

上传学员头像接口

接口详情	请求方式	接口地址
上传学员头像	post	/students/uploadStuAvatar

参数	是否必填	描述
headimgurl	是	上传的文件格式 jpg\|png\|gif

//成功数据{    status: 200,    state: true,    msg: "上传成功",    headimgurl:http://106.12.79.128xxxx }

4.用户模块

获取验证码

接口详情	请求方式	地址
获取验证码	get	/users/getCaptcha

刷新验证码

接口详情	请求方式	地址
获取验证码	get	/users/refreshCaptcha

校验验证码

接口详情	请求方式	地址
获取验证码	get	/users/verifyCaptcha

参数	是否必填	描述
captcha	是	用户输入的验证码

获取所有用户

接口详情	请求方式	地址
获取所有用户	get	/users/getAllUsers

{    "status": 200,    "state": true,    "msg": "success",    "users": [        {            "username": "lbw1",            "nickname": "五五开",            "roleid": "200"        },        {            "username": "root",            "nickname": "王者管理员",            "roleid": "1"        },        {            "username": "lbw2",            "nickname": "五五开",            "roleid": "200"        },        {            "username": "zj",            "nickname": "王远杰",            "roleid": "102"        },        {            "username": "zj01",            "nickname": "巴啦啦小魔仙",            "roleid": "102"        }    ]}

添加用户

接口详情	请求方式	接口地址
添加用户	post	/users/addUser

username	是	用户名
password	是	密码
phone	否	手机号
nickname	是	昵称

修改用户信息

接口详情	请求方式	接口地址
添加用户	post	/users/updateUser

参数	是否必填	描述
unid	是	用户的id
username	否	用户名
password	否	密码
phone	否	手机号
nickname	否	昵称
roleid	否(root才能修改)	权限id
vipLevel	否(root才能修改)	vip等级
headimgurl	否	头像地址
sex	否	性别
city	否	城市
province	否	省份
country	否	国加

用户注册接口(仅root admin管理员有权限)

接口详情	请求方式	地址
用户注册接口	post	/users/register

参数	是否必填	描述
username	是	用户名
password	是	密码
phone	否	手机号
nickname	是	昵称
roles	否	权限

注册成功返回值{	"status": 1,	"state": true,	"msg": "注册成功",	"userInfo": {		"username": "lbw4",		"nickname": "开哥永不开挂",		"phone": "1577775772"	}}注册失败返回值{	"status": 0,	"state": false,	"msg": "用户名已注册"}

登入接口

接口详情	请求方式	地址
用户登入	post	/users/login

参数	是否必填	描述
username	是	账户
password	是	密码

登入成功返回值{	"status": 1,	"state": true,	"msg": "登入成功",	"userInfo": {		"username": "lbw4",		"nickname": "开哥永不开挂",		"phone": "1577775772"	}}登入失败返回值{	"status": 0,	"state": false,	"msg": "用户名或者密码错误"}

微信扫码登入(new)

微信扫码登入建议客户端使用[email protected]这个依赖

首先安装

npm i socket.io-client

也可以使用普通的websocket

socket.io事件

事件名	返回参数	参数描述
connectSuccess	sid	客户端唯一标识
invalidCode	Object	无效二维码主体内容
scancodeSuccess	wechatCode	用户微信扫码返回临时code

接口

获取二维码url

接口	请求方式	携带参数	是否必填	接口描述
/users/getQrcode	get	sid	是	请求微信二维码地址

微信登入

接口	请求方式	接口描述
/users/wechatLogin	get	请求微信登入

参数	是否必填	参数描述
wechatCode	是	扫码成功后微信传回来的wechatCode

流程图

退出登入接口

接口详情	请求方式	接口地址
退出登入	get	/users/sigout

上传用户头像接口

接口详情	请求方式	接口地址
上传头像	post	/users/uploadAvatar

参数	是否必填	描述
headimgurl	是	上传的图片文件
uId	是	当前用户的id
token	是	token值

//成功数据{  "status": 1,  "state": true,  "msg": "图片上传成功"}

校验登入状态

接口详情	请求方式	接口地址
验证用户登入状态	*	/verify

修改用户密码接口

接口详情	请求方式	接口地址
修改用户密码	post	/users/updatePassword

参数	是否必填	描述
username	是	用户名
oldPassword	是	原来的密码
newPassword	是	需要修改的新密码
token	是	token值

//修改成功值{  "status": 1,  "state": true,  "msg": "密码修改成功"}//用户名不存在返回值{  "status": 0,  "state": false,  "msg": "不存在此用户"}//修改失败{  "status": 0,  "state": false,  "msg": "密码修改错误"}

5.权限模块

添加角色(仅root有权限)

接口详情	请求方式	接口地址
添加角色	post	/permission/addrole

参数	是否必填	描述
roleid	是	添加的角色id
token	是	token

获取角色列表

接口详情	请求方式	接口地址
获取角色列表	get	/permission/getrole

参数	是否必填	描述
roleid	否	查询的角色id
token	是	token

结果{    "status": 200,    "msg": "success",    "roles": [        {            "roleid": "200",            "roleName": "员工"        },        {            "roleid": "102",            "roleName": "总监"        },        {            "roleid": "103",            "roleName": "主管"        },        {            "roleid": "1",            "roleName": "王者管理员"        }    ]}

获取权限菜单

接口详情	请求方式	接口地址
获取权限菜单	get	/permission/getMenuList

{    "status": 200,    "msg": "success",    "roleName": "总监",    "menuList": [        {            "name": "管理首页"        },        {            "name": "学员管理",            "children": [                {                    "name": "学员项目管理"                },                {                    "name": "学员资料"                },                {                    "name": "学员宿舍"                }            ]        },        {            "name": "考勤管理"        },        {            "name": "数据统计"        },        {            "name": "我的中心"        }    ]}

6.vip充值

1. 获取vip产品

接口地址	请求方式	接口描述
/product/get_product	get	获取商品

参数	参数值	是否必传
category_id	20210827165510715	是

返回结果

[		{            "updator": null,            "updateTime": null,            "_id": "61277523ad0bdb2ddd70a304",            "product_id": "20210826190403911",            "category_id": "20210826182431225",            "productName": "vip充值",            "description": "尊贵vip充值-vip包月服务,心悦vip,1对1专属客服,随意开挂,随意举报,尊贵红名显示",            "price": 0.01,            "inventory": 74,            "imageUrl": "balabalabala"