GitPulse¶
Dokumentácia bola znovu overená proti implementácii dňa 2026-05-07.
Čo systém robí¶
GitPulse automatizuje hodnotenie tímovej spolupráce v GitLab projektoch:
- ingest webhookov v reálnom čase
- výpočet compliance pravidiel (R01-R13)
- rubric-based hodnotenie
- detekcia gaming vzorov
- dashboard s exportmi
flowchart LR
GL["GitLab"] -->|"webhook + API + OAuth"| Caddy["Caddy"]
Caddy --> API["FastAPI API + Dashboard"]
Caddy -->|/docs/| Docs["MkDocs\n(nginx)"]
API --> PG[("PostgreSQL")]
API --> Redis[("Redis")]
Redis --> W["RQ Worker ×4"]
S["rq-scheduler"] --> Redis
W --> PG
W --> GLPrevádzkový obraz¶
| Oblasť | Aktuálny stav |
|---|---|
| Architektúra | FastAPI + PostgreSQL + Redis + RQ + Caddy + MkDocs |
| Endpointy | 200+ route handlerov |
| Monitoring | Prometheus + Grafana + Jaeger (profil monitoring) |
| Autentifikácia | GitLab OAuth, __Host- cookie prefix, UA fingerprint, CSRF (HMAC-SHA256) |
| Dokumentácia | Slovenská + English, /docs/ (MkDocs Material) |
Odporúčaný onboarding¶
- Študent: Začíname
- Učiteľ: Začíname
- Vývojár: Lokálne prostredie
- Operátor: Nasadenie
- Integrácia: GitLab tokeny a Webhooky
Audit a transparentnosť¶
- Kompletný audit skenu systému:
docs/00_system_audit_2026-02-15.md - Detailná API špecifikácia:
docs/04-api-spec.md - Observability baseline:
docs/13_observability.md