UniAtlas (atlas.bountools.com) is an intelligence platform and web dashboard combining real-time 2026 YÖK ATLAS scraped program data (21,493 programs) with 2019–2024 Kaggle YKS university admissions analytics (128,000+ historical entries & 1,000,000+ subject net stats).
Complete documentation is organized in the docs/ directory:
- 📘 Project Overview - Scope, goals, problem statement, features.
- 🏗️ System Architecture - Component design, tech stack rationale, container topology.
- 🔄 Data Pipeline & ETL - Header rotators, asyncio scraper, Kaggle dataset integration, SQLite schema.
- 🔌 REST API Reference - FastAPI endpoints, parameters, and response schemas.
- 🛠️ Coding Standards - Development guidelines, Python (
uv), React, and Git conventions. - 🚀 Production Deployment - Dokploy, Docker Swarm stack, custom registry, Traefik SSL.
Requirements: uv (Python 3.12+) and Node.js 22+.
# Clone the repository
git clone [email protected]:fusuyfusuy/uniyok-atlas.git
cd uniyok-atlas
# Install Python dependencies
uv sync
# Run data scraper (fetches 2,150 pages with size 10)
uv run main.py --concurrency 20
# Construct unified database
uv run python build_unified_db.py
# Install & build frontend
cd dashboard-ui && npm install && npm run build && cd ..
# Run backend API server
uv run uvicorn server:app --host 0.0.0.0 --port 8000Access the dashboard at http://localhost:8000/.
# Build production Docker image
docker build -t registry.bogazici.app/budok/uniatlas:latest .
# Run container locally
docker run -p 8000:8000 registry.bogazici.app/budok/uniatlas:latest- Scraped Data: YÖK ATLAS Official Guide (
yokatlas.yok.gov.tr) - Historical Data: Kaggle Turkish University Admissions (
ramazanizci/turkish-university-admissions)