项目

项目始终属于某个客户。它汇集了任务、工单、代码、部署、工时、成本和测量数据。

项目列表

在项目下可按“全部”“活跃”“受阻”“审核”和“已暂停”筛选，并在卡片和表格（项目、客户、状态、进度、任务、部署）之间切换。搜索按名称和客户筛选。

创建项目

“添加项目”（或“+ 新建” › 项目，快捷键 p）需要填写：

• 客户（必填）和名称（至少两个字符），
• 地址——VentionDesk 建议的 slug；德语变元音会被拼写展开（“mueller”，而不是“muller”）。它随后会出现在每个 URL 和任务 runner 的配置中，因此请谨慎选择，
• 类型（Web、App、API、内部、数据）、状态、GitHub 仓库（格式为 owner/name）、分支、线上 URL 和描述。

项目页面的页头

• 部署（仅限所有者）打开“开始部署”，列出项目的部署目标。部署只是被触发；是否成功随后在“部署”标签页中显示。如果某个目标还缺少什么，会直接说明——例如“关联托管”。托管服务商只有在运维 › 来源下连接后才能分配。
• 项目计时器，用于开始为该项目记录工时。
• 创建发票（仅限所有者）和打开仓库。
• 铅笔图标打开“编辑项目”；只有所有者可以使用“删除项目”。
• 更换公司（仅限所有者）将项目分配给另一个客户。工单、笔记、文档和草稿会一并转移。已定稿的发票和已发送的报价单不会转移：这种情况下更换会中止，并列出相关凭证——请将其冲销后重新开具。

下方是关键指标进度、未完成、工单、预算和未开票；单击可切换到对应的标签页。

标签页

概览

动态（最新六条，“更多行”展开其余条目）、后续步骤、预算（“成本与预算”，仅限所有者）、链接（客户、仓库、托管、工单入口、邮件入口）以及项目的想法。

工单入口一行是实测得出的：一旦有工单通过表单、App 或服务器进入该项目——无论是通过公开密钥还是入口密钥——就显示“已连接”及最近一次报告。“已设置”表示：某个途径已开启，但尚未收到任何内容。“设置”（仅限所有者）会跳转到设置 › 工单入口，并展开该项目——密钥、来源和邮箱都在那里。

项目的想法（仅限所有者）——即项目所源自的想法，或在想法页面上分配给该项目的其他想法——以小卡片形式显示，包含标题、状态和一行文字。单击标题会在想法页面打开该想法以供编辑。

任务

项目的看板——参见任务与看板。

工单

该项目的工单；单击可打开工单。入口渠道不在这里设置，而是在设置 › 工单入口下设置。

Git 与 PR

一旦填写了仓库并已连接 GitHub，这里会显示来自 GitHub 的提交、拉取请求、分支和检查运行。“立即同步”会获取尚未到达的内容；除此之外每晚同步一次，新事件会立即到达。提交信息中包含 VentionDesk-Task: <task ID> 这一行的提交会关联到该任务。提交和拉取请求各显示前八行（未合并的 PR 优先）；“更多行”展开其余条目。

部署

表格列出环境、状态、提交、时长、触发方式和时间，数据来自 GitHub、Vercel、Render 和其他托管服务商——显示最近八次运行，“更多行”显示更早的记录。在详情视图中：“在服务商处打开构建日志”和“打开已部署的网站”。

路线图

阶段包含标题、从和至（“添加阶段”）；每个阶段有“标记为完成”“重新打开”和“编辑阶段”。带有 roadmap:write 的代理密钥可创建、修改、排序阶段并将其勾选完成——但不能删除。

工时

“补录工时”、每周小时数、分布以及该项目的所有条目——参见工时记录。

成本（仅限所有者）

经常性成本，包含名称、类型、每月或每年金额以及期限（“添加成本项”）。用“设置预算”设置预算。消耗是计算出来的，而不是手动维护的：记录的工时乘以小时费率。

分析

三个部分：使用情况与性能（来自最近七天监控的错误率和 P95 加载时间；只要没有来源测量访问量和转化率，这两项就保持为空——磁贴上的问号会说明原因）、错误（带有用于分配的“错误来源”一行）以及监控（列表和表单在同一张卡片中）。

• 创建监控： URL、类型（“可用性”或“证书”）和间隔。如果监控连续两次失败，就会创建一个工单；一旦再次可访问，该工单即被解决。
• 错误来自 Sentry、Bugsnag 或 Rollbar，只要在“关联错误来源”下选择了服务商处的项目即可。“创建为任务”将错误转为任务。**“已解决”**首先使用错误来源的访问权限在服务商处将其标记为已解决，然后才在这里标记；所有者和员工都有此按钮。如果服务商处的访问权限是只读的（Sentry 没有 event:write，Bugsnag 没有 Organization Administrator 或 Project Owner 角色，Rollbar 没有带 “write” 权限范围的项目访问令牌），或服务商已不认识该错误，或十秒内没有响应，错误将保持未解决，原因显示在列表下方。带有 errors:read 的代理密钥可读取其项目的错误；带有 errors:write 时可用同样的方式将错误标记为已解决。如果错误之后再次出现，则视为回归。