patrick/sojorn
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
sojorn/sojorn_docs/legacy/GO_BACKEND_README.md
Patrick Britton 38653f5854 Sojorn Backend Finalization & Cleanup - Complete Migration from Supabase 
##  Phase 1: Critical Feature Completion (Beacon Voting)
- Add VouchBeacon, ReportBeacon, RemoveBeaconVote methods to PostRepository
- Implement beacon voting HTTP handlers with confidence score calculations
- Register new beacon routes: /beacons/:id/vouch, /beacons/:id/report, /beacons/:id/vouch (DELETE)
- Auto-flag beacons at 5+ reports, confidence scoring (0.5 base + 0.1 per vouch)

##  Phase 2: Feed Logic & Post Distribution Integrity
- Verify unified feed logic supports all content types (Standard, Quips, Beacons)
- Ensure proper distribution: Profile Feed + Main/Home Feed for followers
- Beacon Map integration for location-based content
- Video content filtering for Quips feed

##  Phase 3: The Notification System
- Create comprehensive NotificationService with FCM integration
- Add CreateNotification method to NotificationRepository
- Implement smart deep linking: beacon_map, quip_feed, main_feed
- Trigger notifications for beacon interactions and cross-post comments
- Push notification logic with proper content type detection

##  Phase 4: The Great Supabase Purge
- Delete function_proxy.go and remove /functions/:name route
- Remove SupabaseURL, SupabaseKey from config.go
- Remove SupabaseID field from User model
- Clean all Supabase imports and dependencies
- Sanitize codebase of legacy Supabase references

##  Phase 5: Flutter Frontend Integration
- Implement vouchBeacon(), reportBeacon(), removeBeaconVote() in ApiService
- Replace TODO delay in video_comments_sheet.dart with actual publishComment call
- Fix compilation errors (named parameters, orphaned child properties)
- Complete frontend integration with Go API endpoints

##  Additional Improvements
- Fix compilation errors in threaded_comment_widget.dart (orphaned child property)
- Update video_comments_sheet.dart to use proper named parameters
- Comprehensive error handling and validation
- Production-ready notification system with deep linking

##  Migration Status: 100% Complete
- Backend: Fully migrated from Supabase to custom Go/Gin API
- Frontend: Integrated with new Go endpoints
- Notifications: Complete FCM integration with smart routing
- Database: Clean of all Supabase dependencies
- Features: All functionality preserved and enhanced

Ready for VPS deployment and production testing!
2026-01-30 09:24:31 -06:00

1.6 KiB
Raw Blame History

Sojorn Backend Engine (Golang)

Production-grade Golang backend migrated from Supabase Edge Functions.

Tech Stack

  • Language: Go 1.21+
  • Framework: Gin Gonic
  • Database: PostgreSQL with PostGIS
  • Auth: JWT (compatible with Supabase)
  • Logging: Zerolog
  • Deployment: Docker / Systemd

Getting Started

Prerequisites

  • Go 1.21 or higher
  • PostgreSQL 15+ with PostGIS extension
  • golang-migrate CLI (for migrations)

Setup

  1. Clone the repository
  2. Copy .env.example to .env and fill in your details: 
    cp .env.example .env
  3. Install dependencies: 
    go mod download
  4. Run migrations: 
    make migrate-up

Running Locally

go run cmd/api/main.go

The server will start on http://localhost:8080.

API Documentation

Auth & Profiles

  • POST /api/v1/signup: Complete profile creation after auth
  • GET /api/v1/profiles/:id: Get user profile
  • GET /api/v1/profile: Get current user profile

Posts & Feed

  • POST /api/v1/posts: Create a new post or beacon
  • GET /api/v1/feed: Get personal feed

Deployment

Using Systemd (Ubuntu/Debian)

  1. Edit scripts/deploy.sh with your VPS details.
  2. Run the deployment script: 
    ./scripts/deploy.sh

Using Docker

docker build -t sojorn-api .
docker run -p 8080:8080 --env-file .env sojorn-api

Migration Notes

  • RLS policies have been moved to application-level middleware.
  • Supabase-specific triggers for metrics are maintained in SQL migrations.
  • E2EE session management is ported to handlers/services.