flatten app to repo root and update docker deployment for single-stack runtime

hooks/use-auth-guard.ts

@@ -0,0 +1,16 @@
+'use client';
+
+export function useAuthGuard() {
+  return {
+    session: {
+      user: {
+        id: 1,
+        name: 'Local Operator',
+        email: 'operator@local.fiscal',
+        image: null
+      }
+    },
+    isPending: false,
+    isAuthenticated: true
+  };
+}

hooks/use-task-poller.ts

@@ -0,0 +1,59 @@
+'use client';
+
+import { useEffect, useState } from 'react';
+import { getTask } from '@/lib/api';
+import type { Task } from '@/lib/types';
+
+type UseTaskPollerInput = {
+  taskId: string | null;
+  intervalMs?: number;
+  onTerminalState?: (task: Task) => void;
+};
+
+export function useTaskPoller({ taskId, intervalMs = 2200, onTerminalState }: UseTaskPollerInput) {
+  const [task, setTask] = useState<Task | null>(null);
+
+  useEffect(() => {
+    if (!taskId) {
+      setTask(null);
+      return;
+    }
+
+    let stopped = false;
+    let timer: ReturnType<typeof setTimeout> | null = null;
+
+    const poll = async () => {
+      try {
+        const { task: latest } = await getTask(taskId);
+
+        if (stopped) {
+          return;
+        }
+
+        setTask(latest);
+
+        if (latest.status === 'completed' || latest.status === 'failed') {
+          onTerminalState?.(latest);
+          return;
+        }
+      } catch {
+        if (stopped) {
+          return;
+        }
+      }
+
+      timer = setTimeout(poll, intervalMs);
+    };
+
+    void poll();
+
+    return () => {
+      stopped = true;
+      if (timer) {
+        clearTimeout(timer);
+      }
+    };
+  }, [taskId, intervalMs, onTerminalState]);
+
+  return task;
+}