# abhi31raj/bio-query- architecture

> Architecture diagram of the GitHub repository abhi31raj/bio-query-, 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/abhi31raj/bio-query-
- Repository: https://github.com/abhi31raj/bio-query-

## Overview

BioQuery lets users explore genomic records through natural-language questions, with AI-generated SQL, database results, query history, sequence descriptions, and 3D visualization. Its principal backend flow is authenticated query → SQL generation → genomic lookup → history persistence and results; sequence description and full-sequence retrieval are separate endpoints. The repository contains both a Vite/React frontend and a smaller Next.js query interface. README capabilities such as auth, admin, and visualization are represented, but some frontend-to-backend links are unverified in the excerpts.

Main entry points: [`backend/routes/query.js`](https://github.com/abhi31raj/bio-query-/blob/main/backend/routes/query.js) (Query endpoints), [`backend/server.js`](https://github.com/abhi31raj/bio-query-/blob/main/backend/server.js) (Express API server), [`backend/routes/auth.js`](https://github.com/abhi31raj/bio-query-/blob/main/backend/routes/auth.js) (Authentication endpoints), [`frontend/src/App.tsx`](https://github.com/abhi31raj/bio-query-/blob/main/frontend/src/App.tsx) (Vite application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interfaces"]
  node_vite_app["Vite application<br/>[App.tsx]"]
  node_user_dashboard["Query dashboard<br/>[Dashboard.tsx]"]
  node_admin_ui["Admin dashboard<br/>[AdminDashboard.tsx]"]
  node_auth_ui["Sign-up interface<br/>[SignUp.tsx]"]
  node_sequence_modal["Sequence viewer"]
  node_dna_page["DNA visualization"]
  node_next_query["Next query endpoint<br/>[route.ts]"]
end

subgraph group_query["Genomic querying"]
  node_model_inference["Model inference<br/>[model-inference.ts]"]
  node_query_routes["Query endpoints<br/>[query.js]"]
  node_gemini["Gemini service<br/>[geminiService.js]"]
  node_genomic_store["Genomic data service<br/>[supabaseService.js]"]
  node_history_model["Query history model<br/>[QueryHistory.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth_routes["Authentication endpoints<br/>[auth.js]"]
  node_auth_middleware["JWT authorization<br/>[auth.js]"]
  node_user_model["User model<br/>[User.js]"]
  node_otp_model["OTP model<br/>[OTP.js]"]
end

subgraph group_operations["Platform services"]
  node_api_server["Express API server<br/>[server.js]"]
  node_email_service["Email delivery<br/>[emailService.js]"]
  node_admin_routes["Admin endpoints<br/>[admin.js]"]
  node_contact_routes["Contact endpoint<br/>[contact.js]"]
end

node_researcher(("Researcher"))
node_mongo[("MongoDB")]
node_supabase[("Supabase genomic store")]
node_gemini_api["Google Gemini API"]
node_mail_provider["Gmail SMTP"]

node_researcher -->|"uses"| node_vite_app
node_vite_app -->|"routes to"| node_user_dashboard
node_vite_app -->|"routes to"| node_admin_ui
node_vite_app -->|"routes to"| node_auth_ui
node_user_dashboard -->|"opens"| node_sequence_modal
node_researcher -.->|"submits query"| node_next_query
node_next_query -->|"calls"| node_model_inference
node_researcher -.->|"requests API"| node_api_server
node_api_server -->|"mounts"| node_query_routes
node_api_server -->|"mounts"| node_auth_routes
node_api_server -->|"mounts"| node_admin_routes
node_api_server -->|"mounts"| node_contact_routes
node_query_routes -->|"protects routes"| node_auth_middleware
node_query_routes -->|"generates SQL"| node_gemini
node_query_routes -->|"executes query"| node_genomic_store
node_query_routes -->|"fetches sequence"| node_genomic_store
node_query_routes -->|"saves history"| node_history_model
node_query_routes -->|"reads history"| node_history_model
node_query_routes -->|"generates description"| node_gemini
node_genomic_store -->|"queries"| node_supabase
node_gemini -->|"requests generation"| node_gemini_api
node_auth_routes -->|"reads and writes"| node_user_model
node_auth_routes -->|"reads and writes"| node_otp_model
node_auth_routes -->|"sends OTP"| node_email_service
node_email_service -->|"sends mail"| node_mail_provider
node_api_server -->|"connects"| node_mongo
node_auth_routes -.->|"persists auth data"| node_mongo
node_admin_routes -->|"uses authorization"| node_auth_middleware
node_admin_routes -->|"uses genomic service"| node_genomic_store
node_contact_routes -->|"sends contact mail"| node_email_service
node_user_dashboard -.->|"requests results"| node_query_routes
node_dna_page -.->|"requests sequence data"| node_query_routes
node_auth_ui -.->|"submits credentials"| node_auth_routes

click node_vite_app "https://github.com/abhi31raj/bio-query-/blob/main/frontend/src/App.tsx"
click node_user_dashboard "https://github.com/abhi31raj/bio-query-/blob/main/frontend/src/pages/Dashboard.tsx"
click node_admin_ui "https://github.com/abhi31raj/bio-query-/blob/main/frontend/src/pages/AdminDashboard.tsx"
click node_auth_ui "https://github.com/abhi31raj/bio-query-/blob/main/frontend/src/pages/Auth/SignUp.tsx"
click node_sequence_modal "https://github.com/abhi31raj/bio-query-/blob/main/frontend/src/components/SequenceVisualizationModal.tsx"
click node_dna_page "https://github.com/abhi31raj/bio-query-/blob/main/frontend/src/pages/DNAVisualization.tsx"
click node_next_query "https://github.com/abhi31raj/bio-query-/blob/main/app/api/query/route.ts"
click node_model_inference "https://github.com/abhi31raj/bio-query-/blob/main/lib/model-inference.ts"
click node_api_server "https://github.com/abhi31raj/bio-query-/blob/main/backend/server.js"
click node_query_routes "https://github.com/abhi31raj/bio-query-/blob/main/backend/routes/query.js"
click node_gemini "https://github.com/abhi31raj/bio-query-/blob/main/backend/utils/geminiService.js"
click node_genomic_store "https://github.com/abhi31raj/bio-query-/blob/main/backend/utils/supabaseService.js"
click node_history_model "https://github.com/abhi31raj/bio-query-/blob/main/backend/models/QueryHistory.js"
click node_auth_routes "https://github.com/abhi31raj/bio-query-/blob/main/backend/routes/auth.js"
click node_auth_middleware "https://github.com/abhi31raj/bio-query-/blob/main/backend/middleware/auth.js"
click node_user_model "https://github.com/abhi31raj/bio-query-/blob/main/backend/models/User.js"
click node_otp_model "https://github.com/abhi31raj/bio-query-/blob/main/backend/models/OTP.js"
click node_email_service "https://github.com/abhi31raj/bio-query-/blob/main/backend/utils/emailService.js"
click node_admin_routes "https://github.com/abhi31raj/bio-query-/blob/main/backend/routes/admin.js"
click node_contact_routes "https://github.com/abhi31raj/bio-query-/blob/main/backend/routes/contact.js"

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_vite_app,node_user_dashboard,node_admin_ui,node_auth_ui,node_sequence_modal,node_dna_page,node_next_query toneBlue
class node_model_inference,node_query_routes,node_gemini,node_genomic_store,node_history_model,node_mongo,node_supabase toneAmber
class node_auth_routes,node_auth_middleware,node_user_model,node_otp_model,node_gemini_api toneMint
class node_api_server,node_email_service,node_admin_routes,node_contact_routes toneRose
class node_researcher,node_mail_provider toneIndigo
```

## Components

### Web interfaces

- [Vite application](https://github.com/abhi31raj/bio-query-/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Query dashboard](https://github.com/abhi31raj/bio-query-/blob/main/frontend/src/pages/Dashboard.tsx): `frontend/src/pages/Dashboard.tsx`
- [Admin dashboard](https://github.com/abhi31raj/bio-query-/blob/main/frontend/src/pages/AdminDashboard.tsx): `frontend/src/pages/AdminDashboard.tsx`
- [Sign-up interface](https://github.com/abhi31raj/bio-query-/blob/main/frontend/src/pages/Auth/SignUp.tsx): `frontend/src/pages/Auth/SignUp.tsx`
- [Sequence viewer](https://github.com/abhi31raj/bio-query-/blob/main/frontend/src/components/SequenceVisualizationModal.tsx): `frontend/src/components/SequenceVisualizationModal.tsx`
- [DNA visualization](https://github.com/abhi31raj/bio-query-/blob/main/frontend/src/pages/DNAVisualization.tsx): `frontend/src/pages/DNAVisualization.tsx`
- [Next query endpoint](https://github.com/abhi31raj/bio-query-/blob/main/app/api/query/route.ts): `app/api/query/route.ts`

### Genomic querying

- [Model inference](https://github.com/abhi31raj/bio-query-/blob/main/lib/model-inference.ts): `lib/model-inference.ts`
- [Query endpoints](https://github.com/abhi31raj/bio-query-/blob/main/backend/routes/query.js): `backend/routes/query.js`
- [Gemini service](https://github.com/abhi31raj/bio-query-/blob/main/backend/utils/geminiService.js): `backend/utils/geminiService.js`
- [Genomic data service](https://github.com/abhi31raj/bio-query-/blob/main/backend/utils/supabaseService.js): `backend/utils/supabaseService.js`
- [Query history model](https://github.com/abhi31raj/bio-query-/blob/main/backend/models/QueryHistory.js): `backend/models/QueryHistory.js`

### Identity and access

- [Authentication endpoints](https://github.com/abhi31raj/bio-query-/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [JWT authorization](https://github.com/abhi31raj/bio-query-/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [User model](https://github.com/abhi31raj/bio-query-/blob/main/backend/models/User.js): `backend/models/User.js`
- [OTP model](https://github.com/abhi31raj/bio-query-/blob/main/backend/models/OTP.js): `backend/models/OTP.js`

### Platform services

- [Express API server](https://github.com/abhi31raj/bio-query-/blob/main/backend/server.js): `backend/server.js`
- [Email delivery](https://github.com/abhi31raj/bio-query-/blob/main/backend/utils/emailService.js): `backend/utils/emailService.js`
- [Admin endpoints](https://github.com/abhi31raj/bio-query-/blob/main/backend/routes/admin.js): `backend/routes/admin.js`
- [Contact endpoint](https://github.com/abhi31raj/bio-query-/blob/main/backend/routes/contact.js): `backend/routes/contact.js`

### Other components

- **Researcher**
- **MongoDB**
- **Supabase genomic store**
- **Google Gemini API**
- **Gmail SMTP**

## Connections

- Researcher → Vite application: uses (evidence: `frontend/src/App.tsx`)
- Vite application → Query dashboard: routes to (evidence: `frontend/src/App.tsx`)
- Vite application → Admin dashboard: routes to (evidence: `frontend/src/App.tsx`)
- Vite application → Sign-up interface: routes to (evidence: `frontend/src/App.tsx`)
- Query dashboard → Sequence viewer: opens (evidence: `frontend/src/pages/Dashboard.tsx`)
- Researcher → Next query endpoint: submits query
- Next query endpoint → Model inference: calls (evidence: `app/api/query/route.ts`)
- Researcher → Express API server: requests API
- Express API server → Query endpoints: mounts (evidence: `backend/server.js`)
- Express API server → Authentication endpoints: mounts (evidence: `backend/server.js`)
- Express API server → Admin endpoints: mounts (evidence: `backend/server.js`)
- Express API server → Contact endpoint: mounts (evidence: `backend/server.js`)
- Query endpoints → JWT authorization: protects routes (evidence: `backend/routes/query.js`)
- Query endpoints → Gemini service: generates SQL (evidence: `backend/routes/query.js`)
- Query endpoints → Genomic data service: executes query (evidence: `backend/routes/query.js`)
- Query endpoints → Genomic data service: fetches sequence (evidence: `backend/routes/query.js`)
- Query endpoints → Query history model: saves history (evidence: `backend/routes/query.js`)
- Query endpoints → Query history model: reads history (evidence: `backend/routes/query.js`)
- Query endpoints → Gemini service: generates description (evidence: `backend/routes/query.js`)
- Genomic data service → Supabase genomic store: queries (evidence: `backend/utils/supabaseService.js`)
- Gemini service → Google Gemini API: requests generation (evidence: `backend/utils/geminiService.js`)
- Authentication endpoints → User model: reads and writes (evidence: `backend/routes/auth.js`)
- Authentication endpoints → OTP model: reads and writes (evidence: `backend/routes/auth.js`)
- Authentication endpoints → Email delivery: sends OTP (evidence: `backend/routes/auth.js`)
- Email delivery → Gmail SMTP: sends mail (evidence: `backend/utils/emailService.js`)
- Express API server → MongoDB: connects (evidence: `backend/server.js`)
- Authentication endpoints → MongoDB: persists auth data
- Admin endpoints → JWT authorization: uses authorization (evidence: `backend/routes/admin.js`)
- Admin endpoints → Genomic data service: uses genomic service (evidence: `backend/routes/admin.js`)
- Contact endpoint → Email delivery: sends contact mail (evidence: `backend/routes/contact.js`)
- Query dashboard → Query endpoints: requests results
- DNA visualization → Query endpoints: requests sequence data
- Sign-up interface → Authentication endpoints: submits credentials
