refactor(frontend): restructure project layout and update API schema

Relocate frontend source code from `next-app/` to `frontend/` to align with the new project structure. This includes removing the old Next.js boilerplate files and establishing a cleaner workspace. Additionally, updates the OpenAPI specification to include support for the `immich` widget type and its corresponding configuration schema. - Move frontend files to `frontend/` - Delete obsolete `next-app/` directory and its configuration - Add `immich` widget type to `openapi.yaml` - Update `FrontendPlan.md` with dashboard refactor and UX direction
2026-07-29 15:43:48 +00:00 · 2026-05-04 12:31:34 +02:00
parent b17a06fbba
commit 17a579880f
85 changed files with 9441 additions and 947 deletions
@@ -0,0 +1,146 @@
+// Auto-generated from ../openapi/openapi.yaml
+// Run: npm run api:generate
+
+export interface Dashboard {
+  groups: Group[];
+  ungroupedServices: Service[];
+  widgets: WidgetInstance[];
+}
+
+export interface Group {
+  id: string;
+  name: string;
+  sortOrder: number;
+  collapsed: boolean;
+  services: Service[];
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface Service {
+  id: string;
+  groupId: string | null;
+  name: string;
+  iconUrl: string | null;
+  iconAssetId: string | null;
+  sortOrder: number;
+  urls: ServiceUrl[];
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface ServiceUrl {
+  id: string;
+  label: string;
+  kind: "local" | "external" | "custom";
+  url: string;
+  sortOrder: number;
+  isPrimary: boolean;
+}
+
+export interface WidgetInstance {
+  id: string;
+  type: "clock" | "image" | "pihole" | "memos" | "immich";
+  title: string;
+  enabled: boolean;
+  sortOrder: number;
+  config: Record<string, unknown>;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface WidgetData {
+  widgetId: string;
+  status: "fresh" | "stale" | "error";
+  data?: Record<string, unknown>;
+  error?: string | null;
+  fetchedAt?: string | null;
+  expiresAt?: string | null;
+}
+
+export interface AssetFile {
+  id: string;
+  originalName: string;
+  storedName: string;
+  mimeType: string;
+  sizeBytes: number;
+  publicPath: string;
+  createdAt: string;
+}
+
+export interface ErrorResponse {
+  code:
+    | "validation_error"
+    | "not_found"
+    | "conflict"
+    | "upload_too_large"
+    | "unsupported_media_type"
+    | "widget_fetch_failed"
+    | "internal_error";
+  message: string;
+  details: Record<string, unknown> | null;
+}
+
+export interface CreateGroupRequest {
+  name: string;
+}
+
+export interface PatchGroupRequest {
+  name?: string;
+  collapsed?: boolean;
+}
+
+export interface ServiceRequest {
+  groupId?: string | null;
+  name: string;
+  iconUrl?: string | null;
+  iconAssetId?: string | null;
+  urls: ServiceUrlInput[];
+}
+
+export interface ServiceUrlInput {
+  id?: string;
+  label: string;
+  kind: "local" | "external" | "custom";
+  url: string;
+  isPrimary?: boolean;
+}
+
+export interface LayoutRequest {
+  groupIds: string[];
+  widgetIds: string[];
+  ungroupedServiceIds: string[];
+  groupServices: Record<string, string[]>;
+}
+
+export interface WidgetRequest {
+  type: "clock" | "image" | "pihole" | "memos" | "immich";
+  title: string;
+  enabled?: boolean;
+  config: ClockWidgetConfig | ImageWidgetConfig | PiHoleWidgetConfig | MemosWidgetConfig | ImmichWidgetConfig;
+}
+
+export interface ClockWidgetConfig {
+  timezones?: string[];
+}
+
+export interface ImageWidgetConfig {
+  imageUrl: string;
+  linkUrl?: string | null;
+}
+
+export interface PiHoleWidgetConfig {
+  baseUrl: string;
+  apiToken: string;
+}
+
+export interface MemosWidgetConfig {
+  baseUrl: string;
+  apiToken: string;
+  pageSize?: number;
+}
+
+export interface ImmichWidgetConfig {
+  baseUrl: string;
+  apiKey: string;
+}