History

Developer 17ff0d951e fix: 修复 docker-compose.yml 中所有服务的健康检查问题: - docker-compose.yml 的 healthcheck 覆盖了 Dockerfile 的 HEALTHCHECK - 使用 wget 而不是 curl - 健康检查 URL 不正确,导致所有服务显示 unhealthy 修复: 1. 统一使用 curl -f 代替 wget 2. 修正所有服务的健康检查 URL: - identity-service: /health → /api/v1/health - wallet-service: /health → /api/v1/health - backup-service: /health ✓ (保持不变) - planting-service: /health → /api/v1/health - referral-service: /health ✓ (保持不变) - reward-service: /health ✓ (保持不变) - mpc-service: /api/v1/health ✓ (已正确,改用 curl) - leaderboard-service: /health → /api/health - reporting-service: /health → /api/v1/health - authorization-service: /health ✓ (保持不变,改用 curl) 3. 统一 timeout 为 3s (原来是 10s) 4. admin-web: 优化 timeout 为 3s Docker HEALTHCHECK 机制: - 在容器内部执行 curl localhost:PORT/path - 不经过 Nginx 或外部网络 - 需要与服务实际端点匹配 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>		2025-12-02 09:36:38 -08:00
..
nginx	docs(admin-web): 添加 Nginx 完整安装脚本和文档	2025-12-02 08:33:03 -08:00
public	PC Web App draft 0.1 Okay.	2025-11-26 01:58:34 -08:00
scripts	feat(admin-web): 添加 Docker 管理脚本	2025-12-02 08:24:20 -08:00
src	feat(admin-web): 添加 Docker 一键部署方案	2025-12-02 08:21:41 -08:00
.dockerignore	feat(admin-web): 添加 Docker 一键部署方案	2025-12-02 08:21:41 -08:00
.env.development	PC Web App draft 0.1 Okay.	2025-11-26 01:58:34 -08:00
.env.production	PC Web App draft 0.1 Okay.	2025-11-26 01:58:34 -08:00
.eslintrc.json	PC Web App draft 0.1 Okay.	2025-11-26 01:58:34 -08:00
.gitignore	PC Web App draft 0.1 Okay.	2025-11-26 01:58:34 -08:00
.prettierrc	PC Web App draft 0.1 Okay.	2025-11-26 01:58:34 -08:00
Dockerfile	fix(admin-web): 改用 curl 进行健康检查	2025-12-02 09:07:22 -08:00
README.md	docs(admin-web): 添加项目 README 文档	2025-12-02 09:01:03 -08:00
deploy.sh	feat(admin-web): 添加 Docker 一键部署方案	2025-12-02 08:21:41 -08:00
docker-compose.yml	fix: 修复 docker-compose.yml 中所有服务的健康检查	2025-12-02 09:36:38 -08:00
next.config.ts	feat(admin-web): 添加 Docker 一键部署方案	2025-12-02 08:21:41 -08:00
package-lock.json	fix: 修复登录表单验证错误显示重叠问题	2025-11-26 02:19:58 -08:00
package.json	fix: 修复登录表单验证错误显示重叠问题	2025-11-26 02:19:58 -08:00
tsconfig.json	PC Web App draft 0.1 Okay.	2025-11-26 01:58:34 -08:00

README.md

RWADurian Admin Web

榴莲认种管理后台 - Next.js 15 + TypeScript + SCSS

技术栈

框架: Next.js 15 (App Router)
语言: TypeScript
样式: SCSS Modules
状态管理: Redux Toolkit + Zustand
UI 组件: Recharts (图表)
部署: Docker + Nginx

本地开发

环境要求

Node.js 20+
npm 或 yarn

安装依赖

npm install

启动开发服务器

npm run dev

访问 http://localhost:3000

构建

npm run build
npm start

Docker 部署

快速部署 (推荐)

项目已配置 Docker 一键部署方案，使用 Git 管理代码。

在服务器上部署：

