How gehariharan/zahav works
Project type and purpose
• This is a full‑stack web application called “Zahav” for precious metals trading and booking.
• The backend is a FastAPI service exposing RESTful endpoints for authentication, pricing, bookings, alerts, user management, and shipment tracking.
• The frontend is a React single‑page application offering dashboards, forms, charts, and user workflows.
• There are Docker and Docker Compose recipes for containerized development, plus CI/E2E test workflows.
File structure
• Top‑level “app/” holds two main modules:
• backend/ — Python FastAPI service
– app/main.py: entry point
– app/routes: REST endpoints (auth, users, bookings, prices, alerts)
– app/models + app/db: SQLAlchemy models & DB session
– app/utils: JWT auth helpers
– migrations/: Alembic scripts
– init_db.py: bootstrap sample data
• frontend/ — React app
– public/: static HTML/CSS/manifest assets
– src/: React UI (components, pages, contexts, styles, utils)
– tests/: Playwright E2E specs and unit tests
– package.json, Dockerfile
• docker-compose.yml at app/ root orchestrates services (backend, frontend, database)
• CI workflows under .github/workflows run end-to-end tests.
README for additional insights
• Technology stack: FastAPI, SQLAlchemy, React, Axios, Chart.js, JWT.
• Deployment options: local via batch scripts or Docker Compose.
• External integrations: SMTP/SMS/push for rate alerts, currency feeds, market news.