diff --git a/Image/fastapi-swagger-ui.jpeg b/Image/fastapi-swagger-ui.jpeg new file mode 100644 index 0000000..3bff68e Binary files /dev/null and b/Image/fastapi-swagger-ui.jpeg differ diff --git a/Image/gds-results.jpeg b/Image/gds-results.jpeg new file mode 100644 index 0000000..5f42e5d Binary files /dev/null and b/Image/gds-results.jpeg differ diff --git a/Image/graph-eda-notebook.jpeg b/Image/graph-eda-notebook.jpeg new file mode 100644 index 0000000..ca61747 Binary files /dev/null and b/Image/graph-eda-notebook.jpeg differ diff --git a/Image/neo4j-browser-visualization.jpeg b/Image/neo4j-browser-visualization.jpeg new file mode 100644 index 0000000..13f6115 Binary files /dev/null and b/Image/neo4j-browser-visualization.jpeg differ diff --git a/Image/schema-diagram.png b/Image/schema-diagram.png new file mode 100644 index 0000000..a9ecbd9 Binary files /dev/null and b/Image/schema-diagram.png differ diff --git a/README.md b/README.md index cc7c92c..4a2713c 100644 --- a/README.md +++ b/README.md @@ -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 @@ -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 | @@ -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 @@ -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