# gowthamganesanamibikapthy/cloud-go-live-command-center architecture

> Architecture diagram of the GitHub repository gowthamganesanamibikapthy/cloud-go-live-command-center, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-08-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gowthamganesanamibikapthy/cloud-go-live-command-center
- Repository: https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center

## Overview

#### Purpose and Runtime
This repository is a lightweight Streamlit command-center simulator for managing an insurance-core-system go-live. Its primary entry point is `app.py`, launched with `streamlit run app.py`. Python dependencies are defined in `requirements.txt`.

#### Dashboard Application
`app.py` implements the single-page interactive UI and its operational workflows:
- Seven-phase go-live gate progression from T-30 through closeout.
- Resource call-sheet and active-shift management.
- Incident-command message generation for email and Slack.
- Rollback-trigger simulation and fallback checklist display.

The application is stateful during a Streamlit session and persists selected operational state locally.

#### Session Persistence Boundary
The dashboard saves and restores gates, active shifts, and latest run data through local JSON-backed session storage:
- Default session state is written to `session_state.json` at runtime.
- Named session records are stored in a runtime-created `sessions/` directory.
- Persistence controls are part of the Streamlit workflow in `app.py`.

This is local filesystem persistence rather than a database or remote state service.

#### Incident and Rollback Control Flow
User actions in `app.py` drive the core operational sequence:
1. Operators update phase gates and resource shifts.
2. Incident workflows generate communication templates, mock ticket identifiers, and timing windows.
3. A failed task in the rollback simulator activates an automated fallback checklist.
4. The current operational state can be saved for recovery or later replay.

The UI is therefore both presentation layer and control/orchestration layer; no separate backend service is represented in the tree.

#### Integration and Deployment Assets
The `integrations/` directory contains deployment and observability reference artifacts rather than application modules:
- `integrations/otel-config.yaml` defines OpenTelemetry collector configuration.
- `integrations/datadog-daemonset.yaml` provides Datadog Kubernetes agent deployment material.
- `integrations/helm_values.yaml` supplies Helm deployment values.
- `integrations/teamcity_build.xml` represents TeamCity CI build configuration.
- `integrations/SECURITY_GUIDE_GUIDEWIRE.md` documents Guidewire-oriented security considerations.

These assets indicate intended integration with Kubernetes, Helm, Datadog, OpenTelemetry, TeamCity, and Guidewire environments, while the local dashboard itself remains a standalone Streamlit process.

#### Automation and Operational Interfaces
Repository automation supports release and repository/deployment workflows:
- `.github/workflows/release.yml` defines GitHub Actions release automation.
- `create_and_push_repo.py` supports repository initialization/push operations.
- `deploy_and_pr.py` supports deployment and pull-request automation.
- `tools/mock_webhook_server.py` provides a local mock boundary for webhook-driven integration testing or demonstrations.
- `WEBHOOK_RUNBOOK.md` is the operational reference for webhook handling.

#### Key Architectural Boundaries
The primary boundaries are: Streamlit UI/state in `app.py`; local JSON/session filesystem persistence; optional mocked webhook interaction in `tools/mock_webhook_server.py`; and externally consumed infrastructure templates under `integrations/`. There is no evidence of a production API, database, identity provider, message broker, or real ticketing/Slack integration in the provided repository structure.

