# damnko/angular2-django-movies architecture

> Architecture diagram of the GitHub repository damnko/angular2-django-movies, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/damnko/angular2-django-movies
- Repository: https://github.com/damnko/angular2-django-movies

## Overview

##### Project type and purpose
- This is a full-stack two-tier web application.
- Front-end: An Angular2 single-page application (SPA) that handles user registration, authentication, form validation, protected routes, and movie browsing/comments/ratings.
- Back-end: A Django-based REST API that exposes endpoints for auth, user data, movies, comments, and ratings, persisting data in MySQL, and using JWT for stateless authentication.

##### File structure
- Top-level folders:
- angular2-client – contains all Angular2 code (modules, components, services, assets, build configs)
- django-server – contains Django project (“server”) and a Django app (“movies”) with models, views, middleware, migrations, utils.
- Front-end uses modular structure (Core, Movies, User, Shared modules), Webpack for build, Karma for tests.
- Back-end uses standard Django MVC pattern, custom JWT middleware, URL routing, models→migrations, and a Procfile for Heroku, requirements.txt for dependencies.

##### Additional insights from README
- Angular client served via webpack-dev-server or Firebase hosting.
- Django server run locally in a Python virtualenv, configured via .env and settings.py to connect to MySQL.
- Communication between client and server is over HTTP/HTTPS with JSON + JWT tokens.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% User and Browser
    User(["User"]):::external
    Browser(["Browser"]):::external
    User -->|"interacts with"| Browser

    %% Front-end Layer
    subgraph "Front-end (Angular2 SPA)" 
        direction TB
        SPA["Angular2 SPA"]:::frontend
        SPA --> CoreModule
        SPA --> MoviesModule
        SPA --> UserModule
        SPA --> SharedModule

        CoreModule["Core Module"]:::frontend
        MoviesModule["Movies Module"]:::frontend
        UserModule["User Module"]:::frontend
        SharedModule["Shared Module"]:::frontend

        %% Core Module Services
        CoreModule --> AuthGuard["Auth Guard Service"]:::frontend
        CoreModule --> NonAuthGuard["Non-Auth Guard Service"]:::frontend
        CoreModule --> Helpers["Helpers Service"]:::frontend
        CoreModule --> MoviesSvc["Movies Service"]:::frontend
        CoreModule --> UserSvc["User Service"]:::frontend

        %% Movies Feature
        MoviesModule --> MovieList["Movie List Component"]:::frontend
        MoviesModule --> MovieDetails["Movie Details Component"]:::frontend
        MoviesModule --> Comments["Comments Component"]:::frontend
        MoviesModule --> MovieResolver["Movie Detail Resolver Service"]:::frontend
        MoviesModule --> MoviesRouting["Movies Routing"]:::frontend

        %% User Feature
        UserModule --> UserRouting["User Routing"]:::frontend
        UserModule --> AsyncValidators["Async Form Validators Service"]:::frontend

        %% Shared
        SharedModule --> ErrorBar["Error Bar Component"]:::frontend
        SharedModule --> Spinner["Loading Spinner Component"]:::frontend
        SharedModule --> Toolbar["Toolbar Component"]:::frontend
        SharedModule --> Pipes["Shared Pipes"]:::frontend

        %% Build & Hosting
        config["Webpack Configs"]:::infra
        firebase["Firebase Hosting Config"]:::infra
        SPA --> config
        SPA --> firebase

        Browser -->|"loads SPA"| SPA
        SPA -->|"HTTP/HTTPS + JWT"| API
    end

    %% Back-end Layer
    subgraph "Back-end (Django REST API)"
        direction TB
        API["Django API Server"]:::backend
        API --> Settings["Settings & URL Routing"]:::backend
        API --> WSGI["WSGI Entry Point"]:::backend
        API --> Middleware["JWT Authentication Middleware"]:::backend
        API --> ViewsAuth["Auth View Endpoints"]:::backend
        API --> ViewsMovies["Movies View Endpoints"]:::backend
        API --> ViewsComments["Comments View Endpoints"]:::backend
        API --> ViewsRatings["Ratings View Endpoints"]:::backend
        API --> ViewsUser["User Data View Endpoints"]:::backend
        API --> Utils["Utilities & Validators"]:::backend
        API --> Models["Movies Models"]:::backend
        Models --> Migrations["Migrations"]:::backend
        API --> Admin["Admin Registration"]:::backend
        API --> Procfile["Procfile"]:::infra
        API --> Requirements["requirements.txt"]:::infra
        API --> Manage["manage.py"]:::backend

        API -->|"CRUD"| DB
    end

    %% Database
    DB[(MySQL Database)]:::infra

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#004085,color:#004085;
    classDef backend fill:#d4edda,stroke:#155724,color:#155724;
    classDef infra fill:#fff3cd,stroke:#856404,color:#856404;
    classDef external fill:#f8d7da,stroke:#721c24,color:#721c24;

    %% Click Events Front-end
    click SPA "https://github.com/damnko/angular2-django-movies/tree/master/angular2-client/src/app"
    click CoreModule "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/core/core.module.ts"
    click AuthGuard "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/core/services/auth-guard.service.ts"
    click NonAuthGuard "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/core/services/non-auth-guard.service.ts"
    click Helpers "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/core/services/helpers.service.ts"
    click MoviesSvc "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/core/services/movies.service.ts"
    click UserSvc "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/core/services/user.service.ts"
    click MoviesModule "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/movies/movies.module.ts"
    click MoviesRouting "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/movies/movies.routing.ts"
    click MovieList "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/movies/components/movie-list/movie-list.component.ts"
    click MovieDetails "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/movies/components/movie-details/movie-details.component.ts"
    click Comments "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/movies/components/comments/comments.component.ts"
    click MovieResolver "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/movies/services/movie-detail-resolver.service.ts"
    click UserModule "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/user/user.module.ts"
    click UserRouting "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/user/user.routing.ts"
    click AsyncValidators "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/user/services/async-form-validators.service.ts"
    click SharedModule "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/shared/shared.module.ts"
    click ErrorBar "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/shared/components/errorbar/errorbar.component.ts"
    click Spinner "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/shared/components/loading-spinner/loading-spinner.component.ts"
    click Toolbar "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/shared/components/toolbar/toolbar.component.ts"
    click Pipes "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/shared/pipes/errors-to-list.pipe.ts"
    click Pipes "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/src/app/shared/pipes/genres-to-text.pipe.ts"
    click config "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/config/webpack/webpack.common.js"
    click firebase "https://github.com/damnko/angular2-django-movies/blob/master/angular2-client/firebase.json"

    %% Click Events Back-end
    click Settings "https://github.com/damnko/angular2-django-movies/blob/master/django-server/server/settings.py"
    click Settings "https://github.com/damnko/angular2-django-movies/blob/master/django-server/server/urls.py"
    click WSGI "https://github.com/damnko/angular2-django-movies/blob/master/django-server/server/wsgi.py"
    click Models "https://github.com/damnko/angular2-django-movies/blob/master/django-server/movies/models.py"
    click Migrations "https://github.com/damnko/angular2-django-movies/blob/master/django-server/movies/migrations/__init__.py"
    click Admin "https://github.com/damnko/angular2-django-movies/blob/master/django-server/movies/admin.py"
    click ViewsAuth "https://github.com/damnko/angular2-django-movies/blob/master/django-server/movies/views/auth.py"
    click ViewsMovies "https://github.com/damnko/angular2-django-movies/blob/master/django-server/movies/views/movies.py"
    click ViewsComments "https://github.com/damnko/angular2-django-movies/blob/master/django2-server/movies/views/comments.py"
    click ViewsRatings "https://github.com/damnko/angular2-django-movies/blob/master/django-server/movies/views/ratings.py"
    click ViewsUser "https://github.com/damnko/angular2-django-movies/blob/master/django-server/movies/views/user_data.py"
    click Middleware "https://github.com/damnko/angular2-django-movies/blob/master/django-server/movies/middlewares/jwt_authentication.py"
    click Utils "https://github.com/damnko/angular2-django-movies/blob/master/django-server/movies/utils.py"
    click Procfile "https://github.com/damnko/angular2-django-movies/tree/master/django-server/Procfile"
    click Requirements "https://github.com/damnko/angular2-django-movies/blob/master/django-server/requirements.txt"
    click Manage "https://github.com/damnko/angular2-django-movies/blob/master/django-server/manage.py"
```
