# jaimelm5/web_casa_rural_naranja architecture

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

- Interactive diagram: https://gitdiagram.com/jaimelm5/web_casa_rural_naranja
- Repository: https://github.com/jaimelm5/web_casa_rural_naranja

## Overview

##### Project Type and Purpose
- This is a full-stack web application built with Next.js 14, React 18 and TypeScript.
- It serves as a marketing and booking site for a rural house (“Casa Rural Toledo”), featuring pages for gallery, services, location, availability calendar, contact and booking forms.
- A PostgreSQL database holds reservation and availability data, managed via Prisma ORM.

##### File Structure Analysis
- app/
- Implements Next.js App Router: page.tsx files for UI routes; api/ subfolders for serverless endpoints (availability, bookings, rooms, health).
- components/
- Reusable React UI components and a ui/ library folder (accordion, modal, form controls, etc.).
- lib/
- Shared utilities: data adapters (data.ts), database client (db.ts), env variables (env.ts), mock data, types and general helper functions.
- prisma/
- schema.prisma and migration files for PostgreSQL schema.
- hooks/
- Custom React hooks (e.g., use-toast).
- Config files: next.config.js, tailwind.config.ts, postcss.config.js, tsconfig.json, .env (not committed).

##### Key Architecture Insights from README
- Separation of concerns: UI (Next.js pages + React components), API layer (Next.js server functions), data layer (Prisma → PostgreSQL).
- Technical stack: Tailwind CSS for styling, Framer Motion for animations, React Hook Form + Zod for form validation, Date-fns for date handling.

