Skip to content

Latest commit

 

History

History
37 lines (24 loc) · 998 Bytes

ARCHITECTURE.md

File metadata and controls

37 lines (24 loc) · 998 Bytes

Architecture

Overview

MaporaCustomer is a static-exported Next.js landing project designed to run on standard FTP hosting with a lightweight PHP runtime layer.

Layers

1. Presentation Layer

  • Next.js App Router pages
  • Tailwind-based UI components
  • SEO metadata, OpenGraph, JSON-LD

2. Delivery Layer

  • next.config.ts uses output: "export"
  • Build output copied to ftp-dist/
  • Served under public_html on shared hosting

3. Runtime Utilities

  • PHP front-controller for static route fallback
  • PHP endpoint for visit analytics logs
  • JSON storage for analytics (data/visitor-analytics.json)

Request Flow

  1. User opens landing page
  2. Static HTML/CSS/JS served from public_html
  3. On cookie accept, frontend sends analytics POST to /api/analytics/visit.php
  4. PHP endpoint appends masked visit record in JSON storage

Deployment Modes

  • Local Node development: npm run dev
  • Production FTP deployment: npm run ftp:prepare then upload ftp-dist/