How noemie-gyc/skolinvest works
Project Type & Purpose
• Skolinvest is a full-stack e-learning web application comprised of a Next.js (TypeScript/React) frontend and a Django (Python) backend.
• The goal is to democratize financial education via a client-server architecture, containerized with Docker and coordinated via docker-compose.
File Structure Analysis
• Top level:
• BACK/ → Django project “my_docker_django_app” (models, views, serializers, URL routing v1, authentication app, SQLite DB file).
• FRONT/ → Next.js app (“my_front_app”) organized by app/ (routes, layouts, page.tsx), src/components (UI, forms), src/app/api (Next.js Route Handlers), lib utilities, styles, tests (Unit + E2E).
• CI/CD: .github/workflows/*.yml for linting/tests.
• Orchestration: docker-compose.yml, Taskfile.yml.
Key Technologies & Patterns
• Backend: Django MVC/MTV pattern, DRF-style serializers, SQLite persistence (no dedicated DB container).
• Frontend: Next.js App Router, React components, file-based routing, serverless route.ts API layer that proxies to Django.
• DevOps: Dockerfiles (frontend & backend), volumes for hot reload, docker-compose network, GitHub Actions pipelines.
Main Components & Interactions
a. Client Browser ←→ Frontend Next.js Server
• UI pages & static assets
• Next.js fetches via built-in Route Handlers (/app/api/**)
b. Frontend Route Handlers ←→ Django REST API
• fetchWithAuth.ts calls backend endpoints (e.g. /auth/, /v1/modules, /v1/lessons, /v1/sections)
c. Django App ←→ SQLite Database
• ORM models (Module, Section, Lesson)
• Authentication via custom authentication.py
d. Docker & Network
• frontend container
• backend container
• shared network for HTTP traffic
e. CI/CD Pipeline
• GitHub Actions runs linter.yml (ESLint, pytest), main.yml (build/test).
Architectural Patterns & Principles
• Separation of concerns: UI layer (React), API gateway (Next.js routes), business logic (Django), data layer (SQLite).
• File-based routing in Next.js and versioned API in Django (urls/v1).
• Containerization for isolation and reproducible environments.