# nawinsharma/fingerprint-face-verification architecture

> Architecture diagram of the GitHub repository nawinsharma/fingerprint-face-verification, 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/nawinsharma/fingerprint-face-verification
- Repository: https://github.com/nawinsharma/fingerprint-face-verification

## Overview

##### Project Type and Purpose
- This is a full-stack Next.js web application combining frontend pages and backend API routes.
- It provides biometric capture (fingerprint, face), review, registration, and verification against a PostgreSQL database via Supabase and Prisma ORM.
- It also uses NextAuth.js for user authentication.

##### File Structure
- Top-level:
- “src/app” holds Next.js App Router pages (`page.tsx`, `layout.tsx`) and API routes under `src/app/api/*`.
- “src/components” contains React UI components (camera feed, previews, forms, layout sections).
- “src/lib” houses database and Supabase clients, plus utility functions.
- “prisma” folder holds schema (`schema.prisma`) and migration SQL.
- “src/generated/prisma” is the autogenerated Prisma client.
- “scripts” contains Node scripts for generating test data.
- Key configuration: `next.config.ts`, `tsconfig.json`, `tailwind.config.ts`, `prisma/schema.prisma`, `.env` for credentials.
- Authentication: NextAuth configured under `src/app/api/auth/[...nextauth]/route.ts`.

##### README Insights
- Tech stack: Next.js + Tailwind + Framer Motion (frontend), Next.js API + Supabase (backend), Prisma + PostgreSQL (data), NextAuth for credentials.
- Flow: Capture → Preview → Register → Match/Verify.
- Database table: `users` with biometric fields and hash buckets.

##### Main Components & Their Relationships
- Client Browser
- React pages (Next.js App Router) under `src/app/*`.
- UI components for capture, preview, registration, search.
- Next.js Server
- Server-side rendering of pages.
- API routes:
– `/api/auth/*` (NextAuth credentials provider)
– `/api/auth/signup` (user signup)
– `/api/search` (match & verify endpoint)
– `/app/actions/saveUser` (edge function or server action to persist user).
- Authentication Layer
- NextAuth.js managing sessions and credential checks.
- Uses `lib/supabase` or `lib/db` to verify credentials.
- Data Access Layer
- Prisma Client (in `src/lib/db.ts`) surfaces typed methods for CRUD on `User` model.
- Supabase client (in `src/lib/supabase.ts`) may handle direct REST calls or storage.
- Database
- PostgreSQL hosted by Supabase.
- `users` table storing personal info, face_image URL, thumb_image URL, face_hash, thumb_hash, buckets.
- Optional External Services
- Supabase Storage (if images are stored in buckets rather than as base64).
- Edge Runtime (Next.js Edge Functions for low-latency).
- Test Data Script
- `scripts/generate-test-data.ts` invokes Prisma to populate dummy users.

