# pranith2610/finova architecture

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

- Interactive diagram: https://gitdiagram.com/pranith2610/finova
- Repository: https://github.com/pranith2610/finova

## Overview

Finova is a browser-based banking SIEM dashboard. Its main workflow initializes simulated customer sessions, scores their event histories against tunable rules, and presents decisions, alerts, and incidents to analysts. Analysts can inspect session timelines and use an internal copilot, which streams responses from a configured local Ollama service or falls back to rules-based mock answers. The README documents dashboard, tuner, and admin capabilities; the excerpts show the main wiring and scoring paths, but not every UI rendering detail.

Main entry points: [`js/ui.js`](https://github.com/pranith2610/finova/blob/main/js/ui.js) (Security Dashboard), [`js/app.js`](https://github.com/pranith2610/finova/blob/main/js/app.js) (App Bootstrap), [`js/lib/trustScore.js`](https://github.com/pranith2610/finova/blob/main/js/lib/trustScore.js) (Trust Score Engine), [`js/ollama.js`](https://github.com/pranith2610/finova/blob/main/js/ollama.js) (Ollama Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operations["SOC Operations"]
  node_bootstrap["App Bootstrap<br/>[app.js]"]
  node_dashboard["Security Dashboard<br/>[ui.js]"]
  node_telemetry["Metrics &amp; Telemetry<br/>[ui.js]"]
  node_investigation["Session &amp; Incident Review<br/>[ui.js]"]
  node_simulator["Session Simulator<br/>[mockData.js]"]
  node_sessiondata[("Session State<br/>[mockData.js]")]
  node_alerts[("Alerts &amp; Incidents<br/>[mockData.js]")]
end

subgraph group_risk["Risk Scoring"]
  node_tuner["Risk Rules Tuner<br/>[ui.js]"]
  node_rules["Scoring Parameters<br/>[trustRules.js]"]
  node_engine["Trust Score Engine<br/>[trustScore.js]"]
  node_narrative["Decision Narratives<br/>[trustScore.js]"]
end

subgraph group_copilot["Analyst Copilot"]
  node_copilotui["Copilot Interface<br/>[ui.js]"]
  node_offline["Rules-Based Copilot<br/>[mockData.js]"]
end

subgraph group_integration["Local AI Integration"]
  node_ollamaservice["Ollama Client<br/>[ollama.js]"]
  node_ollama["Local Ollama"]
end

node_analyst(("Bank Analyst"))

node_analyst -->|"uses"| node_dashboard
node_bootstrap -->|"initializes and starts"| node_simulator
node_bootstrap -->|"initializes and renders"| node_dashboard
node_bootstrap -->|"refreshes on updates"| node_telemetry
node_simulator -->|"scores sessions"| node_engine
node_engine -->|"reads defaults"| node_rules
node_dashboard -->|"reads session state"| node_sessiondata
node_dashboard -->|"reads alert and incident state"| node_alerts
node_dashboard -->|"computes decisions"| node_engine
node_dashboard -->|"generates explanations"| node_narrative
node_tuner -->|"edits active parameters"| node_rules
node_investigation -->|"inspects sessions"| node_dashboard
node_copilotui -->|"checks and streams"| node_ollamaservice
node_copilotui -->|"falls back to"| node_offline
node_ollamaservice -->|"sends API requests"| node_ollama
node_copilotui -->|"supplies session context"| node_ollamaservice

click node_bootstrap "https://github.com/pranith2610/finova/blob/main/js/app.js"
click node_dashboard "https://github.com/pranith2610/finova/blob/main/js/ui.js"
click node_telemetry "https://github.com/pranith2610/finova/blob/main/js/ui.js"
click node_investigation "https://github.com/pranith2610/finova/blob/main/js/ui.js"
click node_simulator "https://github.com/pranith2610/finova/blob/main/js/mockData.js"
click node_sessiondata "https://github.com/pranith2610/finova/blob/main/js/mockData.js"
click node_alerts "https://github.com/pranith2610/finova/blob/main/js/mockData.js"
click node_tuner "https://github.com/pranith2610/finova/blob/main/js/ui.js"
click node_rules "https://github.com/pranith2610/finova/blob/main/js/data/trustRules.js"
click node_engine "https://github.com/pranith2610/finova/blob/main/js/lib/trustScore.js"
click node_narrative "https://github.com/pranith2610/finova/blob/main/js/lib/trustScore.js"
click node_copilotui "https://github.com/pranith2610/finova/blob/main/js/ui.js"
click node_offline "https://github.com/pranith2610/finova/blob/main/js/mockData.js"
click node_ollamaservice "https://github.com/pranith2610/finova/blob/main/js/ollama.js"

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_bootstrap,node_dashboard,node_telemetry,node_investigation,node_simulator,node_sessiondata,node_alerts toneBlue
class node_tuner,node_rules,node_engine,node_narrative toneAmber
class node_copilotui,node_offline toneMint
class node_ollamaservice,node_ollama toneRose
class node_analyst toneIndigo
```

## Components

### SOC Operations

- [App Bootstrap](https://github.com/pranith2610/finova/blob/main/js/app.js): `js/app.js`
- [Security Dashboard](https://github.com/pranith2610/finova/blob/main/js/ui.js): `js/ui.js`
- [Metrics & Telemetry](https://github.com/pranith2610/finova/blob/main/js/ui.js): `js/ui.js`
- [Session & Incident Review](https://github.com/pranith2610/finova/blob/main/js/ui.js): `js/ui.js`
- [Session Simulator](https://github.com/pranith2610/finova/blob/main/js/mockData.js): `js/mockData.js`
- [Session State](https://github.com/pranith2610/finova/blob/main/js/mockData.js): `js/mockData.js`
- [Alerts & Incidents](https://github.com/pranith2610/finova/blob/main/js/mockData.js): `js/mockData.js`

### Risk Scoring

- [Risk Rules Tuner](https://github.com/pranith2610/finova/blob/main/js/ui.js): `js/ui.js`
- [Scoring Parameters](https://github.com/pranith2610/finova/blob/main/js/data/trustRules.js): `js/data/trustRules.js`
- [Trust Score Engine](https://github.com/pranith2610/finova/blob/main/js/lib/trustScore.js): `js/lib/trustScore.js`
- [Decision Narratives](https://github.com/pranith2610/finova/blob/main/js/lib/trustScore.js): `js/lib/trustScore.js`

### Analyst Copilot

- [Copilot Interface](https://github.com/pranith2610/finova/blob/main/js/ui.js): `js/ui.js`
- [Rules-Based Copilot](https://github.com/pranith2610/finova/blob/main/js/mockData.js): `js/mockData.js`

### Local AI Integration

- [Ollama Client](https://github.com/pranith2610/finova/blob/main/js/ollama.js): `js/ollama.js`
- **Local Ollama**

### Other components

- **Bank Analyst**

## Connections

- Bank Analyst → Security Dashboard: uses (evidence: `README.md`)
- App Bootstrap → Session Simulator: initializes and starts (evidence: `js/app.js`)
- App Bootstrap → Security Dashboard: initializes and renders (evidence: `js/app.js`)
- App Bootstrap → Metrics & Telemetry: refreshes on updates (evidence: `js/app.js`)
- Session Simulator → Trust Score Engine: scores sessions (evidence: `js/mockData.js`)
- Trust Score Engine → Scoring Parameters: reads defaults (evidence: `js/lib/trustScore.js`)
- Security Dashboard → Session State: reads session state (evidence: `js/ui.js`)
- Security Dashboard → Alerts & Incidents: reads alert and incident state (evidence: `js/ui.js`)
- Security Dashboard → Trust Score Engine: computes decisions (evidence: `js/ui.js`)
- Security Dashboard → Decision Narratives: generates explanations (evidence: `js/ui.js`)
- Risk Rules Tuner → Scoring Parameters: edits active parameters (evidence: `README.md`)
- Session & Incident Review → Security Dashboard: inspects sessions (evidence: `js/ui.js`)
- Copilot Interface → Ollama Client: checks and streams (evidence: `js/ui.js`)
- Copilot Interface → Rules-Based Copilot: falls back to (evidence: `js/ui.js`)
- Ollama Client → Local Ollama: sends API requests (evidence: `js/ollama.js`)
- Copilot Interface → Ollama Client: supplies session context (evidence: `js/ui.js`)
