You can deploy this model and start earning money today!

ndmaivy/
vvvv

Name: vvvv
Availability: InStock

Views

No views yet

HMI - Learning Management System

Full-stack learning management system with FastAPI backend and Next.js frontend.

Project Structure

hmi/
├── backend/          # FastAPI Python backend
├── frontend/         # Next.js React frontend
└── .venv/           # Shared Python virtual environment

Quick Start

Prerequisites

Python 3.11+
Node.js 18+
MySQL 8.0+
Redis 6.0+

1. Setup Backend

bash

# Install Python dependencies (venv already exists at root)
source .venv/bin/activate
pip install -r backend/requirements.txt

# Configure environment
cd backend
cp .env.example .env
# Edit .env with your database credentials

# Run backend
uvicorn app.main:app --reload --port 8000

Backend will run on http://localhost:8000

API docs: http://localhost:8000/docs

2. Setup Frontend

bash

cd frontend
npm install
npm run dev

Frontend will run on http://localhost:3000

Features

Backend (FastAPI)

✅ JWT Authentication with OAuth2
✅ Role-based access control (Teacher/Learner)
✅ RESTful API with async SQLModel ORM
✅ MySQL database with async driver
✅ Redis integration
✅ Complete learning management schema

Database Schema

Users: Teachers and Learners
Courses: Created by teachers
Topics: Lesson categorization
Lessons: Course content with tutorial URLs
Enrollments: Learner course registration
Lesson Progress: Track completed lessons

Frontend (Next.js)

⚛️ React 19 with Next.js 16
🎨 Tailwind CSS 4
📱 Responsive design
🔐 Authentication integration (to be implemented)

API Endpoints

See backend/README.md for complete API documentation.

Main Routes

/api/v1/login/access-token - Authentication
/api/v1/users/ - User management
/api/v1/courses/ - Course CRUD
/api/v1/lessons/ - Lesson management
/api/v1/topics/ - Topic management
/api/v1/enrollments/ - Course enrollment & progress

Development

Backend Development

bash

cd backend
source ../.venv/bin/activate

# Run with hot reload
uvicorn app.main:app --reload

# Run tests (when implemented)
pytest

Frontend Development

bash

cd frontend

# Development server
npm run dev

# Build for production
npm run build

# Lint code
npm run lint

Database Setup

sql

-- Create database
CREATE DATABASE appdb;

-- Tables are auto-created by SQLModel on startup

For production, use migrations:

bash

cd backend
pip install alembic
alembic init migrations
alembic revision --autogenerate -m "Initial migration"
alembic upgrade head

Environment Variables

Backend (.env)

env

DATABASE_URL=mysql+asyncmy://user:password@127.0.0.1:3306/appdb
REDIS_URL=redis://127.0.0.1:6379/0
SECRET_KEY=your-secret-key-change-in-production

Frontend (.env.local)

NEXT_PUBLIC_API_URL=http://localhost:8000

Docker Deployment (Coming Soon)

docker-compose up

Tech Stack

Backend:

FastAPI
SQLModel + SQLAlchemy (async)
MySQL (asyncmy driver)
Redis
Python-JOSE (JWT)
Pydantic validation

Frontend:

Next.js 16
React 19
Tailwind CSS 4
TypeScript

License

MIT

ndmaivy/vvvv

HMI - Learning Management System

Project Structure

Quick Start

Prerequisites

1. Setup Backend

2. Setup Frontend

Features

Backend (FastAPI)

Database Schema

Frontend (Next.js)

API Endpoints

Main Routes

Development

Backend Development

Frontend Development

Database Setup

Environment Variables

Backend (.env)

Frontend (.env.local)

Docker Deployment (Coming Soon)

Tech Stack

License

ndmaivy/
vvvv