---
id: shared-types
name: 共享类型定义
area: shared
status: done
---

## 概述

跨 app 和 packages 共享的 TypeScript 类型定义，以 packages/types 形式发布。纯类型文件，无运行时代码。

## 任务卡

### ✅ 搭建类型包骨架
- status: done
- complexity: S
- files: packages/types/package.json, packages/types/src/index.ts
- acceptance: packages/types 仅包含 .d.ts 或 type-only TS 文件，被引入时不产生任何运行时代码

### ✅ 通用业务类型
- status: done
- complexity: S
- files: packages/types/src/common.ts, packages/types/src/survey.ts
- acceptance: 定义 ApiResponse<T>、PaginatedResult<T>、Nullable<T> 等通用泛型类型，以及 Marker/Item/Photo 业务类型

### 💭 环境与配置类型
- status: concept
- complexity: S
- files: packages/types/src/env.d.ts
- acceptance: 声明 import.meta.env 类型扩展，各 app 的环境变量在 IDE 中有类型提示