initial commit of mobile app

application/MobileApp/Shared/MobileAppBaseHandler.php

@@ -0,0 +1,113 @@
+<?php
+
+/**
+ * Base Handler for Mobile App endpoints
+ *
+ * All app handlers should extend this class.
+ * Provides common functionality for authentication, permissions, and responses.
+ */
+abstract class MobileAppBaseHandler {
+
+    /** @var object Request object */
+    protected $request;
+
+    /** @var User|null Current user */
+    protected $user;
+
+    /** @var MobileAppController Parent controller */
+    protected $controller;
+
+    /** @var string Required permission for this app (override in subclass) */
+    protected $requiredPermission = null;
+
+    /** @var string App name (used for view rendering) */
+    protected $appName = '';
+
+    /** @var string View template path */
+    protected $viewTemplate = '';
+
+    /**
+     * Constructor
+     */
+    public function __construct($request, $user, $controller) {
+        $this->request = $request;
+        $this->user = $user;
+        $this->controller = $controller;
+    }
+
+    /**
+     * Check if user has required permission
+     * @return bool
+     */
+    public function checkPermission() {
+        // If no permission required, allow access
+        if (!$this->requiredPermission) {
+            return true;
+        }
+
+        // If no user, deny access
+        if (!$this->user || !$this->user->id) {
+            return false;
+        }
+
+        // Check permission
+        return $this->user->can($this->requiredPermission);
+    }
+
+    /**
+     * Render the app view
+     * Override in subclass if custom rendering needed
+     */
+    public function renderView() {
+        $layout = $this->controller->layout();
+
+        // Set template
+        if ($this->viewTemplate) {
+            $layout->setTemplate($this->viewTemplate);
+        } else {
+            $layout->setTemplate("MobileApp/{$this->appName}");
+        }
+
+        // Set default JS globals
+        $layout->set("JSGlobals", $this->getJSGlobals());
+    }
+
+    /**
+     * Get JS globals to pass to frontend
+     * Override in subclass to add app-specific globals
+     */
+    protected function getJSGlobals() {
+        $globals = [
+            'BASE_PATH' => '/MobileApp/' . $this->appName,
+            'APP_NAME' => $this->appName,
+        ];
+
+        if ($this->user && $this->user->id) {
+            $globals['USER_ID'] = $this->user->id;
+            $globals['USER_NAME'] = $this->user->name;
+        }
+
+        return $globals;
+    }
+
+    /**
+     * Return JSON response (shorthand)
+     */
+    protected static function returnJson($data, $statusCode = 200) {
+        mfBaseController::returnJson($data, $statusCode);
+    }
+
+    /**
+     * Get POST data from JSON body
+     */
+    protected function getPostData() {
+        return json_decode(file_get_contents('php://input'), true) ?? [];
+    }
+
+    /**
+     * Get database instance
+     */
+    protected function db() {
+        return FronkDB::singleton();
+    }
+}