Guwengo / zeromall

The mall system based on go-zero.

zero mall

• 基于 go + go-zero + gRPC, 以微服务方式实现的B2B2C通用电商平台.
• 目标:
  • 综合社区最佳实践, 力求产品级项目, 而不是 demo 玩具.
  • 通用业务单元: 可以自由组合使用.

Wiki:

• ZeroMall - wiki
• 项目文档

Client:

• client
• https://github.com/zeromicro/zeromall/wiki/client
• 基于 flutter 实现客户端(Web/iOS/Android/Windows/MacOS/Linux)

Requirements:

• flutter 2.5.0+
• GetX: 主要框架

Server:

• 基于 go + go-zero 实现
• app

Requirements:

• go 1.15+
• go-zero: 全功能的 go 微服务框架
• gRPC: RPC 领域事实上的标准
• etcd: 服务注册/服务发现
• mysql: 存储
• redis: 缓存
• kafka: 队列
• rabbitmq: 队列
• docker + docker-compose

这也是掌握本项目, 需要熟知的先修技能栈.

Development Environment:

• reference - wiki

• 搭建本地开发环境 - wiki

  • 请务必仔细查看文档, 有详细说明

• deploy/docs

• install:

# clone repo:
git clone [e-mail]:zeromicro/zeromall.git

# enter project root:
cd zeromall/


# run mysql/redis/rabbitmq/etcd:
task local:init

# install:
make install
make init

# install go pkg:
task tidy


# run:
task run

• 创建新服务目录:
  • go-zero 微服务创建脚手架: cookiecutter-go

cd zeromall/

# 在 app/biz 下创建一个新的业务服务目录:
make app.gen.biz

# 在 app/basic 下创建一个新的基础服务目录:
make app.gen.basic

示例服务:

• 示例服务 app/basic/demo - wiki
• 服务启动说明, 辅助理解代码结构

Structure:

• 项目目录结构详细说明 - wiki
• 非常详细的目录说明, 快速理解项目

RoadMap:

• zeromicro#3
• https://github.com/zeromicro/zeromall/projects/1