How abhi31raj/bio-query- works
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: query.js Query endpoints · server.js Express API server · auth.js Authentication endpoints · App.tsx Vite application
Components 25
Web interfaces
- Vite application
frontend/src/App.tsx - Query dashboard
frontend/src/pages/Dashboard.tsx - Admin dashboard
frontend/src/pages/AdminDashboard.tsx - Sign-up interface
frontend/src/pages/Auth/SignUp.tsx - Sequence viewer
frontend/src/components/SequenceVisualizationModal.tsx - DNA visualization
frontend/src/pages/DNAVisualization.tsx - Next query endpoint
app/api/query/route.ts
Genomic querying
- Model inference
lib/model-inference.ts - Query endpoints
backend/routes/query.js - Gemini service
backend/utils/geminiService.js - Genomic data service
backend/utils/supabaseService.js - Query history model
backend/models/QueryHistory.js
Identity and access
- Authentication endpoints
backend/routes/auth.js - JWT authorization
backend/middleware/auth.js - User model
backend/models/User.js - OTP model
backend/models/OTP.js
Platform services
- Express API server
backend/server.js - Email delivery
backend/utils/emailService.js - Admin endpoints
backend/routes/admin.js - Contact endpoint
backend/routes/contact.js
Other components
- Researcher
- MongoDB
- Supabase genomic store
- Google Gemini API
- Gmail SMTP
Connections 33
- Researcher → Vite application: uses
frontend/src/App.tsx - Vite application → Query dashboard: routes to
frontend/src/App.tsx - Vite application → Admin dashboard: routes to
frontend/src/App.tsx - Vite application → Sign-up interface: routes to
frontend/src/App.tsx - Query dashboard → Sequence viewer: opens
frontend/src/pages/Dashboard.tsx - Researcher → Next query endpoint: submits query
- Next query endpoint → Model inference: calls
app/api/query/route.ts - Researcher → Express API server: requests API
- Express API server → Query endpoints: mounts
backend/server.js - Express API server → Authentication endpoints: mounts
backend/server.js - Express API server → Admin endpoints: mounts
backend/server.js - Express API server → Contact endpoint: mounts
backend/server.js - Query endpoints → JWT authorization: protects routes
backend/routes/query.js - Query endpoints → Gemini service: generates SQL
backend/routes/query.js - Query endpoints → Genomic data service: executes query
backend/routes/query.js - Query endpoints → Genomic data service: fetches sequence
backend/routes/query.js - Query endpoints → Query history model: saves history
backend/routes/query.js - Query endpoints → Query history model: reads history
backend/routes/query.js - Query endpoints → Gemini service: generates description
backend/routes/query.js - Genomic data service → Supabase genomic store: queries
backend/utils/supabaseService.js - Gemini service → Google Gemini API: requests generation
backend/utils/geminiService.js - Authentication endpoints → User model: reads and writes
backend/routes/auth.js - Authentication endpoints → OTP model: reads and writes
backend/routes/auth.js - Authentication endpoints → Email delivery: sends OTP
backend/routes/auth.js - Email delivery → Gmail SMTP: sends mail
backend/utils/emailService.js - Express API server → MongoDB: connects
backend/server.js - Authentication endpoints → MongoDB: persists auth data
- Admin endpoints → JWT authorization: uses authorization
backend/routes/admin.js - Admin endpoints → Genomic data service: uses genomic service
backend/routes/admin.js - Contact endpoint → Email delivery: sends contact mail
backend/routes/contact.js - Query dashboard → Query endpoints: requests results
- DNA visualization → Query endpoints: requests sequence data
- Sign-up interface → Authentication endpoints: submits credentials