[English](README.md)

# ai-workflow-v2

这个仓库现在按“独立模块”来组织，而不是把运行时、缓存和多套旧代码混在一起。

## 模块划分

| 模块 | 路径 | 作用 |
| --- | --- | --- |
| Inbox host | `inbox/` | Go 控制面：CLI、HTTP API、运行时存储、Agent 调度 |
| Dashboard | `dashboard/` | 面向 Inbox host 的 React 运维界面 |
| Blog backend | `apps/blog/backend/` | 示例 Express API |
| Blog frontend | `apps/blog/frontend/` | 示例 React 客户端 |
| Blog E2E | `apps/blog/e2e/` | 面向 blog 应用的 Playwright 黑盒测试 |

模块边界说明见 [docs/modules.md](docs/modules.md)。

## 仓库规则

- 每个模块都应该可以独立开发、独立测试。
- 跨模块只通过 HTTP 或 CLI 边界通信，不直接相互引用源码。
- 运行时数据、本地数据库、worktree、缓存和构建产物默认都不进仓库。

## 快速开始

统一从根目录 `Makefile` 进入：

```bash
make help
make build-inbox
make test-inbox
make test-dashboard
make test-blog-backend
make test-blog-frontend
make test-blog-e2e
```

## 各模块独立使用

### Inbox host

```bash
cd inbox
go build ./cmd/inbox
go test ./...
```

更多说明见 [inbox/README.md](inbox/README.md)。

### Dashboard

```bash
cd dashboard
npm ci
npm run dev
npm test
```

更多说明见 [dashboard/README.md](dashboard/README.md)。

### Blog 应用

```bash
cd apps/blog/backend && npm ci && npm test
cd apps/blog/frontend && npm ci && npm test
cd apps/blog/e2e && npm ci && npm test
```

更多说明见 [apps/blog/README.md](apps/blog/README.md)。

## 测试入口

- 快速测试：`make test-all`
- 浏览器 / E2E：`make test-all-e2e`
- 一次性安装全部 JS 依赖：`make deps-all`

## 当前目标

让每个模块边界清晰、职责单一，并且默认就是“方便使用、方便测试”的状态。