Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added Image/fastapi-swagger-ui.jpeg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added Image/gds-results.jpeg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added Image/graph-eda-notebook.jpeg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added Image/neo4j-browser-visualization.jpeg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added Image/schema-diagram.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
34 changes: 34 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,17 @@ Enables investigation of offshore financial networks, intermediaries, and comple
## Features

- 🔍 **Beneficial Ownership Tracing** — Follow ownership chains through complex corporate structures up to 6 hops deep

![Neo4j Browser Visualization](Image/neo4j-browser-visualization.jpeg)

*A visual representation of an ownership network within the Neo4j Browser. This screenshot displays a multi-hop path unmasking the ultimate human controller behind nested shell companies.*

- 📊 **Network Analysis** — Identify influential entities using PageRank, betweenness centrality, and degree metrics

![Graph Data Science Results](Image/gds-results.jpeg)

*Results from PageRank and Louvain algorithms running on the graph. This highlights the most influential intermediaries and detected communities within the offshore network.*

- 🏘️ **Community Detection** — Discover connected business networks using Louvain clustering and label propagation
- 🚩 **Red Flag Detection** — Automatic identification of suspicious patterns (deep layering, PEP connections, circular ownership)
- ⚡ **Fast Query Performance** — Optimized Cypher queries with proper indexing and bounded variable-length paths
Expand All @@ -19,6 +29,14 @@ Enables investigation of offshore financial networks, intermediaries, and comple

---

## Data Model

![Graph Schema Diagram](Image/schema-diagram.png)

*A logical data model of the Panama Papers network created in draw.io. It defines the properties and relationships between Entity, Officer, Intermediary, and Address nodes.*

---

## Technology Stack

| Component | Technology | Version |
Expand All @@ -37,6 +55,14 @@ Enables investigation of offshore financial networks, intermediaries, and comple

---

## Usage

![FastAPI Swagger UI](Image/fastapi-swagger-ui.jpeg)

*The interactive Swagger UI showcasing operational REST endpoints. This demonstrates the API's ability to execute complex graph traversals and beneficial ownership lookups.*

---

## Quick Start

### Prerequisites
Expand Down Expand Up @@ -505,6 +531,14 @@ curl -X GET "http://localhost:8000/entities/10000001/risk"

---

## Exploratory Data Analysis

![Graph EDA Notebook](Image/graph-eda-notebook.jpeg)

*The Exploratory Data Analysis (EDA) notebook showing the dataset's distribution. It visualizes node counts across jurisdictions and the connectivity degree before graph ingestion.*

---

## Database Schema

### Node Labels
Expand Down