workpod/dev-envs/flux/claude/CLAUDE.md

Flux 开发环境

当前在 ws-flux-dev 容器内 工作目录: /workspace (= E:/wk-flux)

项目概述

贷款撮合平台 (Flux)，核心模块：

模块	技术栈	说明
flux-api	Java 17 + Redkale + Maven	后端 API，核心业务
flux-admin	Vue 3 + Arco Design + bun	管理后台
flux-uniapp	UniApp + Vite	H5 前端
flux-mock	Go	三方模拟服务
flux-test	Go	业务链测试 (撞库等)
file-server	Go	文件上传下载
flux-wechat-api	—	微信服务端

代理工具（优先使用）

容器内代理服务由 .bashrc 自动启动，无需手动启动。 所有数据库和远程操作必须通过代理工具执行，禁止直接用 mysql/ssh/redis-cli。

MySQL 查询

# 查询 (默认表格输出)
mysql-proxy cli -c flux_dev -e "SELECT * FROM users LIMIT 10"

# JSON 输出 (便于解析)
mysql-proxy cli -c flux_dev -e "SHOW TABLES" -F json

# 执行 DML (加 -x)
mysql-proxy cli -c flux_dev -e "UPDATE table SET status=1 WHERE id=1" -x

SSH 远程执行

# 执行命令
ssh-proxy exec -n flux_dev -c "docker ps"

# JSON 输出
ssh-proxy exec -n flux_dev -c "docker ps" -F json

# 生产服务器 (byr_pro = prod_baiyarong)
ssh-proxy exec -n byr_pro -c "cd /opt/flux-api && bash bin/restart.sh"

Redis 操作

# 取值
redis-proxy get -c flux_dev -k "session:user:123"

# 通用命令 (最灵活)
redis-proxy run -c flux_dev -C "KEYS" -a "user:*"

# 设置值
redis-proxy set -c flux_dev -k "key" -v "value"

开发命令

# ===== flux-api (Java/Redkale/Maven) =====
cd /workspace/flux-api
mvn clean package                          # 构建
cmd /c bin\restart.bat                     # 重启 (Windows bat，容器内需调整)

# ===== flux-admin (Vue3/bun) =====
cd /workspace/flux-admin
bun install                                # 安装依赖
bun run dev                                # 开发模式

# ===== flux-uniapp (UniApp) =====
cd /workspace/flux-uniapp
npm install
npm run dev:h5                             # H5 模式

# ===== Go 服务 =====
cd /workspace/flux-mock && go run *.go
cd /workspace/flux-test && go run test_quick.go qulaijie -mode=collide
cd /workspace/file-server && go run *.go

连接信息速查

详细配置见：

• 服务器: /root/.dev-env/servers.yaml
• 数据库: /root/.dev-env/databases.yaml
• 规范: /root/.dev-env/norms.md

快速参考:

环境	MySQL	Redis
测试 (flux_dev)	见 databases.yaml（不入库）	见 databases.yaml :6379
生产 (flux_prox)	见 databases.yaml（不入库）	—

项目知识库

Flux 专属文档位于 /root/.dev-env/docs/：

文件	用途
Redkale使用易错点.md	flux-api 必读 — 框架踩坑记录
MySQL慢查询分析.md	SQL 慢查询优化参考

开发规范

唯一事实来源: /root/.dev-env/norms.md 本文件不重复规范内容，避免维护不一致。

执行任务前先读取 norms.md，关键规则：

• Git 提交、代码审查、命名规范、高危操作检查清单