How jaimelm5/web_casa_rural_naranja works
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