# kuroxi/thesis-vault architecture

> Architecture diagram of the GitHub repository kuroxi/thesis-vault, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kuroxi/thesis-vault
- Repository: https://github.com/kuroxi/thesis-vault

## Overview

##### Project type and purpose
- This is a full-stack Web application: a Library Management System built on Next.js (React) for the frontend and a TRPC/Prisma/Node backend.
- It follows Clean Architecture and Domain-Driven Design (DDD) to manage resources, users, roles, permissions, and audit logs with scalability in mind.

##### File structure
- Top-level folders:
- src/app – Next.js “app router” pages and layout (UI entry points).
- src/components – reusable React components (admin sidebar, data tables, forms, UI primitives).
- src/api (under src/app) – NextAuth “[…nextauth]” and TRPC route definitions.
- src/modules/user – core business module for user, role, permission, and audit-log DDD layers (domain, use cases, infrastructure, mappers, repositories).
- src/shared – common infrastructure for authentication, database connection, TRPC server/client setup, shared core (errors, result types).
- prisma – database schema.
- Config and infra:
- next.config.mjs, babel.config.json, postcss.config.mjs, tailwind.config.ts
- .env.example for environment variables, Supabase/Postgres connection, Google OAuth credentials.
- pnpm scripts for db:push and dev.

