📖 GuestXP Developer Guide

guestxp/
├── index.html              # Main app — login + property manager view
├── super-admin.html        # Super Admin portal (MSP/SA view)
├── api-docs.html           # Interactive API documentation
├── docs.html               # Developer guide (this page)
├── login-preview.html      # Login screen preview
│
├── css/
│   ├── style.css           # Main stylesheet — design tokens, components, topology
│   └── super-admin.css     # Super Admin portal styles — GD tab, SA tabs
│
├── js/
│   ├── api.js              # ★ REST API data access layer (13 namespaces)
│   ├── data.js             # In-memory seed data — properties, APs, guests, SSIDs, VLANs
│   ├── app.js              # Main app logic — tabs, topology, modals, floor plan
│   ├── sa-data.js          # Super Admin seed data — hotel groups, tickets, users
│   └── super-admin.js      # Super Admin UI logic — GD charts, gauges, SA tabs
│
├── images/                 # Static assets
│
└── .tables/                # Database schema definitions (managed by platform)
    └── schema.json

// ─── 1. LIST with pagination ─────────────────────────────
const { data, total } = await GuestXP.PropertiesAPI.list({
  page: 1, limit: 20, search: 'mumbai'
});

// ─── 2. GET single ────────────────────────────────────────
const prop = await GuestXP.PropertiesAPI.get('prop-001');

// ─── 3. CREATE with audit log ─────────────────────────────
const ticket = await GuestXP.TicketsAPI.create({
  property_id:   'prop-001',
  title:         'AP down on floor 3',
  priority:      'high',
  category:      'hardware',
  reporter_name: 'Rahul',
  reporter_role: 'it_manager'
});

// ─── 4. UPDATE (partial) ──────────────────────────────────
await GuestXP.PropertiesAPI.update('prop-001', {
  status: 'warning'
});
// ↑ Automatically writes to audit_log (fire-and-forget)

// ─── 5. Dashboard parallel query ─────────────────────────
const summary = await GuestXP.DashboardAPI.getSummary();
// Runs: PropertiesAPI.getKPIs() + AlertsAPI.getUnreadCount()
//     + TicketsAPI.getKPIs() — all in Promise.all

// ─── 6. Error handling ────────────────────────────────────
try {
  await GuestXP.PropertiesAPI.get('prop-999');
} catch (err) {
  console.error(err.message);  // "GET tables/properties/prop-999 → 404 Not Found"
  showToast('Property not found', 'error');
}

:root {
  /* Brand */
  --primary:        #1a73e8;   /* Google Blue — buttons, links, accents */
  --primary-dark:   #0d5bc7;   /* Hover state */
  --primary-light:  #e8f0fe;   /* Backgrounds, chips */

  /* Status */
  --success:  #16a34a;  --success-bg:  #f0fdf4;
  --warning:  #d97706;  --warning-bg:  #fffbeb;
  --danger:   #dc2626;  --danger-bg:   #fff5f5;

  /* Surface */
  --body-bg:  #f0f4f8;   /* Page background */
  --card-bg:  #ffffff;   /* Card / panel background */
  --border:   #e5e7eb;   /* All borders */

  /* Typography */
  --text:       #1a1f36;  /* Primary text */
  --text-muted: #6b7280;  /* Secondary / label text */

  /* Component */
  --card-radius:  14px;
  --card-shadow:  0 2px 10px rgba(0,0,0,0.06);
}

{
  "id":            "log-1716130800000-x9k2",  // timestamp + random suffix
  "property_id":   "prop-001",               // from window._SA_ACTIVE_PROP
  "user_id":       "usr-001",
  "user_name":     "V. Patel",               // from window._SA_CURRENT_USER
  "user_role":     "super_admin",
  "action":        "UPDATE",                  // CREATE | UPDATE | DELETE
  "resource_type": "property",
  "resource_id":   "prop-001",
  "resource_name": "The Grand Mewar Palace",
  "description":   "UPDATE property \"The Grand Mewar Palace\"",
  "changes":       "{\"status\":\"warning\"}",  // JSON string of changes
  "ip_address":    "",                        // client IP (not available in browser)
  "user_agent":    "Mozilla/5.0 ...",        // first 100 chars
  "occurred_at":   "2025-05-19T10:00:00.000Z",
  "status":        "success"
}