🚗 Adamondo Engineering Documentation Hub
Welcome to the Adamondo Documentation Hub. This portal provides a cohesive, end-to-end view of our engineering ecosystem—from our universal application code to our automated deployment pipeline.
🏗️ Connecting the Dots: The Adamondo Lifecycle
Our documentation is structured to reflect the journey of our product:
- The Codebase (
/apps&/packages): The source of truth for the car rental experience. - The Engine Room (Infrastructure Architecture): How we provision, secure, and monitor our services via Terraform and Kubernetes.
- The Automated Highway: Our CI/CD and GitOps methodology using GitHub Actions, ArgoCD, and Helm.
🗺️ Navigation: By Role
👩💻 For Application Developers
- Architecture: System Design & Infrastructure
- Backend: API & GraphQL Basics
- Payments: Multi-Provider Integration Architecture
- Timezone Mastery: Handling Egypt-First dates
- Caching: Redis & Performance Strategy
- Shared Logic: Utilizing
@adamondo/utils
🛠️ For DevOps & Infrastructure Engineers
- The Stack Deep-Dive: Infrastructure Architecture
- Secrets Management: Infisical lifecycle & secret injection
- CI/CD Pipeline: Automated build & sync flow
- Database Migrations: Zero-downtime deployment hooks
🧪 For QA & Testing Engineers
- Testing Strategy: Automated Verification
- E2E Suite: Full-stack testing with Selenium
🏛️ Deployment Ecosystem
The Adamondo monorepo relies on two companion repositories to power its live instances:
| Repository | Purpose | Primary Tech |
|---|---|---|
core-applications | The infrastructure "Physics"—provisioning the K8s cluster and core services. | Terraform, Infisical, BunkerWeb |
apps-monorepo-manifests | The deployment "Glue"—defining how apps are staged and autoscaled. | Helm, ArgoCD, HPA |
💻 Portal Commands
- Start locally:
yarn docs:start(from repo root) - Build static docs:
yarn docs:build(from repo root) - Re-generate package docs:
yarn generate:docs
🤝 Contribution
Please keep code and documentation in sync. For major architectural changes, update the relevant .md files in the docs directory.