🚀 fastapi-eks-project — Documentation

Bienvenue ! Cette documentation centralise architecture, décisions techniques (ADRs) et tous les incidents du projet DevOps.

---

📚 Sections principales

🎯 Application & Architecture

👉 Application Overview — Stack, endpoints, design patterns
👉 Architecture — Diagrammes, composants, flux
👉 AWS Setup — Configuration AWS, VPC, IAM
👉 Infrastructure Summary — Terraform, EKS, RDS

---

📋 Architecture Decision Records (ADRs)

Enregistrements formels des décisions techniques prises durant le projet.

• ADR-001 — RDS (dev vs prod)
• ADR-002 — ECR (dev vs prod)
• ADR-003 — Terraform Orchestrator
• ADR-004 — Passlib → Bcrypt Migration
• ADR-005 — GitLab CI Build Pipeline
• ADR-006 — Kubernetes Architecture
• ADR-007 — Incidents & Lessons

---

🔥 Incidents & Lessons Learned

30 incidents documentés avec analyses complètes.

Pour les entretiens ou production : - 👉 Quick Reference ⭐ — 5 incidents critiques (2 min) - 👉 Best Practices — Consolidation par domaine

Organisé par Sprint : - Sprint 0 — Fondations & CI/CD (3 incidents) - Sprint 1 — DevSecOps (4 incidents) - Sprint 2 — Terraform AWS (4 incidents) - Sprint 3 — Kubernetes & EKS (19 incidents)

---

🎯 Utilisation rapide

Mode recherche (le plus rapide) 🔍

• Clique Rechercher en haut à droite
• Tape : NAT Gateway, SECRET_KEY, CVE, Terraform, ELB, etc.

Mode lecture progressive

1. Commencer : Application Overview
2. Approfondir : Architecture + ADRs
3. Apprendre des erreurs : Incidents Quick Ref + Best Practices

Pour les entretiens 💼

• 2 min : Quick Reference
• 5 min : Best Practices
• Message : "J'ai documenté 30 incidents et consolidé les lessons"

---

📊 Contenu de la documentation

Section	Fichiers	Type
Application	application.md, architecture.md, aws-setup.md	General
Infrastructure	infra-eks-summary.md	Summary
ADRs	7 fichiers (001-007)	Technical Decisions
Incidents	30 incidents organisés en 4 sprints	Lessons Learned
Best Practices	Recommandations consolidées	Playbook

---

🔗 Stack du projet

App         : FastAPI + PostgreSQL + Alembic
Cloud       : AWS eu-west-3 (EKS, RDS, ECR)
IaC         : Terraform (persistent/ + ephemeral/)
CI/CD       : GitLab CI/CD (2 pipelines)
Routing     : Envoy Gateway (Gateway API)
Domaine     : devopsyouss.com (Cloudflare)

---

💡 Clés à retenir (top 5)

1. Protected vs Masked en CI/CD — c'est différent ! (INC-001)
2. Pydantic BaseSettings — priorité .env > env vars (INC-002)
3. NAT Gateway obligatoire pour EKS (INC-010)
4. python-jose est mort → migrer vers PyJWT (INC-005)
5. Variables projet écrasent variables YAML en GitLab CI (INC-025)

---

🆘 Besoin d'aide ?

• Erreur spécifique ? → Utilise la recherche 🔍
• Entretien ? → Commence par Quick Reference
• Audit technique ? → Lis les ADRs
• Production bug ? → Best Practices

---

📅 Dernière mise à jour

2026-05-18 — Sprint 3 complet

---

Portfolio DevOps — yk-devops@devopsyouss.com