sojorn/sojorn_docs/MIGRATION_PLAN.md
Patrick Britton 3c4680bdd7 Initial commit: Complete threaded conversation system with inline replies
**Major Features Added:**
- **Inline Reply System**: Replace compose screen with inline reply boxes
- **Thread Navigation**: Parent/child navigation with jump functionality
- **Chain Flow UI**: Reply counts, expand/collapse animations, visual hierarchy
- **Enhanced Animations**: Smooth transitions, hover effects, micro-interactions

 **Frontend Changes:**
- **ThreadedCommentWidget**: Complete rewrite with animations and navigation
- **ThreadNode Model**: Added parent references and descendant counting
- **ThreadedConversationScreen**: Integrated navigation handlers
- **PostDetailScreen**: Replaced with threaded conversation view
- **ComposeScreen**: Added reply indicators and context
- **PostActions**: Fixed visibility checks for chain buttons

 **Backend Changes:**
- **API Route**: Added /posts/:id/thread endpoint
- **Post Repository**: Include allow_chain and visibility fields in feed
- **Thread Handler**: Support for fetching post chains

 **UI/UX Improvements:**
- **Reply Context**: Clear indication when replying to specific posts
- **Character Counting**: 500 character limit with live counter
- **Visual Hierarchy**: Depth-based indentation and styling
- **Smooth Animations**: SizeTransition, FadeTransition, hover states
- **Chain Navigation**: Parent/child buttons with visual feedback

 **Technical Enhancements:**
- **Animation Controllers**: Proper lifecycle management
- **State Management**: Clean separation of concerns
- **Navigation Callbacks**: Reusable navigation system
- **Error Handling**: Graceful fallbacks and user feedback

This creates a Reddit-style threaded conversation experience with smooth
animations, inline replies, and intuitive navigation between posts in a chain.
2026-01-30 07:40:19 -06:00

2.1 KiB

Migration Plan: Supabase to Golang VPS

1. Project Overview

  • Source: Supabase (Edge Functions, PostgreSQL with RLS, Auth, Storage)
  • Target: Golang (Gin/Echo), Self-hosted PostgreSQL, Nginx, Systemd
  • App: Sojorn (Social Media platform with Beacons/Location features)

2. Infrastructure Setup (VPS)

  • OS: Ubuntu 22.04 LTS
  • DB: PostgreSQL 15+ with PostGIS, pg_trgm, uuid-ossp
  • Proxy: Nginx (SSL via Certbot)
  • Process Manager: Systemd

3. Database Migration

  • Export schema from Supabase.
  • Convert RLS policies to application logic (Go middleware/services).
  • Migrate Auth users to a local users table (integrating with profiles).
  • Set up Go migration tool (golang-migrate).
  • Data migration strategy: Dump and restore, or script-based sync.

4. Auth System

  • Implement JWT validation (compatible with Supabase or new secret).
  • Login/Signup handlers porting.
  • Middleware for auth.uid() equivalent.

5. API Mapping (Functions to Handlers)

Supabase Function Go Endpoint Status
signup POST /api/v1/auth/signup Pending
profile GET /api/v1/profiles/:id Pending
feed-sojorn GET /api/v1/feed Pending
publish-post POST /api/v1/posts Pending
create-beacon POST /api/v1/beacons Pending
search GET /api/v1/search Pending
... and more ...

6. Implementation Phases

Phase 1: Preparation

  • Initial Audit
  • VPS Configuration
  • Repository Setup (Go scaffolding)

Phase 2: Core Engine

  • Database connection & migrations
  • Auth & Middleware
  • Shared models & utils

Phase 3: Feature Porting

  • User & Profile management
  • Posting & Feed logic
  • Beacon (GIS) system
  • Notifications (FCM integration)
  • E2EE Chat (Session Manager)

Phase 4: Finalization

  • Unit & Integration Tests
  • Deployment Scripts
  • Cutover Plan

7. To-Be-Decided (TBD)

  • Request volume and growth expectations.
  • VPS specifications.
  • Monitoring preferences (Prometheus/Grafana).
  • Storage strategy (Local vs S3/R2).