feat: Vollstaendige Demo-Doku — Safety, Manuals, Reports, API-Doc
Validate / build-test (macos-latest) (push) Failing after 4s
Validate / build-test (windows-latest) (push) Failing after 15s
Validate / build-test (ubuntu-latest) (push) Failing after 15s
Validate / reports (push) Has been skipped
Release / release (push) Successful in 50s

Neue Word-Dokumente (alle aus Markdown via pandoc):

Safety (docs/safety/):
- HARA.docx — Hazard Analysis & Risk Assessment, leitet ASIL-D ab
- Safety-Case.docx — Argumentation pro Safety Goal (GSN-Stil)
- FMEDA.docx — Pro-Komponente Failure Modes + Diagnostic Coverage
- MISRA-Compliance-Statement.docx — formaler MISRA-Nachweis
- Verification-Report.docx — V-Modell rechte Seite Zusammenfassung
- Tool-Qualification-Cppcheck.docx — Tool-Qual (TCL2/ASIL-D)

Manuals (docs/manuals/):
- User-Manual.docx — Fahrerhandbuch-Auszug
- Service-Manual.docx — Werkstatt-Doku mit UDS-DTCs

CI-Erweiterungen:
- Doxyfile + `make docs` — API-Dokumentation aus src/
- tools/generate_test_report.py + `make test-report` — Test-Summary HTML
- validate.yml: Doxygen + Test-Report als CI-Artefakte
- release.yml: alle Word-Docs + Engineering-Artefakte ins Release-Bundle

README:
- Komplette Tour durch alle Artefakte
- Repo-Struktur-Diagramm aktualisiert
This commit is contained in:
Stefan Lohmaier
2026-05-12 00:55:37 -07:00
parent 84fab72f23
commit c54a9c55d2
21 changed files with 1396 additions and 27 deletions
+40 -7
View File
@@ -7,10 +7,7 @@ on:
branches: [main, develop]
jobs:
# Build + Tests laufen auf allen 3 OS, um Portabilitaet zu zeigen.
# Linux ist Pflicht, macOS + Windows sind informell (continue-on-error).
# Hintergrund: act_runner host-mode hat Edge-Cases auf Mac (Cache-Pfad)
# und Windows (busybox-Bash-Konflikt). Linux-Docker-Mode laeuft sauber.
# Build + Tests auf allen 3 OS — Linux verbindlich, Mac/Win continue-on-error
build-test:
strategy:
fail-fast: false
@@ -51,8 +48,7 @@ jobs:
shell: bash
run: make test
# Coverage, Traceability, PlantUML laufen nur auf Linux (lcov-Tooling, Artifact-Upload).
# needs nur auf ubuntu-latest, damit Mac/Win-Failures Reports nicht blockieren.
# Coverage, Traceability, Diagrams, API-Doc, Test-Report — alle auf Linux
reports:
runs-on: ubuntu-latest
needs: build-test
@@ -65,13 +61,17 @@ jobs:
sudo apt-get update
sudo apt-get install -y --no-install-recommends \
build-essential gcc make cppcheck lcov \
python3 python3-pip ca-certificates
python3 python3-pip ca-certificates \
doxygen graphviz
- name: Build + Tests + Coverage
run: |
make test
make coverage
- name: Test-Summary-Report
run: make test-report
- name: Traceability Check
run: python3 tools/traceability.py check
@@ -81,6 +81,15 @@ jobs:
- name: PlantUML Diagramme rendern
run: python3 tools/render_plantuml.py
- name: Doxygen API-Dokumentation
run: make docs
- name: Cppcheck-Report (XML)
run: |
mkdir -p build
cppcheck --enable=all --inconclusive --xml --xml-version=2 \
-I src src 2> build/cppcheck-report.xml || true
- name: Upload Coverage HTML
uses: actions/upload-artifact@v3
if: always()
@@ -88,6 +97,16 @@ jobs:
name: coverage-html
path: build/coverage-html/
- name: Upload Test-Report
uses: actions/upload-artifact@v3
if: always()
with:
name: test-report
path: |
build/test-report.html
build/test-report.md
build/test-output.txt
- name: Upload Traceability Matrix
uses: actions/upload-artifact@v3
if: always()
@@ -101,3 +120,17 @@ jobs:
with:
name: architecture-diagrams
path: docs/diagrams/
- name: Upload Doxygen API-Doc
uses: actions/upload-artifact@v3
if: always()
with:
name: api-doc
path: build/api-doc/html/
- name: Upload Cppcheck-Report
uses: actions/upload-artifact@v3
if: always()
with:
name: cppcheck-report
path: build/cppcheck-report.xml