# ZCODE 实施计划

## Phase 1 项目骨架

```text
WmailHub/
  console/
  node/
  worker/
  docs/
```

Console、Node、Worker 必须边界清晰，共享协议独立。

## Phase 2 Console

实现 Console Web、Management API、数据库、认证、Node CRUD、Domain CRUD、Mailbox CRUD、Email CRUD。

## Phase 3 Cloudflare OAuth

实现 OAuth start、callback、state、token exchange、Account/Zone discovery、加密 token storage。

## Phase 4 自动 Node 安装

Add Node 后完成：OAuth、Node identity、Node credential、Email Worker、Worker -> Node、Email Routing、Domain、Mailbox、Node heartbeat。正常流程禁止要求用户复制安装命令。

## Phase 5 Node

实现 bootstrap、secure config、Email Worker ingress、Console egress、HMAC signing、heartbeat、有限 retry、graceful shutdown、structured logging。

Node 不实现业务路由。

## Phase 6 Email Pipeline

```text
Cloudflare -> Worker -> Node -> Console -> D1/R2
```

测试 plain text、HTML、MIME、attachment、多收件人、大正文和 malformed mail。

## Phase 7 Webhook

实现 CRUD、secret、signing、delivery、retry、timeout、失败状态和日志。

## Phase 8 TTL

实现 retention configuration、expires_at、Cron cleanup、R2 cleanup 和 orphan cleanup。默认 1 day。

## Phase 9 API / MCP

实现 Console API，并提供 list_mailboxes、list_emails、get_email、create_mailbox、delete_mailbox、list_webhooks 等 MCP 工具。权限必须基于 Console credential。

## Phase 10 安全测试

测试 OAuth CSRF、credential revoke、replay attack、伪造 Node 请求、body 篡改、过期 timestamp、Webhook SSRF、未授权 mailbox、未授权 Cloudflare Account、超大邮件和超大附件。

## Phase 11 验收

必须完成：Cloudflare OAuth -> 自动 Node 安装 -> Domain 配置 -> Mailbox 创建 -> 真实 Email -> Email Worker -> Node -> Console -> Database/Webhook/API/MCP -> TTL 自动删除。

如果正常流程要求用户手工登录服务器执行安装命令，则不符合设计目标。