1. 概述

接下来，我们要约定在 web 端和 api 端之间共享请求类型，并使用 Hono RPC 进行通信。

目前 API 侧现在只有一个 GET /health，返回的还是裸 JSON。前端侧也没有真正成型的请求层。继续往下写业务，很快就会碰到三个问题：

• 请求参数靠口头约定
• 成功和失败返回格式各写各的
• 前端拿到接口后，类型还是得自己再补一遍

这类问题一开始不明显，接口一多就会变成维护负担。你会看到同一个错误，在 web、admin、api 三处分别写一遍；同一个字段一旦改名，类型漂移会沿着整条链路扩散。

因此，我们的目标很明确：

• 将 contract 放进共享包，前后端共用同一份类型和 schema
• 统一 success / failure 返回结构
• 前端直接基于 Hono RPC 调用，拿到真实类型推导
• 用首页上的一次 ping 调用验证整条链路是否通顺