IntelliSlot – Smart Interview Scheduling API

🚀 Project Overview

IntelliSlot is a smart interview scheduling API built with FastAPI, PostgreSQL, and SQLAlchemy.
It resolves calendar conflicts, balances interviewer loads, and automates scheduling.

✨ Features

• REST API built with FastAPI
• PostgreSQL + SQLAlchemy ORM integration
• Calendar conflict resolution
• Load balancing across interviewers
• Dockerized setup for easy deployment
• JWT-based authentication (optional)

🛠️ Tech Stack

• Backend: Python 3.11, FastAPI
• Database: PostgreSQL + SQLAlchemy
• Containerization: Docker, Docker Compose
• Auth: JWT

📦 Setup Instructions

Clone the repo

git clone https://github.com/your-username/intellislot.git
cd intellislot

Create virtual environment

python -m venv venv
source venv/bin/activate   # on macOS/Linux
venv\Scripts\activate      # on Windows

Install dependencies

pip install -r requirements.txt

Run locally

uvicorn app.main:app --reload

Run with Docker

docker build -t intellislot .
docker run -p 8000:8000 intellislot

📡 API Endpoints

Method	Endpoint	Description
POST	/schedule	Schedule a new interview
GET	/interviews	Fetch all scheduled interviews
GET	/interviews/{id}	Fetch interview by ID
DELETE	/interviews/{id}	Cancel interview

🤝 Contribution
	1.	Fork this repo
	2.	Create a new branch (feature-x)
	3.	Commit changes
	4.	Open a PR

See CONTRIBUTING.md for more details.

📜 License

This project is licensed under the MIT License – see LICENSE file for details.

---

## 📄 `.gitignore`

```gitignore
# Python
__pycache__/
*.py[cod]
*.pyo
*.pyd
*.pyc
*.pkl
*.egg-info/

# Virtual env
venv/
.env

# IDE
.vscode/
.idea/

# Mac
.DS_Store

# Logs
*.log

# Coverage
.coverage
htmlcov/


⸻