AETHER Engine

Spatial Intelligence Engine

Il cuore geometrico di Aether opera in uno spazio cartesiano virtuale dove l'unità di misura fondamentale è il centimetro (cm). Il sistema gestisce la trasformazione tra il mondo reale e la rappresentazione a schermo tramite una pipeline di calibrazione dinamica.

Collision Logic (SAT Implementation)

Per gestire la rotazione arbitraria dei tavoli, Aether implementa il Separating Axis Theorem (SAT). Invece di semplici Bounding Box (AABB), il motore proietta i vertici delle entità su assi normali per rilevare overlap millimetrici.

// Algoritmo di proiezione e rilevamento collisione
function polygonsCollide(pts1, pts2, minGap) {
    const axes = getNormalAxes(pts1).concat(getNormalAxes(pts2));
    for (let axis of axes) {
        const p1 = project(pts1, axis);
        const p2 = project(pts2, axis);
        if (!overlap(p1, p2, minGap)) return false;
    }
    return true;
}

Table Entity Schema

L'entità Table non è un semplice asset grafico, ma un contenitore complesso di proprietà fisiche e stati di occupazione.

{
    name: string,        // ID univoco (es. "Tavolo 12")
    x, y: float,         // Coordinate World-Space in cm
    config: {
        forma: enum,      // round | rect | semi | main_table
        w_cm: int,        // Larghezza/Diametro
        h_cm: int,        // Profondità
        rotazione: float, // Angolo di rotazione in gradi
        optimize55: bool  // Pitch sedute ridotto (55cm vs 60cm)
    },
    guests: Array<Guest> // Slot mappati in base alla forma
}

Guest Entity Schema

Ogni ospite è trattato come un'entità relazionale atomica definita da vincoli di attrazione (Link) e repulsione (Avoid).

{
    uid: string,            // Identificatore univoco globale
    n, ln: string,         // Nome e Cognome
    colorTag: hex,         // Gruppo sociale di appartenenza
    linkedGroupId: string, // UID per prossimità forzata (📎)
    avoidGuestUids: array, // UIDs per repulsione sociale (⛔)
    confirmStatus: enum,   // confirmed | pending | declined
    ageRange: string,      // bambino | ragazzo | adulto | senior
    menuType: string,      // standard | vegan | glutenfree...
    cateringNote: text     // Allergie e intolleranze (Allerta PDF)
}

Heuristic Optimization (The 🪄 Logic)

L'assegnazione dei posti è un problema di ottimizzazione combinatoria. Aether utilizza un'euristica "Greedy with Rebalancing" basata su una Scoring Matrix. Ogni sedia riceve un punteggio dinamico che riflette l'affinità dell'ospite con il contesto circostante.

Rendering Pipeline & Methods

La pipeline di rendering è costruita su un ciclo ad alta frequenza che utilizza requestAnimationFrame. Il disegno è puramente procedurale (vettoriale), garantendo nitidezza a qualsiasi livello di zoom.

Camera Projection System

Aether utilizza un modello di camera virtuale per separare lo spazio dei dati (World) dallo spazio dei pixel (Screen).

// Conversione Screen -> World (Cruciale per il Drag & Drop)
function screenToWorld(clientX, clientY) {
    return { 
        x: (clientX - camera.x) / camera.zoom, 
        y: (clientY - camera.y) / camera.zoom 
    };
}