# solclarus/movie-log architecture

> Architecture diagram of the GitHub repository solclarus/movie-log, 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/solclarus/movie-log
- Repository: https://github.com/solclarus/movie-log

## Overview

##### Project type and purpose
- This is a full-stack web application built with Next.js (App Router).
- It provides localized pages under `app/[locale]` (sign-in, sign-up, dashboard, movie/person/search listings).
- It integrates with:
– An external TMDB API for movie/person data (via `lib/tmdb/*`)
– An authentication layer (via `app/api/auth/[...all]/route.ts` and `lib/auth*`)
– A database (Prisma ORM under `prisma/`) for persisting user records

##### File structure
- app/
– UI routes (SSR/SSG) per locale
– API routes under `app/api/auth`
– React server & client components (pages, layouts)
- components/
– Reusable UI primitives and composite widgets (auth forms, movie-cards, UI library)
- lib/
– Data-access modules (auth-client, record, TMDB client)
- prisma/
– Schema and migration scripts for relational database
- config, constants, env.ts, i18n, hooks, schemas
– Configuration, type definitions, internationalization, request schemas
- next.config.ts, middleware.ts
– Next.js configuration, global middleware (locale detection, auth)

##### Interactions & data flows
- Browser → Next.js Server
– Page requests → SSR/SSG rendering via React server components
– API calls → `app/api/auth` endpoints (login, logout, session)
- Next.js Server → Database
– Prisma client executes queries for user data, records
- Next.js Server → External TMDB API
– TMDB client modules fetch movie/person/search data
- Middleware
– Reads cookies/headers for auth token & locale, routes or redirects

##### Architectural patterns
- React Server Components & Client Components (App Router)
- Modular “lib” layer for external integration & business logic
- Prisma ORM for schema-driven data model
- i18n routing via dynamic `[locale]` segments
- Atomic UI component library for design consistency

##### Technologies & frameworks
- Next.js with App Router, Middleware
- React + TypeScript
- Prisma ORM + PostgreSQL/MySQL
- TMDB REST API wrapper
- Biome/eslint for linting, PostCSS for styling
- Vercel (likely) for deployment/CDN

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    subgraph "Client (Browser)"
        B["Browser"]:::browser
    end

    %% Server Layer
    subgraph "Next.js Server (Node.js)"
        direction TB
        MW["Middleware\n(Locale & Auth Checks)"]:::server
        SSR["App Router\n(UI Routes & Layouts)"]:::server
        API["Auth API Routes\n(app/api/auth)"]:::server
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        Prisma["Prisma Client\n(prisma/schema.prisma)"]:::db
        Record["User Record Access\nlib/record.ts"]:::data
        AuthLib["Auth Logic\nlib/auth.ts"]:::data
        AuthClient["Auth Client\nlib/auth-client.ts"]:::data
    end

    %% External Services
    subgraph "External Services"
        direction TB
        TMDB["TMDB REST API"]:::external
    end

    %% UI Components
    subgraph "UI Component Library"
        direction TB
        UIlib["Atomic UI Components\ncomponents/ui"]:::ui
        Widgets["Reusable Widgets & Primitives\ncomponents"]:::ui
    end

    %% Configuration & i18n
    subgraph "Config & Internationalization"
        direction TB
        Config["Configuration & Constants\nconfig/site.ts"]:::config
        i18n["i18n Modules"]:::config
    end

    %% Data Flows
    B -->|"Requests (SSR/SSG & API)"| MW
    MW -->|"Page/API Routing"| SSR
    MW -->|"Auth Routes"| API
    SSR -->|"Queries/Mutations"| Prisma
    SSR -->|"User Record CRUD"| Record
    SSR -->|"Auth Operations"| AuthLib
    SSR -->|"Client Auth Calls"| AuthClient
    SSR -->|"Fetch Movie/Person Data"| TMDB
    SSR -->|"Renders Pages with UI Components"| UIlib
    SSR -->|"Renders Widgets"| Widgets

    %% Cross-cutting
    Config -.-> SSR
    Config -.-> MW
    i18n -.-> SSR

    %% Click Events
    click MW "https://github.com/solclarus/movie-log/blob/main/middleware.ts"
    click SSR "https://github.com/solclarus/movie-log/tree/main/app/"
    click API "https://github.com/solclarus/movie-log/blob/main/app/api/auth/[...all]/route.ts"
    click Prisma "https://github.com/solclarus/movie-log/blob/main/prisma/schema.prisma"
    click Record "https://github.com/solclarus/movie-log/blob/main/lib/record.ts"
    click AuthLib "https://github.com/solclarus/movie-log/blob/main/lib/auth.ts"
    click AuthClient "https://github.com/solclarus/movie-log/blob/main/lib/auth-client.ts"
    click TMDB "https://github.com/solclarus/movie-log/tree/main/lib/tmdb/"
    click UIlib "https://github.com/solclarus/movie-log/tree/main/components/ui/"
    click Widgets "https://github.com/solclarus/movie-log/tree/main/components/"
    click Config "https://github.com/solclarus/movie-log/blob/main/config/site.ts"
    click i18n "https://github.com/solclarus/movie-log/blob/main/i18n/navigation.ts"

    %% Styles
    classDef browser fill:#FFFBCC,stroke:#F1C40F,stroke-width:2px
    classDef server fill:#CCF5FF,stroke:#3498DB,stroke-width:2px
    classDef db fill:#E8DAEF,stroke:#8E44AD,stroke-width:2px
    classDef data fill:#D5F5E3,stroke:#27AE60,stroke-width:2px
    classDef external fill:#FADBD8,stroke:#E74C3C,stroke-width:2px
    classDef ui fill:#FEF9E7,stroke:#F39C12,stroke-width:2px
    classDef config fill:#EBF5FB,stroke:#5D6D7E,stroke-width:2px
```
