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

65 lines
2.1 KiB
Markdown

# 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
- [x] 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).