# plantcareassistant-rncp/plantcareassistant architecture

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

- Interactive diagram: https://gitdiagram.com/plantcareassistant-rncp/plantcareassistant
- Repository: https://github.com/plantcareassistant-rncp/plantcareassistant

## Overview

##### Project type and purpose
- This is a full-stack web application (“PlantCareAssistant”) built with Next.js 13 (“app” directory), React components, and Supabase (database, auth, and storage).
- It exposes RESTful API routes under `app/api/*`, uses Prisma for schema/migrations, and ships as a Dockerized service (see `Dockerfile` and `compose.yml`).

##### File structure
- Top-level “plant-care-assistant” folder houses both frontend UI and backend API in a single Next.js monorepo.
- `app/`: Next.js App Router—the React pages, layouts, and serverless API endpoints (`app/api/.../route.ts`).
- `components/`: Reusable UI (common, features, forms, layout, UI modals).
- `lib/`: Supabase client wrappers for browser (`supabaseClient.ts`) and server (`supabaseServer.ts`).
- `providers/`: React context for Auth.
- `prisma/` & `supabase/`: Database schema, migrations, RLS policies, and seed scripts.
- `tests/`: Unit tests for utils & API validation, E2E tests with Playwright.
- Dev-ops configs: `Dockerfile`, `compose.yml`, GitHub workflows for CI and Playwright.

##### README
- Minimal description (“RNCP Project – Plant Care Assistant”), implying the focus is on plant-care scheduling, social feed, user profiles, events, and image uploads via Supabase Storage.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    subgraph "Client (Browser/UI Layer)"
        Browser["Browser"]:::ui
        Pages["Next.js App Router"]:::ui
        Components["React UI Components"]:::ui
        SupaClient["Supabase Browser Client Wrapper"]:::service
        AuthProvider["Auth Context Provider"]:::service
    end

    %% Server/API Layer
    subgraph "Server/API Layer"
        NextServer["Next.js Server"]:::server
        API["Next.js API Routes"]:::api
        SupaServer["Supabase Server Client Wrapper"]:::service
        Prisma["Prisma ORM"]:::service
        Middleware["Middleware (Auth Session Handling)"]:::service
    end

    %% Data & Storage Layer
    subgraph "Data & Storage Layer"
        DB["Supabase PostgreSQL"]:::db
        AuthService["Supabase Auth"]:::db
        Storage["Supabase Storage"]:::db
    end

    %% DevOps & Testing Layer
    subgraph "DevOps & CI/CD"
        DockerCompose["Docker Compose (Next.js + Supabase)"]:::infra
        Dockerfile["Dockerfile for App Container"]:::infra
        CI["CI Workflow"]:::infra
        E2EWorkflow["E2E Test Workflow"]:::infra
        UnitTests["Jest Unit Tests"]:::infra
        E2ETests["Playwright E2E Tests"]:::infra
    end

    %% Connections
    Browser -->|HTTP/HTTPS| Pages
    Browser -->|fetch| SupaClient
    Pages -->|SSR & data fetching| NextServer
    Pages -->|uses| Components
    Components -->|uses| SupaClient
    Components -->|wraps| AuthProvider

    NextServer -->|handles| API
    NextServer -->|runs middleware| Middleware
    API -->|calls| SupaServer
    API -->|uses| Prisma
    API -->|validates| AuthService
    API -->|uploads/downloads| Storage

    Prisma -->|connects| DB

    DockerCompose -->|orchestrates| NextServer
    DockerCompose -->|orchestrates| DB
    DockerCompose -->|orchestrates| AuthService
    DockerCompose -->|orchestrates| Storage

    CI -->|runs| DockerCompose
    CI -->|triggers| UnitTests
    CI -->|triggers| E2ETests
    E2EWorkflow -->|runs| Playwright
    UnitTests -->|validate| API
    E2ETests -->|test| Browser

    %% Click Events
    click Pages "https://github.com/plantcareassistant-rncp/plantcareassistant/tree/dev/plant-care-assistant/app/"
    click API "https://github.com/plantcareassistant-rncp/plantcareassistant/tree/dev/plant-care-assistant/app/api/"
    click Components "https://github.com/plantcareassistant-rncp/plantcareassistant/tree/dev/plant-care-assistant/components/"
    click SupaClient "https://github.com/plantcareassistant-rncp/plantcareassistant/blob/dev/plant-care-assistant/lib/supabaseClient.ts"
    click SupaServer "https://github.com/plantcareassistant-rncp/plantcareassistant/blob/dev/plant-care-assistant/lib/supabaseServer.ts"
    click AuthProvider "https://github.com/plantcareassistant-rncp/plantcareassistant/blob/dev/plant-care-assistant/providers/AuthProvider.tsx"
    click Prisma "https://github.com/plantcareassistant-rncp/plantcareassistant/blob/dev/plant-care-assistant/prisma/schema.prisma"
    click Prisma "https://github.com/plantcareassistant-rncp/plantcareassistant/tree/dev/plant-care-assistant/prisma/migrations/"
    click seed "https://github.com/plantcareassistant-rncp/plantcareassistant/blob/dev/plant-care-assistant/prisma/seed.ts"
    click supabaseConfig "https://github.com/plantcareassistant-rncp/plantcareassistant/blob/dev/plant-care-assistant/supabase/config.toml"
    click supabaseMigrations "https://github.com/plantcareassistant-rncp/plantcareassistant/tree/dev/plant-care-assistant/supabase/migrations/"
    click Dockerfile "https://github.com/plantcareassistant-rncp/plantcareassistant/tree/dev/plant-care-assistant/Dockerfile"
    click DockerCompose "https://github.com/plantcareassistant-rncp/plantcareassistant/blob/dev/plant-care-assistant/compose.yml"
    click CI "https://github.com/plantcareassistant-rncp/plantcareassistant/blob/dev/.github/workflows/ci.yml"
    click E2EWorkflow "https://github.com/plantcareassistant-rncp/plantcareassistant/blob/dev/.github/workflows/playwright.yml"
    click UnitTests "https://github.com/plantcareassistant-rncp/plantcareassistant/blob/dev/plant-care-assistant/jest.config.ts"
    click UnitTests "https://github.com/plantcareassistant-rncp/plantcareassistant/blob/dev/plant-care-assistant/jest.setup.ts"
    click E2ETests "https://github.com/plantcareassistant-rncp/plantcareassistant/tree/dev/plant-care-assistant/tests/e2e/"
    click UnitTests "https://github.com/plantcareassistant-rncp/plantcareassistant/tree/dev/plant-care-assistant/tests/unit/api/"
    click UnitTests "https://github.com/plantcareassistant-rncp/plantcareassistant/tree/dev/plant-care-assistant/tests/unit/"

    %% Styles
    classDef ui fill:#D0E8FF,stroke:#0366d6
    classDef server fill:#FFE5B4,stroke:#d97706
    classDef api fill:#FFE5B4,stroke:#d97706
    classDef service fill:#CFFFE5,stroke:#059669
    classDef db fill:#D8F5D3,stroke:#059669
    classDef infra fill:#E5E7EB,stroke:#6B7280
```
