Files

T

Tirsvad a2bf2d4204 Write and accept the brief use cases for the P1 candidates

Add the use case diagram UCD-001, the user stories US-001 and the brief use
cases UC-001 to UC-004 (Synchronize Repository Metadata, Configure Workflow
Credentials, Onboard a Repository, Diagnose a Failed Workflow). Review and
accept them (RC-019 to RC-024) and the PP-001 row that records them
(RC-025), and update TM-001 and the registry.

Task: MIL-002#1

2026-10-10 13:04:30 +08:00

3.4 KiB

Raw Blame History

Use Case Diagram

Metadata

Key	Value
ID	UCD-001
CrossReference	SA-001, BC-001, US-001, UC-001, UC-002, UC-003, UC-004

Version History

Date	Status	Author	Reviewer	Change	Commit
2026-10-10	Accepted	Jens Tirsvad Nielsen	S01	Initial version	pending

Purpose and Scope

The boundary is the reusable workflow collection of this repository: the Gitea Actions workflows, their credential checks and the guides that go with them. Inside it are the four P1 goals of the Project Plan: keeping the GitHub mirror's description and topics equal to Gitea's, configuring the credentials a workflow needs, bringing a repository onto the shared workflows, and finding the cause of a failed run. Gitea and GitHub are outside the boundary and are shown as external systems. Quality checks and releases (P2) and the software engineer's use cases (P2, P3) are not drawn yet.

Diagram

@startuml
left to right direction
skinparam packageStyle rectangle

actor "DevOps Professional" as DevOps <<Actor>>
actor "Platform Operator" as Operator <<Actor>>
actor "Gitea Instance" as Gitea <<System>>
actor "GitHub" as GitHub <<System>>

rectangle "Reusable Workflow Collection" <<System>> {
  usecase "Synchronize Repository Metadata" as UC1
  usecase "Configure Workflow Credentials" as UC2
  usecase "Onboard a Repository" as UC3
  usecase "Diagnose a Failed Workflow" as UC4
}

DevOps --> UC1
DevOps --> UC2
DevOps --> UC3
DevOps --> UC4
Operator --> UC2
Operator --> UC4
UC1 --> Gitea
UC1 --> GitHub
UC3 ..> UC2 : <<include>>
UC4 ..> UC1 : <<extend>>
@enduml

Actor Table

Actor	Stereotype	Stakeholder ID (SA)	Goals (use cases)
DevOps Professional	`<<Actor>>`	S05	Synchronize Repository Metadata, Configure Workflow Credentials, Onboard a Repository, Diagnose a Failed Workflow
Platform Operator	`<<Actor>>`	S03	Configure Workflow Credentials, Diagnose a Failed Workflow
Gitea Instance	`<<System>>`	-	Synchronize Repository Metadata (source of description and topics)
GitHub	`<<System>>`	S04 (audience of the mirror)	Synchronize Repository Metadata (target)

Use Case Table

Use Case	Actor(s)	Goal
Synchronize Repository Metadata	DevOps Professional	The GitHub mirror shows the Gitea description and topics
Configure Workflow Credentials	DevOps Professional, Platform Operator	Least-privilege tokens that a workflow accepts
Onboard a Repository	DevOps Professional	A repository consumes the shared workflows
Diagnose a Failed Workflow	DevOps Professional, Platform Operator	The cause of a failed run is found and placed in a category

Relationships

Relationship	Justification
Onboard a Repository `<<include>>` Configure Workflow Credentials	Every onboarding needs working credentials; the behaviour is always part of it and is also used on its own when a token is rotated.
Diagnose a Failed Workflow `<<extend>>` Synchronize Repository Metadata	The extension applies only when a run of the synchronization has failed; the synchronization is complete without it.

3.4 KiB Raw Blame History