2026-06-22 12:02:08 +08:00
|
|
|
|
# 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
|
|
|
|
|
|
```
|
