Holarch

入门

主页

项目的起始页:哪些内容需要处理、各生命周期组的进展,以及两列面板,显示您关注的工作、检查和状态,包括后续操作、流程关口、风险、自基线以来的变更以及 AI 项目简报。

使用方法 →

本页内容
  1. 概念
  2. 如何使用
    1. 何时使用及原因
    2. 排列面板
    3. 用键盘移动面板
    4. 用已保存的视图跟踪查询
    5. 用细分统计条目
    6. 撰写项目摘要
    7. 编辑项目描述
    8. 完整示例:为 CubeSat EO-1 演示项目准备评审看板
    9. 提示和良好做法
    10. 常见错误
    11. 关联方式
  3. 主页
    1. 页面标题区
    2. 面板标题
    3. 面板
  4. 早期版本的仪表板
  5. 保存、撤销和角色
  6. 消息
  7. 限制
  8. 相关页面

主页是项目打开时所在的页面。顶部显示需要处理的内容以及各生命周期组的进展。其下方的两列面板显示您关注的工作和状态:后续操作、当前的 SE 流程关口、模型检查发现项、需求质量、验证、风险、里程碑、自上次基线以来的更改、未解决的讨论、已保存的视图、细分图表、备注以及 AI 项目摘要。

每个面板都直接读取模型,因此只要有人更改其显示的条目,它就会立即更新。面板布局保存在项目中:每个成员看到的主页相同,对其所做的每项更改都可以撤销。

概念

  • 标题:项目名称(在顶栏中)和项目描述的第一行,附编辑描述。
  • 需要处理:统计问题的健康卡片:待评审的关联、逾期的 TBD、失败的测试、TPM 超限、高风险、模型检查和保存状态。只显示计数大于零的卡片;如果都为零,则显示一张卡片,内容为没有需要处理的内容。请参阅入门。
  • 生命周期:每个导航栏组一张卡片,显示其主要数字。
  • 导览建议:新项目或几乎为空的项目(少于 25 个条目)会在需要处理上方显示▶ 观看 4 分钟导览。× 会在此浏览器中将其隐藏。
  • 栏:一列面板。主栏约占宽度的三分之二,侧栏占其余部分。在窄窗口中,侧栏会移到主栏下方。
  • 面板:栏中的一个框,带有名称、⋯ 菜单及其内容。面板分为矮(最高约 300 px,超出后滚动)和高(最高约 600 px)。
  • 单一面板:大多数面板显示整个项目的一项内容,在主页上只能出现一次:后续操作、我的工作、SE 流程关口、模型检查、需求质量、验证、风险、里程碑、自基线以来的更改、未解决的讨论、模型内容、项目摘要和最近的工作。已保存的视图、细分、备注、已固定的条目和库可以按需多次添加。
  • 默认面板:新项目会获得适合其阶段的面板。早期(SE 流程各阶段的前半部分,或尚无项目基线):主栏中为后续操作、SE 流程关口和需求质量;侧栏中为最近的工作、里程碑、未解决的讨论和项目摘要。后期:后续操作、验证和自基线以来的更改;最近的工作、风险、里程碑和项目摘要。

如何使用

何时使用及原因

在每次工作开始时和评审之前使用主页。需要处理告诉您哪里出了问题;面板显示您选择关注的内容。

  • 需求工作期间:用SE 流程关口查看阶段检查,用需求质量查看最薄弱的陈述,再加一个需求状态的细分。
  • 在 SRR 或 PDR 等评审之前:用里程碑查看评审日期,用未解决的讨论查看仍未解决的评论,用自基线以来的更改查看自上次评审以来的更改,并用项目摘要开始撰写评审总结。
  • 集成和测试期间:验证、测试用例状态的细分以及模型检查。
  • 用于课程或新团队:SE 流程关口会引导每个人完成所选流程的阶段检查。