# 1. 克隆项目 (首次)
git clone <repository-url>
cd rwadurian/frontend/admin-web

# 2. 或更新代码 (已有项目)
cd ~/rwadurian/frontend/admin-web
git pull

# 3. 赋予脚本执行权限
chmod +x scripts/*.sh deploy.sh nginx/*.sh

# 4. 一键部署 Docker 应用
./scripts/deploy.sh

# 5. 安装 Nginx + SSL (首次需要)
sudo ./nginx/install.sh

Docker 管理脚本

脚本	功能
`./scripts/deploy.sh`	一键部署 (构建+启动)
`./scripts/build.sh`	仅构建镜像
`./scripts/start.sh`	启动服务
`./scripts/stop.sh`	停止服务
`./scripts/restart.sh`	重启服务
`./scripts/logs.sh`	查看实时日志
`./scripts/status.sh`	查看服务状态
`./scripts/health.sh`	健康检查
`./scripts/clean.sh`	清理容器和镜像

使用原始 deploy.sh

# 启动服务
./deploy.sh start

# 停止服务
./deploy.sh stop

# 重启服务
./deploy.sh restart

# 查看日志
./deploy.sh logs

# 查看状态
./deploy.sh status

# 清理
./deploy.sh clean

自定义端口

PORT=8080 ./scripts/deploy.sh

Nginx 配置

前提条件

域名 DNS A 记录已指向服务器 IP
防火墙开放 80 和 443 端口
Docker 应用已在 3000 端口运行

一键安装 (推荐)

cd nginx
sudo ./install.sh

脚本会自动完成：

系统更新
安装 Nginx
安装 Certbot
配置防火墙
申请 Let's Encrypt SSL 证书
配置 HTTPS 反向代理

手动配置

详见 nginx/README.md

项目结构

admin-web/
├── src/
│   ├── app/                    # Next.js App Router
│   │   ├── (auth)/            # 认证相关页面 (登录、注册)
│   │   ├── (dashboard)/       # 仪表板页面
│   │   └── api/               # API 路由
│   ├── components/            # React 组件
│   │   ├── common/            # 通用组件
│   │   ├── features/          # 功能组件
│   │   └── layout/            # 布局组件
│   ├── store/                 # 状态管理
│   │   ├── redux/             # Redux Toolkit
│   │   └── zustand/           # Zustand stores
│   ├── services/              # API 服务
│   ├── utils/                 # 工具函数
│   └── styles/                # 全局样式
├── public/                    # 静态资源
├── nginx/                     # Nginx 配置
│   ├── README.md             # Nginx 部署文档
│   ├── install.sh            # 一键安装脚本
│   ├── setup-ssl.sh          # SSL 配置脚本
│   └── rwaadmin.szaiai.com.conf  # Nginx 站点配置
├── scripts/                   # Docker 管理脚本
├── Dockerfile                 # Docker 镜像构建
├── docker-compose.yml         # Docker 编排
├── deploy.sh                  # 部署脚本
└── README.md                  # 本文档

环境变量

项目使用不同的环境配置文件：

.env.local - 本地开发
.env.development - 开发环境
.env.production - 生产环境

功能特性

✅ 用户管理
✅ 排行榜
✅ 权限管理
✅ 数据统计
✅ 系统设置
✅ 帮助中心
✅ 侧边栏收起/展开
✅ 响应式布局
✅ 健康检查 API

API 端点

GET /api/health - 健康检查

访问地址

本地开发: http://localhost:3000
生产环境: https://rwaadmin.szaiai.com

常见问题

1. Docker 构建失败

确保本地有 .next 和 node_modules 已添加到 .dockerignore

2. 502 Bad Gateway

检查 Docker 容器是否运行：

docker ps
./scripts/status.sh

3. SSL 证书申请失败

确认域名 DNS 解析正确
确认 80 端口可访问
查看错误日志: sudo tail -f /var/log/letsencrypt/letsencrypt.log

许可证

MIT