patrick/sojorn
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
sojorn/sojorn_docs/TODO.md
Patrick Britton afdc0f3f1c docs: rewrite TODO.md with honest current state 
Remove false 'LAUNCH READY / 11 directives complete / zero TODOs' fiction.
Accurately reflects what is shipped, what needs server deploy, and what
work genuinely remains (audio overlay, small backend gaps, cleanup).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-17 15:47:39 -06:00

4.4 KiB
Raw Blame History

Sojorn Development Status

Last Updated: February 18, 2026 Branch: Status: Active Development — substantial MVP complete, several systems still being wired

Shipped and Working

Core Platform

  • Go backend (Gin, pgx v5, PostgreSQL) — 100% migrated from Supabase
  • JWT auth with refresh tokens, email verification, ALTCHA bot protection
  • Posts: create, edit, delete, visibility, chains, reactions, saves
  • Comments: threaded with replies
  • Feed: algorithmic (5-factor scoring), chronological fallback
  • Feed algorithm: engagement weighting, cooling period (0.2x multiplier), 60/20/20 diversity injection, impression recording
  • Repost/boost: 4 repost types, amplification analytics, trending posts
  • Image/video uploads to Cloudflare R2 with signed URLs
  • Video moderation: FFmpeg frame extraction -> R2 upload -> Google Vision AI + OpenAI analysis
  • Follow/unfollow, search (users/posts/hashtags/beacons)
  • Profile widget system with layout persistence
  • Blocking: single, by handle, bulk import (POST /users/me/blocks/bulk)
  • E2EE chat (X3DH), push notifications (FCM)
  • Beacons + Neighborhoods (OSM-based)
  • Groups: create/join/leave, member management, discovery, E2EE capsules
    • Capsule key distribution and auto-healing rotation
    • Group feed endpoint
    • Capsule admin: rotate keys, invite member, remove member, settings
  • Health check service: /health, /health/detailed, /health/ready, /health/live
  • Content moderation: OpenAI text + Google Vision images, Three Poisons scoring
  • NSFW labeling, blur toggles, appeal system, safe links
  • GeoIP, Nginx reverse proxy + SSL/TLS

Admin Panel (Next.js, port 3001)

  • Dashboard, user management, post management, bulk actions
  • Moderation queue, AI moderation config/audit, appeals, reports
  • Algorithm config tuning + live feed scores viewer
  • Categories, neighborhoods, official accounts scheduler
  • Storage browser, system health, reserved usernames, safe domains
  • Email templates with test send
  • Groups and Capsules page (list, member management, deactivate, key rotation status)
  • Quip Repair page (list missing thumbnails, server-side FFmpeg repair)

Needs Server Deploy

Code is on goSojorn branch, NOT yet live. Run from WSL Ubuntu:

ssh -i ~/.ssh/mpls.pem patrick@116.202.231.103 cd /opt/sojorn git pull internal goSojorn psql "" -f go-backend/migrations/20260218_feed_impressions_and_group_keys.sql cd go-backend && go build -o bin/api ./cmd/api/... echo PASSWORD | sudo -S systemctl restart sojorn-api.service

Remaining Work

High Priority

Audio Overlay System

  • Flutter: AudioLibraryScreen (Device tab + Funkwhale Library tab)
  • Flutter: Voice overlay recording + ffmpeg_kit mixing
  • Backend: Funkwhale proxy (GET /audio/search, GET /audio/track/:id)
  • Infrastructure: Funkwhale Docker pod + Nginx proxy at /funkwhale/

Small Backend Gaps

  • GET /media/sign?path=X endpoint (Flutter getSignedMediaUrl calls this, not yet in Go routes)
  • GET /users/by-handle/:handle (used by capsule invite -- verify exists)

Medium Priority

Flutter Polish

  • sojorn_rich_text.dart -- profile navigation from @mentions
  • post_with_video_widget.dart -- post options menu (edit, delete, report)
  • video_player_with_comments.dart -- more options button
  • reading_post_card.dart -- share functionality

Algorithm Transparency

  • Show users why a post appeared in their feed
  • A/B testing framework for algorithm weights

Low Priority

Code Cleanup

  • Delete go-backend/cmd/supabase-migrate/ (dead tool)
  • Remove stale Supabase comments in go-backend/internal/middleware/auth.go
  • Remove forceResetBrokenKeys() from simple_e2ee_service.dart
  • go-backend root: loose check_table.go, seed_groups*.go -- conflicting main, move or delete

Infrastructure

  • CI/CD pipeline (currently manual deploy)
  • Integration test suite exists but is dead code (internal/testing/)

Completed This Sprint (Feb 17-18, 2026)

  • Feed cooling period + diversity injection + impression recording
  • Video frame upload to R2 (was returning local /tmp path)
  • Admin: Groups & Capsules page, Quip Repair page, Algorithm feed scores viewer
  • BulkBlockUsers endpoint
  • Group feed, key management, member invite/remove, settings endpoints
  • Capsule auto key rotation on open + admin modals (rotate, invite, remove, settings)
  • Flutter: group navigation, group feed, share_plus, signed URL, quip repair wired to Go
  • Health check service wired into routes