feat: add @ottabase/ottaport data import/export package with admin UI

apps/ottabase-template-app-tanstack/ottabase/config.migrations.ts

@@ -38,6 +38,7 @@ import {
     seriesTable,
 } from '@ottabase/ottablog';
 import type { Migration } from '@ottabase/ottaorm';
+import { portJobsTable } from '@ottabase/ottaport';
 import { referralTrackingTable } from '@ottabase/referrals';
 import { shortlinksTable } from '@ottabase/shortlinks';
 import { getOttabaseConfig } from './config.loader';
@@ -68,6 +69,10 @@ const PACKAGE_REGISTRY = {
         tables: { referralTrackingTable },
         migrations: [] as Migration[],
     },
+    ottaport: {
+        tables: { portJobsTable },
+        migrations: [] as Migration[],
+    },
     brandEngine: {
         tables: {
             brandKitsTable,
@@ -88,11 +93,18 @@ const PACKAGE_REGISTRY = {
  */
 export type MigrationPackageName = keyof typeof PACKAGE_REGISTRY;
 
+/** Core packages are always enabled regardless of ottabase.config */
+const CORE_PACKAGES: MigrationPackageName[] = ['brandEngine', 'ottaport'];
+
+function isCorePackage(name: string): boolean {
+    return CORE_PACKAGES.includes(name as MigrationPackageName);
+}
+
 export function getMigrationConfig(env?: Record<string, unknown>): Record<MigrationPackageName, boolean> {
     const config = getOttabaseConfig(env);
     const result: Record<string, boolean> = {};
     for (const pkg of Object.keys(PACKAGE_REGISTRY) as MigrationPackageName[]) {
-        result[pkg] = pkg === 'brandEngine' ? true : (config.packages[pkg as BuiltInPackageName] ?? false);
+        result[pkg] = isCorePackage(pkg) ? true : (config.packages[pkg as BuiltInPackageName] ?? false);
     }
     return result as Record<MigrationPackageName, boolean>;
 }
@@ -109,9 +121,9 @@ export function getEnabledPackageTables(env?: Record<string, unknown>) {
     const config = getOttabaseConfig(env);
     const tables: Record<string, unknown> = {};
 
-    // Built-in packages (brandEngine is core — always included)
+    // Built-in packages (core packages are always included)
     for (const [pkgName, pkgConfig] of Object.entries(PACKAGE_REGISTRY)) {
-        if (pkgName === 'brandEngine' || config.packages[pkgName as BuiltInPackageName]) {
+        if (isCorePackage(pkgName) || config.packages[pkgName as BuiltInPackageName]) {
             Object.assign(tables, pkgConfig.tables);
         }
     }
@@ -134,9 +146,9 @@ export function getEnabledPackageMigrations(env?: Record<string, unknown>): Migr
     const config = getOttabaseConfig(env);
     const migrations: Migration[] = [];
 
-    // Built-in packages (brandEngine is core — always included)
+    // Built-in packages (core packages are always included)
     for (const [pkgName, pkgConfig] of Object.entries(PACKAGE_REGISTRY)) {
-        if ((pkgName === 'brandEngine' || config.packages[pkgName as BuiltInPackageName]) && pkgConfig.migrations) {
+        if ((isCorePackage(pkgName) || config.packages[pkgName as BuiltInPackageName]) && pkgConfig.migrations) {
             migrations.push(...pkgConfig.migrations);
         }
     }

apps/ottabase-template-app-tanstack/ottabase/db/schema.ts

@@ -33,6 +33,7 @@ import {
     postsTable,
     seriesTable,
 } from '@ottabase/ottablog';
+import { portJobsTable } from '@ottabase/ottaport';
 import { referralTrackingTable } from '@ottabase/referrals';
 import { shortlinksTable } from '@ottabase/shortlinks';
 
@@ -55,6 +56,7 @@ export {
     postVersionsTable,
     postsTable,
     seriesTable,
+    portJobsTable,
     referralTrackingTable,
     shortlinksTable,
 };

apps/ottabase-template-app-tanstack/package.json

@@ -48,6 +48,7 @@
         "@ottabase/ottalayout": "workspace:*",
         "@ottabase/ottamenu": "workspace:*",
         "@ottabase/ottaorm": "workspace:*",
+        "@ottabase/ottaport": "workspace:*",
         "@ottabase/ottarenderer": "workspace:*",
         "@ottabase/ottaselect": "workspace:*",
         "@ottabase/ottaupload": "workspace:*",

apps/ottabase-template-app-tanstack/src/pages/admin/AdminIndexPage.tsx

@@ -4,6 +4,7 @@ import { Link } from '@tanstack/react-router';
 import { IconMenu2 } from '@tabler/icons-react';
 import {
     Activity,
+    ArrowLeftRight,
     Bell,
     Building2,
     Clock,
@@ -119,6 +120,13 @@ export function AdminIndexPage() {
             icon: UserPlus,
             disabled: false,
         },
+        {
+            title: 'Data Import/Export',
+            description: 'Import CSV/JSON/TSV data into models or export with filters. Track all operations.',
+            href: '/admin/ottaport',
+            icon: ArrowLeftRight,
+            disabled: false,
+        },
         {
             title: 'Queue Management',
             description: 'Monitor background job queues, view processing stats, and manage failed jobs.',

apps/ottabase-template-app-tanstack/src/pages/admin/ottaport/AdminOttaportPage.tsx

@@ -0,0 +1,71 @@
+// ============================================================
+// OttaPort Admin — Data Import/Export Hub
+// ============================================================
+
+import { useState } from 'react';
+import {
+    Badge,
+    Button,
+    Card,
+    CardContent,
+    CardDescription,
+    CardHeader,
+    CardTitle,
+    Tabs,
+    TabsContent,
+    TabsList,
+    TabsTrigger,
+} from '@ottabase/ui-shadcn';
+import { ArrowDownToLine, ArrowUpFromLine, History } from 'lucide-react';
+import { OttaportImportWizard } from './OttaportImportWizard';
+import { OttaportExportPage } from './OttaportExportPage';
+import { OttaportHistoryPage } from './OttaportHistoryPage';
+
+export function AdminOttaportPage() {
+    const [activeTab, setActiveTab] = useState('import');
+
+    return (
+        <div className="container mx-auto max-w-6xl space-y-6 p-4">
+            <div className="flex items-center justify-between">
+                <div>
+                    <h1 className="text-2xl font-bold">Data Import/Export</h1>
+                    <p className="text-sm text-muted-foreground">
+                        Import data from CSV/JSON/TSV files or export model data with filters
+                    </p>
+                </div>
+                <Badge variant="outline" className="text-xs">
+                    OttaPort
+                </Badge>
+            </div>
+
+            <Tabs value={activeTab} onValueChange={setActiveTab}>
+                <TabsList className="grid w-full grid-cols-3 max-w-md">
+                    <TabsTrigger value="import" className="flex items-center gap-1.5">
+                        <ArrowUpFromLine className="h-3.5 w-3.5" />
+                        Import
+                    </TabsTrigger>
+                    <TabsTrigger value="export" className="flex items-center gap-1.5">
+                        <ArrowDownToLine className="h-3.5 w-3.5" />
+                        Export
+                    </TabsTrigger>
+                    <TabsTrigger value="history" className="flex items-center gap-1.5">
+                        <History className="h-3.5 w-3.5" />
+                        History
+                    </TabsTrigger>
+                </TabsList>
+
+                <TabsContent value="import" className="mt-4">
+                    <OttaportImportWizard />
+                </TabsContent>
+
+                <TabsContent value="export" className="mt-4">
+                    <OttaportExportPage />
+                </TabsContent>
+
+                <TabsContent value="history" className="mt-4">
+                    <OttaportHistoryPage />
+                </TabsContent>
+            </Tabs>
+        </div>
+    );
+}