# auto-platform

**Repository Path**: Skiray/auto-platform

## Basic Information

- **Project Name**: auto-platform
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-12
- **Last Updated**: 2026-11-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Auto Platform — 酒店运营 AI Copilot

面向酒旅行业的酒店运营提效平台。先在内部（开发/运维/运营/产品）验证，核心服务对象是**酒店运营人员**；产品成熟后以私有化部署输出给酒旅企业。

## 当前状态

- **产品一**：v1.0.0 定版（2026-10-13，tag `v1.0.0`）；v2 迭代 V2.1–V2.69 全部交付。
- **产品二（自动化测试平台）**：T1–T14、S1–S6b、A1–A2.3、B1–B5 已交付；**workflow-first 改造已全部交付**（2026-11-03，W0–W8 + W5 真机走查 + P0 补口子：运行列表页 / AI 失败细分重建 / known-issue 管理页；ADR-081~087），旧 pipeline/case/task 模型与 run 级协议已删除。章程见 [docs/04-test-platform.md](docs/04-test-platform.md)。
- **质量基线**：Java 测试约 480 个、Node runner 37 个；15 份 OpenAPI 产物（契约测试导出）；金标分类中文 98%、英/日 97%。
- **唯一开放业务验收项**：S9 运营试用（≥2 周、采纳率 ≥60%），账号与演示数据就绪，待分发启动。
- **最新**：2026-11-03 测试平台 W8（cron 计划 `wf_schedule` + 外部触发 Token `wf_trigger_token` + 无 JWT `/trigger` + `/schedules` 管理页）；切片明细见 [docs/03-process.md](docs/03-process.md)。

## 文档（共享两件套 + 分产品章程，按研发流程组织）

| 文档 | 对应阶段 | 内容 |
|------|----------|------|
| [docs/01-product.md](docs/01-product.md) | 立项 + 需求 | 产品一（点评管理）：愿景、用户、Non-Goals 红线、成功标准、里程碑、用户故事与验收标准 |
| [docs/04-test-platform.md](docs/04-test-platform.md) | 立项 + 需求 | 产品二（自动化测试平台）章程：定位、能力边界、Non-Goals、元脚本模型、里程碑 M1–M3 |
| [docs/02-design.md](docs/02-design.md) | 概要 + 详细设计 | 共享：服务架构与边界、数据模型、API 契约、智能体能力架构、技术栈冻结清单、ADR |
| [docs/03-process.md](docs/03-process.md) | 开发 + 测试 + 发布 | 共享：切片计划与 DoD、AI 协作红线、交付评审（AI 交叉评审制）、变更管理、测试门禁、度量、风险 |

**根目录 [AGENTS.md](AGENTS.md)** 是 AI 辅助开发的执行宪法，所有 AI 会话动工前必读。

## 技术形态一句话

微服务（api-gateway + svc-auth / svc-model / svc-kb / svc-review / svc-bi / svc-mcp，ADR-008；测试域 svc-test / svc-test-run / svc-test-runner，ADR-031~035）+ Spring AI + 单 PostgreSQL 实例按服务分库（8 库，pgvector 仅 kb_db）+ Ollama 本地模型（4b 主模型、9b 翻译、embedding 0.6b；API 可选开关），前端 Vue3 + Element Plus + vue-i18n + vue-flow 由网关静态托管，docker compose 一键起（12 容器），单仓库 monorepo。

## 反跑偏机制（本项目最高优先级原则）

1. **文档即契约**：代码实现以 docs/ 三件套为准，文档未写的能力不写代码。
2. **技术栈冻结**：依赖只能在 02-design 允许清单内，新增需走变更流程并记 ADR。
3. **切片推进**：每个切片先有 DoD 再动工，交付前过 AI 交叉评审，每周五 AI 周报自查章程漂移（单人+AI 协作形态，ADR-044）。
4. **测试先行**：验收测试先于实现，AI 改代码不得跳过或删除测试。
5. **门禁由钩子执行**：`bash scripts/install-hooks.sh` 一次安装（`core.hooksPath=scripts/hooks`），此后 `git push` 前自动跑 `scripts/ci-quick.sh`；应急跳过 `git push --no-verify`。
6. **新想法进 backlog，不进代码**：范围外需求记录到 01-product 的 Backlog 节。
7. **机制取舍尺度**：防跑偏类机制保留；性能/规模类机制推后；流程只到切片级、不到 PR 级。