##### README for additional insights
- Confirms Clean Architecture & DDD.
- Describes tech stack: Next.js, pnpm, Supabase PostgreSQL, Google OAuth, Prisma migrations.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Frontend UI Layer"
        UIApp["Next.js app router\n(src/app)"]:::frontend
        UIComp["React components\n(src/components)"]:::frontend
    end

    subgraph "Authentication Layer"
        NextAuth["NextAuth Route Handler"]:::infra
        AuthConfig["Auth Config"]:::infra
        AuthAdapter["Auth Adapter"]:::infra
    end

    subgraph "API Layer (TRPC)"
        TRPCClient["TRPC Client"]:::frontend
        TRPCRoute["Next.js TRPC Route Handler"]:::infra
        TRPCServer["TRPC Server"]:::infra
        TRPCRoutes["TRPC Routes"]:::infra
        TRPCIndex["TRPC Infra"]:::infra
    end

    subgraph "Application Layer (Use Cases)"
        UCUser["User Use Cases"]:::domain
        UCPerm["Permission Use Cases"]:::domain
        UCRole["Role Use Cases"]:::domain
        UCAuditRole["RoleAuditLog Use Cases"]:::domain
        UCAuditUser["UserAuditLog Use Cases"]:::domain
    end

    subgraph "Domain Layer"
        Entities["Entities & Value Objects"]:::domain
        DomainServices["Domain Services"]:::domain
    end

    subgraph "Infrastructure Layer"
        Controllers["HTTP Controllers"]:::infra
        HttpRoutes["HTTP Routes"]:::infra
        Repositories["Prisma Repositories"]:::infra
        Mappers["Mappers & DTOs"]:::infra
    end

    subgraph "Database"
        DB["Supabase PostgreSQL\n(prisma/schema.prisma)"]:::db
        PrismaClient["Prisma Client Init"]:::infra
    end

    subgraph "External Services"
        GoogleOAuth["Google OAuth Provider"]:::external
        Supabase["Supabase PostgreSQL Endpoint"]:::external
    end

    UIApp --> TRPCClient
    UIComp --> TRPCClient
    UIApp --> NextAuth
    TRPCClient --> TRPCRoute
    TRPCRoute --> TRPCServer
    TRPCServer --> Controllers
    TRPCServer --> TRPCRoutes
    TRPCServer --> TRPCIndex
    NextAuth --> AuthConfig
    NextAuth --> AuthAdapter

    Controllers --> HttpRoutes
    Controllers --> UCUser
    Controllers --> UCPerm
    Controllers --> UCRole
    Controllers --> UCAuditRole
    Controllers --> UCAuditUser

    UCUser --> Entities
    UCPerm --> Entities
    UCRole --> Entities
    UCAuditRole --> Entities
    UCAuditUser --> Entities

    UCUser --> DomainServices
    UCPerm --> DomainServices
    UCRole --> DomainServices
    UCAuditRole --> DomainServices
    UCAuditUser --> DomainServices

    UCUser --> Repositories
    UCPerm --> Repositories
    UCRole --> Repositories
    UCAuditRole --> Repositories
    UCAuditUser --> Repositories

    Repositories --> PrismaClient
    PrismaClient --> DB
    PrismaClient --> Supabase

    AuthAdapter --> GoogleOAuth

    classDef frontend fill:#D0E8FF,stroke:#0366d6,color:#0366d6
    classDef domain fill:#DFFFE0,stroke:#22863a,color:#22863a
    classDef infra fill:#FFE5B4,stroke:#d73a49,color:#d73a49
    classDef db fill:#B2F7EF,stroke:#005cc5,color:#005cc5
    classDef external fill:#E8E8E8,stroke:#6a737d,color:#6a737d

    click UIApp "https://github.com/kuroxi/thesis-vault/tree/master/src/app"
    click UIComp "https://github.com/kuroxi/thesis-vault/tree/master/src/components"
    click NextAuth "https://github.com/kuroxi/thesis-vault/blob/master/src/app/api/auth/[...nextauth]/route.ts"
    click AuthConfig "https://github.com/kuroxi/thesis-vault/blob/master/src/shared/infrastructure/authentication/config.ts"
    click AuthAdapter "https://github.com/kuroxi/thesis-vault/blob/master/src/shared/infrastructure/authentication/index.ts"
    click TRPCRoute "https://github.com/kuroxi/thesis-vault/blob/master/src/app/api/trpc/[trpc]/route.ts"
    click TRPCServer "https://github.com/kuroxi/thesis-vault/blob/master/src/shared/infrastructure/trpc/api/server.ts"
    click TRPCClient "https://github.com/kuroxi/thesis-vault/blob/master/src/shared/infrastructure/trpc/api/client.tsx"
    click TRPCRoutes "https://github.com/kuroxi/thesis-vault/blob/master/src/shared/infrastructure/trpc/routes.ts"
    click TRPCIndex "https://github.com/kuroxi/thesis-vault/blob/master/src/shared/infrastructure/trpc/index.ts"
    click UCUser "https://github.com/kuroxi/thesis-vault/tree/master/src/modules/user/src/useCases/user"
    click UCPerm "https://github.com/kuroxi/thesis-vault/tree/master/src/modules/user/src/useCases/permission"
    click UCRole "https://github.com/kuroxi/thesis-vault/tree/master/src/modules/user/src/useCases/role"
    click UCAuditRole "https://github.com/kuroxi/thesis-vault/tree/master/src/modules/user/src/useCases/roleAuditLog"
    click UCAuditUser "https://github.com/kuroxi/thesis-vault/tree/master/src/modules/user/src/useCases/userAuditLog"
    click Entities "https://github.com/kuroxi/thesis-vault/tree/master/src/modules/user/src/domain/models"
    click DomainServices "https://github.com/kuroxi/thesis-vault/tree/master/src/modules/user/src/domain/services"
    click Controllers "https://github.com/kuroxi/thesis-vault/tree/master/src/modules/user/src/infrastructure/http/controllers"
    click HttpRoutes "https://github.com/kuroxi/thesis-vault/tree/master/src/modules/user/src/infrastructure/http/routes"
    click Repositories "https://github.com/kuroxi/thesis-vault/tree/master/src/modules/user/src/repositories"
    click Mappers "https://github.com/kuroxi/thesis-vault/tree/master/src/modules/user/src/mappers"
    click DB "https://github.com/kuroxi/thesis-vault/blob/master/prisma/schema.prisma"
    click PrismaClient "https://github.com/kuroxi/thesis-vault/blob/master/src/shared/infrastructure/database/index.ts"
    click GoogleOAuth "https://github.com/kuroxi/thesis-vault/blob/master/.env.example"
    click Supabase "https://github.com/kuroxi/thesis-vault/blob/master/.env.example"
```
