hailin
/
rwadurian
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
rwadurian/frontend/admin-web
History
hailin a609600cd8 feat(fiat-withdrawal): add complete fiat withdrawal system 
实现完整的法币提现功能，支持银行卡、支付宝、微信三种收款方式。
此功能与现有的区块链划转功能完全独立，互不影响。

## 后端 (wallet-service)

### 数据库
- 新增 `fiat_withdrawal_orders` 表存储法币提现订单
- 与现有 `withdrawal_orders` 表(区块链划转)完全分离
- 添加完整索引支持高效查询

### 领域层
- 新增 `FiatWithdrawalStatus` 枚举（与 WithdrawalStatus 独立）
  - 流程: PENDING -> FROZEN -> REVIEWING -> APPROVED -> PAYING -> COMPLETED
  - 或 REJECTED / FAILED / CANCELLED
- 新增 `PaymentMethod` 枚举: BANK_CARD / ALIPAY / WECHAT
- 新增 `FiatWithdrawalOrder` 聚合根
- 新增 `IFiatWithdrawalOrderRepository` 仓储接口
- 新增 `FIAT_WITHDRAWAL` 账本流水类型

### 应用层
- 新增 `FiatWithdrawalApplicationService` 处理业务逻辑
  - 发送短信验证码
  - 申请法币提现（冻结余额）
  - 提交审核
  - 审核通过/驳回
  - 开始打款
  - 完成打款

### API层
- 新增 `FiatWithdrawalController` 提供用户端API
  - POST /wallet/fiat-withdrawal/send-sms - 发送验证码
  - POST /wallet/fiat-withdrawal - 申请提现
  - GET /wallet/fiat-withdrawal - 获取提现记录
- 新增内部API供管理端调用
  - GET /api/v1/wallets/fiat-withdrawals - 查询订单
  - POST /api/v1/wallets/fiat-withdrawals/:orderNo/review - 审核
  - POST /api/v1/wallets/fiat-withdrawals/:orderNo/start-payment - 开始打款
  - POST /api/v1/wallets/fiat-withdrawals/:orderNo/complete-payment - 完成打款

## 前端 (admin-web)

- 新增法币提现审核管理页面 `/withdrawals`
- 支持按状态分 Tab 查看订单
- 支持审核通过/驳回
- 支持打款操作
- 支持查看订单详情

## 前端 (mobile-app)

- 新增 `WithdrawFiatPage` 法币提现页面
  - 支持选择银行卡/支付宝/微信
  - 输入收款账户信息
- 新增 `WithdrawFiatConfirmPage` 确认页面
  - 短信验证码验证
  - 密码验证
- 在 `WalletService` 中添加法币提现相关方法和模型

## 重要说明

此功能与现有的区块链划转功能 (withdraw_usdt_page.dart) 完全独立：
- 独立的数据库表
- 独立的聚合根
- 独立的状态枚举
- 独立的API端点
- 独立的前端页面

原有的区块链划转功能保持不变，不受任何影响。

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 		2026-01-03 06:39:11 -08:00
..
nginx refactor(mpc-system): migrate to party-driven architecture with PartyID-based routing 2025-12-05 08:11:28 -08:00
public feat(admin-web): 添加 TSS WASM 集成，实现与 Service-Party-App 功能对等 2025-12-29 01:39:43 -08:00
scripts . 2025-12-07 14:56:13 +00:00
src feat(fiat-withdrawal): add complete fiat withdrawal system 2026-01-03 06:39:11 -08:00
.dockerignore refactor(mpc-system): migrate to party-driven architecture with PartyID-based routing 2025-12-05 08:11:28 -08:00
.env.development refactor(mpc-system): migrate to party-driven architecture with PartyID-based routing 2025-12-05 08:11:28 -08:00
.env.production fix(admin-web): 修复生产环境 API 地址为 rwaapi.szaiai.com 2025-12-19 04:23:29 -08:00
.eslintrc.json refactor(mpc-system): migrate to party-driven architecture with PartyID-based routing 2025-12-05 08:11:28 -08:00
.gitignore refactor(mpc-system): migrate to party-driven architecture with PartyID-based routing 2025-12-05 08:11:28 -08:00
.prettierrc refactor(mpc-system): migrate to party-driven architecture with PartyID-based routing 2025-12-05 08:11:28 -08:00
Dockerfile refactor(mpc-system): migrate to party-driven architecture with PartyID-based routing 2025-12-05 08:11:28 -08:00
README.md refactor(mpc-system): migrate to party-driven architecture with PartyID-based routing 2025-12-05 08:11:28 -08:00
deploy.sh fix: convert deploy.sh CRLF to LF and add executable permission 2025-12-07 07:01:13 -08:00
docker-compose.yml chore(docker): 为前端服务添加时区配置 2025-12-23 18:35:45 -08:00
next.config.ts refactor(mpc-system): migrate to party-driven architecture with PartyID-based routing 2025-12-05 08:11:28 -08:00
package-lock.json feat(pending-actions): enhance multi-select creation and add pre-check 2026-01-02 20:23:15 -08:00
package.json feat(pending-actions): enhance multi-select creation and add pre-check 2026-01-02 20:23:15 -08:00
tsconfig.json refactor(mpc-system): migrate to party-driven architecture with PartyID-based routing 2025-12-05 08:11:28 -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 配置

前提条件

  1. 域名 DNS A 记录已指向服务器 IP
  2. 防火墙开放 80 和 443 端口
  3. 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 - 健康检查

访问地址

常见问题

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