# 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 查询

```bash
# 查询 (默认表格输出)
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 远程执行

```bash
# 执行命令
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 操作

```bash
# 取值
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"
```

## 开发命令

```bash
# ===== 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 提交、代码审查、命名规范、高危操作检查清单