From c60905e9e7f992a7f8c79c3812e92a44b2d606f5 Mon Sep 17 00:00:00 2001
From: "Somhairle H. Marisol" <muqiu-han@outlook.com>
Date: Sun, 20 Sep 2026 22:59:00 +0800
Subject: feat(core): 建立 fund-lab 可运行基线
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

[变更性质]
- 本提交冻结当前可构建、可测试的应用基线，不包含 PostgreSQL 持久化。

[新增功能]
- 建立 F# Domain、API、Worker、Web 及测试项目。
- 增加 Bearer 认证、健康检查、账本领域模型和中文空状态页面。

[实现方案]
- 使用环境变量模板注入认证配置，并排除数据、凭证和构建产物。
- 保留 19 个 Domain 测试和 5 个 API 测试作为后续变更基准。

[影响范围]
- 为后续 3a PostgreSQL FOF 创建/读取切片提供可回滚基线。
- 当前仍不接入真实基金数据、真实交易或数据库。
---
 README.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9d1bfbb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+# fund-lab
+
+私人单用户模拟基金平台。当前仓库处于阶段 1 骨架和阶段 2a 纯 F# 账本切片阶段；尚未接入数据库、真实行情或真实下单。
+
+## 本地验证
+
+在仓库根目录运行：
+
+```sh
+dotnet test
+dotnet build FundLab.sln
+```
+
+只运行账本领域测试：
+
+```sh
+dotnet test tests/FundLab.Domain.Tests/FundLab.Domain.Tests.fsproj
+```
+
+构建前端：
+
+```sh
+cd src/FundLab.Web
+npm install
+npm run build
+```
+
+API 使用环境变量 `FUND_LAB_AUTH_TOKEN` 配置 Bearer token；仓库只提供 `.env.example`，不保存真实凭证。`/health` 可匿名访问，业务 API 需要 `Authorization: Bearer <token>`。
+
+运行时数据库、行情缓存、凭证和构建产物不应进入 Git。远端 Git 写入机制和准确 remote URL 尚未确认，因此当前只进行本地开发和验证。
-- 
cgit v1.2.3