# felusion099/verity-microsoftps31 architecture

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

- Interactive diagram: https://gitdiagram.com/felusion099/verity-microsoftps31
- Repository: https://github.com/felusion099/verity-microsoftps31

## Overview

Verity is a local business-performance analytics platform for Finance, Sales, and executives. Users select a demo role and global filters, then explore governed revenue and related measures across dashboards, drill-downs, reconciliation, governance, and data-quality tools. Its analytical workflow loads a star-schema dataset, applies territory security and filters, and serves consistent metrics to product pages; separate verification tools detect anomalies and check invoice statements. The README documents several capabilities beyond the sampled excerpts, so those branches are included; unsampled implementation details are not inferred.

Main entry points: [`app.py`](https://github.com/felusion099/verity-microsoftps31/blob/main/app.py) (App shell), [`src/metrics.py`](https://github.com/felusion099/verity-microsoftps31/blob/main/src/metrics.py) (Governed metrics), [`src/context.py`](https://github.com/felusion099/verity-microsoftps31/blob/main/src/context.py) (Page context), [`pages/overview.py`](https://github.com/felusion099/verity-microsoftps31/blob/main/pages/overview.py) (Executive overview)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App and access"]
  node_app["App shell<br/>[app.py]"]
  node_context["Page context<br/>[context.py]"]
  node_rls["Territory security<br/>[rls.py]"]
  node_filters["Global filters<br/>[filters.py]"]
end

subgraph group_data["Data foundation"]
  node_generator["Data generation and ETL<br/>[data_generator.py]"]
  node_loader["Star-schema loader<br/>[data_loader.py]"]
end

subgraph group_analytics["Metrics and analysis"]
  node_metrics["Governed metrics<br/>[metrics.py]"]
  node_forecast["Trend forecast<br/>[forecast.py]"]
  node_insights["Executive insights<br/>[insights.py]"]
  node_charts["Chart library<br/>[charts.py]"]
end

subgraph group_experience["Business pages"]
  node_overview["Executive overview<br/>[overview.py]"]
  node_revenue["Revenue drill-down<br/>[revenue.py]"]
  node_finance["Finance reconciliation<br/>[finance_sales.py]"]
  node_variance["Variance analysis"]
  node_products["Product analysis<br/>[products.py]"]
  node_regions["Region analysis<br/>[regions.py]"]
  node_customers["Customer analysis<br/>[customers.py]"]
end

subgraph group_trust["Trust and verification"]
  node_governance["Metric governance<br/>[governance.py]"]
  node_quality["Data quality<br/>[data_quality.py]"]
  node_verifier["Anomaly verification<br/>[verifier.py]"]
  node_anomaly["Anomaly center<br/>[anomaly_center.py]"]
  node_trainer["Invoice trainer<br/>[trainer.py]"]
  node_trainerpage["Trainer page<br/>[ai_trainer.py]"]
end

node_user(("Business user"))

node_user -->|"uses"| node_app
node_app -->|"builds context"| node_context
node_context -->|"applies role scope"| node_rls
node_context -->|"applies filters"| node_filters
node_context -->|"loads plan data"| node_loader
node_loader -->|"generates if missing"| node_generator
node_context -->|"computes revenue"| node_metrics
node_app -->|"dispatches pages"| node_overview
node_app -->|"dispatches pages"| node_revenue
node_app -->|"dispatches pages"| node_products
node_app -->|"dispatches pages"| node_regions
node_app -->|"dispatches pages"| node_customers
node_app -->|"dispatches pages"| node_quality
node_app -->|"dispatches pages"| node_governance
node_app -->|"dispatches pages"| node_finance
node_app -->|"dispatches pages"| node_variance
node_app -->|"dispatches pages"| node_anomaly
node_app -->|"dispatches pages"| node_trainerpage
node_overview -->|"uses measures"| node_metrics
node_overview -->|"requests forecast"| node_forecast
node_overview -->|"requests insights"| node_insights
node_overview -->|"renders charts"| node_charts
node_revenue -->|"uses measures"| node_metrics
node_finance -->|"uses measures"| node_metrics
node_finance -->|"reads plan data"| node_loader
node_variance -->|"uses measures"| node_metrics
node_products -->|"uses measures"| node_metrics
node_regions -->|"uses measures"| node_metrics
node_customers -->|"uses measures"| node_metrics
node_governance -->|"proves consistency"| node_metrics
node_governance -->|"reads stored data"| node_loader
node_quality -->|"checks revenue"| node_metrics
node_quality -->|"requests checks"| node_verifier
node_anomaly -->|"requests detection"| node_verifier
node_trainerpage -->|"uses trainer"| node_trainer
node_trainerpage -->|"uses measures"| node_metrics

click node_app "https://github.com/felusion099/verity-microsoftps31/blob/main/app.py"
click node_context "https://github.com/felusion099/verity-microsoftps31/blob/main/src/context.py"
click node_rls "https://github.com/felusion099/verity-microsoftps31/blob/main/src/rls.py"
click node_filters "https://github.com/felusion099/verity-microsoftps31/blob/main/src/filters.py"
click node_generator "https://github.com/felusion099/verity-microsoftps31/blob/main/src/data_generator.py"
click node_loader "https://github.com/felusion099/verity-microsoftps31/blob/main/src/data_loader.py"
click node_metrics "https://github.com/felusion099/verity-microsoftps31/blob/main/src/metrics.py"
click node_forecast "https://github.com/felusion099/verity-microsoftps31/blob/main/src/forecast.py"
click node_insights "https://github.com/felusion099/verity-microsoftps31/blob/main/src/insights.py"
click node_charts "https://github.com/felusion099/verity-microsoftps31/blob/main/src/charts.py"
click node_overview "https://github.com/felusion099/verity-microsoftps31/blob/main/pages/overview.py"
click node_revenue "https://github.com/felusion099/verity-microsoftps31/blob/main/pages/revenue.py"
click node_finance "https://github.com/felusion099/verity-microsoftps31/blob/main/pages/finance_sales.py"
click node_variance "https://github.com/felusion099/verity-microsoftps31/blob/main/pages/variance_analysis.py"
click node_products "https://github.com/felusion099/verity-microsoftps31/blob/main/pages/products.py"
click node_regions "https://github.com/felusion099/verity-microsoftps31/blob/main/pages/regions.py"
click node_customers "https://github.com/felusion099/verity-microsoftps31/blob/main/pages/customers.py"
click node_governance "https://github.com/felusion099/verity-microsoftps31/blob/main/pages/governance.py"
click node_quality "https://github.com/felusion099/verity-microsoftps31/blob/main/pages/data_quality.py"
click node_verifier "https://github.com/felusion099/verity-microsoftps31/blob/main/src/verifier.py"
click node_anomaly "https://github.com/felusion099/verity-microsoftps31/blob/main/pages/anomaly_center.py"
click node_trainer "https://github.com/felusion099/verity-microsoftps31/blob/main/src/trainer.py"
click node_trainerpage "https://github.com/felusion099/verity-microsoftps31/blob/main/pages/ai_trainer.py"

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_app,node_context,node_rls,node_filters,node_user toneBlue
class node_generator,node_loader toneAmber
class node_metrics,node_forecast,node_insights,node_charts toneMint
class node_overview,node_revenue,node_finance,node_variance,node_products,node_regions,node_customers toneRose
class node_governance,node_quality,node_verifier,node_anomaly,node_trainer,node_trainerpage toneIndigo
```

## Components

### App and access

- [App shell](https://github.com/felusion099/verity-microsoftps31/blob/main/app.py): `app.py`
- [Page context](https://github.com/felusion099/verity-microsoftps31/blob/main/src/context.py): `src/context.py`
- [Territory security](https://github.com/felusion099/verity-microsoftps31/blob/main/src/rls.py): `src/rls.py`
- [Global filters](https://github.com/felusion099/verity-microsoftps31/blob/main/src/filters.py): `src/filters.py`

### Data foundation

- [Data generation and ETL](https://github.com/felusion099/verity-microsoftps31/blob/main/src/data_generator.py): `src/data_generator.py`
- [Star-schema loader](https://github.com/felusion099/verity-microsoftps31/blob/main/src/data_loader.py): `src/data_loader.py`

### Metrics and analysis

- [Governed metrics](https://github.com/felusion099/verity-microsoftps31/blob/main/src/metrics.py): `src/metrics.py`
- [Trend forecast](https://github.com/felusion099/verity-microsoftps31/blob/main/src/forecast.py): `src/forecast.py`
- [Executive insights](https://github.com/felusion099/verity-microsoftps31/blob/main/src/insights.py): `src/insights.py`
- [Chart library](https://github.com/felusion099/verity-microsoftps31/blob/main/src/charts.py): `src/charts.py`

### Business pages

- [Executive overview](https://github.com/felusion099/verity-microsoftps31/blob/main/pages/overview.py): `pages/overview.py`
- [Revenue drill-down](https://github.com/felusion099/verity-microsoftps31/blob/main/pages/revenue.py): `pages/revenue.py`
- [Finance reconciliation](https://github.com/felusion099/verity-microsoftps31/blob/main/pages/finance_sales.py): `pages/finance_sales.py`
- [Variance analysis](https://github.com/felusion099/verity-microsoftps31/blob/main/pages/variance_analysis.py): `pages/variance_analysis.py`
- [Product analysis](https://github.com/felusion099/verity-microsoftps31/blob/main/pages/products.py): `pages/products.py`
- [Region analysis](https://github.com/felusion099/verity-microsoftps31/blob/main/pages/regions.py): `pages/regions.py`
- [Customer analysis](https://github.com/felusion099/verity-microsoftps31/blob/main/pages/customers.py): `pages/customers.py`

### Trust and verification

- [Metric governance](https://github.com/felusion099/verity-microsoftps31/blob/main/pages/governance.py): `pages/governance.py`
- [Data quality](https://github.com/felusion099/verity-microsoftps31/blob/main/pages/data_quality.py): `pages/data_quality.py`
- [Anomaly verification](https://github.com/felusion099/verity-microsoftps31/blob/main/src/verifier.py): `src/verifier.py`
- [Anomaly center](https://github.com/felusion099/verity-microsoftps31/blob/main/pages/anomaly_center.py): `pages/anomaly_center.py`
- [Invoice trainer](https://github.com/felusion099/verity-microsoftps31/blob/main/src/trainer.py): `src/trainer.py`
- [Trainer page](https://github.com/felusion099/verity-microsoftps31/blob/main/pages/ai_trainer.py): `pages/ai_trainer.py`

### Other components

- **Business user**

## Connections

- Business user → App shell: uses (evidence: `README.md`)
- App shell → Page context: builds context (evidence: `src/context.py`)
- Page context → Territory security: applies role scope (evidence: `src/context.py`)
- Page context → Global filters: applies filters (evidence: `src/context.py`)
- Page context → Star-schema loader: loads plan data (evidence: `src/context.py`)
- Star-schema loader → Data generation and ETL: generates if missing (evidence: `src/data_loader.py`)
- Page context → Governed metrics: computes revenue (evidence: `src/context.py`)
- App shell → Executive overview: dispatches pages (evidence: `app.py`)
- App shell → Revenue drill-down: dispatches pages (evidence: `app.py`)
- App shell → Product analysis: dispatches pages (evidence: `app.py`)
- App shell → Region analysis: dispatches pages (evidence: `app.py`)
- App shell → Customer analysis: dispatches pages (evidence: `app.py`)
- App shell → Data quality: dispatches pages (evidence: `app.py`)
- App shell → Metric governance: dispatches pages (evidence: `app.py`)
- App shell → Finance reconciliation: dispatches pages (evidence: `app.py`)
- App shell → Variance analysis: dispatches pages (evidence: `app.py`)
- App shell → Anomaly center: dispatches pages (evidence: `app.py`)
- App shell → Trainer page: dispatches pages (evidence: `app.py`)
- Executive overview → Governed metrics: uses measures (evidence: `pages/overview.py`)
- Executive overview → Trend forecast: requests forecast (evidence: `pages/overview.py`)
- Executive overview → Executive insights: requests insights (evidence: `pages/overview.py`)
- Executive overview → Chart library: renders charts (evidence: `pages/overview.py`)
- Revenue drill-down → Governed metrics: uses measures (evidence: `pages/revenue.py`)
- Finance reconciliation → Governed metrics: uses measures (evidence: `pages/finance_sales.py`)
- Finance reconciliation → Star-schema loader: reads plan data (evidence: `pages/finance_sales.py`)
- Variance analysis → Governed metrics: uses measures (evidence: `pages/variance_analysis.py`)
- Product analysis → Governed metrics: uses measures (evidence: `pages/products.py`)
- Region analysis → Governed metrics: uses measures (evidence: `pages/regions.py`)
- Customer analysis → Governed metrics: uses measures (evidence: `pages/customers.py`)
- Metric governance → Governed metrics: proves consistency (evidence: `pages/governance.py`)
- Metric governance → Star-schema loader: reads stored data (evidence: `pages/governance.py`)
- Data quality → Governed metrics: checks revenue (evidence: `pages/data_quality.py`)
- Data quality → Anomaly verification: requests checks (evidence: `pages/data_quality.py`)
- Anomaly center → Anomaly verification: requests detection (evidence: `pages/anomaly_center.py`)
- Trainer page → Invoice trainer: uses trainer (evidence: `pages/ai_trainer.py`)
- Trainer page → Governed metrics: uses measures (evidence: `pages/ai_trainer.py`)
