需求分析

又是一年开学季,万众瞩目的社团招新又开始啦!社团涵盖了文化体育、学术科技、志愿公益等方面。面对着琳琅满目的社团活动,你会pick哪一个呢?

概要设计

主要功能包括公告通知,社团风采,社团招新列表,社团培训列表,社团活动列表,社团简介,我的报名,后台招新/培训/活动项目管理,后台通知管理,后台管理员管理等功能
image.png

技术选型

  • 使用腾讯专门的小程序云开发技术,云资源包含云函数,数据库,带宽,存储空间,定时器等,资源配额价格低廉,无需域名和服务器即可搭建。
  • 小程序本身的即用即走,适合小工具的使用场景,也适合快速开发迭代。
  • 云开发技术采用腾讯内部链路,没有被黑客攻击的风险,不会 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);
    }  

原型设计

image.png
image.png
image.png
image.png
image.png
image.png
image.png
image.png
image.png

后台管理系统设计

image.png
image.png
image.png
image.png
image.png
image.png

源码

git代码


CC同学呀
27 声望13 粉丝

鹅厂程序猿一枚,交流v: cclinux0730