# cotrip-sdd

**Repository Path**: leansd/cotrip-sdd

## Basic Information

- **Project Name**: cotrip-sdd
- **Description**: 一个新版本的基于编程智能体的 cotrip 后端开发实验，基于 SDD
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cotrip-sdd

当前仓库已重构为“后端服务 + 测试前端”的双项目布局，用于快速端到端联调与验证。

## 目录结构

```text
cotrip-sdd/
  specs/                    # SDD 功能规格、计划、契约（仓库根，与 speckit 默认一致）
  cotrip-core-service/      # Spring Boot 后端
  cotrip-web-playground/    # React + Vite 测试前端
```

## 快速开始

### 一键启动（推荐）

```bash
./dev-up.sh
```

脚本会同时启动后端与前端；首次执行会自动安装前端依赖。按 `Ctrl+C` 可一起停止。

可选参数（适合 CI 或更快冷启动）：

```bash
./dev-up.sh --no-install
```

`--no-install` 会跳过前端依赖安装检查，要求 `cotrip-web-playground/node_modules` 已存在。

### 一键停止（按 pid 文件）

```bash
./dev-down.sh
```

该脚本会读取 `.run/backend.pid` 与 `.run/frontend.pid` 并停止对应进程。

### 1) 启动后端

```bash
cd cotrip-core-service
./mvnw spring-boot:run
```

后端默认地址：`http://localhost:8380`

### 2) 启动前端

```bash
cd cotrip-web-playground
npm install
npm run dev
```

前端默认地址：`http://localhost:5173`  
已配置代理到后端 `http://localhost:8380`（`/health`、`/travel-plans`）。

## 联调路径

- 健康检查：前端按钮调用 `/health`
- 创建行程：前端表单调用 `POST /travel-plans`
- 查询行程：前端按钮调用 `GET /travel-plans?page=1&size=20`
- **管理员跨用户查询**（需后端配置 `cotrip.admin.api-token`）：前端「出行计划 → 管理员查询」调用 `GET /admin/travel-plans`，请求头 `X-Admin-Token`（详见对应规格 `specs/004-admin-travel-plans-query/`）

## 持续集成

仓库根 `.github/workflows/ci.yml` 包含：

- **`test`**：`cotrip-core-service` 下 `./mvnw -B test`
- **`frontend`**：`cotrip-web-playground` 下 `npm ci && npm run build`

详见 `docs/backend/testing-guide.md` 中「前端自动化」分层说明（含可选 Vitest / Playwright）。

## 更多说明

- **文档总索引**：`docs/INDEX.md`
- **功能规格与任务**：`specs/<feature-id>/`（如 `specs/003-list-travel-plans/`）
- 后端说明见 `cotrip-core-service/README.md`；后端约定见 `docs/backend/`
- 规格写法（SDD）见 `docs/specification-guide.md`
- 测试前端约定见 `docs/frontend/testing-playground-guide.md`