GitPulse
Documentation was re-verified against the implementation on 2026-06-05.
What the system does
GitPulse automates evaluation of teamwork in GitLab projects:
- real-time webhook ingestion
- compliance rule scoring (R01-R13)
- configurable compliance checks
- communication and review indicators
- dashboard with exports
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"]
W --> PG
W --> GLOperational Snapshot
| Area | Current state |
|---|---|
| Architecture | FastAPI + PostgreSQL + Redis + RQ + Caddy + MkDocs |
| Endpoints | 220+ route handlers |
| Monitoring | Prometheus + Grafana + Jaeger (monitoring profile) |
| Authentication | GitLab OAuth, __Host- cookie prefix, UA fingerprint, CSRF (HMAC-SHA256) |
| Documentation | Slovak + English, /docs/ (MkDocs Material) |
Recommended Onboarding Path
- Student: Getting started
- Teacher: Getting started
- Developer: Local environment
- Operator: Deployment
- Integration: GitLab tokens and Webhooks
Audit and Transparency
- Full system scan report:
docs/00_system_audit_2026-02-15.md - Detailed API specification:
docs/04-api-spec.md - Observability baseline:
docs/13_observability.md