# vest_client

**Repository Path**: keny1985/vest_client

## Basic Information

- **Project Name**: vest_client
- **Description**: 使用AI构建一个金融交易客户端，使用rust+gpui-kit为技术栈，华为CodeArts为开发工具
- **Primary Language**: Rust
- **License**: Not specified
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-10
- **Last Updated**: 2026-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VestClient

Rust 桌面行情交易客户端。基于 GPUI Kit 0.6.0 构建。

## 工作空间结构

```
crates/
  domain/       纯数据结构与业务规则，不依赖 GUI/网络
  market-data/  行情接入、解析、归一化
  engine/       订单校验、风控、持仓计算
  ui/           GPUI Kit 视图层，只读状态，不含业务计算
  app/          胶水层，启动、配置、依赖注入
poc/
  gpui-table/   GPUI Kit 技术验证 PoC（独立于 workspace）
```

## 依赖方向

依赖只能单向向内流动，禁止反向或横向依赖：

| crate | 允许依赖 | 禁止依赖 |
| --- | --- | --- |
| `domain` | `rust_decimal` | `ui`, `market-data`, `engine`, `app`, `gpui`, `tokio` |
| `market-data` | `domain` | `ui`, `engine`, `app`, `gpui` |
| `engine` | `domain` | `ui`, `market-data`, `app`, `gpui`, `tokio` |
| `ui` | `domain`, `gpui-kit`, `gpui-fps` | `market-data`, `engine`, `app` |
| `app` | 以上全部 | — |

```
app ─▶ ui ─▶ domain
 │      │
 │      └─(gpui-kit)
 ├─▶ engine ─▶ domain
 └─▶ market-data ─▶ domain
```

## 构建与质量门禁

```bash
cargo build --workspace                       # 编译无错误
cargo test --workspace                        # 全部测试通过
cargo clippy --workspace -- -D warnings       # 零警告
```

额外约束（见 `.codeartsdoer/rule/`）：

- `domain` 与 `engine` 禁止 `f64`，金额与价格一律使用 `rust_decimal::Decimal`。
- 禁止用 `unwrap()` / `expect()` / `panic!()` 处理可恢复错误，统一返回 `Result`。
- `gpui-kit` 锁定 `=0.6.0`，只能使用该版本 API，不确定时先查文档，不得猜测。
- 引入新依赖前需申报：用途、许可证、已知 CVE、是否可被现有依赖替代。