# zie619/n8n-workflows architecture

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

- Interactive diagram: https://gitdiagram.com/zie619/n8n-workflows
- Repository: https://github.com/zie619/n8n-workflows

## Overview

This repository is a large n8n workflow collection with searchable web/API access, downloadable workflow JSON, and a separate Node.js API/indexing implementation. The main user journey is to browse or search the collection, inspect a workflow, and download its JSON. The graph also preserves documented search, filtering, statistics, categories, integrations, and community/analytics modules. Python and Node.js paths represent distinct implementations; unsampled subsystem links are omitted rather than inferred.

Main entry points: [`api_server.py`](https://github.com/zie619/n8n-workflows/blob/main/api_server.py) (FastAPI Routes), [`workflow_db.py`](https://github.com/zie619/n8n-workflows/blob/main/workflow_db.py) (SQLite FTS Index), [`workflows`](https://github.com/zie619/n8n-workflows/tree/main/workflows) (Workflow JSONs), [`src/database.js`](https://github.com/zie619/n8n-workflows/blob/main/src/database.js) (Node Workflow Index)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Workflow Catalog"]
  node_workflow_files["Workflow JSONs"]
end

subgraph group_python["Python Search API"]
  node_py_index["Python Indexer<br/>[workflow_db.py]"]
  node_py_db[("SQLite FTS Index<br/>[workflow_db.py]")]
  node_api["FastAPI Routes<br/>[api_server.py]"]
  node_launcher["Server Launcher<br/>[run.py]"]
end

subgraph group_web["Web Experience"]
  node_static_ui["Web Interface"]
  node_pages_ui["Pages Search"]
  node_search_index["Search Index Builder"]
  node_readme_stats["Stats Updater"]
end

subgraph group_node["Node API"]
  node_node_server["Express API<br/>[server.js]"]
  node_node_db[("Node Workflow Index<br/>[database.js]")]
  node_node_cli["Node Index CLI<br/>[index-workflows.js]"]
end

subgraph group_features["Extended Features"]
  node_enhanced_api["Enhanced API<br/>[enhanced_api.py]"]
  node_community[("Ratings and Reviews")]
  node_analytics["Analytics Engine"]
  node_assistant["AI Assistant<br/>[ai_assistant.py]"]
  node_integrations["Integration Hub<br/>[integration_hub.py]"]
  node_performance["Performance Monitor"]
  node_user_mgmt["User Management<br/>[user_management.py]"]
end

node_visitor(("Browser User"))

node_workflow_files -->|"indexes files"| node_py_index
node_launcher -->|"initializes and indexes"| node_py_index
node_api -->|"queries"| node_py_db
node_visitor -->|"browses"| node_static_ui
node_static_ui -->|"calls API"| node_api
node_api -->|"serves search and stats"| node_py_db
node_api -->|"downloads JSON"| node_workflow_files
node_search_index -->|"reads indexed data"| node_py_db
node_search_index -->|"generates search data"| node_pages_ui
node_readme_stats -->|"reads statistics"| node_py_db
node_node_server -->|"queries and reindexes"| node_node_db
node_node_cli -->|"indexes workflows"| node_node_db
node_node_db -->|"reads JSON files"| node_workflow_files
node_enhanced_api -->|"registers endpoints"| node_community

click node_workflow_files "https://github.com/zie619/n8n-workflows/tree/main/workflows"
click node_py_index "https://github.com/zie619/n8n-workflows/blob/main/workflow_db.py"
click node_py_db "https://github.com/zie619/n8n-workflows/blob/main/workflow_db.py"
click node_api "https://github.com/zie619/n8n-workflows/blob/main/api_server.py"
click node_launcher "https://github.com/zie619/n8n-workflows/blob/main/run.py"
click node_static_ui "https://github.com/zie619/n8n-workflows/tree/main/static"
click node_pages_ui "https://github.com/zie619/n8n-workflows/tree/main/docs"
click node_search_index "https://github.com/zie619/n8n-workflows/blob/main/scripts/generate_search_index.py"
click node_readme_stats "https://github.com/zie619/n8n-workflows/blob/main/scripts/update_readme_stats.py"
click node_node_server "https://github.com/zie619/n8n-workflows/blob/main/src/server.js"
click node_node_db "https://github.com/zie619/n8n-workflows/blob/main/src/database.js"
click node_node_cli "https://github.com/zie619/n8n-workflows/blob/main/src/index-workflows.js"
click node_enhanced_api "https://github.com/zie619/n8n-workflows/blob/main/src/enhanced_api.py"
click node_community "https://github.com/zie619/n8n-workflows/blob/main/src/community_features.py"
click node_analytics "https://github.com/zie619/n8n-workflows/blob/main/src/analytics_engine.py"
click node_assistant "https://github.com/zie619/n8n-workflows/blob/main/src/ai_assistant.py"
click node_integrations "https://github.com/zie619/n8n-workflows/blob/main/src/integration_hub.py"
click node_performance "https://github.com/zie619/n8n-workflows/blob/main/src/performance_monitor.py"
click node_user_mgmt "https://github.com/zie619/n8n-workflows/blob/main/src/user_management.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_workflow_files,node_visitor toneBlue
class node_py_index,node_py_db,node_api,node_launcher toneAmber
class node_static_ui,node_pages_ui,node_search_index,node_readme_stats toneMint
class node_node_server,node_node_db,node_node_cli toneRose
class node_enhanced_api,node_community,node_analytics,node_assistant,node_integrations,node_performance,node_user_mgmt toneIndigo
```

## Components

### Workflow Catalog

- [Workflow JSONs](https://github.com/zie619/n8n-workflows/tree/main/workflows): `workflows`

### Python Search API

- [Python Indexer](https://github.com/zie619/n8n-workflows/blob/main/workflow_db.py): `workflow_db.py`
- [SQLite FTS Index](https://github.com/zie619/n8n-workflows/blob/main/workflow_db.py): `workflow_db.py`
- [FastAPI Routes](https://github.com/zie619/n8n-workflows/blob/main/api_server.py): `api_server.py`
- [Server Launcher](https://github.com/zie619/n8n-workflows/blob/main/run.py): `run.py`

### Web Experience

- [Web Interface](https://github.com/zie619/n8n-workflows/tree/main/static): `static`
- [Pages Search](https://github.com/zie619/n8n-workflows/tree/main/docs): `docs`
- [Search Index Builder](https://github.com/zie619/n8n-workflows/blob/main/scripts/generate_search_index.py): `scripts/generate_search_index.py`
- [Stats Updater](https://github.com/zie619/n8n-workflows/blob/main/scripts/update_readme_stats.py): `scripts/update_readme_stats.py`

### Node API

- [Express API](https://github.com/zie619/n8n-workflows/blob/main/src/server.js): `src/server.js`
- [Node Workflow Index](https://github.com/zie619/n8n-workflows/blob/main/src/database.js): `src/database.js`
- [Node Index CLI](https://github.com/zie619/n8n-workflows/blob/main/src/index-workflows.js): `src/index-workflows.js`

### Extended Features

- [Enhanced API](https://github.com/zie619/n8n-workflows/blob/main/src/enhanced_api.py): `src/enhanced_api.py`
- [Ratings and Reviews](https://github.com/zie619/n8n-workflows/blob/main/src/community_features.py): `src/community_features.py`
- [Analytics Engine](https://github.com/zie619/n8n-workflows/blob/main/src/analytics_engine.py): `src/analytics_engine.py`
- [AI Assistant](https://github.com/zie619/n8n-workflows/blob/main/src/ai_assistant.py): `src/ai_assistant.py`
- [Integration Hub](https://github.com/zie619/n8n-workflows/blob/main/src/integration_hub.py): `src/integration_hub.py`
- [Performance Monitor](https://github.com/zie619/n8n-workflows/blob/main/src/performance_monitor.py): `src/performance_monitor.py`
- [User Management](https://github.com/zie619/n8n-workflows/blob/main/src/user_management.py): `src/user_management.py`

### Other components

- **Browser User**

## Connections

- Workflow JSONs → Python Indexer: indexes files (evidence: `README.md`)
- Server Launcher → Python Indexer: initializes and indexes (evidence: `run.py`)
- FastAPI Routes → SQLite FTS Index: queries (evidence: `api_server.py`)
- Browser User → Web Interface: browses (evidence: `README.md`)
- Web Interface → FastAPI Routes: calls API (evidence: `README.md`)
- FastAPI Routes → SQLite FTS Index: serves search and stats (evidence: `api_server.py`)
- FastAPI Routes → Workflow JSONs: downloads JSON (evidence: `api_server.py`)
- Search Index Builder → SQLite FTS Index: reads indexed data (evidence: `scripts/generate_search_index.py`)
- Search Index Builder → Pages Search: generates search data (evidence: `scripts/generate_search_index.py`)
- Stats Updater → SQLite FTS Index: reads statistics (evidence: `scripts/update_readme_stats.py`)
- Express API → Node Workflow Index: queries and reindexes (evidence: `src/server.js`)
- Node Index CLI → Node Workflow Index: indexes workflows (evidence: `src/index-workflows.js`)
- Node Workflow Index → Workflow JSONs: reads JSON files (evidence: `src/database.js`)
- Enhanced API → Ratings and Reviews: registers endpoints (evidence: `src/enhanced_api.py`)
