从 0 到 100:4S 店服务小程序开发历程
作者：CC同学
- 2024-07-08 广东
本文字数：10302 字
阅读完需：约 34 分钟
背景
为汽车销售和服务业务设计，旨在提供用户便捷的预约和汽车服务的方式。
功能设计
在线预约试驾：用户可以选择感兴趣的车型并预约试驾，选择适合自己的时间进行试驾安排。
维保服务预约：用户可以预约汽车的定期保养、维修和检查服务。可以选择服务项目、预约时间。
店内活动：4S 店为回馈用户，会经常组织一些活动。用户可以在小程序上浏览活动信息并报名参加活动，店家可以通过小程序收集报名信息并进行管理，包括签到、活动记录、活动照片、活动评论等。
活动数据统计：小程序可以统计活动数据，包括参与人数、评论反馈等。
设计图
数据库设计
ActivityModel.DB_STRUCTURE = { _pid: 'string|true', ACTIVITY_ID: 'string|true',
ACTIVITY_TITLE: 'string|true|comment=标题', ACTIVITY_STATUS: 'int|true|default=1|comment=状态 0=未启用,1=使用中',
ACTIVITY_CATE_ID: 'string|true|default=0|comment=分类', ACTIVITY_CATE_NAME: 'string|false|comment=分类冗余',
ACTIVITY_CANCEL_SET: 'int|true|default=1|comment=取消设置 0=不允,1=允许,2=仅截止前可取消', ACTIVITY_CHECK_SET: 'int|true|default=0|comment=审核 0=不需要审核,1=需要审核', ACTIVITY_IS_MENU: 'int|true|default=1|comment=是否公开展示名单',
ACTIVITY_MAX_CNT: 'int|true|default=20|comment=人数上限 0=不限', ACTIVITY_START: 'int|false|comment=活动开始时间', ACTIVITY_END: 'int|false|comment=活动截止时间', ACTIVITY_STOP: 'int|true|default=0|comment=报名截止时间 0=永不过期',
ACTIVITY_ORDER: 'int|true|default=9999', ACTIVITY_VOUCH: 'int|true|default=0',
ACTIVITY_FORMS: 'array|true|default=[]', ACTIVITY_OBJ: 'object|true|default={}',
ACTIVITY_JOIN_FORMS: 'array|true|default=[]',
ACTIVITY_ADDRESS: 'string|false|comment=详细地址', ACTIVITY_ADDRESS_GEO: 'object|false|comment=详细地址坐标参数',
ACTIVITY_QR: 'string|false', ACTIVITY_VIEW_CNT: 'int|true|default=0', ACTIVITY_JOIN_CNT: 'int|true|default=0', ACTIVITY_COMMENT_CNT: 'int|true|default=0',
ACTIVITY_USER_LIST: 'array|true|default=[]|comment={name,id,pic}',
ACTIVITY_ADD_TIME: 'int|true', ACTIVITY_EDIT_TIME: 'int|true', ACTIVITY_ADD_IP: 'string|false', ACTIVITY_EDIT_IP: 'string|false',};MeetModel.DB_STRUCTURE = { _pid: 'string|true', MEET_ID: 'string|true', MEET_ADMIN_ID: 'string|true|comment=添加的管理员', MEET_TITLE: 'string|true|comment=标题', MEET_JOIN_FORMS: 'array|true|default=[]|comment=表单字段设置', MEET_DAYS: 'array|true|default=[]|comment=最近一次修改保存的可用日期',
MEET_CATE_ID: 'string|true|comment=分类编号', MEET_CATE_NAME: 'string|true|comment=分类冗余',
MEET_FORMS: 'array|true|default=[]', MEET_OBJ: 'object|true|default={}',
MEET_CANCEL_SET: 'int|true|default=1|comment=取消设置 0=不允,1=允许,2=仅开始前可取消',
MEET_STATUS: 'int|true|default=1|comment=状态 0=未启用,1=使用中,9=停止预约,10=已关闭', MEET_ORDER: 'int|true|default=9999', MEET_VOUCH: 'int|true|default=0',
MEET_QR: 'string|false',
MEET_ADD_TIME: 'int|true', MEET_EDIT_TIME: 'int|true', MEET_ADD_IP: 'string|false', MEET_EDIT_IP: 'string|false',};
复制代码
核心代码
class MeetService extends BaseProjectService {
constructor() { super(); this._log = new LogUtil(projectConfig.MEET_LOG_LEVEL); }
/** * 抛出异常 * @param {*} msg * @param {*} code */ AppError(msg) { this._log.error(msg); super.AppError(msg); }
_meetLog(meet, func = '', msg = '') { let str = ''; str = `[MEET=${meet.MEET_TITLE}][${func}] ${msg}`; this._log.debug(str); }
/** 统一获取Meet（某天) */ async getMeetOneDay(meetId, day, where, fields = '*') {
let meet = await MeetModel.getOne(where, fields); if (!meet) return meet;
meet.MEET_DAYS_SET = await this.getDaysSet(meetId, day, day); return meet; }
/** 获取日期设置 */ async getDaysSet(meetId, startDay, endDay = null) { let where = { DAY_MEET_ID: meetId } if (startDay && endDay && endDay == startDay) where.day = startDay; else if (startDay && endDay) where.day = ['between', startDay, endDay]; else if (!startDay && endDay) where.day = ['<=', endDay]; else if (startDay && !endDay) where.day = ['>=', startDay];
let orderBy = { 'day': 'asc' } let list = await DayModel.getAllBig(where, 'day,dayDesc,times', orderBy, 1000);
for (let k = 0; k < list.length; k++) { delete list[k]._id; }
return list; }
// 按时段统计某时段报名情况 async statJoinCnt(meetId, timeMark) { let whereDay = { DAY_MEET_ID: meetId, day: this.getDayByTimeMark(timeMark) }; let day = await DayModel.getOne(whereDay, 'times'); if (!day) return;
let whereJoin = { JOIN_MEET_TIME_MARK: timeMark, JOIN_MEET_ID: meetId }; let ret = await JoinModel.groupCount(whereJoin, 'JOIN_STATUS');
let stat = { //统计数据 succCnt: ret['JOIN_STATUS_1'] || 0, //1=预约成功, cancelCnt: ret['JOIN_STATUS_10'] || 0, //10=已取消, adminCancelCnt: ret['JOIN_STATUS_99'] || 0, //99=后台取消 };
let times = day.times; for (let j in times) { if (times[j].mark === timeMark) { let data = { ['times.' + j + '.stat']: stat } await DayModel.edit(whereDay, data); return; } }
}
// 预约前检测 async beforeJoin(userId, meetId, timeMark) { await this.checkMeetRules(userId, meetId, timeMark); }
// 用户预约逻辑 async join(userId, meetId, timeMark, formsList) { }
// 根据日期获取其所在天设置 getDaySetByDay(meet, day) { for (let k = 0; k < meet.MEET_DAYS_SET.length; k++) { if (meet.MEET_DAYS_SET[k].day == day) return dataUtil.deepClone(meet.MEET_DAYS_SET[k]); } return null; }
// 根据时段标识获取其所在天 getDayByTimeMark(timeMark) { return timeMark.substr(1, 4) + '-' + timeMark.substr(5, 2) + '-' + timeMark.substr(7, 2); }
// 根据时段标识获取其所在天设置 getDaySetByTimeMark(meet, timeMark) { let day = this.getDayByTimeMark(timeMark);
for (let k = 0; k < meet.MEET_DAYS_SET.length; k++) { if (meet.MEET_DAYS_SET[k].day == day) return dataUtil.deepClone(meet.MEET_DAYS_SET[k]); } return null; }
// 根据时段标识获取其所在时段设置 getTimeSetByTimeMark(meet, timeMark) { let day = this.getDayByTimeMark(timeMark);
for (let k = 0; k < meet.MEET_DAYS_SET.length; k++) { if (meet.MEET_DAYS_SET[k].day != day) continue;
for (let j in meet.MEET_DAYS_SET[k].times) { if (meet.MEET_DAYS_SET[k].times[j].mark == timeMark) return dataUtil.deepClone(meet.MEET_DAYS_SET[k].times[j]); } } return null; }
// 预约时段人数和状态控制校验 async checkMeetTimeControll(meet, timeMark, meetPeopleCnt = 1) { if (!meet) this.AppError('预约时段设置错误, 预约项目不存在');
let daySet = this.getDaySetByTimeMark(meet, timeMark); // 当天设置 let timeSet = this.getTimeSetByTimeMark(meet, timeMark); // 预约时段设置
if (!daySet || !timeSet) this.AppError('预约时段设置错误day&time');
let statusDesc = timeSet.status == 1 ? '开启' : '关闭'; let limitDesc = ''; if (timeSet.isLimit) { limitDesc = '人数上限MAX=' + timeSet.limit; } else limitDesc = '人数不限制NO';
this._meetLog(meet, `------------------------------`); this._meetLog(meet, `#预约时段控制,预约日期=<${daySet.day}>`, `预约时段=[${timeSet.start}-${timeSet.end}],状态=${statusDesc}, ${limitDesc} 当前预约成功人数=${timeSet.stat.succCnt}`);
if (timeSet.status == 0) this.AppError('该时段预约已经关闭，请选择其他');
// 时段总人数限制 if (timeSet.isLimit) { if (timeSet.stat.succCnt >= timeSet.limit) { this.AppError('该时段预约人员已满，请选择其他'); }
let maxCnt = timeSet.limit - timeSet.stat.succCnt;
if (maxCnt < meetPeopleCnt) { this.AppError('本时段最多还可以预约' + (maxCnt) + '人，您当前提交了' + meetPeopleCnt + '人，请调整后再提交'); } }
}
/** 报名规则校验 */ async checkMeetRules(userId, meetId, timeMark, formsList = null) {
// 预约时段是否存在 let meetWhere = { _id: meetId }; let day = this.getDayByTimeMark(timeMark); let meet = await this.getMeetOneDay(meetId, day, meetWhere); if (!meet) { this.AppError('预约时段选择错误，请重新选择'); }
// 预约时段人数和状态控制校验 let meetPeopleCnt = formsList ? formsList.length : 1;
await this.checkMeetTimeControll(meet, timeMark, meetPeopleCnt);
// 截止规则 await this.checkMeetEndSet(meet, timeMark);
// 针对用户的次数限制 await this.checkMeetLimitSet(userId, meet, timeMark, meetPeopleCnt);
}
// 预约次数限制校验 async checkMeetLimitSet(userId, meet, timeMark, nowCnt) { if (!meet) this.AppError('预约次数规则错误, 预约项目不存在'); let meetId = meet._id;
let daySet = this.getDaySetByTimeMark(meet, timeMark); // 当天设置 let timeSet = this.getTimeSetByTimeMark(meet, timeMark); // 预约时段设置
this._meetLog(meet, `------------------------------`); this._meetLog(meet, `#预约次数规则,预约日期=<${daySet.day}>`, `预约时段=[${timeSet.start}～${timeSet.end}]`);
let where = { JOIN_MEET_ID: meetId, JOIN_MEET_TIME_MARK: timeMark, JOIN_USER_ID: userId, JOIN_STATUS: JoinModel.STATUS.SUCC } let cnt = await JoinModel.count(where); let maxCnt = projectConfig.MEET_MAX_JOIN_CNT; this._meetLog(meet, `预约次数规则,mode=本时段可预约${maxCnt}次`, `当前已预约=${cnt}次`);
if (cnt >= maxCnt) this.AppError(`您本时段已经预约，不能继续预约`);
}
// 预约截止设置校验 async checkMeetEndSet(meet, timeMark) { if (!meet) this.AppError('预约截止规则错误, 预约项目不存在');
this._meetLog(meet, `------------------------------`); let daySet = this.getDaySetByTimeMark(meet, timeMark); // 当天设置 let timeSet = this.getTimeSetByTimeMark(meet, timeMark); // 预约时段设置
this._meetLog(meet, `#预约截止规则,预约日期=<${daySet.day}>`, `预约时段=[${timeSet.start}-${timeSet.end}]`);
let nowTime = timeUtil.time('Y-M-D h:m:s');
/* let startTime = daySet.day + ' ' + timeSet.start + ':00'; this._meetLog(meet, `预约开始规则,mode=<时段过期判定>`, `预约开始时段=${startTime},当前时段=${nowTime}`); if (nowTime > startTime) { this.AppError('该时段已开始，无法预约，请选择其他'); }*/
let endTime = daySet.day + ' ' + timeSet.end + ':59'; this._meetLog(meet, `预约开始规则,mode=<时段过期判定>`, `预约结束时段=${endTime},当前时段=${nowTime}`); if (nowTime > endTime) { this.AppError('该时段已结束，无法预约，请选择其他'); }
}
/** 预约详情 */ async viewMeet(meetId) {
let fields = '*';
let where = { _id: meetId, MEET_STATUS: ['in', [MeetModel.STATUS.COMM, MeetModel.STATUS.OVER]] } let meet = await MeetModel.getOne(where, fields); if (!meet) return null;
let getDaysSet = []; meet.MEET_DAYS_SET = await this.getDaysSet(meetId, timeUtil.time('Y-M-D')); //今天及以后 let daysSet = meet.MEET_DAYS_SET;
let now = timeUtil.time('Y-M-D'); for (let k = 0; k < daysSet.length; k++) { let dayNode = daysSet[k];
if (dayNode.day < now) continue; // 排除过期
let getTimes = [];
for (let j in dayNode.times) { let timeNode = dayNode.times[j];
// 排除状态关闭的时段 if (timeNode.status != 1) continue;
// 判断数量是否已满 if (timeNode.isLimit && timeNode.stat.succCnt >= timeNode.limit) timeNode.error = '预约已满';
// 截止规则 if (!timeNode.error) { try { await this.checkMeetEndSet(meet, timeNode.mark); } catch (ex) { if (ex.name == 'AppError') timeNode.error = '预约结束'; else throw ex; } }
getTimes.push(timeNode); } dayNode.times = getTimes;
getDaysSet.push(dayNode); }
// 只返回需要的字段 let ret = {}; ret.MEET_DAYS_SET = getDaysSet;
ret.MEET_QR = meet.MEET_QR; ret.MEET_TITLE = meet.MEET_TITLE; ret.MEET_CATE_NAME = meet.MEET_CATE_NAME; ret.MEET_OBJ = meet.MEET_OBJ; return ret; }
/** 预约前获取关键信息 */ async detailForJoin(userId, meetId, timeMark) {
let fields = 'MEET_DAYS_SET,MEET_JOIN_FORMS, MEET_TITLE';
let where = { _id: meetId, MEET_STATUS: ['in', [MeetModel.STATUS.COMM, MeetModel.STATUS.OVER]] } let day = this.getDayByTimeMark(timeMark); let meet = await this.getMeetOneDay(meetId, day, where, fields); if (!meet) return null;
let dayDesc = timeUtil.fmtDateCHN(this.getDaySetByTimeMark(meet, timeMark).day);
let timeSet = this.getTimeSetByTimeMark(meet, timeMark); let timeDesc = timeSet.start + '～' + timeSet.end; meet.dayDesc = dayDesc + ' ' + timeDesc;
// 取出本人最近一次本时段填写表单 let whereMy = { JOIN_USER_ID: userId, } let orderByMy = { JOIN_ADD_TIME: 'desc' } let joinMy = await JoinModel.getOne(whereMy, 'JOIN_FORMS', orderByMy);
if (joinMy) meet.myForms = joinMy.JOIN_FORMS; else meet.myForms = [];
return meet; }
/** 按天获取预约项目 */ async getMeetListByDay(day) { let where = { 'meet.MEET_STATUS': ['in', [MeetModel.STATUS.COMM, MeetModel.STATUS.OVER]], 'day': day, };
let orderBy = { 'MEET_ORDER': 'asc', 'MEET_ADD_TIME': 'desc' };
let fields = 'meet.MEET_ORDER,meet.MEET_ADD_TIME,meet.MEET_TITLE,meet.MEET_DAYS_SET,meet.MEET_OBJ.cover, DAY_MEET_ID, day, times';
let joinParams = { from: MeetModel.CL, localField: 'DAY_MEET_ID', foreignField: '_id', as: 'meet', };
let list = await DayModel.getListJoin(joinParams, where, fields, orderBy, 1, 100, false); list = list.list; let retList = [];
for (let k = 0; k < list.length; k++) {
let usefulTimes = [];
for (let j in list[k].times) { if (list[k].times[j].status != 1) continue; usefulTimes.push(list[k].times[j]); }
if (usefulTimes.length == 0) continue;
let node = {}; node.timeDesc = usefulTimes.length > 1 ? usefulTimes.length + '个时段' : usefulTimes[0].start; node.title = list[k].meet.MEET_TITLE; node.pic = list[k].meet.MEET_OBJ.cover; node._id = list[k].DAY_MEET_ID; retList.push(node);
} return retList; }
/** 获取从某天开始可预约的日期 */ async getHasDaysFromDay(day) { let where = { day: ['>=', day], };
let fields = 'times,day'; let list = await DayModel.getAllBig(where, fields);
let retList = []; for (let k = 0; k < list.length; k++) { for (let n in list[k].times) { if (list[k].times[n].status == 1) { retList.push(list[k].day); break; } } } return retList; }
/** 取得预约分页列表 */ async getMeetList({ search, // 搜索条件 sortType, // 搜索菜单 sortVal, // 搜索菜单 orderBy, // 排序 cateId, //分类查询条件 page, size, isTotal = true, oldTotal }) {
orderBy = orderBy || { 'MEET_ORDER': 'asc', 'MEET_ADD_TIME': 'desc' }; let fields = 'MEET_TITLE,MEET_OBJ,MEET_DAYS,MEET_CATE_NAME,MEET_CATE_ID';
let where = {}; where.and = { _pid: this.getProjectId() //复杂的查询在此处标注PID };
if (cateId && cateId !== '0') where.and.MEET_CATE_ID = cateId;
where.and.MEET_STATUS = ['in', [MeetModel.STATUS.COMM, MeetModel.STATUS.OVER]]; // 状态
if (util.isDefined(search) && search) { where.or = [ { MEET_TITLE: ['like', search] }, ];
} else if (sortType && util.isDefined(sortVal)) { // 搜索菜单 switch (sortType) { case 'sort': { orderBy = this.fmtOrderBySort(sortVal, 'NEWS_ADD_TIME'); break; } case 'cateId': { if (sortVal) where.and.MEET_CATE_ID = String(sortVal); break; } } } let result = await MeetModel.getList(where, fields, orderBy, page, size, isTotal, oldTotal);
return result; }
/** 取消我的预约 只有成功可以取消 */ async cancelMyJoin(userId, joinId) { let where = { JOIN_USER_ID: userId, _id: joinId, JOIN_IS_CHECKIN: 0, // 核销不能取消 JOIN_STATUS: JoinModel.STATUS.SUCC }; let join = await JoinModel.getOne(where);
if (!join) { this.AppError('未找到可取消的预约记录'); }
// 取消规则判定 let whereMeet = { _id: join.JOIN_MEET_ID, MEET_STATUS: ['in', [MeetModel.STATUS.COMM, MeetModel.STATUS.OVER]] } let meet = await this.getMeetOneDay(join.JOIN_MEET_ID, join.JOIN_MEET_DAY, whereMeet); if (!meet) this.AppError('预约项目不存在或者已关闭');
let daySet = this.getDaySetByTimeMark(meet, join.JOIN_MEET_TIME_MARK); let timeSet = this.getTimeSetByTimeMark(meet, join.JOIN_MEET_TIME_MARK); if (!timeSet) this.AppError('被取消的时段不存在');
if (meet.MEET_CANCEL_SET == 0) this.AppError('该预约不能取消');
let startT = daySet.day + ' ' + timeSet.start + ':00'; let startTime = timeUtil.time2Timestamp(startT); let now = timeUtil.time(); if (meet.MEET_CANCEL_SET == 2 && now > startTime) this.AppError('该预约时段已经开始，无法取消');
// TODO 已过期不能取消
await JoinModel.del(where);
// 统计 this.statJoinCnt(join.JOIN_MEET_ID, join.JOIN_MEET_TIME_MARK);
}
/** 取得我的预约详情 */ async getMyJoinDetail(userId, joinId) {
let fields = 'JOIN_COMPLETE_END_TIME,JOIN_IS_CHECKIN,JOIN_CHECKIN_TIME,JOIN_REASON,JOIN_MEET_ID,JOIN_MEET_TITLE,JOIN_MEET_DAY,JOIN_MEET_TIME_START,JOIN_MEET_TIME_END,JOIN_STATUS,JOIN_ADD_TIME,JOIN_CODE,JOIN_FORMS';
let where = { _id: joinId, JOIN_USER_ID: userId }; return await JoinModel.getOne(where, fields); }
/** 取得我的预约分页列表 */ async getMyJoinList(userId, { search, // 搜索条件 sortType, // 搜索菜单 sortVal, // 搜索菜单 orderBy, // 排序 page, size, isTotal = true, oldTotal }) { orderBy = orderBy || { // 'JOIN_MEET_DAY': 'desc', // 'JOIN_MEET_TIME_START': 'desc', 'JOIN_ADD_TIME': 'desc' }; let fields = 'JOIN_COMPLETE_END_TIME,JOIN_IS_CHECKIN,JOIN_REASON,JOIN_MEET_ID,JOIN_MEET_TITLE,JOIN_MEET_DAY,JOIN_MEET_TIME_START,JOIN_MEET_TIME_END,JOIN_STATUS,JOIN_ADD_TIME,JOIN_OBJ';
let where = { JOIN_USER_ID: userId }; //where.MEET_STATUS = ['in', [MeetModel.STATUS.COMM, MeetModel.STATUS.OVER]]; // 状态
if (util.isDefined(search) && search) { where['JOIN_MEET_TITLE'] = { $regex: '.*' + search, $options: 'i' }; } else if (sortType) { // 搜索菜单 switch (sortType) {
case 'cateId': { if (sortVal) where.JOIN_MEET_CATE_ID = String(sortVal); break; } case 'all': { //所有 break; } case 'use': { //可用未过期 where.JOIN_STATUS = JoinModel.STATUS.SUCC; where.JOIN_COMPLETE_END_TIME = ['>=', timeUtil.time('Y-M-D h:m')]; break; } case 'check': { //已核销 where.JOIN_STATUS = JoinModel.STATUS.SUCC; where.JOIN_IS_CHECKIN = 1; break; } case 'timeout': { //已过期未核销 where.JOIN_STATUS = JoinModel.STATUS.SUCC; where.JOIN_IS_CHECKIN = 0; where.JOIN_COMPLETE_END_TIME = ['<', timeUtil.time('Y-M-D h:m')]; break; } case 'succ': { //预约成功 where.JOIN_STATUS = JoinModel.STATUS.SUCC; //where.JOIN_MEET_DAY = ['>=', timeUtil.time('Y-M-D h:m')]; //where.JOIN_MEET_TIME_START = ['>=', timeUtil.time('h:m')]; break; } case 'cancel': { //已取消 where.JOIN_STATUS = ['in', [JoinModel.STATUS.CANCEL, JoinModel.STATUS.ADMIN_CANCEL]]; break; } } } let result = await JoinModel.getList(where, fields, orderBy, page, size, isTotal, oldTotal);
return result; }
/** 取得我的某日预约列表 */ async getMyJoinSomeday(userId, day) {
let fields = 'JOIN_IS_CHECKIN,JOIN_MEET_ID,JOIN_MEET_TITLE,JOIN_MEET_DAY,JOIN_MEET_TIME_START,JOIN_MEET_TIME_END,JOIN_STATUS,JOIN_ADD_TIME';
let where = { JOIN_USER_ID: userId, JOIN_MEET_DAY: day }; //where.MEET_STATUS = ['in', [MeetModel.STATUS.COMM, MeetModel.STATUS.OVER]]; // 状态
let orderBy = { 'JOIN_MEET_TIME_START': 'asc', 'JOIN_ADD_TIME': 'desc' }
return await JoinModel.getAll(where, fields, orderBy);
}}
复制代码
UI 设计
后台管理系统设计
git 代码下载
划线
评论
复制
发布于: 刚刚阅读数: 3
CC同学
关注
CC同学的小程序开发笔记 2021-06-13 加入
大鹅厂的小小程序媛，vx: cclinux0730
评论