Hvis en bruger aktivt har valgt et personligt tema i sine profilindstillinger ($_SESSION['user_theme'] !== 'system'), har dette absolut førsteprioritet og overstyrer både organisationens tema og globale systemindstillinger.

Hvis brugerens eget tema er sat til system (eller intet er valgt), og brugeren er tilknyttet en organisation i qr_org.db, nedarver brugeren automatisk organisationens tema ($_SESSION['user_org']). Organisationer kan enten vælge et af Studios 14 standardtemaer som udgangspunkt eller skræddersy alle 6 nøglefarver (primær, accent, mørk, baggrund, kant og kort) samt fulde CSS-baggrundsgradienter for 100% white-labeling.

Hvis hverken brugeren eller brugerens organisation har specificeret et tema, anvendes det globale standardtema konfigureret i systemindstillingerne ($sys_settings['theme_mode'] ?? 'light').

Ingen knapper, kort, headers eller tekst må anvende faste hex-farver som #0070f3 eller #1e293b i CSS eller inline-styles. Benyt altid CSS variabler (fx var(--primary), var(--card-bg), var(--dark), var(--border), var(--bg)). Dette muliggør problemfri temaskift og automatisk organisations-white-labeling.

Krydsafhængighed mellem moduler er strengt forbudt (f.eks. må modules/poll aldrig inkludere filer fra modules/qr). Al fælles forretningslogik, sessionshåndtering, adgangskontrol, billedbehandling og globale hjælpefunktioner skal placeres i studio_ravencraft_dk_private/includes/.

Hvert modul har sin egen isolerede SQLite-database i studio_ravencraft_dk_private/databases/ via hjælpefunktionen get_db_path('modulnavn.db'). Databasen skal oprette sine egne tabeller via CREATE TABLE IF NOT EXISTS ved første kørsel og udføre automatiske schema-migrationer, hvis en kolonne mangler.

Alle moduler skal verificere brugerens tilladelse ved start via require_module_access('modul_noegle'). Dette sikrer automatisk håndtering af 14-dages tidsbegrænsede demo-adgange og permanent adgangskontrol.

Undgå at hardcode relative stier som ../../studio_ravencraft_dk_private/ i koden. Studio definerer i stedet den private backend-mappe som en miljøvariabel i .htaccess:

SetEnv STUDIO_PRIVATE_DIR "studio_ravencraft_dk_private"

I roden af Studio findes bootstrap.php, som automatisk udlæser denne variabel og definerer STUDIO_PRIVATE_PATH samt hjælpefunktionen studio_private_path($subpath).

Hurtig staging/produktions-flytning: Når en ny udgave af Studio (fx studiov3) skal idriftsættes, kan den udrulles direkte til produktion blot ved at skifte værdien i .htaccess til den nye mappe (eller omvendt), uden at en eneste PHP-fil i systemet behøver ændres!

I Studio v3 bor alle moduler på deres egne selvstændige subdomæner til ravencraft.dk:

• Hovedportal & Identity Provider: studio.ravencraft.dk (udvikles i studiov3.ravencraft.dk).
• Modul Web-roots: F.eks. flow.ravencraft.dk, buzz.ravencraft.dk, poll.ravencraft.dk.
• Private Modul-mapper: Hvert modul har sin egen isolerede private mappe (fx flow_ravencraft_dk_private/) til sine egne SQLite-databaser og modullogik.

For at undgå klodset, skrøbelig JavaScript-genereret HTML til topbaren og head-injektion, anvender Studio v3 Løsning A: En delt privat kerne i studiov3_ravencraft_dk_private/ (eller studio_ravencraft_dk_private/ i produktion).

Alle subdomæner inkluderer head.php, header.php og header-user.php direkte herfra. Dette sikrer lynhurtig server-side rendering, ensartet design på tværs af platformen og fuld SEO/performance uden DOM-flicker.

En bruger må kun have 1 aktiv session ad gangen. Ved login genereres et unikt current_session_token, som gemmes i databasen og i brugerens session.

Princippet "Ny session vinder": Hvis brugeren logger ind fra en ny enhed eller browser, overskrives tokenet i databasen. Næste gang den ældre session laver en forespørgsel, termineres den automatisk (session_destroy()), og brugeren omdirigeres til login. Samme terminering sker øjeblikkeligt ved ændring af adgangskode.

For at undgå 3-4 API-kald eller databaseopslag pr. sidevisning på subdomænerne, caches alle profil- og organisationsdata direkte i $_SESSION ved login på Studio:

• $_SESSION['user_name'] & $_SESSION['user_avatar'] (fuld CDN URL: https://lib.ravencraft.dk/uploads/avatars/...)
• $_SESSION['user_org'] (indeholder org_name, logo_url som https://lib.ravencraft.dk/uploads/orgs/... samt brandfarver)
• $_SESSION['allowed_features'] (aktive moduler og tilladelser)

Fordi sessionen deles via cookie-domænet .ravencraft.dk, har flow.ravencraft.dk, buzz.ravencraft.dk m.fl. øjeblikkelig adgang til alle claims uden et eneste eksternt kald. Ved profilopdatering overskrives claims i sessionen i realtid.

Subdomæner og moduler henter delte stylesheets (studio_ui.css), webfonts, JavaScript-værktøjer samt brand- og uploadede aktiver (logoer, avatarer) direkte fra det centrale CDN https://lib.ravencraft.dk. Dette styres via miljøvariablen STUDIO_CDN_URL i subdomænets .htaccess:

SetEnv STUDIO_CDN_URL "https://lib.ravencraft.dk"

lib_ravencraft_dk udsender Access-Control-Allow-Origin: * og 1-års browser-caching på alle statiske aktiver, så moduler deler cachen og aldrig oplever cross-origin eller 404-fejl.

Under al udvikling af Studio v3 skal Brandbooket løbende kontrolleres og bekræftes. Der må under ingen omstændigheder indføres nye kontroller, knaptyper, kort-varianter eller formularelementer i Studio v3 uden forudgående godkendelse.

Nye elementer skal altid først godkendes, dokumenteres i Brandbooket og tilføjes til studio_ui.css, før de tages i anvendelse i noget modul.

For at fastholde det overskuelige moduloverblik fra Studio v1 og v2, benytter Studio v3's centrale forside (index.php) et fast 4-kolonne responsivt gitter (.studio-module-grid) til visning af installerede moduler.

• Kun subdomæner: Landingssidens grid viser udelukkende moduler med gyldige subdomæne-adresser (f.eks. https://flow.ravencraft.dk).
• Ingen overflødige badges: Modulkortene må ikke vise tags som "Kerne" eller "Subdomæne", da samtlige moduler i Studio v3 følger subdomæne-arkitekturen.

Opret en dedikeret undermappe i modules/ navngivet med små bogstaver og bindestreger/underscores:

Hvert modul skal indeholde en gyldig module.json fil:

{
    "name": "Studio MitModul",
    "purpose": "Klar og præcis beskrivelse af modulets didaktiske formål på dansk.",
    "status": "development",
    "permission_nodes": [
        "mitmodul"
    ],
    "settings_file": "mitmodul_settings_schema.json",
    "last_change": "2026-10-16 11:19:54",
    "changed_by": "Udvikler Navn"
}

Tilføj tilladelsesnoden og modulets landing-card i studio_ravencraft_dk_private/includes/features.json:

// 1. Under "permissions":
{
    "key": "mitmodul",
    "label": "🚀 Studio MitModul",
    "default_checked": true
}

// 2. Under "landing_cards" (Alle moduler i Studio v3 er subdomæner):
{
    "id": "mitmodul",
    "title": "Studio MitModul",
    "description": "Beskrivelse vist på forsiden i 4-kolonne modul-oversigten.",
    "url": "https://mitmodul.ravencraft.dk",
    "required_features": ["mitmodul"],
    "check_operator": "AND",
    "show_to_guests": true,
    "admin_only": false,
    "style": "",
    "class": "",
    "enabled": true,
    "maintenance": false
}

Tilføj rewrite-regler i rodens .htaccess, så brugerne kan tilgå studio.ravencraft.dk/mitmodul direkte:

# Rewrite /mitmodul to modules/mitmodul/index.php
RewriteRule ^mitmodul/mitmodul\.css$ modules/mitmodul/mitmodul.css [L]
RewriteRule ^mitmodul/?$ modules/mitmodul/index.php [L,QSA]
RewriteRule ^mitmodul/([a-zA-Z0-9_-]+\.php)$ modules/mitmodul/$1 [L,QSA]
RewriteRule ^mitmodul/([a-zA-Z0-9_-]+)$ modules/mitmodul/$1.php [L,QSA]

I toppen af modulets index.php og alle handlinger kaldes require_module_access('modul_noegle'). Dette sikrer:

• Uloggede brugere omdirigeres automatisk til /login.php?redirect=....
• Administratorer godkendes automatisk.
• Brugere med aktiv tilladelse eller en aktiv 14-dages prøveperiode i studio_access.db godkendes automatisk.
• Brugere uden adgang eller med udløbet prøveperiode omdirigeres venligt tilbage til forsiden med en advarselsbesked.

// Inkluder central bootstrap (indlæser .htaccess miljøvariabel, microservices og session)
require_once __DIR__ . '/../../bootstrap.php';

// Beskyt modulet:
require_module_access('mitmodul');

Brug altid get_db_path('mitmodul.db') til at hente stien til databasen. Eksempel på en robust initialiseringsfunktion:

function getMitModulDB(): PDO {
    static $db = null;
    if ($db === null) {
        $dbPath = get_db_path('studio_mitmodul.db');
        $db = new PDO("sqlite:" . $dbPath);
        $db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
        $db->exec("PRAGMA busy_timeout = 5000;");

        // Selvhæftende tabeller:
        $db->exec("CREATE TABLE IF NOT EXISTS mitmodul_items (
            id INTEGER PRIMARY KEY AUTOINCREMENT,
            user_id INTEGER NOT NULL,
            title TEXT NOT NULL,
            description TEXT,
            status TEXT DEFAULT 'active',
            created_at DATETIME DEFAULT CURRENT_TIMESTAMP
        )");
        $db->exec("CREATE INDEX IF NOT EXISTS idx_mitmodul_user ON mitmodul_items(user_id);");
    }
    return $db;
}

Kopiér denne skabelon direkte ind som modules/mitmodul/index.php for at komme i gang på 30 sekunder:

<?php
// modules/mitmodul/index.php
session_start();

// 1. Central bootstrap (indlæser automatisk micro-services og php-user-session via .htaccess)
require_once __DIR__ . '/../../bootstrap.php';

// 2. Håndhæv moduladgang
require_module_access('mitmodul');

$user_id = $_SESSION['user_id'] ?? 0;
?>
<!DOCTYPE html>
<html lang="da">
<head>
    <?php require_once studio_private_path('includes/head.php'); ?>
    <link rel="stylesheet" href="/mitmodul/mitmodul.css?v=1.0">
    <title>Studio MitModul - Didaktisk Værktøj</title>
</head>
<body>

    <header>
        <?php require_once studio_private_path('includes/header.php'); ?>
    </header>

    <!-- Modul Sub-Header -->
    <div class="studio-sub-header">
        <div class="studio-sub-header-nav">
            <span style="font-weight: 700; color: var(--studio-dark);">🚀 Studio MitModul</span>
            <div class="studio-tabs">
                <a href="index.php" class="studio-tab active">Oversigt</a>
                <a href="create.php" class="studio-tab">Opret Ny</a>
            </div>
        </div>
        <div class="studio-sub-header-actions">
            <a href="/" class="studio-btn studio-btn-sm studio-btn-secondary">← Tilbage til Studio</a>
        </div>
    </div>

    <!-- Hovedindhold -->
    <div class="container" style="max-width: 1200px; margin: 30px auto; padding: 0 20px;">
        <div class="studio-card">
            <div class="studio-card-header">
                <h3 class="studio-card-title">Velkommen til MitModul</h3>
                <span class="studio-badge studio-badge-primary">Aktiv</span>
            </div>
            <div class="studio-card-body">
                <p>Dit modul er fuldt integreret med Studio identitet, temaer og adgangskontrol.</p>
            </div>
            <div class="studio-card-footer">
                <button type="button" class="studio-btn studio-btn-secondary">Sekundær Handling</button>
                <button type="button" class="studio-btn studio-btn-primary">Gem & Fortsæt ➜</button>
            </div>
        </div>
    </div>

</body>
</html>

rci.dk er ikke blot begrænset til omdirigeringer. Domænet og dets arkitektur er designet som en udvidelsesparat gateway, der kan rumme en bred vifte af fremtidige funktioner:

• Generisk URL-forkorter & Kampagne-tracking: Tabellen short_urls er allerede forberedt i studio_dynamic_qr.db, så vilkårlige marketing-links, kampagner og vanity-koder kan administreres centralt.
• Mobile Letvægts Mini-Apps: Ligesom afstemnings-kommentarer kører direkte i rci.dk/index.php uden at trække hele Studio-skallen med, kan nye hurtige mikro-interfaces (fx lottotrækninger, hurtig feedback, ja/nej-knapper eller touch-kiosker) afvikles direkte på rci.dk for maksimal fart.
• Hurtig Event- & Stand-Check-in: Scanning af deltager-QR-koder eller adgangskort ved arrangementer og messer uden logintung backend.
• IoT, NFC & Webhook endpoints: Modtagelse af data eller triggere fra fysiske NFC-tags eller hardware-scannere.

Sådan tilføjes et nyt modul eller ny rute til rci.dk:

I rci.dk/index.php tilføjes en ny præfiks-blok. Koden undersøger $prefix og håndterer enten omdirigering eller direkte visning:

// Eksempel: Nyt modul 'mitmodul' kobles på rci.dk (fx rci.dk/m/123 eller rci.dk/mitmodul/123)
if ($prefix === 'mitmodul' || $prefix === 'm') {
    $item_id = $code;
    if (!empty($item_id)) {
        // Valgfrit: Log scanning eller udfør hurtig validering her...
        
        // Viderestil deltageren til modulets mobilvisning:
        header("Location: https://studio.ravencraft.dk/mitmodul/view.php?id=" . urlencode($item_id));
        exit;
    }
}

Det offentlige subdomæne https://lib.ravencraft.dk (mappe: lib_ravencraft_dk/) fungerer som platformens centrale distributionshub for stylesheets, skrifttyper, JavaScript-biblioteker, statiske brand-assets og dynamiske uploads. Det betjener Studio, samtlige subdomæner samt eksterne webapps som infokort.dk:

• CORS & Caching: .htaccess udsender Access-Control-Allow-Origin: * og 1-års browser-cache, så webfonts, scripts og billeder kan hentes på tværs af alle subdomæner uden sikkerhedsfejl eller unødige genhentninger.
• Statiske Brand Assets (assets/img/): Huser globale brandelementer (favicon.ico, favicon.png, default_avatar.webp, header_logo.png).
• Dynamiske Uploads (uploads/): Centraliseret lager for brugeravatarer (uploads/avatars/) og organisationslogoer (uploads/orgs/). Sikrer at underdomæner som flow.ravencraft.dk og buzz.ravencraft.dk aldrig leder lokalt efter uploads med 404-fejl til følge.
• GDPR & Stabilitet: Ingen afhængighed af eksterne CDN'er (som cdnjs eller jsdelivr). Ingen bruger-IP'er lækkes til tredjepartsudbydere.

Server-side PHP biblioteker (som PHPMailer og Composer-pakker) må aldrig placeres i en offentlig web-root. De bor i stedet i lib_ravencraft_dk_private/, placeret uden for webserverens offentlige mappe:

• Delt mellem flere webapps: Både Ravencraft Studio/moduler og eksterne webapps på serveren (f.eks. infokort.dk) inkluderer herfra – kun én central installation at opdatere og vedligeholde.
• Lynhurtig kørsel: Læses direkte fra lokal disk med 0 ms netværks-overhead og fuld PHP OPcache-understøttelse.
• Central Autoloader: Enhver applikation skal blot kalde require_once lib_private_path('autoload.php'); for at aktivere de delte pakker.
• PHPMailer (v7.1.1): Ligger i lib_ravencraft_dk_private/vendor/PHPMailer/ og konfigureres til at sende via Simply.coms officielle mailserver websmtp.simply.com:587 med STARTTLS og SMTP-autentificering for ubegrænset scriptafsendelse.

Hvert modul indeholder i sin private mappe (f.eks. flow_ravencraft_dk_private/config.php) et centralt konfigurationsobjekt. Ingen eksterne URLs må hardcodes direkte i PHP-kildeteksten. Benyt altid de definerede miljø- og konfigurationsværdier:

<?php
/**
 * Eksempel på stand-alone forberedt modulkonfiguration
 * Værdierne overskrives nemt via Apache SetEnv i .htaccess eller .env filer
 */
return [
    'app_name'    => 'Studio Flow',
    'environment' => getenv('APP_ENV') ?: 'production', // 'development' | 'production' | 'standalone'

    // 🌐 Eksterne URLs (Frontend, Identitet & Gateway)
    'urls' => [
        'cdn'      => getenv('STUDIO_CDN_URL')      ?: 'https://lib.ravencraft.dk',
        'portal'   => getenv('STUDIO_PORTAL_URL')   ?: 'https://studio.ravencraft.dk',
        'rci'      => getenv('RCI_SHORT_URL')       ?: 'https://rci.dk',
        'services' => getenv('STUDIO_SERVICES_URL')  ?: 'https://services.ravencraft.dk',
    ],

    // ⚙️ Backend Integrationer
    'backend' => [
        // 'shared_server' når moduler bor sammen, 'standalone' hvis flyttet til egen server
        'driver'           => getenv('STUDIO_BACKEND_MODE') ?: 'shared_server',
        'lib_private_path' => getenv('LIB_PRIVATE_DIR')     ?: __DIR__ . '/../../lib_ravencraft_dk_private',
        'studio_core_path' => getenv('STUDIO_PRIVATE_DIR')  ?: __DIR__ . '/../../studio_ravencraft_dk_private',
    ]
];

De to driftstilstande: