# matteo-luraghi/opa-policy-manager architecture

> Architecture diagram of the GitHub repository matteo-luraghi/opa-policy-manager, 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/matteo-luraghi/opa-policy-manager
- Repository: https://github.com/matteo-luraghi/opa-policy-manager

## Overview

OPA Policy Manager parses extended OpenAPI specifications, generates per-service REGO policies, and updates an OPA bundle. Users manage services through either the CLI or HTTP API; the add workflow runs through use cases, policy parsing, generation, and bundle storage. The README also documents list, delete, bundle retrieval, and policy testing. Several use-case and command implementations were not sampled, so those capabilities are represented at their documented subsystem level; their internal links are omitted where source evidence is unavailable.

Main entry points: [`internal/usecases/add.go`](https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/usecases/add.go) (Add service), [`internal/usecases`](https://github.com/matteo-luraghi/opa-policy-manager/tree/main/internal/usecases) (Other use cases), [`cmd/web/handlers/service.go`](https://github.com/matteo-luraghi/opa-policy-manager/blob/main/cmd/web/handlers/service.go) (Policy handlers), [`cmd/cli/commands`](https://github.com/matteo-luraghi/opa-policy-manager/tree/main/cmd/cli/commands) (CLI commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entrypoints["User interfaces"]
  node_cli["CLI commands"]
  node_web["HTTP server<br/>[main.go]"]
  node_handlers["Policy handlers<br/>[service.go]"]
  node_cli_add["CLI add<br/>[add.go]"]
  node_cli_ops["CLI operations"]
end

subgraph group_management["Service management"]
  node_usecase_add["Add service<br/>[add.go]"]
  node_usecase_ops["Other use cases"]
end

subgraph group_policy["Policy generation"]
  node_openapi_parser["OpenAPI parser<br/>[openapi.go]"]
  node_policy_rules["Policy rule model<br/>[groups.go]"]
  node_service_generator["Service REGO<br/>[service.go]"]
  node_main_generator["Main REGO<br/>[main.go]"]
end

subgraph group_bundles["Bundle storage"]
  node_bundle_model["Bundle model<br/>[bundle.go]"]
  node_minio_storage[("MinIO repository<br/>[minio_repo.go]")]
  node_filesystem_storage[("Filesystem repository<br/>[fs_repo.go]")]
end

node_web -->|"routes requests"| node_handlers
node_cli -->|"registers command"| node_cli_add
node_cli -->|"registers commands"| node_cli_ops
node_cli_add -->|"invokes add"| node_usecase_add
node_handlers -->|"adds service"| node_usecase_add
node_handlers -->|"lists or deletes"| node_usecase_ops
node_cli_ops -.->|"manages services"| node_usecase_ops
node_usecase_add -->|"reads and writes"| node_minio_storage
node_usecase_add -->|"updates bundle"| node_bundle_model
node_usecase_add -->|"parses specification"| node_openapi_parser
node_usecase_add -->|"generates service"| node_service_generator
node_usecase_add -->|"generates entry rules"| node_main_generator
node_openapi_parser -->|"builds policies"| node_policy_rules
node_service_generator -->|"renders policies"| node_policy_rules
node_usecase_ops -.->|"reads bundle state"| node_bundle_model
node_usecase_ops -.->|"retrieves bundle"| node_minio_storage

click node_cli "https://github.com/matteo-luraghi/opa-policy-manager/tree/main/cmd/cli/commands"
click node_web "https://github.com/matteo-luraghi/opa-policy-manager/blob/main/cmd/web/main.go"
click node_handlers "https://github.com/matteo-luraghi/opa-policy-manager/blob/main/cmd/web/handlers/service.go"
click node_cli_add "https://github.com/matteo-luraghi/opa-policy-manager/blob/main/cmd/cli/commands/add.go"
click node_cli_ops "https://github.com/matteo-luraghi/opa-policy-manager/tree/main/cmd/cli/commands"
click node_usecase_add "https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/usecases/add.go"
click node_usecase_ops "https://github.com/matteo-luraghi/opa-policy-manager/tree/main/internal/usecases"
click node_openapi_parser "https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/policy/parser/openapi.go"
click node_policy_rules "https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/policy/groups.go"
click node_service_generator "https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/generator/service.go"
click node_main_generator "https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/generator/main.go"
click node_bundle_model "https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/bundle/bundle.go"
click node_minio_storage "https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/bundle/minio_repo.go"
click node_filesystem_storage "https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/bundle/fs_repo.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_cli,node_web,node_handlers,node_cli_add,node_cli_ops toneBlue
class node_usecase_add,node_usecase_ops toneAmber
class node_openapi_parser,node_policy_rules,node_service_generator,node_main_generator toneMint
class node_bundle_model,node_minio_storage,node_filesystem_storage toneRose
```

## Components

### User interfaces

- [CLI commands](https://github.com/matteo-luraghi/opa-policy-manager/tree/main/cmd/cli/commands): `cmd/cli/commands`
- [HTTP server](https://github.com/matteo-luraghi/opa-policy-manager/blob/main/cmd/web/main.go): `cmd/web/main.go`
- [Policy handlers](https://github.com/matteo-luraghi/opa-policy-manager/blob/main/cmd/web/handlers/service.go): `cmd/web/handlers/service.go`
- [CLI add](https://github.com/matteo-luraghi/opa-policy-manager/blob/main/cmd/cli/commands/add.go): `cmd/cli/commands/add.go`
- [CLI operations](https://github.com/matteo-luraghi/opa-policy-manager/tree/main/cmd/cli/commands): `cmd/cli/commands`

### Service management

- [Add service](https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/usecases/add.go): `internal/usecases/add.go`
- [Other use cases](https://github.com/matteo-luraghi/opa-policy-manager/tree/main/internal/usecases): `internal/usecases`

### Policy generation

- [OpenAPI parser](https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/policy/parser/openapi.go): `internal/policy/parser/openapi.go`
- [Policy rule model](https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/policy/groups.go): `internal/policy/groups.go`
- [Service REGO](https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/generator/service.go): `internal/generator/service.go`
- [Main REGO](https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/generator/main.go): `internal/generator/main.go`

### Bundle storage

- [Bundle model](https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/bundle/bundle.go): `internal/bundle/bundle.go`
- [MinIO repository](https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/bundle/minio_repo.go): `internal/bundle/minio_repo.go`
- [Filesystem repository](https://github.com/matteo-luraghi/opa-policy-manager/blob/main/internal/bundle/fs_repo.go): `internal/bundle/fs_repo.go`

## Connections

- HTTP server → Policy handlers: routes requests (evidence: `cmd/web/main.go`)
- CLI commands → CLI add: registers command
- CLI commands → CLI operations: registers commands
- CLI add → Add service: invokes add (evidence: `cmd/cli/commands/add.go`)
- Policy handlers → Add service: adds service (evidence: `cmd/web/handlers/service.go`)
- Policy handlers → Other use cases: lists or deletes (evidence: `cmd/web/handlers/service.go`)
- CLI operations → Other use cases: manages services (evidence: `README.md`)
- Add service → MinIO repository: reads and writes (evidence: `internal/usecases/add.go`)
- Add service → Bundle model: updates bundle (evidence: `internal/usecases/add.go`)
- Add service → OpenAPI parser: parses specification (evidence: `internal/usecases/add.go`)
- Add service → Service REGO: generates service (evidence: `internal/usecases/add.go`)
- Add service → Main REGO: generates entry rules (evidence: `internal/usecases/add.go`)
- OpenAPI parser → Policy rule model: builds policies (evidence: `internal/policy/parser/openapi.go`)
- Service REGO → Policy rule model: renders policies (evidence: `internal/generator/service.go`)
- Other use cases → Bundle model: reads bundle state (evidence: `README.md`)
- Other use cases → MinIO repository: retrieves bundle (evidence: `README.md`)
