> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# Tasks Schema

> **Status: Historical compatibility pointer**

Task schema 不在本页复制 fields、enums 或 Target tables，避免与 live code、product semantics、Policy、prompt、UI 和 reporting 再次漂移。

当前 selected Target：

- [Task V3 Product / Domain Contract](/product-design/v3/tasks-feature/task-domain-lifecycle.md) — Target fields/values、ERD、API、AI authority 与 migration boundary。
- [Task V3 Rollout 状态快照](/product-design/v3/tasks-feature/task-v3-rollout-status.md) — source、deployment、TEST、UAT 与 PROD readiness 分栏。

历史审计背景：

- [Task V2 → Task V2+ → Task V3 工程审计与设计建议](/product-design/v2/tasks-feature/task-v2-plus-engineering-audit.md)

Current code 的 executable source of truth：

- `callytics-infrastructure/packages/common/src/db/schema/tasks.ts`
- `callytics-infrastructure/packages/common/src/db/schema/task-progress.ts`
- `callytics-infrastructure/packages/common/src/db/schema/contact-timeline.ts`
- `callytics-infrastructure/packages/common/src/domain/task-orchestrator/index.ts`

本页保留仅为兼容旧 inbound links；下列同名章节是 anchor redirects，不复制旧字段或枚举，也不得当作现行规范。

***

## Legacy inbound-link map

以下 heading 只保留旧 URL fragment；每一项都重定向到 V3 的对应语义，不恢复已漂移的 schema snapshot。

#### 1. Live Schema Overview

旧 `§1` anchor 保留用于兼容链接。V3 Target contract 中的 point-in-time implementation inventory 见 [§9.1 Current：可直接复用的基础](/product-design/v3/tasks-feature/task-domain-lifecycle.md#91-current可直接复用的基础)；引用前仍须核对 live code。

#### 2. `tasks` 表

旧 `§2` anchor 保留用于兼容链接。字段语义见 [§6.1 Task fields](/product-design/v3/tasks-feature/task-domain-lifecycle.md#61-task-fields)，Current / Target database 边界分别见 [§9.1](/product-design/v3/tasks-feature/task-domain-lifecycle.md#91-current可直接复用的基础) 与 [§9.3 `tasks` Target delta](/product-design/v3/tasks-feature/task-domain-lifecycle.md#93-tasks-expand-schema)。

#### 2.1 `typeCategory` 9 values

这个标题只保留旧 `#21-typecategory-9-values` anchor；legacy `typeCategory` 的 Target mapping 见 [§16.1](/product-design/v3/tasks-feature/task-domain-lifecycle.md#161-legacy-typecategory-怎样迁移)。

#### 2.2 `closeResult` 15 values

这个标题只保留旧 `#22-closeresult-15-values` anchor；legacy `closeResult` 的 Target mapping 见 [§16.2](/product-design/v3/tasks-feature/task-domain-lifecycle.md#162-legacy-closeresult-怎样迁移)。

#### 2.3 Integrity / indexes worth knowing

这个标题只保留旧 `§2.3` anchor；Target integrity 与 indexes 见 [§9.5 Index 与 integrity](/product-design/v3/tasks-feature/task-domain-lifecycle.md#95-index-与-integrity)。

#### 3. `task_progress_events` 表

旧 `#3-task_progress_events-表` anchor 保留用于兼容链接。Standalone progress table 的旧描述不再是 Current contract；Activity vocabulary 与 Timeline storage 分别见 [§6.4](/product-design/v3/tasks-feature/task-domain-lifecycle.md#64-activity-fields-与-live-values) 和 [§9.4](/product-design/v3/tasks-feature/task-domain-lifecycle.md#94-timeline--activity)。

#### 4. AI Output Tables

旧 `§4` anchor 保留用于兼容链接。Task 内建议见 [§6.3 AI Suggestion fields](/product-design/v3/tasks-feature/task-domain-lifecycle.md#63-ai-suggestion-fields)；pre-task proposal、Reasoner run 与 SMS cursor 见 [§9.6](/product-design/v3/tasks-feature/task-domain-lifecycle.md#96-pre-task-proposalreasoner-run-与-sms-cursor)。

#### 4.1 `task_suggestions`

旧 `§4.1` anchor 保留用于兼容链接；请使用上面的 V3 contract 与 rollout status。

#### 4.2 `task_playbooks`

旧 `§4.2` anchor 保留用于兼容链接；请使用上面的 V3 contract 与 rollout status。

#### 4.3 `ai_feedback`

旧 `§4.3` anchor 保留用于兼容链接；请使用上面的 V3 contract 与 rollout status。

#### 5. API / Page Caveats

旧 `§5` anchor 保留用于兼容链接。V3 Target Workbench projection 与 API commands 分别见 [§13](/product-design/v3/tasks-feature/task-domain-lifecycle.md#13-workbench--ui-projection-contract) 和 [§10](/product-design/v3/tasks-feature/task-domain-lifecycle.md#10-api-与-domain-commands)。

#### 6. Prompt Output ↔ Schema Check

旧 `§6` anchor 保留用于兼容链接。Target prompt/tool vocabulary 由 [Task Policy Catalog](/product-design/v3/tasks-feature/task-domain-lifecycle.md#8-task-policy-catalog) 驱动；bounded reasoning loop 见 [§12](/product-design/v3/tasks-feature/task-domain-lifecycle.md#12-从-one-shot-inference-到-bounded-reasoning-loop)。

#### 7. Re-verification Commands

旧 `§7` anchor 保留用于兼容链接。Target validation 与 executable source map 见 [§17](/product-design/v3/tasks-feature/task-domain-lifecycle.md#17-validationtesting-与-observability) 和 [§20](/product-design/v3/tasks-feature/task-domain-lifecycle.md#20-implementation-source-map)。

#### 8. Cross-References

旧 `§8` anchor 保留用于兼容链接；当前方向读 [Task V3 Product / Domain Contract](/product-design/v3/tasks-feature/task-domain-lifecycle.md) 和 [Task V3 Rollout 状态快照](/product-design/v3/tasks-feature/task-v3-rollout-status.md)，历史背景再查 [Task V2+ audit](/product-design/v2/tasks-feature/task-v2-plus-engineering-audit.md)。