##### Main Components & Interactions
a. Frontend Layer
- Next.js App Router pages (app/page.tsx, app/servicios/page.tsx, etc.)
- UI Components (components/* and components/ui/*)
- Client-side code for interactivity (forms, calendar, modal dialogs)
b. API Layer (Serverless Functions)
- app/api/availability/route.ts: CRUD for availability data
- app/api/bookings/route.ts: Booking submission endpoints
- app/api/rooms/route.ts: Room data retrieval
- app/api/health/route.ts: Health check endpoint
c. Data Access Layer
- Prisma Client (lib/db.ts)
- Schema definitions (prisma/schema.prisma)
- Migrations (prisma/migrations)
d. Database
- PostgreSQL instance hosting tables for rooms, bookings, availability, etc.
e. External Libraries & Services
- React Hook Form & Zod for forms
- Date-fns for date logic
- Framer Motion for animations
- Tailwind CSS for styling
- ENV service (.env file for DATABASE_URL)

##### Architectural Patterns & Principles
- Layered architecture: Presentation → API → Data
- Serverless functions via Next.js App Router
- ORM abstraction (Prisma) hides SQL details
- Componentized UI for reuse and theming (ThemeProvider + Tailwind)
- Validation and business logic separated in API routes

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Browser
    Browser["Browser"]:::external

    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        Landing["Landing Page<br/>(app/page.tsx)"]:::ui
        Servicios["Servicios Page<br/>(app/servicios/page.tsx)"]:::ui
        Galeria["Galería Page<br/>(app/galeria/page.tsx)"]:::ui
        Disponibilidad["Disponibilidad Page<br/>(app/disponibilidad/page.tsx)"]:::ui
        Ubicacion["Ubicación Page<br/>(app/ubicacion/page.tsx)"]:::ui
        Contacto["Contacto Page<br/>(app/contacto/page.tsx)"]:::ui
        Dashboard["Dashboard Page<br/>(app/dashboard/page.tsx)"]:::ui
        Layout["Global Layout<br/>(app/layout.tsx)"]:::ui
        GlobalsCSS["Global Styles<br/>(app/globals.css)"]:::ui
        CoreComponents["Core UI Components<br/>(components/)"]:::ui
        UILibrary["UI Library<br/>(components/ui/)"]:::ui
    end

    %% API Layer
    subgraph "API Layer"
        direction TB
        AvailabilityAPI["Availability API<br/>(app/api/availability/route.ts)"]:::api
        BookingsAPI["Bookings API<br/>(app/api/bookings/route.ts)"]:::api
        RoomsAPI["Rooms API<br/>(app/api/rooms/route.ts)"]:::api
        HealthAPI["Health Check API<br/>(app/api/health/route.ts)"]:::api
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        direction TB
        PrismaClient["Prisma Client<br/>(lib/db.ts)"]:::data
        Schema["Prisma Schema<br/>(prisma/schema.prisma)"]:::data
        Migrations["Prisma Migrations<br/>(prisma/migrations/)"]:::data
        SharedUtils["Shared Utilities & Types<br/>(lib/)"]:::data
        CustomHook["Custom Hook<br/>(hooks/use-toast.ts)"]:::data
    end

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

    %% External Libraries
    subgraph "External Libraries & Services"
        direction TB
        Tailwind["Tailwind CSS"]:::ext
        Framer["Framer Motion"]:::ext
        ReactForm["React Hook Form + Zod"]:::ext
        DateFns["Date-fns"]:::ext
        EnvFile[".env Variables"]:::ext
    end

    %% Connections
    Browser -->|"HTTP GET/POST"| Landing
    Browser --> Servicios
    Browser --> Galeria
    Browser --> Disponibilidad
    Browser --> Ubicacion
    Browser --> Contacto
    Browser --> Dashboard

    %% Frontend to API
    Landing -->|"fetch"| AvailabilityAPI
    Servicios -->|"fetch"| RoomsAPI
    Galeria -->|"fetch"| AvailabilityAPI
    Disponibilidad -->|"POST /api/availability"| AvailabilityAPI
    Contacto -->|"POST /api/bookings"| BookingsAPI
    Dashboard -->|"GET /api/health"| HealthAPI

    CoreComponents --> Layout
    UILibrary --> CoreComponents

    %% API to Data Access
    AvailabilityAPI -->|"ORM: findMany / update"| PrismaClient
    BookingsAPI -->|"ORM: create"| PrismaClient
    RoomsAPI -->|"ORM: findMany"| PrismaClient
    HealthAPI -->|"DB ping"| PrismaClient

    %% Data Access to DB
    PrismaClient -->|"SQL Queries"| PostgreSQL
    Schema --> PrismaClient
    Migrations --> Schema
    SharedUtils --> PrismaClient
    CustomHook --> CoreComponents

    %% External Libraries usage
    Tailwind --> Layout
    Framer --> CoreComponents
    ReactForm --> Contacto
    DateFns --> Disponibilidad
    EnvFile --> PrismaClient

    %% Click Events
    click Landing "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/app/page.tsx"
    click Servicios "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/app/servicios/page.tsx"
    click Galeria "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/app/galeria/page.tsx"
    click Disponibilidad "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/app/disponibilidad/page.tsx"
    click Ubicacion "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/app/ubicacion/page.tsx"
    click Contacto "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/app/contacto/page.tsx"
    click Dashboard "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/app/dashboard/page.tsx"
    click Layout "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/app/layout.tsx"
    click GlobalsCSS "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/app/globals.css"
    click CoreComponents "https://github.com/jaimelm5/web_casa_rural_naranja/tree/main/components/"
    click UILibrary "https://github.com/jaimelm5/web_casa_rural_naranja/tree/main/components/ui/"
    click AvailabilityAPI "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/app/api/availability/route.ts"
    click BookingsAPI "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/app/api/bookings/route.ts"
    click RoomsAPI "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/app/api/rooms/route.ts"
    click HealthAPI "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/app/api/health/route.ts"
    click PrismaClient "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/lib/db.ts"
    click Schema "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/prisma/schema.prisma"
    click Migrations "https://github.com/jaimelm5/web_casa_rural_naranja/tree/main/prisma/migrations/"
    click SharedUtils "https://github.com/jaimelm5/web_casa_rural_naranja/tree/main/lib/"
    click CustomHook "https://github.com/jaimelm5/web_casa_rural_naranja/blob/main/hooks/use-toast.ts"

    %% Styles
    classDef ui fill:#D0E8FF,stroke:#0366d6,stroke-width:1px
    classDef api fill:#E2F8D0,stroke:#228B22,stroke-width:1px
    classDef data fill:#FFE5B4,stroke:#FF8C00,stroke-width:1px
    classDef db fill:#A9A9A9,stroke:#696969,stroke-width:1px
    classDef ext fill:#E6E6FA,stroke:#9370DB,stroke-width:1px
    classDef external fill:#ffffff,stroke:#000000,stroke-width:1px,stroke-dasharray: 5 5
```
