📷🥯 ↝ [SSG-281 SSF-9]: Viewport extensions - Merge pull request #205 from Signal-K/SSG-281

🍓📷 ↝ [SSG-281 SSF-9]: Viewport extensions

Author: Gizmotronn

.DS_Store

@@ -0,0 +1,25 @@
+name: Delete Push Anomaly Log
+
+on:
+  schedule:
+    # Run at 00:00 AEST every Sunday (AEST is UTC+10, so 14:00 UTC Saturday)
+    - cron: '0 14 * * 6'
+  workflow_dispatch:
+
+jobs:
+  delete-push-anomaly-log:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - name: Setup Go
+        uses: actions/setup-go@v4
+        with:
+          go-version: '1.21'
+      - name: Install dependencies
+        run: go mod tidy
+      - name: Delete push anomaly log
+        env:
+          SUPABASE_URL: ${{ secrets.NEXT_PUBLIC_SUPABASE_URL }}
+          SUPABASE_SERVICE_ROLE_KEY: ${{ secrets.SUPABASE_SERVICE_ROLE_KEY }}
+        run: go run scripts/delete_push_anomaly_log.go

.github/workflows/delete-push-anomaly-log.yml

@@ -0,0 +1,29 @@
+name: Unlock SolarHealth Anomalies
+
+on:
+  schedule:
+    # Run every 24 hours
+    - cron: '0 0 * * *'
+  push:
+    branches: [ '*' ]
+  workflow_dispatch:
+
+jobs:
+  unlock-solarhealth-anomalies:
+    if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch' || (github.event_name == 'push' && contains(github.event.head_commit.message, 'SSM-257'))
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'yarn'
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+      - name: Unlock SolarHealth anomalies
+        env:
+          SUPABASE_URL: ${{ secrets.NEXT_PUBLIC_SUPABASE_URL }}
+          SUPABASE_SERVICE_ROLE_KEY: ${{ secrets.SUPABASE_SERVICE_ROLE_KEY }}
+        run: node scripts/unlock-solarhealth-anomalies.js

.github/workflows/unlock-solarhealth-anomalies.yml

@@ -24,6 +24,11 @@ venv
 /.next/
 /out/
 
+storage_downloads/
+.storage_downloads/
+/storage_downloads/
+/.storage_downloads/
+
 # production
 /build
 

.gitignore

