How atharvamanchalkar/bynx works
Project type and purpose
• This is a full-stack web application called “Bynx,” designed to manage waste collection operations (bins, routes, maintenance, complaints, tasks, reports, etc.).
• Frontend: React (CRA)
• Backend: Python 3.8+ with FastAPI (via Uvicorn)
• Datastores: MySQL (relational data) and MongoDB (document data)
File structure
• Top‐level splits into bynx-backend/ and bynx-frontend/.
• Backend organizes code by feature:
• app/auth for authentication handlers
• app/crud for data‐access functions per entity
• app/routes for HTTP endpoints grouped by resource
• app/schemas for Pydantic models
• app/database for MySQL and MongoDB connectors
• Frontend follows a standard React directory layout:
• src/pages/ for route‐based views (Dashboard, Login, BinManagement, etc.)
• src/components/ for reusable UI elements (Navbar, Sidebar, Announcements)
• src/api/axios.js to centralize HTTP client configuration
README for additional insights
• Two terminal processes: one for backend (uvicorn app.main:app --reload), one for frontend (npm start).
• Relational (MySQL) and document (MongoDB) databases run locally.
• Environment variables configure DB credentials.
Detailed guidance
• For each feature area (bins, complaints, tasks), show how the React page calls a specific route, how that maps to a CRUD module, and which database is touched
• Shared cross‐cutting concerns like authentication (JWT issuance and validation middleware)
• Startup configuration: .env → Uvicorn launch → DB connections established