# pairwise-technologies/ai-interviewer architecture

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

- Interactive diagram: https://gitdiagram.com/pairwise-technologies/ai-interviewer
- Repository: https://github.com/pairwise-technologies/ai-interviewer

## Overview

##### Project type and purpose
- This is a full-stack web application combining:
- A Django-based backend (“ai-interviewer” project plus five Django apps: users, profiles, documents, jobs, locations).
- A React-based frontend under “front-end/app” served (or bundled) via Webpack and Django’s static files.
- Purpose: likely an AI-powered interviewer platform that manages users, profiles, jobs, documents, and locations.

##### File structure
- Top-level
- manage.py
- ai-interviewer/ (Django project settings, routing, WSGI/ASGI entrypoints)
- apps/ (five Django “apps” each with models, views, tests, migrations)
- front-end/ (React app sources, entrypoints App.js, index.js, views/*.jsx)
- static/ (built JS bundle)
- templates/ (base.html for server-side rendered pages)
- webpack.config.js, package.json, requirements.txt
- Architectural hints
- Multi-app Django MVC
- React single-page application served as static bundle
- Django templating for initial page load and API endpoints in views.py files.

##### README
- Minimal: refers to an external quickstart guide; no embedded architecture sections.
- We must infer architecture from code layout.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    ReactApp["Client Browser\n(React SPA)"]:::frontend
    ReactApp -->|"HTTP/REST"| WebServer

    %% Web Server Layer
    WebServer["Web Server\n(Gunicorn/Daphne)"]:::backend
    WebServer -->|"WSGI/ASGI"| DjangoProject

    %% Django Application
    subgraph "Django Application"
        DjangoProject["ai-interviewer"]:::backend
        ManagePy["manage.py"]:::backend
        DjangoProject --> ManagePy
        subgraph "Django Apps"
            UsersApp["Users App"]:::backend
            ProfilesApp["Profiles App"]:::backend
            DocumentsApp["Documents App"]:::backend
            JobsApp["Jobs App"]:::backend
            LocationsApp["Locations App"]:::backend
        end
        DjangoProject -->|"ORM/SQL"| Database
        DjangoProject -->|"Serve Static"| Static
        DjangoProject -->|"Render Templates"| Templates
        DjangoProject -->|"HTTP/REST"| ExternalAI
    end

    %% Database
    Database["Database\n(PostgreSQL/MySQL)"]:::db

    %% Static Assets
    Static["Static Assets Bundle\n(static/index-bundle.js)"]:::frontend

    %% Templates
    Templates["Django Templates\n(templates/base.html)"]:::backend

    %% External Service
    ExternalAI["External AI Service"]:::external

    %% Build & Configuration
    subgraph "Build & Configuration"
        Webpack["webpack.config.js"]:::backend
        PackageJSON["package.json\npackage-lock.json"]:::frontend
        Requirements["requirements.txt"]:::backend
    end
    Webpack --> ReactApp
    PackageJSON --> Webpack
    Requirements --> DjangoProject

    %% Click Events
    click DjangoProject "https://github.com/pairwise-technologies/ai-interviewer/tree/main/ai-interviewer/"
    click ManagePy "https://github.com/pairwise-technologies/ai-interviewer/blob/main/manage.py"
    click UsersApp "https://github.com/pairwise-technologies/ai-interviewer/tree/main/apps/users/"
    click ProfilesApp "https://github.com/pairwise-technologies/ai-interviewer/tree/main/apps/profiles/"
    click DocumentsApp "https://github.com/pairwise-technologies/ai-interviewer/tree/main/apps/documents/"
    click JobsApp "https://github.com/pairwise-technologies/ai-interviewer/tree/main/apps/jobs/"
    click LocationsApp "https://github.com/pairwise-technologies/ai-interviewer/tree/main/apps/locations/"
    click ReactApp "https://github.com/pairwise-technologies/ai-interviewer/tree/main/front-end/app/"
    click Static "https://github.com/pairwise-technologies/ai-interviewer/blob/main/static/index-bundle.js"
    click Templates "https://github.com/pairwise-technologies/ai-interviewer/blob/main/templates/base.html"
    click Webpack "https://github.com/pairwise-technologies/ai-interviewer/blob/main/webpack.config.js"
    click PackageJSON "https://github.com/pairwise-technologies/ai-interviewer/blob/main/package.json"
    click Requirements "https://github.com/pairwise-technologies/ai-interviewer/blob/main/requirements.txt"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366d6,color:#0366d6;
    classDef backend fill:#D6F5D6,stroke:#28a745,color:#28a745;
    classDef db fill:#FFE8B3,stroke:#DB8B00,color:#DB8B00;
    classDef external fill:#E0E0E0,stroke:#8C8C8C,color:#8C8C8C;
```