排列面板

  1. 点击主栏或侧栏末尾的+ 添加面板。(或选择主页 ▾ → 添加面板…,它会添加到主栏。)

    菜单列出尚未在主页上的面板。

  2. 点击一个面板。

    大多数面板会立即出现在栏的末尾。已保存的视图、已固定的条目和库会先打开一个简短表单;填写后点击添加面板。

  3. 拖动面板的标题,将其移到同一栏或另一栏中的其他位置。

    一条线显示它将落下的位置。松开鼠标时布局即保存。

  4. 要更改面板,请点击其标题上的 ⋯:
    • 配置…打开其表单(只有带设置的面板才有此项)。
    • 重命名…设置其名称。双击名称可就地重命名:Enter 保存,Esc 取消。名称为空时会恢复面板的原有名称。
    • 调高或调矮更改其高度。
    • 上移、下移和移到侧栏(或移到主栏)用于移动它。
    • 导出…下载其内容(只有可导出的面板才有此项)。
    • 从主页移除会立即将其移除。提示消息提供撤销。

用键盘移动面板

  1. 用 Tab 键移到该面板(其周围显示焦点环),或点击其标题。
  2. 按 Alt+↑ 或 Alt+↓ 可在其所在栏中上移或下移。
  3. 按 Alt+→ 将其移到侧栏,或按 Alt+← 将其移到主栏。

    每次移动后,面板保持焦点。

用已保存的视图跟踪查询

  1. 点击+ 添加面板并选择已保存的视图。
  2. 在已保存的查询下,选择在数据库中保存的查询,或保留在此输入的查询并输入查询(数据库搜索),例如 class:Risk。

    输入时,匹配的条目数显示在字段下方。

  3. 将显示为设为计数、序列或表格,设置顺序(最近更改的在前、最新的在前、编号或名称)以及行数(1 到 50)。
  4. 点击添加面板。

    底部的在数据库中打开会在数据库中运行同一查询。导出… → Table (CSV)下载所有匹配的条目。

用细分统计条目

  1. 点击+ 添加面板并选择细分。

    当架构中有状态属性时,新的细分按该属性统计需求,否则按类统计条目。

  2. 选择 ⋯ → 配置…,并选择计数依据:类、标签或属性下的某个枚举属性(以类: 属性的形式列出)。
  3. 点击保存。

    最多 6 个值时,面板绘制一个环形图,中间显示总数;值更多时则绘制水平条形图。指向某个扇区或条形可查看其计数;点击类或标签扇区会打开按其筛选的数据库。

  4. 要在其他地方使用该图表,请选择 ⋯ → 导出… → Chart (SVG)或Chart (PNG)。除非勾选透明背景,否则 PNG 为白色背景。

撰写项目摘要

  1. 在顶栏中选择✦ AI ▾ → 撰写项目摘要,或点击项目摘要面板中的撰写摘要。

    Holarch 会向 AI 发送项目概要、自最新项目基线以来的更改(或过去 30 天内更改的条目)、健康检查中发现的问题(高风险、失败的测试、超限的指标、逾期的 TBD/TBR 条目、待评审的关联、模型检查错误)以及当前的 SE 流程阶段。

  2. 在预览中阅读摘要。它分为三部分:更改、有风险和下一步,并附有指向其提及条目的链接。
  3. 点击保留在主页上将其存入项目摘要面板(一次撤销即可全部撤回),或点击关闭将其丢弃。

    面板显示摘要的撰写时间、所用模型及其依据。重新撰写会在新的预览之后替换它。

编辑项目描述

  1. 点击描述行旁边的编辑描述(没有描述时为添加描述),或选择主页 ▾ → 编辑描述…。
  2. 在富文本编辑器中编辑文本,然后点击保存。

    第一行显示在主页顶部。该描述与项目偏好设置…中的描述相同。

完整示例:为 CubeSat EO-1 演示项目准备评审看板

CubeSat EO-1 演示项目打开时包含后续操作、需求状态和测试用例状态细分、验证、一个已固定的Functional Flow图、以发射日期开头的里程碑、一个Model Walkthrough流程关口、未解决的讨论、最近的工作和项目摘要。为设计评审做准备:

  1. 打开演示项目。主页随即打开。
  2. 点击主栏末尾的+ 添加面板,然后选择已保存的视图。
  3. 输入 class:Risk 作为查询,将显示为设为表格,行设为 10,然后点击添加面板。

    表格列出 RK-1 Reaction Wheel Failure、RK-3 Launch Slip 和其他风险。

  4. 双击新面板的名称,输入Risk Register并按 Enter。
  5. 将该面板拖到验证上方。
  6. 选择✦ AI ▾ → 撰写项目摘要,阅读预览并点击保留在主页上。
  7. 评审之前,在风险表格上选择 ⋯ → 导出… → Table (CSV),将其附加到评审包中。

