# Complete Documentation

Welcome to the project documentation. This guide is written for someone who is opening the repository for the first time and wants to understand both how the system works and how to operate it safely.

## Documentation structure

The docs are organized by operational domains so each concern can be read independently.

### Architecture and API

* `architecture-and-api/overview.md`
* `architecture-and-api/api-reference.md`
* `architecture-and-api/data-model-and-validation.md`
* `architecture-and-api/developer-workflow.md`

### Reliability and Bonus Quest

* `reliability-and-bonus-quest/overview.md`
* `reliability-and-bonus-quest/error-handling-contract.md`
* `reliability-and-bonus-quest/resilience-and-recovery.md`
* `reliability-and-bonus-quest/bonus-quest-report.md`

### Scalability, Observability, and Operations

* `scalability-observability-and-operations/overview.md`
* `scalability-observability-and-operations/load-testing.md`
* `scalability-observability-and-operations/monitoring-and-alerting.md`
* `scalability-observability-and-operations/operations-playbook.md`

## Recommended reading order for new contributors

1. Architecture and API overview and API reference
2. Reliability overview and error contract
3. Monitoring guide and operations playbook