Purpose
To provide a standardized infrastructure diagram template that visually represents environments, components, and interactions across systems.
This ensures every project has a clear, visual map of infra layers (frontend, backend, DB, services, cloud resources, monitoring).
Scope
- Applies to all new and existing projects.
- Used by Developers, DevOps, Architects, and QA.
- Covers staging, production, monitoring, and external integrations.
Diagram Conventions (Legend)
To maintain consistency, use the following symbols and shapes across all diagrams:
| Shape/Icon | Meaning | Example |
| Rectangle | Service/Component | API Gateway, Backend Service |
| Cylinder | Database/Storage | PostgreSQL, Firestore |
| Circle | External Service | Stripe, Auth0 |
| Rounded Rectangle | Client/User Interface | React App, Flutter App |
| Arrows | Data Flow | Request/Response, Event Stream |
| Padlock Icon | Security Layer | TLS/HTTPS, RBAC |
| Cloud Shape | Cloud Provider | AWS, GCP, Azure |
Example – B2B SaaS Project
- Frontend: React web app.
- Backend: Node.js microservices on AWS ECS.
- DB: PostgreSQL on AWS RDS.
- Auth: Auth0 OIDC.
- CI/CD: GitHub Actions → ECS Deploy.
- Monitoring: Datadog + CloudWatch.
Diagram flow:
User → React (CloudFront) → API Gateway → Node Services (ECS) → PostgreSQL (RDS)
↘ Stripe, Auth0, SendGrid
Example – B2C Mobile App
- Frontend: Flutter app (iOS + Android).
- Backend: Firebase Functions.
- DB: Firestore.
- Auth: Firebase Auth.
- Push Notifications: Firebase Cloud Messaging.
- Payment: Razorpay.
Diagram flow:
User → Flutter App → Firebase Functions → Firestore DB
↘ Firebase Auth
↘ Razorpay
↘ Cloud Messaging
Blank Reusable Template
Section 1 – Project Metadata
| Field | Entry |
| Project Name | |
| Infra Owner | |
| Date Last Updated | |
| Environments Covered | Dev / Staging / Production |
Section 2 – Infra Layers
| Layer | Components | Notes |
| Client Interfaces | Web, Mobile | |
| API Gateway / Backend | REST, GraphQL, Functions | |
| Databases / Storage | SQL, NoSQL, Blob | |
| Authentication / Security | IAM, OAuth, JWT | |
| External Integrations | Payments, Analytics | |
| CI/CD | Toolchain | |
| Monitoring / Logging | Datadog, Grafana |
Section 4 – Change Log
| Date | Change Made | Author |