v1.1.0: Alpine 轻量级 Docker 开发环境 + 敏感凭证清理

2026-07-27 13:59:18 +08:00
parent feb76081a0
commit ccca0fa62b
51 changed files with 6125 additions and 993 deletions
@@ -0,0 +1,117 @@
+# 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 提交、代码审查、命名规范、高危操作检查清单