提示和良好做法

  • 每个面板回答一个问题。需求状态的细分加上草稿需求的已保存视图,比一张拥挤的表格更易读。
  • 按问题为面板命名,例如Unverified requirements。
  • 保持侧栏简短:里程碑、讨论和最近的工作适合放在那里;表格和图表需要主栏。
  • 在每次评审时保存项目基线。这样自基线以来的更改和摘要就会显示自该次评审以来的更改。
  • 在查询中使用属性测试,例如 Requirement:"Status=Draft"。面板的顺序决定排列顺序。

常见错误

  • "没有可按类计数的内容。请用 ⋯ → 配置… 选择要计数的内容。"该细分没有可计数的条目。请选择其他计数依据。
  • "尚无项目基线。请在“基线与版本”上保存一个,以统计其后的更改。"自基线以来的更改需要一个项目范围的基线。在此之前,它会列出最近更改的条目。
  • 拖动时面板不移动。请拖动其标题而不是内容,或使用 Alt+方向键。
  • 摘要已过时。摘要只在请求时撰写一次。较大更改之后,请点击重新撰写。

关联方式

  • 健康状况和后续操作:后续操作使用与需要处理、导航栏徽标以及顶栏的需要处理按钮相同的计数。
  • SE 流程:SE 流程关口显示 SE 流程指南的当前阶段、其未完成的检查以及关口里程碑和评审包。
  • 模型和数据库:已保存的视图和自基线以来的更改筛选器使用数据库的查询语法。
  • 基线和版本:自基线以来的更改像比较一样,将最新项目基线与当前模型进行比较;在“基线与版本”中比较会打开完整的比较。
  • 验证和风险:验证使用与 RVTM 相同的行;风险使用风险登记册和项目风险等级(风险、问题与决策)。
  • 导出:开启包含项目偏好设置时,面板布局会随项目导出一起带走(请参阅导入和导出)。

主页

控件功能
主页 ▾添加面板…、编辑描述…、项目偏好设置…、导出项目…和重置主页…。仅有查看权限时不显示。
继续:…打开您最近打开的条目。在您打开过图、文档或其他条目后显示。
✦ AI ▾ → 撰写项目摘要(在顶栏中)撰写项目摘要(见上文)。

重置主页…会询问 "用适合项目阶段的默认面板替换现有面板?撤销可恢复当前面板。" 重置会替换所有面板。

面板标题

控件功能
姓名面板的名称。双击可就地重命名。拖动标题可移动面板。
⋯配置…、重命名…、调高 / 调矮、上移、下移、移到侧栏 / 移到主栏、导出…和从主页移除。

面板

面板显示内容设置和导出
后续操作最多 6 个最紧急的事项,从失败的测试到第一批需求—
我的工作分配给我的(附截止日期)、待评审(处于评审中的需求)和提及(提及您姓名的未解决评论);打开“我的工作”—
SE 流程关口当前阶段及其阶段和进度、未完成的检查(最多 4 项,高面板 8 项)及链接,以及关口:该阶段的每次评审及其里程碑、评审包和剩余天数;打开 SE 流程—
模型检查错误和警告,然后是主要发现项(5 项,高面板 10 项),错误优先,每项附修复;打开模型检查—
需求质量按质量分数显示需求的条形图:良好(67% 或以上)、一般、差(低于 34%)和未评分,然后是最低分(4 项,高面板 10 项);打开质量—
验证已验证(total 中的 n)、失败和无测试;每项都会打开按其筛选的 RVTM。高面板:无测试列出这些需求—
风险热图:按项目风险等级,以可能性为行(最高的在顶部)、以后果为列,每个单元格显示风险数量和该单元格的级别颜色;没有概率或后果的风险在下方计数;打开风险登记册—
里程碑带有 Milestone 标签且开始日期为今天或之后的 Time 条目(5 项,高面板 12 项),附日期和n 天后;14 天以内的标签会突出显示。已过去的里程碑数量显示在下方—
自基线以来的更改最新的项目基线,然后是已添加、已移除、已更改和关联更改,然后是最近更改的条目(4 项,高面板 8 项);在“基线与版本”中比较配置…:仅匹配的条目(数据库查询)
未解决的讨论未解决的评论(5 项,高面板 12 项),提及您的优先,附条目、作者、日期和解决—
已保存的视图以计数、序列或表格(编号、名称、类)显示的查询;在数据库中打开配置…:已保存的查询、查询(数据库搜索)、显示为、顺序、行;Table (CSV)
细分以环形图(最多 6 个值)或条形图(超过 6 个)显示的条目计数,下方显示 "按 … 计数"配置…:计数依据;Chart (SVG)、Chart (PNG)
项目摘要保留的摘要、其撰写时间和依据;撰写摘要 / 重新撰写—
备注自由格式富文本;编辑,然后保存或取消—
模型内容条目计数:条目、需求、动作、资产和关系,然后是最近的更改:最近更改的条目(6 项,高面板 12 项);打开数据库—
最近的工作打开的标签页和最近编辑的文档(6 项,高面板 12 项)—
已固定的条目以卡片形式显示一个图、文档、演示文稿、图表或其他制品及其图片配置…:种类、条目;Picture (PNG)
库以卡片形式显示某一类的所有制品,带搜索、排序和显示更多配置…:种类

