karnova

Karnova (React + FastAPI + MongoDB)

A production-ready starter that includes:

• React frontend (Vite)
• FastAPI backend
• MongoDB database
• Admin dashboard to view all users, all user queries, and all raised issues

Default Admin Login

• Username: admin@gmail.com
• Password: admin123

Change admin credentials immediately in production using environment variables.

---

Project Structure

• frontend/ → React application
• backend/ → FastAPI API with MongoDB integration
• backend/.env.example → backend env format
• frontend/.env.example → frontend env format

---

Backend Environment Variables (backend/.env)

Copy backend/.env.example to backend/.env and set values:

JWT_SECRET=replace-with-strong-secret
JWT_EXPIRE_MINUTES=120
FRONTEND_ORIGIN=http://localhost:5173

MONGODB_URI=mongodb+srv://<username>:<password>@<cluster-url>/?retryWrites=true&w=majority
MONGODB_DB_NAME=karnova

ADMIN_EMAIL=admin@gmail.com
ADMIN_PASSWORD=admin123

EMAIL_PROVIDER_API_KEY=replace-email-provider-key
THIRD_PARTY_API_KEY=replace-third-party-key

What each env is for

• JWT_SECRET: signing JWT tokens for auth.
• JWT_EXPIRE_MINUTES: token expiry.
• FRONTEND_ORIGIN: CORS allowlist for frontend URL.
• MONGODB_URI: your MongoDB connection string.
• MONGODB_DB_NAME: database name.
• ADMIN_EMAIL, ADMIN_PASSWORD: seeded admin login.
• EMAIL_PROVIDER_API_KEY, THIRD_PARTY_API_KEY: placeholders for integrations/secrets.

---

Frontend Environment Variables (frontend/.env)

Copy frontend/.env.example to frontend/.env:

VITE_API_BASE_URL=http://localhost:8000

• VITE_API_BASE_URL: backend API base URL.

---

Local Development

1) Backend

cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --host 0.0.0.0 --port 8000 --reload

2) Frontend

cd frontend
npm install
npm run dev

Open http://localhost:5173

---

MongoDB Setup

1. Create a MongoDB Atlas cluster.
2. Create a DB user.
3. Add your IP to Network Access list.
4. Get connection string and set MONGODB_URI.
5. Start backend. Collections (users, user_queries, user_issues) are auto-used.

---

Deploy on Render (Backend)

1. Push code to GitHub.
2. Create Web Service on Render from repo.
3. Root directory: backend.
4. Build command:

   pip install -r requirements.txt
   

5. Start command:

   uvicorn main:app --host 0.0.0.0 --port $PORT
   

6. Add environment variables from backend .env format.
7. Deploy.

Example backend URL after deploy:

• https://your-backend.onrender.com

---

Deploy on Vercel (Frontend)

1. Import repo in Vercel.
2. Set root directory to frontend.
3. Framework preset: Vite.
4. Add env:
   • VITE_API_BASE_URL=https://your-backend.onrender.com
5. Deploy.

---

API Overview

• POST /api/auth/signup → user registration
• POST /api/auth/login → user login
• POST /api/admin/login → admin login
• GET /api/users/me → current user profile
• POST /api/user/queries → submit user query
• POST /api/user/issues → raise user issue
• GET /api/admin/dashboard → admin dashboard data (all users + queries + issues)
• GET /api/health → health check

---

Production Hardening Checklist

• Use very strong JWT_SECRET.
• Use managed MongoDB Atlas with least-privilege DB user.
• Rotate all API keys periodically.
• Restrict CORS to exact frontend domain.
• Add rate limiting and structured logging.
• Add monitoring (Render logs, APM, uptime checks).
• Enable HTTPS-only and secure headers.
• Replace default admin credentials.