毕设:wei-xin-mini + TypeScript + nest.js + typeORM 搭建的校园外卖系统

简介: 毕设:wei-xin-mini + TypeScript + nest.js + typeORM 搭建的校园外卖系统

简介

完整的一套毕设级别项目,用于学习如何原生开发微信小程序,以及使用前端技术栈搭建较为完善的后端 Web 服务。

feature

  • theme、banner 业务划分
  • activity & 优惠券业务支持
  • 商品分类
  • 购物车业务
  • 订单业务
  • 延迟支付功能
  • 用户登录
  • 真实微信支付接入

对优惠券业务和订单业务做简单介绍,其余功能请扫码体验。

TODO:二维码

优惠券

用户只有在进行登录授权后,才可领取优惠券。并且优惠券是有品类限制和使用条件的,在品类上分为全场券品类劵,在使用条件上除了上述有可能存在品类限制外,还需要达到一定金额方可在支付时使用。因此大体有如下种类优惠券:

  • 全场无门槛减免劵
  • 甜点满 100 减 30 优惠券劵(单个类型限制)
  • 主食和热菜满 508 折优惠券(多个类型限制)
    ...

订单业务

当用户在购物车添加商品并触发下单逻辑后,后端首先需要对前端提交的数据进行详细校验,主要目的在于:

  • 保证数据的准确性(牢记前端传递过来的数据可能会被篡改或者存在时差
  • 核查库存,防止负库存情况发生

随后进行库存的预扣除、优惠券的核销。当扣除和核销成功后,会为该订单生成一条数据并插入到数据库中,并将该订单信息推入到消息队列中间件中,以便在订单支付超时能够进行库存和优惠券的归还。

用户在下单完成后,可以选择在一段时间内进行支付,也可以手动取消,或者超出时间范围内自动取消订单。

TODO:支付成功后将数据写入到 MQ 中间件(提高并发能力),方便其他 RPC 业务(短信通知、仓库发货等)进行处理。

该项目是本人在做毕业设计时的产物,之所以拿出来分享并做教程,是因为当时在对整套系统进行技术选型时遇到了比较大的阻力。

如果不感兴趣,或者比较想直接看干货,请跳过该部分。

阻力

dataBase

首先我有一点数据库基础(停留在 MySQL 应知应会水平)以为数据库就那么简单,撸袖子干就行了。可见当时是有多无知

后来随着不断开始设计数据库表时候,就明显觉得异样。当时脑子里并没有对于一个相对有点复杂系统有完整的设计思路,或者说是经验。

因为系统内部的每一个模块是有关联的,不是相互孤立的,所以最初版的数据库设计的跟屎一样。冗余字段、连表查询困难、连最基本的业务软删除硬删除都没有意识到,于是就开始找寻只跟数据库设计的书有关,或者说:能够快速教我如何设计这个数据库。

很显然,数据库好的书籍比比皆是,但教你如何设计一个系统,我还真没找到。于是在某网上找到一套课程,开始学习起来。这,就有了本套系统的数据库雏形。

但当时,比较大的阻力就是,如何将老师讲得东西迁移到自己的系统中?并能够用比较适合自己的技术栈给他应用起来?

经过很多资料的查询和尝试后,最终选择了 TS+typeORM 这种 ORM 去嫁接在 MySQL 之上。有几个原因:

  • 我想学习 TS,并应用它。
  • typeORM 语法很干练,类型注解用起来开发效率暴增

在开发的过程中,发现国内有的资料很少很少,官方文档也没有写全。往往很多时候需要去查询.d.ts 文件,如果还看不懂就要去 stackOverflow 和 typeORM 下面的 issue 查,查完自己还要反复试错。

因此就萌生了想把整个开发过程复盘下来,并分享给其他人。

webapi

同时在对 Web 框架进行选型时,由于我想尝试并学一下后端较为成熟的项目架构分层,就开始在 egg.js 和 Nest.js 之间进行选择。不是说 egg.js 不好,只能说我火候还差的太远我用不好,或者说理解不好。于是便选择了 nest.js 作为整套项目 Web 后端框架,同上述数据库一样,依然国内没有较为体系的、较为细致的教程。nestJS 官方文档虽然还不错,但是能够直接看文档就拿他撸一个项目,还需要有一定功底的。(除非你的项目根本就是小 demo,好多问题不考虑的那种。)

更何况后面由于项目存在一定复杂度,需要通过接入延迟消息队列去解耦业务时,自己又是趟了一把 rabbitMQ 的坑。因此更加坚定了自己写教程的想法。

技术栈

前端:微信小程序 + LinUI 组件库

后端:TypeScript + MySQL(typeORM)+ Nest.js + rabbitMQ

部署:Docker + Docker Swarm + CentOS + Nginx

技术难点

  • 实现一个功能的思维路径是怎样的?
  • 如何设计合理的订单系统?
  • 如何设计并实现优惠券活动?
  • 如何实现高效的延迟支付功能?
  • 如何通过 Docker 部署可拓展集群?

沉淀

闭环思维提升

并不是认不清自我要往全栈发展,只是作为一名 RD 人员,应该在力所能及的情况下对整个研发流程有一定理解和体会。这样在多人协作时才能发挥出最大价值,并且在一定程度上进行能够换位思考,而不是互相甩锅。

从一个 ide 产生,到具体落地需要几步?

设计规划 -> ... (接下来混乱了)

这就是当时我拿到课设题目时的状态,有主意但难实现。当时自己简单的学过一个 express 开发的项目 : (TODO:地址)

该项目较为简单,当时只是体验了一把 TS + express + GraphQL 开发的后端的乐趣,但并没有形成系统性的思维。

于是在经历某夜失眠后,将整个问题拆解成如下几个部分:

  • 一个需求如何从前端到后端进行具体实现?
  • 如何设计一个“能用的数据库”?
  • 合理的后端分层是怎么做的?
  • 如何部署一套“能用的“服务器?

在这漫长的修行之旅中,先后补充了如下知识:(如果需要,请私信我,我都会发给你~)

  • 数据库设计
  • Spring 设计电商(大体了解一下 Spring 写 webserver)
  • docker 部署
  • zero-to-nestJS

在这过程中,也参考了如下专栏:(TODO:地址)

将整个过程记录在该仓库中,一是为了能够给其他兄弟一些参考,另外是做一个自己的技术沉淀,毕竟好记性不如赖笔头。

虽然自己离真正的闭环还差的十万八千里,但好歹也是迈出了第一步~希望在下一个节点,能让这个圈儿,再壮实一把!

产出意识

凡是需要有“产出”,道理我都懂,但做的一直都不好。在学习前端知识的时候自己就有意识去产出,但都没有做的很满意。(TODO:仓库地址)

我想可能有如下原因:

  • 学习资料比比皆是,感觉自己的总结对他人无用(其实是错误的观点)
  • 枯燥乏味,难以坚持产出
  • 缺少内驱力

但依然还是坚持在做产出,例如我自己的技术脑图(TODO:脑图截图)

但都没有达到能真正的解决其他人的问题,虽然自己收获的蛮多。但没有得到市场(他人)认可,就是失败的产出(消极了)。

于是这次重新上路,决定将自己对于每一个 feature 的理解、思维路径、以及实现过程中遇到问题如何解决都会详细记录。力图给 nodejs 社区添砖加瓦(努力做,一定可以的)。

TODO:(反复思考重整) 思维路径可以归纳为如下步骤:

对需求进行详细分析,提炼需求点

进行数据库设计
      设计数据层(repository),思考数据库事务操作,找到核心点
         分解业务层(service),对复杂的业务分解处理完毕后,交给上面分析过的数据层。
           接口约定
             设计控制层(controller),主要起到承上(http)启下(service)作用。
                 抽象DTO,...
                    接口保护 
                      接口校验

整个分析过程会适当借助流程图辅助进行梳理,比如 jwt 登录鉴权、订单校验逻辑以及延迟消息队列的接入。

相关文章
|
2月前
|
JavaScript 前端开发 开发者
深入理解TypeScript:类型系统与实用技巧
【10月更文挑战第8天】深入理解TypeScript:类型系统与实用技巧
|
3月前
|
JavaScript 前端开发
用html+javascript打造公文一键排版系统12:删除附件说明中“附件:”里的空格
用html+javascript打造公文一键排版系统12:删除附件说明中“附件:”里的空格
|
2月前
|
JavaScript 前端开发 开发者
深入理解TypeScript:类型系统与最佳实践
【10月更文挑战第8天】深入理解TypeScript:类型系统与最佳实践
|
2月前
|
缓存 JSON JavaScript
Node.js模块系统
10月更文挑战第4天
41 2
|
29天前
|
JavaScript 前端开发 安全
TypeScript进阶:类型系统与高级类型的应用
【10月更文挑战第25天】TypeScript作为JavaScript的超集,其类型系统是其核心特性之一。本文通过代码示例介绍了TypeScript的基本数据类型、联合类型、交叉类型、泛型和条件类型等高级类型的应用。这些特性不仅提高了代码的可读性和可维护性,还帮助开发者构建更健壮的应用程序。
27 0
|
2月前
|
Web App开发 JavaScript API
构建高效后端系统:Node.js与Express框架的实践之路
【9月更文挑战第37天】在数字化时代的浪潮中,后端开发作为技术架构的核心,承载着数据处理和业务逻辑的重要职责。本文将深入探讨如何利用Node.js及其强大的Express框架来搭建一个高效、可扩展的后端系统。我们将从基础概念讲起,逐步引导读者理解并实践如何设计、开发和维护一个高性能的后端服务。通过实际代码示例和清晰的步骤说明,本文旨在为初学者和有经验的开发者提供一个全面的指南,帮助他们在后端开发的旅途上走得更远。
50 3
|
2月前
|
JavaScript 前端开发
前端js,vue系统使用iframe嵌入第三方系统的父子系统的通信
前端js,vue系统使用iframe嵌入第三方系统的父子系统的通信
|
2月前
|
JavaScript 前端开发 开发者
深入理解TypeScript:类型系统与实用技巧
【10月更文挑战第8天】深入理解TypeScript:类型系统与实用技巧
用html+javascript打造公文一键排版系统14:为半角和全角字符相互转换功能增加英文字母、阿拉伯数字、标点符号、空格选项
用html+javascript打造公文一键排版系统14:为半角和全角字符相互转换功能增加英文字母、阿拉伯数字、标点符号、空格选项
|
3月前
|
存储 文字识别 前端开发
用html+javascript打造公文一键排版系统13:增加半角字符和全角字符的相互转换功能
用html+javascript打造公文一键排版系统13:增加半角字符和全角字符的相互转换功能