# honeyshah624/retail-store-opensible architecture

> Architecture diagram of the GitHub repository honeyshah624/retail-store-opensible, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/honeyshah624/retail-store-opensible
- Repository: https://github.com/honeyshah624/retail-store-opensible

## Overview

OpenSible is an infrastructure and deployment automation control plane. The documented user journey starts with defining an environment, then review/approval, provisioning, configuration and deployment, followed by monitoring and controlled updates or cleanup. Its major capabilities also include reusable playbooks/templates, secrets, cost awareness, and execution history. The graph combines documented product flows with relationships visible in the supplied source index; unsampled implementation details are not treated as inspected.

Main entry points: [`server/services/cloud_provisioning.py`](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/cloud_provisioning.py) (Cloud provisioning), [`server/app.py`](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/app.py) (API application), [`server/services/execution_history.py`](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/execution_history.py) (Execution history), [`server/services/cicd_engine.py`](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/cicd_engine.py) (CI/CD engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Operator console"]
  node_console["Web console<br/>[main.tsx]"]
end

subgraph group_api["API and access"]
  node_api_app["API application<br/>[app.py]"]
  node_auth["Authentication<br/>[middleware.py]"]
  node_source_routes["Source routes<br/>[sources_routes.py]"]
  node_playbook_routes["Playbook routes"]
end

subgraph group_automation["Automation workflows"]
  node_source_sync["Source synchronization"]
  node_git_sources["Git source manager"]
  node_playbook_storage[("Playbook storage")]
  node_playbook_parser["Playbook parser<br/>[parser.py]"]
  node_playbook_generator["Playbook generator<br/>[generator.py]"]
  node_cicd_engine["CI/CD engine<br/>[cicd_engine.py]"]
  node_scheduler["Playbook scheduler"]
  node_templates["Reusable templates"]
end

subgraph group_operations["Infrastructure operations"]
  node_cloud_provisioning["Cloud provisioning"]
  node_cloud_providers["Cloud providers"]
  node_worker_registry["Worker registry<br/>[worker_registry.py]"]
  node_worker["Execution worker<br/>[main.go]"]
  node_vault["Secret management<br/>[vault_service.py]"]
end

subgraph group_state["Operational state"]
  node_cicd_store[("Pipeline state<br/>[cicd_store.py]")]
  node_execution_history["Execution history"]
  node_execution_store[("Execution records")]
  node_index_db[("Execution index<br/>[index_db.py]")]
  node_cost_store[("Cost records<br/>[cost_store.py]")]
end

node_operator(("Operator"))

node_operator -->|"defines workflow"| node_console
node_console -->|"manages operations"| node_api_app
node_api_app -->|"uses access control"| node_auth
node_api_app -->|"registers routes"| node_source_routes
node_source_routes -->|"starts synchronization"| node_source_sync
node_source_sync -->|"uses Git manager"| node_git_sources
node_api_app -->|"registers routes"| node_playbook_routes
node_playbook_routes -->|"uses scheduling"| node_scheduler
node_playbook_storage -->|"parses YAML"| node_playbook_parser
node_playbook_storage -->|"generates playbooks"| node_playbook_generator
node_cicd_engine -->|"updates pipeline state"| node_cicd_store
node_cicd_engine -->|"runs provisioning"| node_cloud_provisioning
node_cicd_engine -->|"tracks execution"| node_execution_history
node_cloud_provisioning -->|"selects provider"| node_cloud_providers
node_cloud_provisioning -->|"uses worker registry"| node_worker_registry
node_cloud_provisioning -->|"records costs"| node_cost_store
node_execution_history -->|"uses execution records"| node_execution_store
node_execution_history -->|"uses execution index"| node_index_db
node_auth -->|"checks worker access"| node_worker_registry
node_operator -->|"requests infrastructure"| node_cloud_provisioning
node_operator -->|"reuses workflows"| node_templates
node_operator -->|"manages secrets"| node_vault
node_operator -->|"reviews runs"| node_execution_history
node_operator -->|"reviews costs"| node_cost_store
node_operator -.->|"observes execution"| node_worker

click node_console "https://github.com/honeyshah624/retail-store-opensible/blob/main/console/src/main.tsx"
click node_api_app "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/app.py"
click node_auth "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/auth/middleware.py"
click node_source_routes "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/api/sources_routes.py"
click node_source_sync "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/source_sync_service.py"
click node_git_sources "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/git_source_manager.py"
click node_playbook_routes "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/api/playbooks_routes.py"
click node_playbook_storage "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/storage/playbook_storage.py"
click node_playbook_parser "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/playbooks/parser.py"
click node_playbook_generator "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/playbooks/generator.py"
click node_cicd_engine "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/cicd_engine.py"
click node_cicd_store "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/storage/cicd_store.py"
click node_cloud_provisioning "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/cloud_provisioning.py"
click node_cloud_providers "https://github.com/honeyshah624/retail-store-opensible/tree/main/server/services/cloud_providers"
click node_execution_history "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/execution_history.py"
click node_execution_store "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/storage/executions_store.py"
click node_index_db "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/storage/index_db.py"
click node_worker_registry "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/worker_registry.py"
click node_worker "https://github.com/honeyshah624/retail-store-opensible/blob/main/worker/cmd/worker/main.go"
click node_vault "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/vault_service.py"
click node_cost_store "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/storage/cost_store.py"
click node_scheduler "https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/playbook_scheduler.py"
click node_templates "https://github.com/honeyshah624/retail-store-opensible/tree/main/server/templates"

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_console toneBlue
class node_api_app,node_auth,node_source_routes,node_playbook_routes toneAmber
class node_source_sync,node_git_sources,node_playbook_storage,node_playbook_parser,node_playbook_generator,node_cicd_engine,node_scheduler,node_templates toneMint
class node_cloud_provisioning,node_cloud_providers,node_worker_registry,node_worker,node_vault toneRose
class node_cicd_store,node_execution_history,node_execution_store,node_index_db,node_cost_store,node_operator toneIndigo
```

## Components

### Operator console

- [Web console](https://github.com/honeyshah624/retail-store-opensible/blob/main/console/src/main.tsx): `console/src/main.tsx`

### API and access

- [API application](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/app.py): `server/app.py`
- [Authentication](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/auth/middleware.py): `server/auth/middleware.py`
- [Source routes](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/api/sources_routes.py): `server/api/sources_routes.py`
- [Playbook routes](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/api/playbooks_routes.py): `server/api/playbooks_routes.py`

### Automation workflows

- [Source synchronization](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/source_sync_service.py): `server/services/source_sync_service.py`
- [Git source manager](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/git_source_manager.py): `server/services/git_source_manager.py`
- [Playbook storage](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/storage/playbook_storage.py): `server/storage/playbook_storage.py`
- [Playbook parser](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/playbooks/parser.py): `server/playbooks/parser.py`
- [Playbook generator](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/playbooks/generator.py): `server/playbooks/generator.py`
- [CI/CD engine](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/cicd_engine.py): `server/services/cicd_engine.py`
- [Playbook scheduler](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/playbook_scheduler.py): `server/services/playbook_scheduler.py`
- [Reusable templates](https://github.com/honeyshah624/retail-store-opensible/tree/main/server/templates): `server/templates`

### Infrastructure operations

- [Cloud provisioning](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/cloud_provisioning.py): `server/services/cloud_provisioning.py`
- [Cloud providers](https://github.com/honeyshah624/retail-store-opensible/tree/main/server/services/cloud_providers): `server/services/cloud_providers`
- [Worker registry](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/worker_registry.py): `server/services/worker_registry.py`
- [Execution worker](https://github.com/honeyshah624/retail-store-opensible/blob/main/worker/cmd/worker/main.go): `worker/cmd/worker/main.go`
- [Secret management](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/vault_service.py): `server/services/vault_service.py`

### Operational state

- [Pipeline state](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/storage/cicd_store.py): `server/storage/cicd_store.py`
- [Execution history](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/services/execution_history.py): `server/services/execution_history.py`
- [Execution records](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/storage/executions_store.py): `server/storage/executions_store.py`
- [Execution index](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/storage/index_db.py): `server/storage/index_db.py`
- [Cost records](https://github.com/honeyshah624/retail-store-opensible/blob/main/server/storage/cost_store.py): `server/storage/cost_store.py`

### Other components

- **Operator**

## Connections

- Operator → Web console: defines workflow
- Web console → API application: manages operations
- API application → Authentication: uses access control (evidence: `server/app.py`)
- API application → Source routes: registers routes (evidence: `server/app.py`)
- Source routes → Source synchronization: starts synchronization (evidence: `server/api/sources_routes.py`)
- Source synchronization → Git source manager: uses Git manager (evidence: `server/services/source_sync_service.py`)
- API application → Playbook routes: registers routes (evidence: `server/app.py`)
- Playbook routes → Playbook scheduler: uses scheduling (evidence: `server/api/playbooks_routes.py`)
- Playbook storage → Playbook parser: parses YAML (evidence: `server/storage/playbook_storage.py`)
- Playbook storage → Playbook generator: generates playbooks (evidence: `server/storage/playbook_storage.py`)
- CI/CD engine → Pipeline state: updates pipeline state (evidence: `server/services/cicd_engine.py`)
- CI/CD engine → Cloud provisioning: runs provisioning (evidence: `server/services/cicd_engine.py`)
- CI/CD engine → Execution history: tracks execution (evidence: `server/services/cicd_engine.py`)
- Cloud provisioning → Cloud providers: selects provider (evidence: `server/services/cloud_provisioning.py`)
- Cloud provisioning → Worker registry: uses worker registry (evidence: `server/services/cloud_provisioning.py`)
- Cloud provisioning → Cost records: records costs (evidence: `server/services/cloud_provisioning.py`)
- Execution history → Execution records: uses execution records (evidence: `server/services/execution_history.py`)
- Execution history → Execution index: uses execution index (evidence: `server/services/execution_history.py`)
- Authentication → Worker registry: checks worker access (evidence: `server/auth/middleware.py`)
- Operator → Cloud provisioning: requests infrastructure
- Operator → Reusable templates: reuses workflows
- Operator → Secret management: manages secrets
- Operator → Execution history: reviews runs
- Operator → Cost records: reviews costs
- Operator → Execution worker: observes execution
