域名 AXUM.RS 将于 2025 年 10 月到期。我们无意再对其进行续费,如果你有意接续这个域名,请与我们取得联系。
  • AXUM.RS 现仅需人民币 3000 元(大写:叁仟元整。接受适度议价
  • 按照行业规则,AXUM.RS 到期后,大概率会进入长时间的赎回期,该期间内,如果你想拥有该域名,将要付出高额的费用
  • 我们已启用 AXUM.EU.ORG 域名,并将持续运营
  • 仅接受微信或支付宝交易
如果你对 AXUM.RS 有兴趣,请和我们进行联系:

项目结构

本专题相对复杂,规划好结构非常必要。本专题至少包含四大部分:阶段一的单节点商城、阶段二的分布式商城、商城的UI和各种所需要的前置知识。

如上文所述,整体看,本专题包含四大部分:

  • 阶段一的单节点商城,我们命名为和整个专题同名的 plaza
  • 阶段二的分布式商城,我们命名为 plaza-distributed
  • 商城的UI,我们命名为 plaza-ui
  • 各种所需要的前置知识,我们命名为 knowledge

其中,前置知识比较繁杂,包含多种知识,每个知识都将以单独项目出现,knowledge 只是用于组织这些单独的项目。

目录结构

我们通过一个 plaza 目录组织本专题所需要的所有项目,如下:

├── plaza
│   ├── knowledge
│   ├── plaza
│   ├── plaza-distributed
│   └── plaza-ui

阶段一的单节点商城

我们以最简单的结构来组织单节点商城:

cargo new plaza

为了便于第二阶段的重构,所有业务功能都独立为单独的模块,并且包含:

  • db:数据操作
  • model:模型定义
  • service:封装业务逻辑
  • form:表单定义
  • handler:axum 处理程序

user(用户)为例,它的结构是:

plaza/plaza
└── src
    ├── user
    │   ├── db
    │   ├── form
    │   ├── handler
    │   ├── model
    │   └── service

除此之外,我们还将中间件(mid)、工具函数(util)单独为一个模块:

plaza/plaza
└── src
    ├── mid
    ├── user
    │   ├── db
    │   ├── form
    │   ├── handler
    │   ├── model
    │   └── service
    └── util
plaza/plaza
└── src
    ├── merchant
    │   ├── db
    │   ├── form
    │   ├── handler
    │   ├── model
    │   └── service
    ├── mid
    ├── order
    │   ├── db
    │   ├── form
    │   ├── handler
    │   ├── model
    │   └── service
    ├── user
    │   ├── db
    │   ├── form
    │   ├── handler
    │   ├── model
    │   └── service
    └── util

前置知识

plaza/knowledge
├── distributed-lock
└── sse

阶段二的分布式商城

我们将依照旧版商城项目的结构进行创建,到时详解。

我们使用 NextJS 来构建 UI,使用的是官方的 create-next-app 命令,并使用 App 路由方式。所以它的结构就是典型的 NextJS 项目结构,具体结构我们到时详解。

整体结构

经过以上讲解,让我们看一下整个专题大概的目录结构:

├── plaza
│   ├── knowledge
│   │   ├── distributed-lock
│   │   └── sse
│   ├── plaza
│   │   └── src
│   │       ├── merchant
│   │       │   ├── db
│   │       │   ├── form
│   │       │   ├── handler
│   │       │   ├── model
│   │       │   └── service
│   │       ├── mid
│   │       ├── order
│   │       │   ├── db
│   │       │   ├── form
│   │       │   ├── handler
│   │       │   ├── model
│   │       │   └── service
│   │       ├── user
│   │       │   ├── db
│   │       │   ├── form
│   │       │   ├── handler
│   │       │   ├── model
│   │       │   └── service
│   │       └── util
│   ├── plaza-distributed
│   └── plaza-ui

开发环境

本专题将在 Linux x64 下进行开发,所以涉及到的某些脚本会使用 GNU 工具链和 Bash 脚本。这些工具基本与 MacOS 兼容,对于 Windows 而言,建议像作者一样,使用 WSL2。

专题所需要的一些服务,比如 PostgreSQL,都是使用 docker ,所以请确保你安装了 docker。

Rust 等环境和依赖使用截止本专题开始编写时的最新版本,并在整个专题编写期间保持版本锁定,即不会在编写中途更新任何版本:

  • Rust:version 1.84.0 (9fc6b4312 2025-01-07)
  • Axum:0.8
  • sqlx:0.8
  • tokio:1
  • serde:1

开发工具和插件

本专题使用 Visual Studio Code 进行开发,为了提高开发效率,将使用以下插件:

  • rust-analyzer:使用 VSC 开发 Rust 必备插件,提供自动完成、格式化代码、错误检查等日常开发所需的功能
  • Even Better TOML:提供 TOML 支持
  • Dependi:依赖管理,提供自动检测项目依赖是否有新版本等功能
  • Error Lens:将错误信息直接显示,而不需要移动光标到错误处,再弹出错误信息
  • DotEnv:提供 .env 支持
  • clang-format:格式化 protobuf3 文件
  • vscode-proto3:提供 protobuf3 支持
  • Prettier:对多种文件进行格式化,尤其是前端相关的文件
  • Tailwind CSS IntelliSense:提供 Tailwind CSS 支持。包括自动完成类名,显示类名对应的原生 CSS 等功能
  • Codeium:AI 智能助手,根据上下文提供代码补全
  • Roo Cline:AI 智能助理,通过 chat 自动生成项目。它是 Cline 的 fork 版本,提供比原版更易用的功能
  • REST Client:直接在 VSC 里发起 HTTP 请求,用于 API 测试

源码仓库

要查看完整内容,请先登录