早期版本的仪表板

使用早期小组件仪表板保存的项目在打开时,其小组件会按阅读顺序转换为面板。位于旧网格右侧三分之一的小组件会移到侧栏;高度为 10 行或以上的小组件会成为高面板。小组件自己的标题会成为面板的名称。

小组件面板
备注带有相同文本的备注
饼图、条形图带有相同类、标签或属性的细分
实体表格以表格形式显示的已保存的视图,使用相同的查询、顺序和列,最多 50 行
最近的更改自基线以来的更改
最近的评论未解决的讨论
倒计时时钟里程碑,以时钟的条目或日期开头
日历里程碑(月历位于项目管理中)
流程步骤SE 流程关口,附一行显示检查清单及其进度;这些步骤仍作为条目保留在模型中
需求验证 (RVTM)验证
制品预览已固定的条目
所有现有内容库
项目概要、项目描述、主要页面不转换:需要处理和生命周期显示计数,描述位于标题中,导航栏链接各页面

栏上方的通知说明有多少小组件成为了面板,并列出未转换的小组件名称。保留这些面板会保存转换后的布局;使用默认面板会将其替换为默认面板组。旧布局保留在项目中,直到随项目一起被删除。

保存、撤销和角色

  • 对主页的每项更改(添加、移动、调整大小、重命名、设置、移除、重置、保留摘要)都可通过一次撤销撤回(⌘Z / Ctrl+Z)。
  • 布局是项目的一部分。所有成员看到的主页相同,一个成员所做的更改会同步给其他成员。
  • 查看者和评审者可以看到面板,但看不到主页 ▾、+ 添加面板或 ⋯ 中的编辑命令。

消息

留言含义和解决方法
"所有面板都已在主页上。"每个单一面板都已在主页上,无法再添加其他面板。请先移除一个。
"请选择一个条目。此项目中还没有这种类型的条目。"已固定的条目:选择另一种类型,或先创建一个这种类型的条目。
"无法读取该查询。请对照数据库搜索语法进行检查。"已保存的视图:修正查询。
"此面板的已保存查询已被删除。请用 ⋯ → 配置… 选择另一个。"已保存视图所依据的数据库查询已不存在。
"已固定的条目已不存在。请用 ⋯ → 配置… 选择另一个。"已固定的制品已被删除。
"未使用任何流程指南。请选择一个流程,以在此处查看其阶段检查和关口。"SE 流程关口没有流程。点击打开 SE 流程并选择一个。
"没有即将到来的里程碑。请为 Time 条目加上 Milestone 标签并设置开始日期,或在 SE 流程中添加关口里程碑。"里程碑没有可显示的内容。
"无法显示此面板:…"面板无法绘制。请检查其设置,或将其移除后重新添加。

限制

  • 两栏;面板分为矮面板和高面板。
  • 已保存的视图:最多 50 行;CSV 包含所有匹配的条目。
  • 项目摘要:最多向 AI 发送 150 项更改和 40 个高风险。SysML v2 项目中不提供摘要。
  • 每个项目一个主页,由所有成员共享。