# udaykishore-resu/cloudoptix architecture

> Architecture diagram of the GitHub repository udaykishore-resu/cloudoptix, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/udaykishore-resu/cloudoptix
- Repository: https://github.com/udaykishore-resu/cloudoptix

## Overview

CloudOptix is an AWS cloud-economics platform: it discovers cloud resources, attributes spend to architecture and workloads, finds savings, prices proposed changes, and governs execution and validation. Users interact through a Next.js dashboard and onboarding flow; the Go modular monolith exposes the API and runs background workers. Major capabilities include cost ingestion, architecture economics, optimization, IaC simulation, governance, automation, and AI copilot. The README establishes the product workflow; sampled source confirms application assembly, route registration, and storage selection. Some subsystem wiring is unsampled, so those links are omitted or marked unverified.

Main entry points: [`internal/app/app.go`](https://github.com/udaykishore-resu/cloudoptix/blob/main/internal/app/app.go) (Application assembly), [`internal/transport/http/routes.go`](https://github.com/udaykishore-resu/cloudoptix/blob/main/internal/transport/http/routes.go) (HTTP API routes), [`internal/application/discovery`](https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/discovery) (Estate discovery), [`internal/application/economics`](https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/economics) (Architecture economics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_dashboard["Dashboard and onboarding"]
end

subgraph group_runtime["Go application runtime"]
  node_api["HTTP API routes<br/>[routes.go]"]
  node_api_process["API process<br/>[main.go]"]
  node_worker_process["Worker process<br/>[main.go]"]
  node_app["Application assembly<br/>[app.go]"]
  node_services["Application services<br/>[services.go]"]
  node_persistence["Storage adapters<br/>[storage.go]"]
  node_database[("PostgreSQL")]
end

subgraph group_economics["Discovery and economics"]
  node_discovery["Estate discovery"]
  node_cloud["AWS estate"]
  node_costing["Cost ingestion"]
  node_economics_engine["Architecture economics"]
end

subgraph group_decisions["Optimization and governance"]
  node_optimization["Recommendations<br/>[engine.go]"]
  node_compiler["IaC pricing"]
  node_simulation["Change simulation"]
  node_governance["Policy and approvals"]
  node_automation["Execution and validation"]
  node_copilot["AI copilot<br/>[service.go]"]
end

node_engineer(("Cloud engineer"))

node_engineer -->|"uses"| node_dashboard
node_dashboard -.->|"requests data"| node_api
node_api_process -->|"builds"| node_app
node_worker_process -->|"builds"| node_app
node_app -->|"assembles"| node_services
node_app -->|"builds router"| node_api
node_api -->|"routes requests"| node_services
node_app -->|"selects storage"| node_persistence
node_persistence -->|"opens backend"| node_database
node_worker_process -.->|"runs cycles"| node_discovery
node_discovery -.->|"scans estate"| node_cloud
node_costing -.->|"ingests billing"| node_cloud
node_economics_engine -.->|"uses topology"| node_discovery
node_optimization -.->|"attributes spend"| node_economics_engine
node_compiler -.->|"prices changes"| node_simulation
node_governance -.->|"authorizes actions"| node_automation
node_automation -.->|"executes changes"| node_cloud
node_copilot -.->|"answers questions"| node_economics_engine

click node_dashboard "https://github.com/udaykishore-resu/cloudoptix/tree/main/frontend/src/app"
click node_api "https://github.com/udaykishore-resu/cloudoptix/blob/main/internal/transport/http/routes.go"
click node_api_process "https://github.com/udaykishore-resu/cloudoptix/blob/main/cmd/cloudoptix-api/main.go"
click node_worker_process "https://github.com/udaykishore-resu/cloudoptix/blob/main/cmd/cloudoptix-worker/main.go"
click node_app "https://github.com/udaykishore-resu/cloudoptix/blob/main/internal/app/app.go"
click node_services "https://github.com/udaykishore-resu/cloudoptix/blob/main/internal/app/services.go"
click node_persistence "https://github.com/udaykishore-resu/cloudoptix/blob/main/internal/app/storage.go"
click node_database "https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/adapters/postgres"
click node_discovery "https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/discovery"
click node_cloud "https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/adapters/aws/discovery"
click node_costing "https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/costing"
click node_economics_engine "https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/economics"
click node_optimization "https://github.com/udaykishore-resu/cloudoptix/blob/main/internal/application/optimization/engine.go"
click node_compiler "https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/compiler"
click node_simulation "https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/simulation"
click node_governance "https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/governance"
click node_automation "https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/automation"
click node_copilot "https://github.com/udaykishore-resu/cloudoptix/blob/main/internal/application/copilot/service.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard toneBlue
class node_api,node_api_process,node_worker_process,node_app,node_services,node_persistence,node_database toneAmber
class node_discovery,node_cloud,node_costing,node_economics_engine toneMint
class node_optimization,node_compiler,node_simulation,node_governance,node_automation,node_copilot toneRose
class node_engineer toneIndigo
```

## Components

### User experience

- [Dashboard and onboarding](https://github.com/udaykishore-resu/cloudoptix/tree/main/frontend/src/app): `frontend/src/app`

### Go application runtime

- [HTTP API routes](https://github.com/udaykishore-resu/cloudoptix/blob/main/internal/transport/http/routes.go): `internal/transport/http/routes.go`
- [API process](https://github.com/udaykishore-resu/cloudoptix/blob/main/cmd/cloudoptix-api/main.go): `cmd/cloudoptix-api/main.go`
- [Worker process](https://github.com/udaykishore-resu/cloudoptix/blob/main/cmd/cloudoptix-worker/main.go): `cmd/cloudoptix-worker/main.go`
- [Application assembly](https://github.com/udaykishore-resu/cloudoptix/blob/main/internal/app/app.go): `internal/app/app.go`
- [Application services](https://github.com/udaykishore-resu/cloudoptix/blob/main/internal/app/services.go): `internal/app/services.go`
- [Storage adapters](https://github.com/udaykishore-resu/cloudoptix/blob/main/internal/app/storage.go): `internal/app/storage.go`
- [PostgreSQL](https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/adapters/postgres): `internal/adapters/postgres`

### Discovery and economics

- [Estate discovery](https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/discovery): `internal/application/discovery`
- [AWS estate](https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/adapters/aws/discovery): `internal/adapters/aws/discovery`
- [Cost ingestion](https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/costing): `internal/application/costing`
- [Architecture economics](https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/economics): `internal/application/economics`

### Optimization and governance

- [Recommendations](https://github.com/udaykishore-resu/cloudoptix/blob/main/internal/application/optimization/engine.go): `internal/application/optimization/engine.go`
- [IaC pricing](https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/compiler): `internal/application/compiler`
- [Change simulation](https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/simulation): `internal/application/simulation`
- [Policy and approvals](https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/governance): `internal/application/governance`
- [Execution and validation](https://github.com/udaykishore-resu/cloudoptix/tree/main/internal/application/automation): `internal/application/automation`
- [AI copilot](https://github.com/udaykishore-resu/cloudoptix/blob/main/internal/application/copilot/service.go): `internal/application/copilot/service.go`

### Other components

- **Cloud engineer**

## Connections

- Cloud engineer → Dashboard and onboarding: uses (evidence: `README.md`)
- Dashboard and onboarding → HTTP API routes: requests data
- API process → Application assembly: builds (evidence: `cmd/cloudoptix-api/main.go`)
- Worker process → Application assembly: builds (evidence: `cmd/cloudoptix-worker/main.go`)
- Application assembly → Application services: assembles (evidence: `internal/app/app.go`)
- Application assembly → HTTP API routes: builds router (evidence: `internal/app/app.go`)
- HTTP API routes → Application services: routes requests (evidence: `internal/transport/http/routes.go`)
- Application assembly → Storage adapters: selects storage (evidence: `internal/app/storage.go`)
- Storage adapters → PostgreSQL: opens backend (evidence: `internal/app/storage.go`)
- Worker process → Estate discovery: runs cycles
- Estate discovery → AWS estate: scans estate
- Cost ingestion → AWS estate: ingests billing
- Architecture economics → Estate discovery: uses topology
- Recommendations → Architecture economics: attributes spend
- IaC pricing → Change simulation: prices changes
- Policy and approvals → Execution and validation: authorizes actions
- Execution and validation → AWS estate: executes changes
- AI copilot → Architecture economics: answers questions
