118 lines
3.1 KiB
Markdown
118 lines
3.1 KiB
Markdown
# 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 提交、代码审查、命名规范、高危操作检查清单
|