让类型自己说话：我如何组织一个中等规模项目的类型层

src/
├─ types/
│  ├─ api.ts        # 接口出入参，与后端契约一一对应
│  ├─ model.ts      # 领域模型，页面之间共享的那一份
│  └─ ui.ts         # 纯展示态类型（Tab 枚举、表单状态）

export async function fetchPost(slug: string): Promise<Post> {
  const raw = await http.get<ApiPost>(`/posts/${slug}`)
  return toPost(raw)          // ← 唯一的转换点
}

function toPost(raw: ApiPost): Post {
  return {
    id: raw.id,
    title: raw.title,
    tags: raw.tags.map((t) => t.name),
    publishedAt: new Date(raw.published_at),
  }
}