zhixing-system/README.md

# Zhixing System

Zhixing System 是一个 Python + React 的量化系统基础工程。后端采用限界上下文优先的 DDD 模块化单体，前端采用 feature 垂直切片结构。

## 目录

```text
.
├── docs/adr/               # 需要长期保留的架构决策
├── zhixing-server/         # FastAPI 后端与量化计算边界
├── zhixing-web/            # React 管理页面
├── .env.example            # 开发环境变量模板
├── dev.sh                  # 统一开发入口
└── docker-compose.dev.yml  # 前后端热更新环境
```

## 快速开始

```bash
cp .env.example .env
./dev.sh dev
```

打开 <http://localhost:5555>。前端通过 `/api/v1/system/status` 调用后端，后端健康检查位于 <http://localhost:8000/healthz>。

常用命令：

```bash
./dev.sh logs
./dev.sh check
./dev.sh test
./dev.sh down
```

后端和前端也可分别通过 `uv` 与 `pnpm` 在本机运行，具体命令见各子项目 README。