🚀 Full Stack Application – Driver's License Portal

---

✨ Overview

A modern full-stack web application built with ❤️ for managing users, roles, questions, and authentication. Features a responsive React frontend and a powerful FastAPI backend.

---

🔐 Features

• ✅ Authentication & Authorization

  • JWT-based system
  • Roles: admin & user
  • Secure login/logout/register flow

• 👤 User Dashboard

  • Edit profile
  • View orders, items, and history

• 🛠️ Admin Panel

  • Manage users and entities
  • View detailed dashboards

---

🧱 Tech Stack

Layer	Tech Used
Frontend	React + Vite, React Router, Redux Toolkit, TailwindCSS, Axios
Backend	FastAPI, SQLAlchemy, Alembic, PostgreSQL, Pydantic, JWT
DevOps	Docker, Docker-Compose, .env configs

---

🚀 Quickstart

1. 📦 Clone the Repository

git clone git@github.com:serejekee/drivers_licence_free.git
cd fullstack-app

---

2. 🐳 Start with Docker

Requires: Docker + Docker Compose installed

docker-compose up --build

---

3. ⚙️ Initialize Database

# Apply migrations
docker-compose exec backend alembic upgrade head

# Create admin user
docker-compose exec backend python create_admin.py

---

4. 🌐 Access App

Part	URL
Frontend	http://localhost:5173
API Docs	http://localhost:8000/docs
Admin Login	http://localhost:5173/admin

Default Admin Credentials:

👤 Username: admin
🔑 Password: admin

---

⚙️ Environment Variables

Create a .env file inside the backend/ folder:

DATABASE_URL=postgresql://postgres:postgres@db:5432/drive
JWT_SECRET_KEY=your-super-secret-jwt-key-change-this-in-production
JWT_ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=60
DEBUG=True

---

🧪 Testing

Run tests for the backend:

cd backend
pytest

---

📸 Screenshots

🖼️ Click to expand

User Dashboard	Admin Panel

---

🪪 License

MIT

📸 How to Add Questions and Photos to Your Driving Test App

IMPORT

---

💡 Tip

Use .env.example as a starting point for new environments or contributors.

📬 Contacts