This is a live demo — explore a slice of Specsight's own product spec, generated from its codebase. The full spec is much larger.
This is a live demo — explore a slice of Specsight's own product spec, generated from its codebase. The full spec is much larger.
| Context | Action | Outcome |
|---|---|---|
HP-27 team member on the GitHub Connection page Action connects the organisation to GitHub Outcome connection saved, repositories available for project selection | connects the organisation to GitHub | connection saved, repositories available for project selection |
HP-28 team member creating a new project Action selects a repository and branch to monitor Outcome project created, Specsight begins watching for code changes |
selects a repository and branch to monitor |
project created, Specsight begins watching for code changes |
EC-14 Admin on the GitHub Connection page Action disconnects GitHub from the organisation Outcome connection removed, automatic syncing stops for all projects | disconnects GitHub from the organisation | connection removed, automatic syncing stops for all projects |
EC-15 GitHub connection removed directly on GitHub by the repository owner Action Specsight receives the uninstall event Outcome connection removed, affected projects show a disconnected state | Specsight receives the uninstall event | connection removed, affected projects show a disconnected state |
EC-16 code change merged on a branch not configured for monitoring Action Specsight receives the push event Outcome event acknowledged, no sync started | Specsight receives the push event | event acknowledged, no sync started |
EC-17 code change merged while the initial analysis is still running Action change notification received Outcome change queued, picked up automatically after the analysis completes | change notification received | change queued, picked up automatically after the analysis completes |
ER-12 webhook request from GitHub with an invalid HMAC signature Action Specsight verifies the webhook signature Outcome request rejected, no changes made | Specsight verifies the webhook signature | request rejected, no changes made |
ER-13 webhook request from GitHub for an unrecognised installation Action Specsight looks up the installation Outcome no matching organisation found, event acknowledged silently | Specsight looks up the installation | no matching organisation found, event acknowledged silently |