MyGoMall

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #cli #dsh #claude-code #codex #developer-tools #react

★ 18 Open GitHub ↗

MyGoMall——字节跳动青训营结营项目

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
 <h1>🛍️ MyGoMall<br/></h1>
 <img src="https://img.shields.io/badge/go-%2300ADD8.svg?style=for-the-badge&logo=go&logoColor=white"/>
 <img src="https://img.shields.io/badge/mysql-%2300f.svg?style=for-the-badge&logo=mysql&logoColor=white"/>
 <img src="https://img.shields.io/badge/cloudwego-%23008ECF.svg?style=for-the-badge&logo=bytedance&logoColor=white"/>
</div>

# 🌟 简介

MyGoMall 是一个基于分布式微服务架构的电商平台，提供用户认证、商品管理、购物车、订单、支付等功能。

详情见：https://taix7w1al12.feishu.cn/wiki/XXupwJXGriFIsJkWAmbcL2N9nQb#share-KfUAd7n74oRRAuxT5bWcauVjnTt

## ✨ 核心特性

- 🔐 **认证系统** - 基于JWT的用户注册和登录
- 📦 **商品管理** - 完整的商品目录系统
- 🛒 **购物车** - 强大的购物车功能
- 📋 **订单处理** - 订单管理和追踪
- 💳 **支付集成** - 支付网关集成就绪
- 🏗️ **清晰架构** - 行业标准的项目结构
- 📝 **详细日志** - 全面的日志系统
- ⚙️ **易于配置** - 基于YAML的配置管理

> [!NOTE]  
>
> - 需要 Go >= 1.18
> - 需要 MySQL >= 8.0
> - 推荐 Redis >= 6.0

## 📚 目录

- [技术栈](#-技术栈)
- [项目结构](#-项目结构)
- [快速开始](#-快速开始)
  - [安装说明](#安装说明)
  - [配置说明](#配置说明)
- [API文档](#-api文档)
- [开发指南](#-开发指南)
- [数据库架构](#-数据库架构)
- [贡献指南](#-贡献指南)
- [许可证](#-许可证)
- [作者](#-作者)

## 🛠️ 技术栈

<div align="center">
  <table>
    <tr>
      <td align="center" width="96">
        <img src="https://cdn.simpleicons.org/go" width="48" height="48" alt="Go" />
        <br>Go
      </td>
      <td align="center" width="96">
        <img src="https://cdn.simpleicons.org/mysql" width="48" height="48" alt="MySQL" />
        <br>MySQL
      </td>
      <td align="center" width="96">
        <img src="https://cdn.simpleicons.org/redis" width="48" height="48" alt="Redis" />
        <br>Redis
      </td>
      <td align="center" width="96">
        <img src="https://cdn.simpleicons.org/jsonwebtokens" width="48" height="48" alt="JWT" />
        <br>JWT
      </td>
      <td align="center" width="96">
        <img src="https://cdn.simpleicons.org/bytedance" width="48" height="48" alt="Kitex" />
        <br>Kitex
      </td>
      <td align="center" width="96">
        <img src="https://cdn.simpleicons.org/go/00ADD8" width="48" height="48" alt="GORM" />
        <br>GORM
      </td>
      <td align="center" width="96">
        <img src="https://cdn.simpleicons.org/bytedance" width="48" height="48" alt="Hertz" />
        <br>Hertz
      </td>
    </tr>
    <tr>
      <td align="center" width="96">
        <img src="https://cdn.simpleicons.org/rabbitmq" width="48" height="48" alt="RabbitMQ" />
        <br>RabbitMQ
      </td>
      <td align="center" width="96">
        <img src="https://cdn.simpleicons.org/consul" width="48" height="48" alt="Consul" />
        <br>Consul
      </td>
      <td align="center" width="96">
        <img src="https://cdn.simpleicons.org/docker" width="48" height="48" alt="Docker" />
        <br>Docker
      </td>
      <td align="center" width="96">
        <img src="https://www.kindpng.com/picc/m/393-3937724_protocol-buffers-google-developers-hd-png-download.png" width="48" height="48" alt="Protobuf" />
        <br>Protobuf
      </td>
    </tr>
  </table>
</div>

> [!TIP]  
> 我们的技术栈中的每个组件都是基于其可靠性和在生产环境中的广泛采用而选择的。

### 开发中的挑战

1. **认证流程**

- 安全存储密钥
   - 正确解码Token并认证
   - 处理令牌过期

2. **表单处理**
   - 版本1：使用HTML5验证
   - 版本2：实现受控组件

3. **容器化部署**

- Consul的服务注册与发现
   - 检查网关与路由的配置
   - Redis的集群部署

4. **下单-扣除库存-支付**

- 复杂的业务场景需求分析
   - 高并发场景下的性能问题
   - Saga分布式事务一致性解决方案

📂 项目结构

## 🚀 快速开始

### 安装说明

1. 克隆仓库：
```bash
git clone https://github.com/BeroKiTeer/MyGoMall.git
cd MyGoMall
```

2. 安装依赖：
```bash
go mod download
或
go mod tidy
```

3. 设置数据库：
```bash
cd docs/database
# 按照提示，在 `MyGoMall` database 中建立数据表与索引
```

4. 配置应用：
```bash
cd app/[微服务名]/conf/dev
# 使用您的数据库凭证编辑 各个微服务的配置文件
```

5. 在`Docker`上构建：
    1. 使用以下路径的 `Dockerfile`：`deploy\docker\[微服务名]\Dockerfile`
    2. 绑定端口，端口号要与 `conf/dev`中的 `yaml`文件填写的一致
    3. 环境变量，设置`GO_ENV=dev`绑定开发环境。

## 📝 API文档

```bash
cd docs/api
```

## 🗄️ 数据库架构

我们的综合电商数据库包括：

- `user`: 用户账户和认证
- `product`: 商品基本信息
- `category`: 商品类别
- `category_product` : 中间表，在`product`表与`category`表中建立联系
- `order`: 订单处理
- `payment`: 支付记录

## 🤝 贡献指南

我们欢迎贡献！请按照以下步骤操作：

1. Fork 本仓库
2. 创建您的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交您的更改 (`git commit -m '添加一些很棒的特性'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启一个 Pull Request

## 📄 许可证

本项目采用 MIT 许可证。

## 🙋‍♀ 作者

- [金仓鼠](https://github.com/BeroKiTeer) 
- [Blaze](https://github.com/wzy04)
- [Muschuang123](https://github.com/Muschuang123)
- [supermefyz](https://github.com/supermefyz)
- [CruxZhou](https://github.com/CruxZhou)
- [图图](https://github.com/youniverse-jk)
- [kklmars](https://github.com/kklmars)

---

<div align="center">
<br/>
⭐ 在 GitHub 上为我们加注星标 | 📖 阅读 Wiki | 🐛 报告问题
</div>

MyGoMall

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README