@@ -0,0 +1,207 @@
+# WARP.md
+
+This file provides guidance to WARP (warp.dev) when working with code in this repository.
+
+## Project Overview
+
+**Star Sailors** is a Next.js 14 application for space exploration, citizen science, and data classification. It features a complex user-centric architecture with components organized around user mechanics (classification, deployment, discovery, research, social, profile) rather than technical implementation.
+
+## Common Development Commands
+
+### Local Development
+```bash
+# Start development server (recommended)
+yarn dev
+# or using Makefile
+make dev
+
+# Install dependencies
+yarn install
+# or
+make install
+
+# Build application
+yarn build
+# or
+make build-app
+```
+
+### Database Operations (Drizzle ORM + Supabase)
+```bash
+# Generate database schema
+yarn db:generate
+
+# Push schema changes to database
+yarn db:push
+
+# Open Drizzle Studio (database UI)
+yarn db:studio
+# or via Docker
+make db-studio
+
+# Database migrations
+yarn db:migrate
+```
+
+### Testing
+
+#### Unit Testing (Vitest)
+```bash
+# Run unit tests
+yarn test:unit
+
+# Run unit tests in watch mode
+yarn test:unit:watch
+
+# Run unit tests in Docker (isolated)
+yarn docker:test:unit
+```
+
+#### E2E Testing (Cypress)
+```bash
+# Run E2E tests headless
+yarn test:e2e
+
+# Run E2E tests with Cypress UI
+yarn test:e2e:open
+
+# Run E2E tests with user creation (local)
+yarn test:e2e:local
+
+# Run E2E tests in Docker
+yarn docker:test:e2e
+yarn docker:test:e2e:local
+```
+
+#### Comprehensive Testing
+```bash
+# Run all tests (unit + E2E)
+yarn test:all
+yarn docker:test:all
+
+# Clean Docker test resources
+yarn docker:test:clean
+```
+
+### Docker Operations
+```bash
+# Development with Docker
+docker-compose up
+# or
+make up
+
+# Production deployment
+docker-compose -f docker-compose.prod.yml up -d
+# or
+make prod-up
+
+# Test environment
+docker-compose -f docker-compose.test.yml --profile unit up
+docker-compose -f docker-compose.test.yml --profile e2e up
+```
+
+### Linting and Code Quality
+```bash
+# Next.js linting
+yarn lint
+
+# Detect unused dependencies
+yarn knip
+```
+
+### Single Test Execution
+```bash
+# Run specific Cypress test
+npx cypress run --spec "cypress/e2e/specific-test.cy.ts"
+
+# Run specific unit test
+npx vitest run path/to/test.test.ts
+
+# Run tests matching pattern
+npx vitest run --reporter=verbose --grep "test pattern"
+```
+
+## Architecture Overview
+
+### File Organization
+The codebase uses a **user-centric component architecture** rather than technical grouping:
+
+- **`src/components/classification/`** - Image/data classification mechanics (viewports, telescopes, AI tools)
+- **`src/components/deployment/`** - Structure & mission deployment (buildings, equipment, missions)
+- **`src/components/discovery/`** - Exploration & data discovery (planets, anomalies, weather)
+- **`src/components/research/`** - Scientific progression (projects, skill trees)
+- **`src/components/social/`** - Community features (comments, posts, activity)
+- **`src/components/profile/`** - User management (auth, dashboard, inventory)
+- **`src/components/ui/`** - Reusable UI components
+- **`src/components/layout/`** - Application layout components
+
+### Core Architecture
+- **`app/`** - Next.js 14 App Router with file-based routing
+- **`src/core/`** - Core application logic and context providers
+- **`src/shared/`** - Shared utilities and helper functions
+- **`lib/`** - External library configurations
+- **`hooks/`** - Custom React hooks
+- **`types/`** - TypeScript type definitions
+
+### Key Technologies
+- **Frontend**: Next.js 14, React 18, TypeScript, Tailwind CSS
+- **Database**: Supabase with Drizzle ORM (PostgreSQL)
+- **3D Graphics**: Three.js with React Three Fiber
+- **Testing**: Vitest (unit), Cypress (E2E)
+- **Styling**: Tailwind CSS, Radix UI, Framer Motion
+- **Auth**: Supabase Auth with NextAuth helpers
+
+### Import Patterns
+```typescript
+// Absolute imports using @ alias
+import { Component } from '@/src/components/classification/...'
+import { utility } from '@/src/shared/utils'
+import { type } from '@/types/...'
+
+// UI components
+import { Button } from '@/src/components/ui/button'
+```
+
+### Environment Configuration
+- **`.env`** - Production environment variables
+- **`.env.local`** - Local development overrides
+- **`.env.example`** - Template with required variables
+- **`.env.test`** - Testing environment configuration
+
+### Docker Architecture
+
+#### Container Services
+- **nextapp**: Main Next.js application container
+- **nextapp-test**: Test application server
+- **unit-tests**: Isolated unit testing service
+- **e2e-tests-headless**: Headless E2E testing
+- **e2e-tests-local**: Local E2E testing with user creation
+- **db**: PostgreSQL database
+- **redis**: Redis cache
+- **drizzle-studio**: Database UI tool
+
+#### Testing Profiles
+- **`unit`**: Fast, isolated unit testing
+- **`e2e`**: Full application integration testing
+- **`local-test`**: Comprehensive testing with user creation
+- **`all`**: Complete test suite validation
+
+### Flask API Integration
+The application integrates with a Flask backend for citizen science features:
+- Flask routes are proxied through Next.js using `/citizen/*` paths
+- Development uses `http://flask:5001` container communication
+- API routes remain at `/api/*` for Next.js server functions
+
+### Key Development Notes
+- Components are organized by **user mechanics** not technical implementation
+- Database schema is managed through Drizzle ORM in `src/core/database/schema.ts`
+- All routes have been validated for the user-centric reorganization
+- Docker testing environment provides consistent CI/CD integration
+- Three.js components use React Three Fiber patterns
+- Supabase handles authentication, real-time subscriptions, and data storage
+
+### Testing Strategy
+- **Unit tests** focus on individual component logic and utilities
+- **E2E tests** cover complete user workflows and integration scenarios
+- **Docker profiles** enable different testing scopes (unit, e2e, combined)
+- Tests can skip user creation with `SKIP_USER_CREATION_TESTS=true`

WARP.md

@@ -5,7 +5,7 @@ import { useRouter } from "next/navigation"
 import { AvatarGenerator } from "@/src/components/profile/setup/Avatar"
 import DeployTelescopeViewport from "@/src/components/ui/scenes/deploy/TelescopeViewportRange"
 import { Button } from "@/src/components/ui/button"
-import { useSession } from "@supabase/auth-helpers-react"
+import { useSession, useSupabaseClient } from "@supabase/auth-helpers-react"
 import { ArrowLeft, User, Sun, Moon } from "lucide-react"
 import { useEffect, useState } from "react"
 import { Switch } from "@/src/components/ui/switch"
@@ -14,7 +14,36 @@ import UseDarkMode from "@/src/shared/hooks/useDarkMode"
 export default function NewDeployPage() {
   const router = useRouter()
   const session = useSession()
+  const supabase = useSupabaseClient()
   const { isDark, toggleDarkMode } = UseDarkMode()
+  const [profileChecked, setProfileChecked] = useState(false)
+
+  useEffect(() => {
+    async function ensureProfile() {
+      if (!session?.user?.id) return;
+      // Check if profile exists in Supabase
+      const { data, error } = await supabase
+        .from("profiles")
+        .select("id")
+        .eq("id", session.user.id)
+        .single();
+      if (!data) {
+        // Create profile if not exists
+        const { error: insertError } = await supabase
+          .from("profiles")
+          .insert({ id: session.user.id });
+        if (insertError) {
+          console.error("Error creating profile:", insertError.message);
+        }
+      }
+      setProfileChecked(true);
+    }
+    ensureProfile();
+  }, [session, supabase]);
+
+  if (!profileChecked) {
+    return <div className="h-screen w-full flex items-center justify-center bg-gradient-to-b from-[#002439] to-[#001a2a] text-white text-lg">Preparing your profile...</div>;
+  }
 
   return (
     <div className="h-screen w-full flex flex-col bg-gradient-to-b from-[#002439] to-[#001a2a] overflow-hidden">