基于云开发的大学社团招新小程序开发笔记

作者：CC同学

2022 年 10 月 10 日
广东
本文字数：3126 字
阅读完需：约 10 分钟

需求分析

又是一年开学季，万众瞩目的社团招新又开始啦！社团涵盖了文化体育、学术科技、志愿公益等方面。面对着琳琅满目的社团活动，你会 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);  }