# jeeks

**Repository Path**: houhaining/jeeks

## Basic Information

- **Project Name**: jeeks
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-28
- **Last Updated**: 2026-06-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Quant — Flutter + Java 单应用

```
Jeek/
├── flutter_app/     # Flutter UI + BackendLauncher + WebSocket
├── java_backend/    # Spring Boot 后台
├── scripts/         # 构建与打包
└── docs/            # 协议与架构文档
```

详细结构、分工与合作说明见 [docs/project-overview.md](docs/project-overview.md)。

## 快速开始

### 1. 构建 Java 后台（需 JDK 21 + Maven）

```powershell
cd java_backend
mvn package -DskipTests
```

产物：`java_backend/target/backend.jar`

### 2. 开发调试（推荐：IDEA 跑 Java）

详见 [docs/development.md](docs/development.md)。

1. IDEA **Debug** 运行 `com.quant.Application`（VM：`-DQUANT_DATA_DIR=../data`）
2. Flutter 手动后台模式（读 `flutter_app/dart_defines/dev.json`，或 Cursor 选「手动 Java 后台」）：

```powershell
.\scripts\dev_flutter.ps1
# 或
cd flutter_app
flutter run -d windows --dart-define-from-file=dart_defines/dev.json
```

### 3. 运行 Flutter（自动拉起 jar）

```powershell
cd flutter_app
flutter pub get
flutter run -d windows
```

### 4. 打包前复制 JAR

```powershell
.\scripts\copy_backend.ps1
```

详细数据流（交易所 MQTT、Java 推送/接收 Flutter）见 [java-flutter-data-flow.md](java-flutter-data-flow.md)。

## 端口

| 服务 | 地址 |
|------|------|
| WebSocket | `ws://127.0.0.1:18888/ws` |
| 健康检查 | `http://127.0.0.1:18889/actuator/health` |

## 启动流程

```
Flutter main()
  → BackendLauncher.ensureStarted()   # java -jar backend.jar
  → 等待 18889 health UP
  → WebSocket.connect()
  → 首页
```

## auth.* WebSocket

| type | 说明 |
|------|------|
| `auth.captcha` | 获取验证码 key + base64 图 |
| `auth.login` | 登录并连接 MQTT（quotemqtt + push） |
| `auth.login.result` | 登录结果 |
| `auth.logout` | 登出并断开 MQTT |
| `auth.session` | 恢复会话状态 |

## 打包 Windows（内嵌 JRE）

```powershell
.\scripts\build_backend.ps1
.\scripts\build_jre.ps1
.\scripts\copy_backend.ps1
cd flutter_app
flutter build windows
# 将 build\windows\x64\runner\Release\ 与 engine\jre、engine\backend.jar 一起分发
```