# aliaman11072003/project architecture

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

- Interactive diagram: https://gitdiagram.com/aliaman11072003/project
- Repository: https://github.com/aliaman11072003/project

## Overview

##### Project Type and Purpose
- This is a full-stack web application called “Programming Club Application System,” built with Next.js 14, TypeScript, Tailwind CSS, Shadcn UI, and Supabase.
- It provides a student-facing application form (“apply” pages) and an admin dashboard (“admin” pages), plus underlying API routes and database integration via Supabase.

##### File Structure
- app/
- Contains Next.js routes and layouts.
- app/apply/page.tsx – student application form.
- app/admin/* – admin dashboard, login, reset-password, main listing.
- app/api/health/route.ts – lightweight API health check.
- components/ & components/ui/
- Reusable UI primitives (buttons, dialogs, forms, tables, etc.) based on Shadcn.
- lib/
- lib/supabase.ts – initializes Supabase client.
- lib/types.ts – shared TypeScript interfaces for application data.
- lib/utils.ts/test-connection.ts – helper functions.
- scripts/
- Node/TS scripts to bootstrap the database and create or reset admin users.
- config & tooling
- next.config.mjs, tailwind.config.ts, postcss.config.js/mjs, render.yaml for deployment.
- middleware.ts for any global request handling.

##### README for Additional Insights
- Confirms tech stack, features (authentication, CSV export, search/filter).
- Describes database schema (core_applications table).
- Mentions Render as the target hosting platform.

##### Essential Architectural Elements
- Next.js app router structure (app/apply, app/admin, app/api).
- UI library usage (components/ui) as a shared resource.
- Lib/supabase.ts client as the single integration point with Supabase.
- Deployment to Render and environment variables for Supabase credentials.
- Don’t over-complicate: break the system into these clear layers and interactions for maximum clarity.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend (UI)"
        direction TB
        SAP["Student Application Form"]:::ui
        click SAP "https://github.com/aliaman11072003/project/blob/main/app/apply/page.tsx"
        subgraph "Admin Dashboard"
            direction TB
            ADB["Dashboard Page"]:::ui
            click ADB "https://github.com/aliaman11072003/project/blob/main/app/admin/dashboard/page.tsx"
            ADL["Login Page"]:::ui
            click ADL "https://github.com/aliaman11072003/project/blob/main/app/admin/login/page.tsx"
            ADR["Reset Password Page"]:::ui
            click ADR "https://github.com/aliaman11072003/project/blob/main/app/admin/reset-password/page.tsx"
            ADP["Admin Root Page"]:::ui
            click ADP "https://github.com/aliaman11072003/project/blob/main/app/admin/page.tsx"
        end
        subgraph "Public Routes & Layout"
            direction TB
            APR["Public Page"]:::ui
            click APR "https://github.com/aliaman11072003/project/blob/main/app/page.tsx"
            AL["Layout"]:::ui
            click AL "https://github.com/aliaman11072003/project/blob/main/app/layout.tsx"
            AG["Globals CSS"]:::ui
            click AG "https://github.com/aliaman11072003/project/blob/main/app/globals.css"
        end
    end

    %% UI Primitives & Hooks
    subgraph "UI Primitives & Hooks"
        direction TB
        TP["Theme Provider"]:::ui
        click TP "https://github.com/aliaman11072003/project/blob/main/components/theme-provider.tsx"
        UIP["UI Components"]:::ui
        click UIP "https://github.com/aliaman11072003/project/tree/main/components/ui/"
        MH["use-mobile Hook"]:::ui
        click MH "https://github.com/aliaman11072003/project/blob/main/hooks/use-mobile.tsx"
        TH["use-toast Hook"]:::ui
        click TH "https://github.com/aliaman11072003/project/blob/main/hooks/use-toast.ts"
    end

    %% API Layer
    subgraph "API Layer"
        direction TB
        HC["Health Check API"]:::api
        click HC "https://github.com/aliaman11072003/project/blob/main/app/api/health/route.ts"
    end

    %% Business Logic & Data Access
    subgraph "Business Logic & Data Access"
        direction TB
        SB["Supabase Client"]:::util
        click SB "https://github.com/aliaman11072003/project/blob/main/lib/supabase.ts"
        UT["Utils"]:::util
        click UT "https://github.com/aliaman11072003/project/blob/main/lib/utils.ts"
        TC["Test Connection"]:::util
        click TC "https://github.com/aliaman11072003/project/blob/main/lib/test-connection.ts"
        TY["Types"]:::util
        click TY "https://github.com/aliaman11072003/project/blob/main/lib/types.ts"
    end

    %% Database
    DB["Supabase PostgreSQL"]:::db

    %% Admin Scripts
    subgraph "Admin CLI Scripts"
        direction TB
        SI1["create-admin-user.ts"]:::scripts
        click SI1 "https://github.com/aliaman11072003/project/blob/main/scripts/create-admin-user.ts"
        SI2["create-admin.js"]:::scripts
        click SI2 "https://github.com/aliaman11072003/project/blob/main/scripts/create-admin.js"
        SI3["create-admin.ts"]:::scripts
        click SI3 "https://github.com/aliaman11072003/project/blob/main/scripts/create-admin.ts"
        SI4["reset-admin-password.ts"]:::scripts
        click SI4 "https://github.com/aliaman11072003/project/blob/main/scripts/reset-admin-password.ts"
        SI5["setup-admin.ts"]:::scripts
        click SI5 "https://github.com/aliaman11072003/project/blob/main/scripts/setup-admin.ts"
        SI6["setup-production-admin.js"]:::scripts
        click SI6 "https://github.com/aliaman11072003/project/blob/main/scripts/setup-production-admin.js"
        SI7["setup-database.js"]:::scripts
        click SI7 "https://github.com/aliaman11072003/project/blob/main/scripts/setup-database.js"
        SI8["setup-database.ts"]:::scripts
        click SI8 "https://github.com/aliaman11072003/project/blob/main/scripts/setup-database.ts"
    end

    %% Deployment & Config
    subgraph "Deployment & Configuration"
        direction TB
        RY["Render Config"]:::ext
        click RY "https://github.com/aliaman11072003/project/blob/main/render.yaml"
        NC["Next.js Config"]:::ext
        click NC "https://github.com/aliaman11072003/project/blob/main/next.config.mjs"
        TC2["Tailwind Config"]:::ext
        click TC2 "https://github.com/aliaman11072003/project/blob/main/tailwind.config.ts"
        PC1["PostCSS Config"]:::ext
        click PC1 "https://github.com/aliaman11072003/project/blob/main/postcss.config.js"
        PC2["PostCSS Config MJS"]:::ext
        click PC2 "https://github.com/aliaman11072003/project/blob/main/postcss.config.mjs"
        MD["Middleware"]:::ext
        click MD "https://github.com/aliaman11072003/project/blob/main/middleware.ts"
        TSC1["tsconfig.json"]:::ext
        click TSC1 "https://github.com/aliaman11072003/project/blob/main/tsconfig.json"
        TSC2["Scripts tsconfig.json"]:::ext
        click TSC2 "https://github.com/aliaman11072003/project/blob/main/scripts/tsconfig.json"
    end

    %% Hosting
    RN["Render (Hosting)"]:::ext

    %% Connections
    SAP -->|"calls API"| HC
    ADB -->|"calls API"| HC
    APR -->|"calls API"| HC

    HC -->|"uses Client"| SB
    UT -->|"supports"| SB
    TC -->|"tests"| SB
    SB -->|"reads/writes"| DB
    TY -->|"defines data"| SB

    MH -->|"enhances UI"| SAP
    TH -->|"enhances UI"| SAP

    SI1 -->|"\n"| DB
    SI2 -->|"\n"| DB
    SI3 -->|"\n"| DB
    SI4 -->|"\n"| DB
    SI5 -->|"\n"| DB
    SI6 -->|"\n"| DB
    SI7 -->|"\n"| DB
    SI8 -->|"\n"| DB

    RN -->|"hosts"| SAP
    RN -->|"hosts"| ADB
    RN -->|"hosts"| APR
    RN -->|"hosts"| HC
    RN -->|"runs"| SI1
    RN -->|"runs"| SI5

    %% Styles
    classDef ui fill:#9f6,stroke:#333,stroke-width:1px;
    classDef api fill:#6cf,stroke:#333,stroke-width:1px;
    classDef db fill:#fc6,stroke:#333,stroke-width:1px;
    classDef util fill:#c9f,stroke:#333,stroke-width:1px;
    classDef scripts fill:#ccc,stroke:#333,stroke-width:1px;
    classDef ext fill:#aaa,stroke:#333,stroke-width:1px;
```
