项目

EasyPM 的最高层容器。一个项目对应一个工作流（一个 PM 团队在一个方向上的工作）。

数据模型

interface Project {
  id: string;             // cuid
  workspaceId: string;
  name: string;            // 项目名
  key: string;            // WEB / MOB / INT 简短代号
  description: string | null;
  ragStatus: "GREEN" | "AMBER" | "RED" | "UNKNOWN";
  ownerId: string | null;  // User.id
  startDate: string | null;
  dueDate: string | null;
  archivedAt: string | null;
  createdAt: string;
  updatedAt: string;
}

Endpoints

列出项目

GET /openapi/v1/resource/project/list
X-Client-ID: eacli_xxx
Authorization: eapk_live_xxx

查询参数：

• limit：1-200，默认 50
• cursor：上次响应的 nextCursor

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "cms5brzya0009zp13m0hmf79x",
        "workspaceId": "cms5brzy30003zp1395fqiok2",
        "name": "官网重构",
        "key": "WEB",
        "ragStatus": "GREEN",
        "startDate": "2026-06-01T00:00:00.000Z",
        "dueDate": "2026-09-30T00:00:00.000Z",
        "archivedAt": null,
        "createdAt": "2026-07-29T00:07:08.483Z"
      }
    ],
    "hasMore": false,
    "nextCursor": null,
    "total": 1
  }
}

项目详情

GET /openapi/v1/resource/project/detail?id=:id

创建项目

POST /openapi/v1/resource/project/create

Body：

{
  "name": "新项目",
  "key": "WEB",
  "description": "...",
  "startDate": "2026-09-01T00:00:00.000Z",
  "dueDate": "2026-12-31T00:00:00.000Z"
}

key 必须匹配 ^[A-Z0-9_-]{1,10}$；同工作区内不能重复。

Scope

• 读：projects:read
• 写：projects:write

下一步

• 任务 →
• 风险 →
• 应用管理 →