# C4 Architecture Document - Level 2: Container Diagram (Landing Page)

Describes the deployable components of the Landing Page system.

## 1. Container List

### 1.1. Sales Landing App (Frontend)
- **Technology**: React, Vite, TailwindCSS.
- **Role**: Provides the interactive interface (Responsive).
- **Features**: Data input forms, Camera capture (for OCR), PDF Viewer, product navigation.

### 1.2. Backend For Frontend (BFF)
- **Technology**: Node.js / Express (or Serverless Functions).
- **Role**: Secures intermediary and API coordinator.
- **Features**:
    - Hides Tokens/Secrets when making calls to the OCR and PDF APIs.
    - Manages user sessions.
    - Sanitizes and normalizes data before dispatching.

### 1.3. Local Storage / Caching DB
- **Technology**: PostgreSQL (or Redis/LocalStorage depending on long-term storage needs). *Based on the requirement to save customer data for future visits, PostgreSQL will be used.*
- **Role**: Stores draft customer information and temporary illustration history.

## 2. Container Diagram

```mermaid
C4Container
    title Container Diagram - Landing Page Sales Party

    Person(sales_agent, "Sales Agent", "Using personal device.")

    System_Boundary(landing_zone, "Landing Page System") {
        Container(web_app, "Sales Landing App", "React/Vite", "Mobile-first user interface.")
        Container(bff_api, "BFF Service", "Node.js", "Intermediary logic and security handler.")
        ContainerDb(local_db, "Client Cache DB", "PostgreSQL", "Stores draft customer information.")
    }

    System_Ext(auth_api, "Auth API", "Authentication")
    System_Ext(ocr_service, "OCR Service", "Image processing")
    System_Ext(pdf_engine, "PDF Engine", "PDF Generation")
    System_Ext(core_system, "Core System", "Stores contracts")

    Rel(sales_agent, web_app, "Interacts", "HTTPS")
    Rel(web_app, bff_api, "API Call", "JSON/HTTPS")
    
    Rel(bff_api, local_db, "Read/Write Customer Data", "SQL")
    Rel(bff_api, auth_api, "Auth Proxy", "REST")
    Rel(bff_api, ocr_service, "Calls OCR", "REST")
    Rel(bff_api, pdf_engine, "Calls PDF Gen", "REST")
    Rel(bff_api, core_system, "Submits application", "REST")
```

---
*Authored by: Agent mbl-landing-page-architecture*
