# goodhall-solutions/delegaris architecture

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

- Interactive diagram: https://gitdiagram.com/goodhall-solutions/delegaris
- Repository: https://github.com/goodhall-solutions/delegaris

## Overview

This repository is the distribution and deployment companion for Delegaris; the application source itself is not published here. The documented user workflow is directory sign-in, rule-governed resource access, and starting, stopping, scheduling, or requesting access to AWS resources. The visible repository supports installation, AWS role configuration, and a simulated demo. The feature nodes below reflect README claims, not inspected implementation; edges are limited to relationships documented there.

Main entry points: [`iam/policies`](https://github.com/goodhall-solutions/delegaris/tree/main/iam/policies) (IAM policies), [`iam/hub-role.yaml`](https://github.com/goodhall-solutions/delegaris/blob/main/iam/hub-role.yaml) (Hub role), [`iam/member-account-role.yaml`](https://github.com/goodhall-solutions/delegaris/blob/main/iam/member-account-role.yaml) (Member role), [`demo/docker-compose.yml`](https://github.com/goodhall-solutions/delegaris/blob/main/demo/docker-compose.yml) (Demo Compose)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product["Delegaris product"]
  node_portal["Delegaris portal"]
  node_governance["Rules and approvals"]
  node_resource_ops["Resource operations"]
  node_scheduling["Schedules and groups"]
  node_integrations["Reports and integrations"]
end

subgraph group_aws["AWS access setup"]
  node_hub_role["Hub role<br/>[hub-role.yaml]"]
  node_member_role["Member role"]
  node_iam_policies["IAM policies"]
end

subgraph group_demo["Demo environment"]
  node_demo_compose["Demo Compose<br/>[docker-compose.yml]"]
  node_cluster_compose["Cluster demo"]
  node_demo_seed["Demo seed data<br/>[seed.py]"]
end

subgraph group_deployment["Deployment tools"]
  node_installer["Linux installer<br/>[install.sh]"]
  node_uninstaller["Linux uninstaller<br/>[uninstall.sh]"]
end

node_people(("Directory users"))
node_aws_accounts[("Managed AWS accounts")]
node_simulated_aws["Simulated AWS"]

node_people -->|"sign in"| node_portal
node_portal -->|"enforces rules"| node_governance
node_portal -->|"starts and stops"| node_resource_ops
node_portal -->|"manages schedules"| node_scheduling
node_portal -->|"provides"| node_integrations
node_hub_role -->|"accesses accounts"| node_aws_accounts
node_member_role -->|"grants permissions"| node_aws_accounts
node_iam_policies -->|"defines permissions"| node_member_role
node_iam_policies -->|"defines permissions"| node_hub_role
node_demo_compose -->|"runs demo against"| node_simulated_aws
node_cluster_compose -.->|"runs demo against"| node_simulated_aws
node_installer -->|"installs service"| node_portal
node_uninstaller -->|"removes installation"| node_portal

click node_hub_role "https://github.com/goodhall-solutions/delegaris/blob/main/iam/hub-role.yaml"
click node_member_role "https://github.com/goodhall-solutions/delegaris/blob/main/iam/member-account-role.yaml"
click node_iam_policies "https://github.com/goodhall-solutions/delegaris/tree/main/iam/policies"
click node_demo_compose "https://github.com/goodhall-solutions/delegaris/blob/main/demo/docker-compose.yml"
click node_cluster_compose "https://github.com/goodhall-solutions/delegaris/blob/main/demo/docker-compose.cluster.yml"
click node_demo_seed "https://github.com/goodhall-solutions/delegaris/blob/main/demo/seed.py"
click node_installer "https://github.com/goodhall-solutions/delegaris/blob/main/install.sh"
click node_uninstaller "https://github.com/goodhall-solutions/delegaris/blob/main/uninstall.sh"

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_portal,node_governance,node_resource_ops,node_scheduling,node_integrations,node_people toneBlue
class node_hub_role,node_member_role,node_iam_policies,node_aws_accounts toneAmber
class node_demo_compose,node_cluster_compose,node_demo_seed toneMint
class node_installer,node_uninstaller toneRose
class node_simulated_aws toneIndigo
```

## Components

### Delegaris product

- **Delegaris portal**
- **Rules and approvals**
- **Resource operations**
- **Schedules and groups**
- **Reports and integrations**

### AWS access setup

- [Hub role](https://github.com/goodhall-solutions/delegaris/blob/main/iam/hub-role.yaml): `iam/hub-role.yaml`
- [Member role](https://github.com/goodhall-solutions/delegaris/blob/main/iam/member-account-role.yaml): `iam/member-account-role.yaml`
- [IAM policies](https://github.com/goodhall-solutions/delegaris/tree/main/iam/policies): `iam/policies`

### Demo environment

- [Demo Compose](https://github.com/goodhall-solutions/delegaris/blob/main/demo/docker-compose.yml): `demo/docker-compose.yml`
- [Cluster demo](https://github.com/goodhall-solutions/delegaris/blob/main/demo/docker-compose.cluster.yml): `demo/docker-compose.cluster.yml`
- [Demo seed data](https://github.com/goodhall-solutions/delegaris/blob/main/demo/seed.py): `demo/seed.py`

### Deployment tools

- [Linux installer](https://github.com/goodhall-solutions/delegaris/blob/main/install.sh): `install.sh`
- [Linux uninstaller](https://github.com/goodhall-solutions/delegaris/blob/main/uninstall.sh): `uninstall.sh`

### Other components

- **Directory users**
- **Managed AWS accounts**
- **Simulated AWS**

## Connections

- Directory users → Delegaris portal: sign in (evidence: `README.md`)
- Delegaris portal → Rules and approvals: enforces rules (evidence: `README.md`)
- Delegaris portal → Resource operations: starts and stops (evidence: `README.md`)
- Delegaris portal → Schedules and groups: manages schedules (evidence: `README.md`)
- Delegaris portal → Reports and integrations: provides (evidence: `README.md`)
- Hub role → Managed AWS accounts: accesses accounts (evidence: `README.md`)
- Member role → Managed AWS accounts: grants permissions (evidence: `README.md`)
- IAM policies → Member role: defines permissions (evidence: `README.md`)
- IAM policies → Hub role: defines permissions (evidence: `README.md`)
- Demo Compose → Simulated AWS: runs demo against (evidence: `README.md`)
- Cluster demo → Simulated AWS: runs demo against
- Linux installer → Delegaris portal: installs service (evidence: `README.md`)
- Linux uninstaller → Delegaris portal: removes installation (evidence: `README.md`)
