hailin
/
rwadurian
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
rwadurian/frontend/admin-web
History
hailin dfdd8ed65a feat(pending-actions): add special deduction feature for admin-created user actions 
实现特殊扣减功能，允许管理员为用户创建扣减待办操作，由用户在移动端确认执行。

## 后端 (wallet-service)

### 领域层
- 新增 `SPECIAL_DEDUCTION` 到 LedgerEntryType 枚举
  用于记录特殊扣减的账本流水类型

### 应用层
- 新增 `executeSpecialDeduction` 方法
  - 验证用户钱包存在性
  - 检查余额是否充足
  - 乐观锁控制并发
  - 扣减余额并记录账本流水
  - 返回操作结果和新余额

### API层
- 新增内部API: POST /api/v1/wallets/special-deduction/execute
  供移动端调用执行特殊扣减操作

## 前端 (admin-web)

### 类型定义
- 新增 `SPECIAL_DEDUCTION` 到 ACTION_CODES
- 新增 `SpecialDeductionParams` 接口定义扣减参数
  - amount: 扣减金额
  - reason: 扣减原因

### 页面
- 更新待办操作管理页面
  - 当选择 SPECIAL_DEDUCTION 时显示扣减金额和原因输入框
  - 验证扣减金额必须大于0
  - 验证扣减原因不能为空

### 样式
- 新增特殊扣减表单区域样式

## 前端 (mobile-app)

### 服务层
- 新增 `executeSpecialDeduction` 方法到 WalletService
- 新增 `SpecialDeductionResult` 结果类
- 新增 `specialDeduction` 到 PendingActionCode 枚举

### 页面
- 新增 `SpecialDeductionPage` 特殊扣减确认页面
  - 显示扣减金额和管理员备注
  - 显示当前余额和扣减后余额
  - 余额不足时禁用确认按钮
  - 温馨提示说明操作性质

- 更新 `PendingActionsPage`
  - 处理 SPECIAL_DEDUCTION 类型的待办操作
  - 从 actionParams 解析 amount 和 reason
  - 导航到特殊扣减确认页面

## 工作流程

1. 管理员在 admin-web 创建 SPECIAL_DEDUCTION 待办操作
   - 选择目标用户
   - 输入扣减金额
   - 输入扣减原因

2. 用户在 mobile-app 待办操作列表看到该操作

3. 用户点击后进入特殊扣减确认页面
   - 查看扣减详情
   - 确认余额充足
   - 点击确认执行扣减

4. 后端执行扣减并记录账本流水

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 		2026-01-03 07:04:46 -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(pending-actions): add special deduction feature for admin-created user actions 2026-01-03 07:04:46 -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