# antonio-emilio/ric-implementation architecture

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

- Interactive diagram: https://gitdiagram.com/antonio-emilio/ric-implementation
- Repository: https://github.com/antonio-emilio/ric-implementation

## Overview

This repository combines RIC deployment tooling with a sample FlexRIC monitoring xApp. The documented deployment workflow gathers and validates RIC, CORE, and gNB settings, generates a deployment script, then executes it; supported targets include ORAN SC, FlexRIC, OAI E2 Agent, and custom RICs. The xApp provides E2-oriented monitoring and analytics, with a separate SQLite persistence module. Deployment links reflect the interactive script excerpt and README; source excerpts do not establish all xApp runtime wiring, so uncertain integrations are left unconnected or marked unverified.

Main entry points: [`old/deploy_ric_interactive.py`](https://github.com/antonio-emilio/ric-implementation/blob/main/old/deploy_ric_interactive.py) (Interactive configuration), [`xapp/test-2/src/smart_monitor_xapp.c`](https://github.com/antonio-emilio/ric-implementation/blob/main/xapp/test-2/src/smart_monitor_xapp.c) (Smart Monitor xApp), [`openran-deployment/scripts/deploy_oran_sc.sh`](https://github.com/antonio-emilio/ric-implementation/blob/main/openran-deployment/scripts/deploy_oran_sc.sh) (ORAN SC RIC), [`openran-deployment/scripts/deploy_flexric_oai.sh`](https://github.com/antonio-emilio/ric-implementation/blob/main/openran-deployment/scripts/deploy_flexric_oai.sh) (FlexRIC / OAI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deploy["Deployment workflow"]
  node_wizard["Interactive configuration"]
  node_config["Deployment settings"]
  node_generator["Script generation"]
  node_runner["Deployment execution"]
end

subgraph group_targets["RIC deployment targets"]
  node_oran["ORAN SC RIC<br/>[deploy_oran_sc.sh]"]
  node_flexric["FlexRIC / OAI"]
  node_custom["Custom RIC"]
  node_infrastructure["CORE / gNB"]
end

subgraph group_monitor["Monitoring xApp"]
  node_smart["Smart Monitor xApp"]
  node_e2nodes["E2 nodes"]
  node_hello["Hello xApp example<br/>[main.cpp]"]
end

subgraph group_internals["Analytics and persistence"]
  node_analytics["Metric analytics<br/>[analytics.c]"]
  node_database[("SQLite persistence<br/>[database.c]")]
  node_utilities["Logging and utilities<br/>[utils.c]"]
end

node_operator(("Operator"))
node_e2ric["FlexRIC RIC"]

node_operator -->|"configures"| node_wizard
node_wizard -->|"collects settings"| node_config
node_wizard -->|"generates scripts"| node_generator
node_wizard -->|"executes deployment"| node_runner
node_generator -.->|"targets ORAN SC"| node_oran
node_generator -.->|"targets FlexRIC"| node_flexric
node_generator -.->|"supports custom"| node_custom
node_runner -.->|"connects CORE / gNB"| node_infrastructure
node_runner -.->|"deploys ORAN SC"| node_oran
node_runner -.->|"deploys FlexRIC"| node_flexric
node_smart -->|"requests recommendations"| node_analytics
node_e2nodes -.->|"sends indications"| node_smart
node_smart -.->|"uses E2 interface"| node_e2ric
node_hello -->|"connects by socket"| node_e2ric

click node_wizard "https://github.com/antonio-emilio/ric-implementation/blob/main/old/deploy_ric_interactive.py"
click node_config "https://github.com/antonio-emilio/ric-implementation/blob/main/old/deploy_ric_interactive.py"
click node_generator "https://github.com/antonio-emilio/ric-implementation/blob/main/old/deploy_ric_interactive.py"
click node_runner "https://github.com/antonio-emilio/ric-implementation/blob/main/old/deploy_ric_interactive.py"
click node_oran "https://github.com/antonio-emilio/ric-implementation/blob/main/openran-deployment/scripts/deploy_oran_sc.sh"
click node_flexric "https://github.com/antonio-emilio/ric-implementation/blob/main/openran-deployment/scripts/deploy_flexric_oai.sh"
click node_custom "https://github.com/antonio-emilio/ric-implementation/blob/main/old/deploy_ric_interactive.py"
click node_smart "https://github.com/antonio-emilio/ric-implementation/blob/main/xapp/test-2/src/smart_monitor_xapp.c"
click node_analytics "https://github.com/antonio-emilio/ric-implementation/blob/main/xapp/test-2/src/analytics.c"
click node_database "https://github.com/antonio-emilio/ric-implementation/blob/main/xapp/test-2/src/database.c"
click node_utilities "https://github.com/antonio-emilio/ric-implementation/blob/main/xapp/test-2/src/utils.c"
click node_hello "https://github.com/antonio-emilio/ric-implementation/blob/main/xapp/test-1/src/main.cpp"

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_wizard,node_config,node_generator,node_runner toneBlue
class node_oran,node_flexric,node_custom,node_infrastructure toneAmber
class node_smart,node_e2nodes,node_hello toneMint
class node_analytics,node_database,node_utilities toneRose
class node_operator,node_e2ric toneIndigo
```

## Components

### Deployment workflow

- [Interactive configuration](https://github.com/antonio-emilio/ric-implementation/blob/main/old/deploy_ric_interactive.py): `old/deploy_ric_interactive.py`
- [Deployment settings](https://github.com/antonio-emilio/ric-implementation/blob/main/old/deploy_ric_interactive.py): `old/deploy_ric_interactive.py`
- [Script generation](https://github.com/antonio-emilio/ric-implementation/blob/main/old/deploy_ric_interactive.py): `old/deploy_ric_interactive.py`
- [Deployment execution](https://github.com/antonio-emilio/ric-implementation/blob/main/old/deploy_ric_interactive.py): `old/deploy_ric_interactive.py`

### RIC deployment targets

- [ORAN SC RIC](https://github.com/antonio-emilio/ric-implementation/blob/main/openran-deployment/scripts/deploy_oran_sc.sh): `openran-deployment/scripts/deploy_oran_sc.sh`
- [FlexRIC / OAI](https://github.com/antonio-emilio/ric-implementation/blob/main/openran-deployment/scripts/deploy_flexric_oai.sh): `openran-deployment/scripts/deploy_flexric_oai.sh`
- [Custom RIC](https://github.com/antonio-emilio/ric-implementation/blob/main/old/deploy_ric_interactive.py): `old/deploy_ric_interactive.py`
- **CORE / gNB**

### Monitoring xApp

- [Smart Monitor xApp](https://github.com/antonio-emilio/ric-implementation/blob/main/xapp/test-2/src/smart_monitor_xapp.c): `xapp/test-2/src/smart_monitor_xapp.c`
- **E2 nodes**
- [Hello xApp example](https://github.com/antonio-emilio/ric-implementation/blob/main/xapp/test-1/src/main.cpp): `xapp/test-1/src/main.cpp`

### Analytics and persistence

- [Metric analytics](https://github.com/antonio-emilio/ric-implementation/blob/main/xapp/test-2/src/analytics.c): `xapp/test-2/src/analytics.c`
- [SQLite persistence](https://github.com/antonio-emilio/ric-implementation/blob/main/xapp/test-2/src/database.c): `xapp/test-2/src/database.c`
- [Logging and utilities](https://github.com/antonio-emilio/ric-implementation/blob/main/xapp/test-2/src/utils.c): `xapp/test-2/src/utils.c`

### Other components

- **Operator**
- **FlexRIC RIC**

## Connections

- Operator → Interactive configuration: configures (evidence: `README.md`)
- Interactive configuration → Deployment settings: collects settings (evidence: `old/deploy_ric_interactive.py`)
- Interactive configuration → Script generation: generates scripts (evidence: `old/deploy_ric_interactive.py`)
- Interactive configuration → Deployment execution: executes deployment (evidence: `old/deploy_ric_interactive.py`)
- Script generation → ORAN SC RIC: targets ORAN SC (evidence: `README.md`)
- Script generation → FlexRIC / OAI: targets FlexRIC (evidence: `README.md`)
- Script generation → Custom RIC: supports custom (evidence: `README.md`)
- Deployment execution → CORE / gNB: connects CORE / gNB (evidence: `README.md`)
- Deployment execution → ORAN SC RIC: deploys ORAN SC (evidence: `README.md`)
- Deployment execution → FlexRIC / OAI: deploys FlexRIC (evidence: `README.md`)
- Smart Monitor xApp → Metric analytics: requests recommendations (evidence: `xapp/test-2/src/smart_monitor_xapp.c`)
- E2 nodes → Smart Monitor xApp: sends indications
- Smart Monitor xApp → FlexRIC RIC: uses E2 interface
- Hello xApp example → FlexRIC RIC: connects by socket (evidence: `xapp/test-1/src/main.cpp`)
