How priyanshudas01/bloodnetwork works
Project Type and Purpose
• Full-stack blood donation platform
• React frontend (client) + Node/Express backend (server) + MongoDB database
• Integrates Mapbox for mapping, Google OAuth for authentication, real-time inventory & alerting
File Structure
• Top level: /client (React app), /server (Express API)
• Client: public/, src/ (components grouped by feature: Auth, Bank, User, Main, Util, context)
• Server: app.js, middleware/ (authentication), models/ (Mongoose schemas), routers/ (Express route modules)
Key Components to Illustrate
a. Frontend (React)
– Components (AuthContext, API wrapper)
– UI features: map (Mapbox GL), animations (Framer Motion), routing (React Router), HTTP client (Axios)
– Environment config (REACT_APP_API_URL, MAPBOX_TOKEN)
b. Backend (Node.js/Express)
– Express server entry (app.js)
– Middleware layer (auth.js JWT & Passport)
– Routers: authRouter, bankRouter, campRouter, userRouter
– Controllers (implicit in routers)
– Models (models.js defines User, Bank, Camp schemas via Mongoose)
c. Database
– MongoDB instance (hosted, connection via MONGODB_URI)
– Collections: users, banks, camps, inventory
d. External Services
– Google OAuth2 (GOOGLE_CLIENT_ID/SECRET)
– Mapbox API
– (Optional) Notification/push service for emergency alerts
Relationships and Data Flows
• Frontend → Backend API (HTTP/HTTPS, Axios)
• Auth requests: signup/login → receives JWT
• CRUD: banks, camps, user profiles
• Search/filter: real-time availability, location queries
• Backend → Database (Mongoose ORM)
• Backend → External APIs
• Google OAuth for social login
• Mapbox for map tiles/geocoding
• (Future) push notification service
• Frontend Context (AuthContext) stores JWT, provides to Axios via Authorization header
Architectural Patterns & Design Principles
• Frontend: component-driven UI, single-page app, separation of concerns by feature folder
• Backend: MVC-style separation (Routes → Controllers → Models), middleware for cross-cutting concerns (auth)
• API-first: RESTful routes mapped to resource endpoints
• JWT-based stateless authentication