# cursor-valispace

**Repository Path**: DBSDMY/cursor-valispace

## Basic Information

- **Project Name**: cursor-valispace
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-09
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cursor-valispace 仓库说明

本仓库包含两套可独立运行的栈：

1. **既有工程平台（存量）**：代码位于 [`mvt-legacy/`](mvt-legacy/)（由原根目录 `backend/app` 与 `frontend` 迁入）。
2. **全链路集成管控平台（新）**：符合 `spec` 的根目录 [`backend/`](backend/) 与 [`frontend/`](frontend/)，**默认端口 9080（API）与 5174（前端 dev）**，避免占用既有 **8080（既有 API）** 与 **8081（SysON）**。

> 请勿修改仓库根目录 `.env` / `.env.example` 及 Spring `application*.yml`（工作区禁飞规则）。集成平台使用环境变量或 [`backend/env.integration.template`](backend/env.integration.template) 自行复制为本地文件后加载（勿提交密钥）。

## 集成平台：快速启动

在仓库根目录（`d:\VS\cursor-valispace`）执行：

```powershell
$env:PYTHONPATH = "$PWD"
$env:INTEGRATION_CELERY_EAGER = "true"   # 无 Redis 时同步执行任务
.\.venv\Scripts\uvicorn.exe backend.main:app --host 127.0.0.1 --port 9080
```

另开终端启动前端（代理已指向 9080）：

```powershell
cd frontend
npm run dev
```

浏览器访问 `http://127.0.0.1:5174` ，默认登录占位账号 `admin` / `admin`。

### Celery + Redis（可选）

若已安装本机 Redis，可关闭 `INTEGRATION_CELERY_EAGER`，并启动 worker：

```powershell
$env:PYTHONPATH = "$PWD"
.\.venv\Scripts\celery.exe -A backend.tasks.celery_config.celery_app worker -l info
```

## 既有平台（8080）启动

依赖见 [`mvt-legacy/backend/requirements.txt`](mvt-legacy/backend/requirements.txt)。**注意**：若与集成平台共用同一虚拟环境，`pip install -r backend/requirements.txt` 与既有平台依赖可能发生 FastAPI 版本拉扯，**推荐为既有平台与集成平台分别使用虚拟环境**，或按需交替安装 requirements。

从 `mvt-legacy/backend` 目录启动（示例）：

```powershell
cd mvt-legacy\backend
$env:PYTHONPATH = "$PWD\..\.."   # 若需从仓库根解析模块，请按你本地脚本调整
..\..\.venv\Scripts\uvicorn.exe app.main:app --host 127.0.0.1 --port 8080
```

具体以你现有 `start_api_8080.bat` / 文档为准；若脚本仍指向旧路径，请将 `backend\requirements.txt` 改为 `mvt-legacy\backend\requirements.txt`。

## 文档

- 产品 PRD / 技术规范 / 开发计划：见仓库根目录对应 Markdown / PDF。
- 部署细节：[`docs/deploy_guide.md`](docs/deploy_guide.md)
- 全链路用例提纲：[`docs/test_case.md`](docs/test_case.md)
- 环境快照：[`docs/ENV_SNAPSHOT.md`](docs/ENV_SNAPSHOT.md)

## 测试

```powershell
$env:PYTHONPATH = "$PWD"
.\.venv\Scripts\pytest.exe backend\tests -q
cd frontend
npm run test
```