55 lines
5.4 KiB
Markdown
55 lines
5.4 KiB
Markdown
## Purpose
|
|
|
|
Liefert geprüfte Terminal-Basic-Programme und Exportvorlagen für die vier festgelegten Ziele über Gitea Actions und Releases am bestehenden Origin aus.
|
|
|
|
## ADDED Requirements
|
|
|
|
### Requirement: Vier verbindliche Buildziele
|
|
Gitea Actions am bestehenden Origin SHALL Terminalanwendungen für Windows amd64, macOS arm64, Linux amd64 und Linux arm64 aus derselben Revision auf dem vorhandenen Linux-arm64-Runner bauen und paketieren. Cross-Kompilierung SHALL für fremde Ziele verwendet werden; vier native Buildrunner MUST NOT vorausgesetzt werden. Buildprüfungen und echte Zielausführung SHALL getrennt nachvollziehbar sein. Fehlgeschlagene Builds oder fehlende Artefakte eines Pflichtziels MUST eine Veröffentlichung verhindern. Build, Paketierung und Veröffentlichung SHALL ausschließlich durch den Push eines neuen Release-Tags im exakten Format `vX.Y.Z` ausgelöst werden; X, Y und Z SHALL nichtnegative Dezimalzahlen ohne führende Nullen sein. Der Tag SHALL der Workspace-Version entsprechen. Normale Branch-Commits und Pull Requests MUST NOT Actions-Builds oder Paketartefakte auslösen. Lokale Entwicklungsprüfungen SHALL weiterhin verfügbar sein.
|
|
|
|
#### Scenario: Ein Ziel fehlt
|
|
- **WHEN** drei Zieljobs erfolgreich sind und der vierte fehlt oder fehlschlägt
|
|
- **THEN** wird kein vollständiger Release veröffentlicht und das fehlende Ziel bleibt erkennbar
|
|
|
|
#### Scenario: Normaler Commit oder Pull Request
|
|
- **WHEN** ein Commit auf main oder ein Pull Request gepusht wird
|
|
- **THEN** startet kein Actions-Build und es entstehen keine Paketartefakte
|
|
|
|
#### Scenario: Neuer passender Release-Tag
|
|
- **WHEN** v1.0.0 auf eine Revision mit Workspace-Version 1.0.0 gepusht wird
|
|
- **THEN** laufen nach der Versionsvorprüfung die vier Paketbuilds für diese Revision und der vollständige Upload wird direkt veröffentlicht
|
|
|
|
#### Scenario: Ungültiger oder unpassender Tag
|
|
- **WHEN** ein Tag vom Format vX.Y.Z oder von der Workspace-Version abweicht
|
|
- **THEN** beginnt kein Cargo-/Paketbuild; ein vom groben Tagfilter erfasster ungültiger Tag scheitert bereits in der Vorprüfung
|
|
|
|
### Requirement: Nutzbare Releasearchive
|
|
Windows SHALL als `.7z` ausgeliefert werden; macOS und beide Linux-Architekturen SHALL jeweils als `.tar.gz` ausgeliefert werden. Jedes Archiv SHALL die passenden IDE-/Compiler-Executables `tb`/`tbc` und `tbrt` als native Runtime-/Exportvorlage (Windows jeweils mit `.exe`), benötigte Metadaten, Lizenz und Benutzungshinweise enthalten. Architektur, Version und Betriebssystem SHALL im Dateinamen eindeutig sein; Dateirechte und notwendige Begleitdateien SHALL erhalten bleiben.
|
|
|
|
#### Scenario: Aus Archiv starten
|
|
- **WHEN** ein Zielarchiv in ein sauberes Verzeichnis entpackt wird
|
|
- **THEN** starten IDE und Compiler als native Terminalanwendungen und ein Beispielprojekt kann mit den mitgelieferten Vorlagen exportiert und nativ verwendet werden
|
|
|
|
### Requirement: Lokale Paketprüfung und vorherige Entwicklungstests
|
|
Der Release-Build SHALL Archivinhalt, Format, Zielarchitektur, Version, Revision und SHA-256 vor dem Upload lokal prüfen. Das Setzen des Release-Tags SHALL die Freigabeentscheidung des Benutzers nach dessen Entwicklungstests sein. Der Releasepfad MUST NOT eine erneute Pflichtabnahme, Ziel-/Terminalberichte, manuelle JSON-Nachweise oder einen zusätzlichen Nachweis-Commit verlangen. Vorhandene lokale Testwerkzeuge SHALL unabhängig vom Release verwendbar bleiben.
|
|
|
|
#### Scenario: Falsches Binary im richtigen Archiv
|
|
- **WHEN** ein Windows-amd64-Archiv versehentlich ein Binary eines anderen Ziels enthält
|
|
- **THEN** scheitert die Formatprüfung vor der Veröffentlichung
|
|
|
|
#### Scenario: Tag ohne zusätzliche Nachweise
|
|
- **WHEN** ein gültiger Tag gesetzt wurde und alle vier Builds sowie der vollständige Upload erfolgreich sind, ohne dass zusätzliche Nachweisdateien vorliegen
|
|
- **THEN** veröffentlicht derselbe Workflow den Release automatisch und verlangt keinen manuellen Publish-Schritt
|
|
|
|
### Requirement: Nachvollziehbare Veröffentlichung
|
|
Releaseartefakte SHALL Version/Tag, Commit, Toolchain, Buildhost, Ziel, Integritätsprüfsumme nachvollziehbar machen. Nur der freigegebene Tag-/Releasepfad SHALL Veröffentlichungsrechte verwenden; Normale Commits und PRs SHALL keine Actions-Jobs starten. Der repositorygebundene Gitea-Jobtoken SHALL für Releasezugriffe nutzbar sein; ein getrenntes Secret SHALL optional bleiben. Vier Archive und vier zugehörige SHA-256-Dateien SHALL die Pflichtassets bilden. Ein Entwurf SHALL ausschließlich den laufenden Upload vor Teilveröffentlichung schützen und nach dessen erfolgreicher Kontrolle im selben Job automatisch freigegeben werden. Wiederholte fehlgeschlagene Veröffentlichungen SHALL keinen bestehenden vollständigen Release stillschweigend durch unvollständige Assets ersetzen.
|
|
|
|
#### Scenario: Paket beschädigt oder Upload unvollständig
|
|
- **WHEN** ein Archiv nach dem Bau verändert wird oder ein Pflichtasset nicht hochgeladen werden kann
|
|
- **THEN** verhindert die Integritäts-/Vollständigkeitsprüfung die Freigabe und nennt das betroffene Asset
|
|
|
|
#### Scenario: Uploadkontrolle ohne erneuten Download
|
|
- **WHEN** der Releasejob die lokal auf Integrität geprüften Pakete hochgeladen hat
|
|
- **THEN** prüft er über die Release-API die vollständige Pflichtasset-Liste und die Dateigrößen, ohne Asset-Inhalte erneut herunterzuladen
|
|
- **AND** ergänzt ein wiederholter Release-Aufruf nur fehlende Dateien; vorhandene Assets werden nicht ersetzt und abweichende Größen führen zum Fehler
|