Run the frontend

Follow these steps to run the React app located in university-management-react/.

Prerequisites

• Node.js 18+ and npm

Start (development)

cd university-management-react
npm install
npm start

Then open http://localhost:3000 in your browser.

Build (production)

cd university-management-react
npm run build

That's it.

Backend Development Plan (3 Days)

Day 1: Core Foundation

• FastAPI project setup
• Postgresql database with basic models
• Simple authentication (JWT tokens)
• User registration/login endpoints
• Basic course model and CRUD
• Test with Postman/curl

Day 2: Essential Features

• Course enrollment system
• Basic capacity management
• Simple conflict detection (same course twice)
• Frontend integration
• Fix CORS issues
• Test full flow: register → login → create course → enroll

Day 3: Polish & Deploy

• Error handling and validation
• Basic API documentation
• Fix any integration issues
• Deploy to a simple platform (Railway, Render, or local)
• Final testing
• Documentation

Essential API Endpoints

Authentication

• POST /auth/register
• POST /auth/login
• GET /auth/me

Courses

• GET /courses
• POST /courses (admin only)
• GET /courses/{id}
• PUT /courses/{id} (admin only)
• DELETE /courses/{id} (admin only)

Enrollment

• POST /enrollments
• DELETE /enrollments/{id}
• GET /enrollments/student/{student_id}

Success Criteria

1. ✅ Working authentication - Users can register and login
2. ✅ Admin can create courses - Add/edit/delete courses
3. ✅ Students can enroll - Browse and enroll in courses
4. ✅ Basic validation - Prevent over-enrollment, duplicate enrollment
5. ✅ Frontend integration - React app works with backend
6. ✅ Deployed and accessible - Live URL for testing