Browse the documentation
Product
What Hoggar is, who it is for, and the long-term product direction.
Architecture
Modular monolith, technology choices and Architecture Decision Records.
Development
Git workflow, specification flow and engineering principles.
Infrastructure
OVH VPS, Ansible, Docker, Coolify and the self-hosted GitLab.
Deployment
How services reach production today and the target CI/CD pipeline.
Security
Network security layers, secrets policy and future upload security.
AI Agents
How Claude Code and Codex work on Hoggar, and the rules they follow.
API
The future Spring Boot REST API, documented with OpenAPI.
Project state
Operational
- OVH VPS with security baseline
- Docker, Coolify and Traefik
- Self-hosted GitLab
- Coming Soon site on hoggar.app
- Private documentation portal on docs.hoggar.app
Planned
- Spring Boot modular monolith
- PostgreSQL + PostGIS
- Angular PWA (Phase 1)
- GitLab CI/CD, SonarQube, Trivy
Deferred
- Microservices
- Kafka
- Kubernetes
- Native mobile until Phase 2
The authoritative project state lives in PROJECT_CONTEXT.md at the root of the hoggar-docs repository.
Build the simplest architecture that correctly supports today's requirements while keeping a clean path toward tomorrow's scale.