# fund-lab

私人单用户模拟基金平台。当前仓库处于阶段 1 骨架和阶段 2a 纯 F# 账本切片阶段；已接入基金创建/读取 PostgreSQL 持久化，尚未接入真实行情或真实下单。

## 本地验证

在仓库根目录运行：

```sh
dotnet build "FundLab.sln" --no-restore
dotnet test "FundLab.sln" --no-restore
```

API 持久化测试默认启动临时 Docker PostgreSQL 容器；运行 `dotnet test` 前需要 Docker。也可以用 `FUND_LAB_TEST_DATABASE_URL` 指向已有 PostgreSQL 实例。

只运行账本领域测试：

```sh
dotnet test tests/FundLab.Domain.Tests/FundLab.Domain.Tests.fsproj
```

构建前端：

```sh
cd src/FundLab.Web
PATH=/home/somhairle/projects/fund-lab/.tools/node-v22.23.2/bin:$PATH npm run build
```

仓库自带可复用的 Node.js 22.23.2/npm 10.9.8；系统 PATH 没有 npm 时使用上面的项目本地 PATH，不需要重新安装依赖。最近一次收口验证结果为：Fable/Vite 成功转换 65 个模块并以 exit 0 结束。

API 使用环境变量 `FUND_LAB_AUTH_TOKEN` 配置 Bearer token，使用 `FUND_LAB_DATABASE_URL` 配置 PostgreSQL 连接字符串；仓库只提供 `.env.example`，不保存真实凭证。`/health` 可匿名访问，业务 API 需要 `Authorization: Bearer <token>`。

基金创建接口为 `POST /api/funds`，需要 `Idempotency-Key` 和 decimal 字符串字段；基金读取接口为 `GET /api/funds/{id}`。首次启动会自动创建所需表。

运行时数据库、行情缓存、凭证和构建产物不应进入 Git。当前 `origin` 为 `/home/somhairle/git/fund-lab.git`；基线提交已独立发布并核对，最新 3a 持久化修改在完成最终验证前保持在本地工作树。

3a 收口测试还会启动独立临时 PostgreSQL 和真实 Kestrel 进程，覆盖 HTTP 创建、幂等重放/冲突、认证、畸形 JSON、金额边界、停止重启后的读取，以及首次 SQL 写入后故障的完整事务回滚。