需求分析
又是一年开学季,万众瞩目的社团招新又开始啦!社团涵盖了文化体育、学术科技、志愿公益等方面。面对着琳琅满目的社团活动,你会pick哪一个呢?
概要设计
主要功能包括公告通知,社团风采,社团招新列表,社团培训列表,社团活动列表,社团简介,我的报名,后台招新/培训/活动项目管理,后台通知管理,后台管理员管理等功能
技术选型
- 使用腾讯专门的小程序云开发技术,云资源包含云函数,数据库,带宽,存储空间,定时器等,资源配额价格低廉,无需域名和服务器即可搭建。
- 小程序本身的即用即走,适合小工具的使用场景,也适合快速开发迭代。
- 云开发技术采用腾讯内部链路,没有被黑客攻击的风险,不会 DDOS攻击,节省防火墙费用,安全性高且免维护。
- 资源承载力可根据业务发展需要随时弹性扩展。
数据字典
NewsModel.DB_STRUCTURE = {
_pid: 'string|true',
NEWS_ID: 'string|true',
NEWS_TITLE: 'string|false|comment=标题',
NEWS_DESC: 'string|false|comment=描述',
NEWS_STATUS: 'int|true|default=1|comment=状态 0/1',
NEWS_CATE_ID: 'string|true|comment=分类编号',
NEWS_CATE_NAME: 'string|true|comment=分类冗余',
NEWS_ORDER: 'int|true|default=9999',
NEWS_VOUCH: 'int|true|default=0',
NEWS_CONTENT: 'array|true|default=[]|comment=内容',
NEWS_QR: 'string|false',
NEWS_VIEW_CNT: 'int|true|default=0|comment=访问次数',
NEWS_PIC: 'array|false|default=[]|comment=封面图 [cloudId1,cloudId2,cloudId3...]',
NEWS_FORMS: 'array|true|default=[]',
NEWS_OBJ: 'object|true|default={}',
NEWS_ADD_TIME: 'int|true',
NEWS_EDIT_TIME: 'int|true',
NEWS_ADD_IP: 'string|false',
NEWS_EDIT_IP: 'string|false',
};
UserModel.DB_STRUCTURE = {
_pid: 'string|true',
USER_ID: 'string|true',
USER_MINI_OPENID: 'string|true|comment=小程序openid',
USER_STATUS: 'int|true|default=1|comment=状态 0=待审核,1=正常,8=审核未过,9=禁用',
USER_CHECK_REASON: 'string|false|comment=审核未过的理由',
USER_NAME: 'string|false|comment=用户昵称',
USER_MOBILE: 'string|false|comment=联系电话',
USER_FORMS: 'array|true|default=[]',
USER_OBJ: 'object|true|default={}',
USER_LOGIN_CNT: 'int|true|default=0|comment=登陆次数',
USER_LOGIN_TIME: 'int|false|comment=最近登录时间',
USER_ADD_TIME: 'int|true',
USER_ADD_IP: 'string|false',
USER_EDIT_TIME: 'int|true',
USER_EDIT_IP: 'string|false',
}
核心实现
// 注册
async register(userId, {
mobile,
name,
forms,
status
}) {
// 判断是否存在
let where = {
USER_MINI_OPENID: userId
}
let cnt = await UserModel.count(where);
if (cnt > 0)
return await this.login(userId);
where = {
USER_MOBILE: mobile
}
cnt = await UserModel.count(where);
if (cnt > 0) this.AppError('该手机已注册');
// 入库
let data = {
USER_MINI_OPENID: userId,
USER_MOBILE: mobile,
USER_NAME: name,
USER_OBJ: dataUtil.dbForms2Obj(forms),
USER_FORMS: forms,
USER_STATUS: Number(status)
}
await UserModel.insert(data);
return await this.login(userId);
}
/** 获取手机号码 */
async getPhone(cloudID) {
let cloud = cloudBase.getCloud();
let res = await cloud.getOpenData({
list: [cloudID], // 假设 event.openData.list 是一个 CloudID 字符串列表
});
if (res && res.list && res.list[0] && res.list[0].data) {
let phone = res.list[0].data.phoneNumber;
return phone;
} else
return '';
}
/** 取得我的用户信息 */
async getMyDetail(userId) {
let where = {
USER_MINI_OPENID: userId
}
let fields = 'USER_MOBILE,USER_NAME,USER_FORMS,USER_OBJ,USER_STATUS,USER_CHECK_REASON'
return await UserModel.getOne(where, fields);
}
/** 修改用户资料 */
async editBase(userId, {
mobile,
name,
forms
}) {
let whereMobile = {
USER_MOBILE: mobile,
USER_MINI_OPENID: ['<>', userId]
}
let cnt = await UserModel.count(whereMobile);
if (cnt > 0) this.AppError('该手机已注册');
let where = {
USER_MINI_OPENID: userId
}
let user = await UserModel.getOne(where);
if (!user) return;
let data = {
USER_MOBILE: mobile,
USER_NAME: name,
USER_OBJ: dataUtil.dbForms2Obj(forms),
USER_FORMS: forms,
};
if (user.USER_STATUS == UserModel.STATUS.UNCHECK)
data.USER_STATUS = UserModel.STATUS.UNUSE;
await UserModel.edit(where, data);
}
/** 登录 */
async login(userId) {
let where = {
'USER_MINI_OPENID': userId
};
let fields = 'USER_ID,USER_MINI_OPENID,USER_NAME,USER_PIC,USER_STATUS';
let user = await UserModel.getOne(where, fields);
let token = {};
if (user) {
// 正常用户
token.id = user.USER_MINI_OPENID;
token.key = user.USER_ID;
token.name = user.USER_NAME;
token.pic = user.USER_PIC;
token.status = user.USER_STATUS;
// 异步更新最近更新时间
let dataUpdate = {
USER_LOGIN_TIME: this._timestamp
};
UserModel.edit(where, dataUpdate);
UserModel.inc(where, 'USER_LOGIN_CNT', 1);
} else
token = null;
return {
token
};
}
/** 浏览资讯信息 */
async viewNews(id) {
let fields = '*';
let where = {
_id: id,
NEWS_STATUS: 1
}
let news = await NewsModel.getOne(where, fields);
if (!news) return null;
return news;
}
/** 取得分页列表 */
async getNewsList({
search, // 搜索条件
sortType, // 搜索菜单
sortVal, // 搜索菜单
orderBy, // 排序
cateId, //附加查询条件
page,
size,
isTotal = true,
oldTotal
}) {
orderBy = orderBy || {
'NEWS_ORDER': 'asc',
'NEWS_ADD_TIME': 'desc'
};
let fields = 'NEWS_PIC,NEWS_VIEW_CNT,NEWS_TITLE,NEWS_DESC,NEWS_CATE_ID,NEWS_ADD_TIME,NEWS_ORDER,NEWS_STATUS,NEWS_CATE_NAME,NEWS_OBJ';
let where = {};
where.NEWS_STATUS = 1; // 状态
if (cateId && cateId !== '0') where.NEWS_CATE_ID = cateId;
if (util.isDefined(search) && search) {
where.NEWS_TITLE = {
$regex: '.*' + search,
$options: 'i'
};
} else if (sortType && util.isDefined(sortVal)) {
// 搜索菜单
switch (sortType) {
case 'sort': {
orderBy = this.fmtOrderBySort(sortVal, 'NEWS_ADD_TIME');
break;
}
}
}
return await NewsModel.getList(where, fields, orderBy, page, size, isTotal, oldTotal);
}
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。