Main entry points: [`app.py`](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/app.py) (Streamlit command center), [`integrations/helm_values.yaml`](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/integrations/helm_values.yaml) (Helm values), [`.github/workflows/release.yml`](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/.github/workflows/release.yml) (Release workflow), [`deploy_and_pr.py`](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/deploy_and_pr.py) (Deploy & PR automation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard Runtime"]
  node_app["Streamlit command center<br/>Python application<br/>[app.py]"]
  node_gates["Go-live gates<br/>workflow state<br/>[app.py]"]
  node_shifts["Call sheets &amp; shifts<br/>resource state<br/>[app.py]"]
  node_incident["Incident command<br/>workflow<br/>[app.py]"]
  node_rollback["Rollback simulator<br/>workflow<br/>[app.py]"]
end

subgraph group_persistence["Local State"]
  node_session_file["Default session state<br/>JSON file"]
  node_named_sessions[("Named session records<br/>JSON directory")]
end

subgraph group_automation["Automation &amp; Operations"]
  node_mock_webhook{{"Mock webhook server<br/>local integration boundary"}}
  node_webhook_runbook["Webhook runbook<br/>operations guide<br/>[WEBHOOK_RUNBOOK.md]"]
  node_release["Release workflow<br/>GitHub Actions<br/>[release.yml]"]
  node_repo_push["Repository push automation<br/>Python script"]
  node_deploy_pr["Deploy &amp; PR automation<br/>Python script<br/>[deploy_and_pr.py]"]
end

subgraph group_integration["Deployment References"]
  node_otel["OpenTelemetry config<br/>collector template<br/>[otel-config.yaml]"]
  node_datadog["Datadog daemonset<br/>Kubernetes template"]
  node_helm["Helm values<br/>deployment template<br/>[helm_values.yaml]"]
  node_teamcity["TeamCity build config<br/>CI template<br/>[teamcity_build.xml]"]
  node_security["Guidewire security guide<br/>security guidance"]
end

node_app -->|"manages"| node_gates
node_app -->|"manages"| node_shifts
node_app -->|"runs"| node_incident
node_app -->|"runs"| node_rollback
node_app -->|"saves and restores"| node_session_file
node_app -->|"saves and restores"| node_named_sessions
node_rollback -->|"activates fallback checklist"| node_app
node_app -.->|"optional mocked interaction"| node_mock_webhook
node_webhook_runbook -.->|"documents handling"| node_mock_webhook
node_release -.->|"supports release delivery"| node_deploy_pr
node_repo_push -.->|"supports repository setup"| node_release
node_deploy_pr -.->|"uses deployment values"| node_helm
node_helm -.->|"deploys alongside"| node_datadog
node_helm -.->|"deploys alongside"| node_otel
node_teamcity -.->|"builds deployment artifact"| node_helm
node_security -.->|"guides target environment"| node_helm

click node_app "https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/app.py"
click node_gates "https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/app.py"
click node_shifts "https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/app.py"
click node_incident "https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/app.py"
click node_rollback "https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/app.py"
click node_mock_webhook "https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/tools/mock_webhook_server.py"
click node_webhook_runbook "https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/WEBHOOK_RUNBOOK.md"
click node_release "https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/.github/workflows/release.yml"
click node_repo_push "https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/create_and_push_repo.py"
click node_deploy_pr "https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/deploy_and_pr.py"
click node_otel "https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/integrations/otel-config.yaml"
click node_datadog "https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/integrations/datadog-daemonset.yaml"
click node_helm "https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/integrations/helm_values.yaml"
click node_teamcity "https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/integrations/teamcity_build.xml"
click node_security "https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/integrations/SECURITY_GUIDE_GUIDEWIRE.md"

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_app,node_gates,node_shifts,node_incident,node_rollback toneBlue
class node_session_file,node_named_sessions toneAmber
class node_mock_webhook,node_webhook_runbook,node_release,node_repo_push,node_deploy_pr toneMint
class node_otel,node_datadog,node_helm,node_teamcity,node_security toneRose
```

## Components

### Dashboard Runtime

- [Streamlit command center](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/app.py): Python application · Single-page UI and operational workflow orchestrator. · `app.py`
- [Go-live gates](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/app.py): workflow state · Seven-phase progression from T-30 through closeout. · `app.py`
- [Call sheets & shifts](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/app.py): resource state · `app.py`
- [Incident command](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/app.py): workflow · Generates communication templates, mock tickets, and timing windows. · `app.py`
- [Rollback simulator](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/app.py): workflow · Failed tasks activate the fallback checklist. · `app.py`

### Local State

- **Default session state**: JSON file
- **Named session records**: JSON directory · Runtime-created saved sessions for recovery or replay.

### Automation & Operations

- [Mock webhook server](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/tools/mock_webhook_server.py): local integration boundary · Optional local webhook endpoint for demonstrations and testing. · `tools/mock_webhook_server.py`
- [Webhook runbook](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/WEBHOOK_RUNBOOK.md): operations guide · `WEBHOOK_RUNBOOK.md`
- [Release workflow](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/.github/workflows/release.yml): GitHub Actions · `.github/workflows/release.yml`
- [Repository push automation](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/create_and_push_repo.py): Python script · `create_and_push_repo.py`
- [Deploy & PR automation](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/deploy_and_pr.py): Python script · `deploy_and_pr.py`

### Deployment References

Externally consumed templates and operational guidance.

- [OpenTelemetry config](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/integrations/otel-config.yaml): collector template · `integrations/otel-config.yaml`
- [Datadog daemonset](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/integrations/datadog-daemonset.yaml): Kubernetes template · `integrations/datadog-daemonset.yaml`
- [Helm values](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/integrations/helm_values.yaml): deployment template · `integrations/helm_values.yaml`
- [TeamCity build config](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/integrations/teamcity_build.xml): CI template · `integrations/teamcity_build.xml`
- [Guidewire security guide](https://github.com/gowthamganesanamibikapthy/cloud-go-live-command-center/blob/main/integrations/SECURITY_GUIDE_GUIDEWIRE.md): security guidance · `integrations/SECURITY_GUIDE_GUIDEWIRE.md`

## Connections

- Streamlit command center → Go-live gates: manages
- Streamlit command center → Call sheets & shifts: manages
- Streamlit command center → Incident command: runs
- Streamlit command center → Rollback simulator: runs
- Streamlit command center → Default session state: saves and restores
- Streamlit command center → Named session records: saves and restores
- Rollback simulator → Streamlit command center: activates fallback checklist
- Streamlit command center → Mock webhook server: optional mocked interaction
- Webhook runbook → Mock webhook server: documents handling
- Release workflow → Deploy & PR automation: supports release delivery
- Repository push automation → Release workflow: supports repository setup
- Deploy & PR automation → Helm values: uses deployment values
- Helm values → Datadog daemonset: deploys alongside
- Helm values → OpenTelemetry config: deploys alongside
- TeamCity build config → Helm values: builds deployment artifact
- Guidewire security guide → Helm values: guides target environment