asset_helper/backend/README.md

Backend Services

项目结构

backend/
├── nginx/               # Nginx 配置
├── gateway/             # WebSocket 网关服务
├── services/
│   └── user-svc/        # 用户微服务
├── shared/              # 公共工具包
│   ├── logger/          # 日志工具
│   ├── errors/          # 错误处理
│   ├── postgres/        # PostgreSQL 数据库
│   ├── redis/           # Redis 缓存
│   └── proto/           # 公共 proto 定义
├── scripts/             # 自动化脚本
├── docker-compose.yml   # 生产环境配置
├── docker-compose.dev.yml # 开发环境配置
├── Makefile             # 命令封装
└── README.md            # 使用说明

环境要求

• Docker
• Docker Compose

快速开始

开发环境

1. 一键启动开发环境：

make dev-start

这会自动：

• 生成 proto 代码
• 构建开发环境镜像
• 启动所有服务
• 显示服务状态

2. 查看服务状态：

make dev-status

3. 查看服务日志：

make dev-logs

4. 停止开发环境：

make dev-down

生产环境

1. 构建生产环境：

make build

2. 启动生产环境：

make up

3. 停止生产环境：

make down

其他命令

生成 proto 代码

make gen-proto

运行测试

make test

服务端口

• Nginx: 80
• Gateway: 8080
• User Service: 50051
• PostgreSQL: 5432
• Redis: 6379

技术栈

• Go 1.26.1
• gRPC
• PostgreSQL
• Redis
• Nginx
• Docker

注意事项

• 所有服务都在 Docker 容器中运行，无宿主机依赖
• 服务之间通过内部网络通信
• 数据持久化使用 Docker 卷