docs/ci: move workflow to .forgejo and add architecture diagram

This commit is contained in:
Tiago Yamamoto 2025-12-27 23:02:54 -03:00
parent 0bc1c27ef6
commit c651cbda1d
2 changed files with 25 additions and 1 deletions

View file

@ -41,6 +41,30 @@ backend/
└── docs/ # Swagger documentation
```
### 📊 Diagrama de Fluxo (C4 Simplificado)
```mermaid
graph TD
Client[📱 Clients (Frontend/App)] -->|JSON/HTTP| Router[🚦 Router (Mux)]
subgraph "Core Backend"
Router --> Middleware[🛡️ Middleware (Auth, CORS)]
Middleware --> Handlers[🎮 HTTP Handlers]
Handlers --> UseCases[🧠 Services & UseCases]
UseCases --> Repos[💾 Repositories]
UseCases --> Adapters[🔌 External Adapters]
end
Repos --> DB[(🐘 PostgreSQL)]
Adapters --> Firebase[🔥 Firebase (FCM)]
Adapters --> LavinMQ[📨 LavinMQ]
Adapters --> Storage[☁️ S3/R2 Storage]
Adapters --> Stripe[💳 Stripe]
```
---
## 🚀 Deployment & CI/CD (Forgejo)
@ -48,7 +72,7 @@ backend/
O deployment é automatizado via **Forgejo Actions**.
### Workflow: `Deploy Backend (Dev)`
Arquivo: `.github/workflows/deploy.yaml`
Arquivo: `.forgejo/workflows/deploy.yaml`
Este workflow é disparado automaticamente ao realizar um push para o branch `dev` com alterações na pasta `backend/`.