# X-Financial

项目结构已按前后端拆开：

- `web/`：前端工程（当前 Vue + Vite 项目）
- `server/`：后端工程目录
- `docs/`：方案和阶段文档
- `UI/`：界面参考稿
- `document/`：业务文档

根目录统一环境变量：

- `.env`
- `.env.example`

这里集中维护：

- 前端启动端口
- 后端启动端口
- PostgreSQL 连接参数
- `DATABASE_URL`
- `REDIS_URL`

从根目录统一启动：

```bash
./start.sh
```

可选模式：

```bash
./start.sh web
./start.sh server
./start.sh all
```

根目录 `start.sh` 是统一编排入口；前端和后端的子启动脚本分别是 `web/web_start.sh` 与 `server/server_start.sh`。

Docker Compose 运行方式见 `docker/README.md`：

- `docker-compose.yml`：只启动主应用容器，适合复用已有数据库、ONLYOFFICE 等外部依赖。
- `docker-compose.full.yml`：启动主应用、PostgreSQL、Qdrant、ONLYOFFICE 的完整本地开发栈。

手动进入前端目录：

```bash
cd web
npm run dev
```
