# jishnusetia/bioloopai architecture

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

- Interactive diagram: https://gitdiagram.com/jishnusetia/bioloopai
- Repository: https://github.com/jishnusetia/bioloopai

## Overview

BioLoop AI is a farm-to-industry biomass marketplace: farm and industry managers register, maintain supply or demand profiles, discover potential exchanges, and propose and manage collaborations. Its optimization service estimates matches and economic/environmental impact, with optional AI explanations; the dashboard presents this information through tables, maps, charts, and insights. The README documents these product capabilities, while sampled source confirms key frontend requests and optimization calls. Some route and UI implementation details were not excerpted, so those relationships are omitted or shown only where documented.

Main entry points: [`backend/src/index.js`](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/index.js) (Express API), [`backend/src/db.js`](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/db.js) (Prisma client), [`js/dashboard.js`](https://github.com/jishnusetia/bioloopai/blob/main/js/dashboard.js) (Dashboard workflows), [`backend/src/services/pythonRunner.js`](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/services/pythonRunner.js) (Python runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Marketplace dashboard"]
  node_dashboard_page["Dashboard<br/>[dashboard.html]"]
  node_auth_ui["Sign-in and signup<br/>[auth.js]"]
  node_api_client["API client<br/>[api.js]"]
  node_dashboard_logic["Dashboard workflows<br/>[dashboard.js]"]
  node_map_view["Marketplace map<br/>[map.js]"]
  node_charts_view["Impact charts<br/>[charts.js]"]
  node_insights_panel["AI insights panel<br/>[ai-insights.js]"]
end

subgraph group_api["API and identity"]
  node_api_server["Express API<br/>[index.js]"]
  node_auth_routes["Authentication routes<br/>[auth.js]"]
  node_jwt_middleware["JWT verification<br/>[auth.js]"]
end

subgraph group_marketplace["Marketplace operations"]
  node_farm_routes["Farm profiles<br/>[farms.js]"]
  node_industry_routes["Industry profiles<br/>[industries.js]"]
  node_directory_routes["Marketplace directory<br/>[directory.js]"]
  node_match_routes["Match discovery<br/>[matches.js]"]
  node_collab_routes["Collaborations<br/>[collaborations.js]"]
end

subgraph group_optimization["Matching and insights"]
  node_optimize_routes["Optimization endpoint<br/>[optimize.js]"]
  node_ai_routes["AI endpoint<br/>[ai.js]"]
  node_optimizer_service["Optimization service<br/>[optimizeService.js]"]
  node_python_runner["Python runner<br/>[pythonRunner.js]"]
  node_optimizer["Biomass optimizer<br/>[optimizer.py]"]
  node_ai_explainer["AI explainer<br/>[ai_explainer.py]"]
  node_ai_match_review["AI match review<br/>[ai_match_review.py]"]
  node_haversine["Distance calculation<br/>[haversine.py]"]
end

subgraph group_data["Persistent data"]
  node_prisma_client["Prisma client<br/>[db.js]"]
  node_database[("Marketplace database<br/>[schema.prisma]")]
end

node_farm_manager(("Farm manager"))
node_industry_manager(("Industry manager"))
node_ollama["Ollama service"]
node_routing_service["OSRM routing"]

node_farm_manager -->|"signs in"| node_auth_ui
node_industry_manager -->|"signs in"| node_auth_ui
node_auth_ui -->|"requests auth"| node_api_client
node_dashboard_page -->|"loads"| node_dashboard_logic
node_dashboard_logic -->|"requests data"| node_api_client
node_dashboard_logic -->|"uses map"| node_map_view
node_dashboard_logic -->|"uses charts"| node_charts_view
node_dashboard_logic -->|"uses insights"| node_insights_panel
node_api_client -->|"sends HTTP requests"| node_api_server
node_map_view -->|"requests routes"| node_routing_service
node_api_server -->|"mounts routes"| node_auth_routes
node_api_server -->|"mounts routes"| node_farm_routes
node_api_server -->|"mounts routes"| node_industry_routes
node_api_server -->|"mounts routes"| node_directory_routes
node_api_server -->|"mounts routes"| node_match_routes
node_api_server -->|"mounts routes"| node_collab_routes
node_api_server -->|"mounts routes"| node_optimize_routes
node_api_server -->|"mounts routes"| node_ai_routes
node_auth_routes -->|"reads and writes users"| node_prisma_client
node_auth_routes -->|"protects profile lookup"| node_jwt_middleware
node_farm_routes -->|"accesses farm data"| node_prisma_client
node_industry_routes -->|"accesses industry data"| node_prisma_client
node_directory_routes -->|"reads directory data"| node_prisma_client
node_collab_routes -->|"accesses collaborations"| node_prisma_client
node_match_routes -->|"reads profiles"| node_prisma_client
node_match_routes -->|"runs optimization"| node_optimizer_service
node_optimize_routes -->|"runs optimization"| node_optimizer_service
node_ai_routes -->|"runs Python service"| node_python_runner
node_optimizer_service -->|"runs scripts"| node_python_runner
node_python_runner -->|"executes script"| node_optimizer
node_python_runner -->|"executes script"| node_ai_explainer
node_optimizer -->|"uses distance helper"| node_haversine
node_prisma_client -.->|"queries"| node_database
node_ai_explainer -.->|"generates explanations"| node_ollama
node_ai_match_review -.->|"may use AI service"| node_ollama

click node_dashboard_page "https://github.com/jishnusetia/bioloopai/blob/main/dashboard.html"
click node_auth_ui "https://github.com/jishnusetia/bioloopai/blob/main/js/auth.js"
click node_api_client "https://github.com/jishnusetia/bioloopai/blob/main/js/api.js"
click node_dashboard_logic "https://github.com/jishnusetia/bioloopai/blob/main/js/dashboard.js"
click node_map_view "https://github.com/jishnusetia/bioloopai/blob/main/js/map.js"
click node_charts_view "https://github.com/jishnusetia/bioloopai/blob/main/js/charts.js"
click node_insights_panel "https://github.com/jishnusetia/bioloopai/blob/main/js/ai-insights.js"
click node_api_server "https://github.com/jishnusetia/bioloopai/blob/main/backend/src/index.js"
click node_auth_routes "https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/auth.js"
click node_jwt_middleware "https://github.com/jishnusetia/bioloopai/blob/main/backend/src/middleware/auth.js"
click node_farm_routes "https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/farms.js"
click node_industry_routes "https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/industries.js"
click node_directory_routes "https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/directory.js"
click node_match_routes "https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/matches.js"
click node_collab_routes "https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/collaborations.js"
click node_optimize_routes "https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/optimize.js"
click node_ai_routes "https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/ai.js"
click node_optimizer_service "https://github.com/jishnusetia/bioloopai/blob/main/backend/src/services/optimizeService.js"
click node_python_runner "https://github.com/jishnusetia/bioloopai/blob/main/backend/src/services/pythonRunner.js"
click node_optimizer "https://github.com/jishnusetia/bioloopai/blob/main/backend/python/optimizer.py"
click node_ai_explainer "https://github.com/jishnusetia/bioloopai/blob/main/backend/python/ai_explainer.py"
click node_ai_match_review "https://github.com/jishnusetia/bioloopai/blob/main/backend/python/ai_match_review.py"
click node_haversine "https://github.com/jishnusetia/bioloopai/blob/main/backend/python/haversine.py"
click node_prisma_client "https://github.com/jishnusetia/bioloopai/blob/main/backend/src/db.js"
click node_database "https://github.com/jishnusetia/bioloopai/blob/main/backend/prisma/schema.prisma"

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_dashboard_page,node_auth_ui,node_api_client,node_dashboard_logic,node_map_view,node_charts_view,node_insights_panel toneBlue
class node_api_server,node_auth_routes,node_jwt_middleware toneAmber
class node_farm_routes,node_industry_routes,node_directory_routes,node_match_routes,node_collab_routes toneMint
class node_optimize_routes,node_ai_routes,node_optimizer_service,node_python_runner,node_optimizer,node_ai_explainer,node_ai_match_review,node_haversine toneRose
class node_prisma_client,node_database,node_farm_manager,node_industry_manager,node_ollama,node_routing_service toneIndigo
```

## Components

### Marketplace dashboard

- [Dashboard](https://github.com/jishnusetia/bioloopai/blob/main/dashboard.html): `dashboard.html`
- [Sign-in and signup](https://github.com/jishnusetia/bioloopai/blob/main/js/auth.js): `js/auth.js`
- [API client](https://github.com/jishnusetia/bioloopai/blob/main/js/api.js): `js/api.js`
- [Dashboard workflows](https://github.com/jishnusetia/bioloopai/blob/main/js/dashboard.js): `js/dashboard.js`
- [Marketplace map](https://github.com/jishnusetia/bioloopai/blob/main/js/map.js): `js/map.js`
- [Impact charts](https://github.com/jishnusetia/bioloopai/blob/main/js/charts.js): `js/charts.js`
- [AI insights panel](https://github.com/jishnusetia/bioloopai/blob/main/js/ai-insights.js): `js/ai-insights.js`

### API and identity

- [Express API](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/index.js): `backend/src/index.js`
- [Authentication routes](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/auth.js): `backend/src/routes/auth.js`
- [JWT verification](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`

### Marketplace operations

- [Farm profiles](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/farms.js): `backend/src/routes/farms.js`
- [Industry profiles](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/industries.js): `backend/src/routes/industries.js`
- [Marketplace directory](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/directory.js): `backend/src/routes/directory.js`
- [Match discovery](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/matches.js): `backend/src/routes/matches.js`
- [Collaborations](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/collaborations.js): `backend/src/routes/collaborations.js`

### Matching and insights

- [Optimization endpoint](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/optimize.js): `backend/src/routes/optimize.js`
- [AI endpoint](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/routes/ai.js): `backend/src/routes/ai.js`
- [Optimization service](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/services/optimizeService.js): `backend/src/services/optimizeService.js`
- [Python runner](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/services/pythonRunner.js): `backend/src/services/pythonRunner.js`
- [Biomass optimizer](https://github.com/jishnusetia/bioloopai/blob/main/backend/python/optimizer.py): `backend/python/optimizer.py`
- [AI explainer](https://github.com/jishnusetia/bioloopai/blob/main/backend/python/ai_explainer.py): `backend/python/ai_explainer.py`
- [AI match review](https://github.com/jishnusetia/bioloopai/blob/main/backend/python/ai_match_review.py): `backend/python/ai_match_review.py`
- [Distance calculation](https://github.com/jishnusetia/bioloopai/blob/main/backend/python/haversine.py): `backend/python/haversine.py`

### Persistent data

- [Prisma client](https://github.com/jishnusetia/bioloopai/blob/main/backend/src/db.js): `backend/src/db.js`
- [Marketplace database](https://github.com/jishnusetia/bioloopai/blob/main/backend/prisma/schema.prisma): `backend/prisma/schema.prisma`

### Other components

- **Farm manager**
- **Industry manager**
- **Ollama service**
- **OSRM routing**

## Connections

- Farm manager → Sign-in and signup: signs in (evidence: `README.md`)
- Industry manager → Sign-in and signup: signs in (evidence: `README.md`)
- Sign-in and signup → API client: requests auth (evidence: `js/auth.js`)
- Dashboard → Dashboard workflows: loads (evidence: `README.md`)
- Dashboard workflows → API client: requests data (evidence: `js/dashboard.js`)
- Dashboard workflows → Marketplace map: uses map (evidence: `js/dashboard.js`)
- Dashboard workflows → Impact charts: uses charts (evidence: `js/dashboard.js`)
- Dashboard workflows → AI insights panel: uses insights (evidence: `js/dashboard.js`)
- API client → Express API: sends HTTP requests (evidence: `README.md`)
- Marketplace map → OSRM routing: requests routes (evidence: `js/map.js`)
- Express API → Authentication routes: mounts routes (evidence: `backend/src/index.js`)
- Express API → Farm profiles: mounts routes (evidence: `backend/src/index.js`)
- Express API → Industry profiles: mounts routes (evidence: `backend/src/index.js`)
- Express API → Marketplace directory: mounts routes (evidence: `backend/src/index.js`)
- Express API → Match discovery: mounts routes (evidence: `backend/src/index.js`)
- Express API → Collaborations: mounts routes (evidence: `backend/src/index.js`)
- Express API → Optimization endpoint: mounts routes (evidence: `backend/src/index.js`)
- Express API → AI endpoint: mounts routes (evidence: `backend/src/index.js`)
- Authentication routes → Prisma client: reads and writes users (evidence: `backend/src/routes/auth.js`)
- Authentication routes → JWT verification: protects profile lookup (evidence: `backend/src/routes/auth.js`)
- Farm profiles → Prisma client: accesses farm data (evidence: `backend/src/routes/farms.js`)
- Industry profiles → Prisma client: accesses industry data (evidence: `backend/src/routes/industries.js`)
- Marketplace directory → Prisma client: reads directory data (evidence: `backend/src/routes/directory.js`)
- Collaborations → Prisma client: accesses collaborations (evidence: `backend/src/routes/collaborations.js`)
- Match discovery → Prisma client: reads profiles (evidence: `backend/src/routes/matches.js`)
- Match discovery → Optimization service: runs optimization (evidence: `backend/src/routes/matches.js`)
- Optimization endpoint → Optimization service: runs optimization (evidence: `backend/src/routes/optimize.js`)
- AI endpoint → Python runner: runs Python service (evidence: `backend/src/routes/ai.js`)
- Optimization service → Python runner: runs scripts (evidence: `backend/src/services/optimizeService.js`)
- Python runner → Biomass optimizer: executes script
- Python runner → AI explainer: executes script
- Biomass optimizer → Distance calculation: uses distance helper (evidence: `backend/python/optimizer.py`)
- Prisma client → Marketplace database: queries
- AI explainer → Ollama service: generates explanations
- AI match review → Ollama service: may use AI service