##### Architectural Patterns & Design Principles
- App Router pattern in Next.js separating Layout, Pages, and API routes.
- Server Actions (in `src/app/actions`) to encapsulate backend logic close to UI.
- Single codebase for frontend + backend (monorepo style).
- Typed ORM (Prisma) for compile-time safety.
- Clear separation of concerns:
- UI components vs. API business logic.
- Data access (Prisma) vs. external API wrappers (Supabase).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Browser
    subgraph "Client Browser"
        Browser["Web Browser"]
    end

    %% Frontend Layer
    subgraph "Frontend (Next.js App Router)"
        classDef frontend fill:#E0F7FA,stroke:#006064
        Layout["App Layout (layout.tsx)"]:::frontend
        HomePage["Home Page (page.tsx)"]:::frontend
        CapturePage["Capture Page (capture/page.tsx)"]:::frontend
        SearchPage["Search Page (search/page.tsx)"]:::frontend
        SignInPage["Sign In Page (signin/page.tsx)"]:::frontend
        SignUpPage["Sign Up Page (signup/page.tsx)"]:::frontend
        CameraFeed["CameraFeed Component"]:::frontend
        ImagePreview["ImagePreview Component"]:::frontend
        PersonForm["PersonForm Component"]:::frontend
        NavBar["NavBar Component"]:::frontend
        Footer["Footer Component"]:::frontend

        Browser -->|navigates| HomePage
        Browser -->|navigates| CapturePage
        Browser -->|navigates| SearchPage
        Browser -->|navigates| SignInPage
        Browser -->|navigates| SignUpPage

        HomePage -->|renders| Layout
        CapturePage -->|uses| CameraFeed
        CapturePage -->|uses| ImagePreview
        CapturePage -->|uses| NavBar
        CapturePage -->|uses| Footer
        SearchPage -->|uses| NavBar
        SearchPage -->|uses| Footer
        SignInPage -->|uses| NavBar
        SignUpPage -->|uses| NavBar
        SignUpPage -->|uses| PersonForm
    end

    %% Backend Layer
    subgraph "Backend (Next.js API & Server Actions)"
        classDef backend fill:#E8F5E9,stroke:#1B5E20
        NextAuthAPI["NextAuth API Route"]:::backend
        SignUpAPI["Sign Up API Route"]:::backend
        SearchAPI["Search API Route"]:::backend
        SaveUserAction["Server Action: saveUser"]:::backend

        SignInPage -->|POST credentials| NextAuthAPI
        SignUpPage -->|POST data| SignUpAPI
        PersonForm -->|invoke| SaveUserAction
        SearchPage -->|GET| SearchAPI
    end

    %% Authentication Configuration
    subgraph "Authentication Configuration"
        AuthOptions["NextAuth Options"]:::backend
        Middleware["Route Protection Middleware"]:::backend

        AuthOptions --> NextAuthAPI
        Middleware --> NextAuthAPI
        NextAuthAPI -->|reads/writes| DBAccess
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        classDef data fill:#FFF3E0,stroke:#E65100
        DBAccess["Prisma Client Wrapper"]:::data
        PrismaClient["Autogenerated Prisma Client"]:::data
        SupabaseClient["Supabase Client"]:::data
        Utils["Utility Functions"]:::data

        DBAccess --> PrismaClient
        SignUpAPI -->|CRUD| DBAccess
        SearchAPI -->|CRUD| DBAccess
        SaveUserAction -->|CRUD| DBAccess
        SupabaseClient -->|upload/download| Storage
        NextAuthAPI -->|verify sessions| SupabaseClient
        Utils --> SignUpAPI
        Utils --> SearchAPI
    end

    %% External Services
    subgraph "External Services"
        classDef external fill:#ECEFF1,stroke:#546E7A
        Database["PostgreSQL Database"]:::external
        Storage["Supabase Storage"]:::external
        TestDataScript["Generate Test Data Script"]:::external

        PrismaClient --> Database
        TestDataScript -->|populate| Database
    end

    %% Click Events
    click Layout "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/app/layout.tsx"
    click HomePage "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/app/page.tsx"
    click CapturePage "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/app/capture/page.tsx"
    click SearchPage "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/app/search/page.tsx"
    click SignInPage "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/app/signin/page.tsx"
    click SignUpPage "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/app/signup/page.tsx"
    click CameraFeed "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/components/CameraFeed.tsx"
    click ImagePreview "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/components/ImagePreview.tsx"
    click PersonForm "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/components/PersonForm.tsx"
    click NavBar "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/components/NavBar.tsx"
    click Footer "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/components/Footer.tsx"
    click NextAuthAPI "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/app/api/auth/[...nextauth]/route.ts"
    click SignUpAPI "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/app/api/auth/signup/route.tsx"
    click SearchAPI "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/app/api/search/route.ts"
    click SaveUserAction "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/app/actions/saveUser.ts"
    click AuthOptions "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/app/authOptions.tsx"
    click Middleware "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/middleware.ts"
    click DBAccess "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/lib/db.ts"
    click PrismaClient "https://github.com/nawinsharma/fingerprint-face-verification/tree/main/src/generated/prisma"
    click SupabaseClient "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/lib/supabase.ts"
    click Utils "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/src/lib/utils.ts"
    click TestDataScript "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/scripts/generate-test-data.ts"
    click Database "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/prisma/schema.prisma"
    click Database "https://github.com/nawinsharma/fingerprint-face-verification/blob/main/prisma/migrations/20250511093432_init/migration.sql"
```
