Skip to content

Recommendation System For Book Discovery. Current recommendation system takes into account your previous experience of reading and suggests to you the most appropriate books.

Notifications You must be signed in to change notification settings

IU-Capstone-Project-2025/Recommendation-System

Repository files navigation

Recommendation System for Book Discovery

CI/CD Pipeline Docker Compose FastAPI License

Features

  • Personalized book recommendations
  • Reading list management (Read/Reading/Planned)
  • 1-5 star rating system
  • Weekly trending books
  • Books Top

Deployment Guide:

  • The official Keycloak and LDAP containers are run simultaneously via Docker using official guides, and are manually synchronized via user interfaces.
  • Before starting all other components rename file .env.example to .env
  • All other components may be built via one of the following orchestrators: docker/kubernetes. For docker-compose orchestration use docker compose up --build -d tester

Access Points

Environment Service URL Credentials
Local Web UI http://localhost:8000 -
Local Airflow http://localhost:8080 admin/admin
Local Keycloak http://localhost:8081 admin/admin
Local Postgres (backend) http://localhost:5432 admin/admin
Local Postgres (airflow) http://localhost:5433 admin/admin
Local Clickhouse (HTTP connection) http://localhost:8124 admin/admin
Local Clickhouse (TCP connection) http://localhost:9001 admin/admin
Production Live Site https://capstone2.cybertoad.ru -
Production Authentication servises https://capstone.cybertoad.ru -

Architecture

Component Technology
Backend FastAPI
Frontend Jinja2 + HTML + CSS + JS
Auth Keycloak + LDAP
Orchestration Airflow
Transactional DB PostgreSQL
Analytical DB ClickHouse
Infrastructure Docker/Kubernetes

Testing

pytest --cov=src tests/

Code Coverage

Team

Member Role
Denis Troegubov Data Engineer, Team Lead
Timur Garifullin Full-Stack Developer
Peter Zavadskii DevOps Engineer, Algorithm Developer
Adelina Karavaeva Frontend Developer
Grigorii Belyaev Frontend Developer

About

Recommendation System For Book Discovery. Current recommendation system takes into account your previous experience of reading and suggests to you the most appropriate books.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 5