How pantr2318/business-compass works
Business Compass (also branded NXvanta in the backend) is a business-intelligence and startup-news platform. The principal reader workflow is to enter the site, discover news or company and market information, and view detailed content; the newsroom also ingests feed stories, uses AI to rewrite them, and queues them for review or publication. Editors manage content through admin tools, while a separate FastAPI backend exposes authentication, article, category, and media endpoints. README capabilities exceed what the sampled source confirms, so unsampled feature wiring is shown only where the tree supports a meaningful subsystem.
Main entry points: router.tsx Web Router · news-ingest.server.ts Feed Ingestion · main.py FastAPI App · index.tsx Home Discovery
Components 22
Reader Discovery
- Web Router
src/router.tsx - Home Discovery
src/routes/index.tsx - Public Content Data
src/lib/public.functions.ts - Profiles & Intelligence
src/routes - Public Data API
src/routes/api/public/v1
Newsroom
- News Pages
src/routes/news.index.tsx - Article Detail
src/routes/news.$slug.tsx - Feed Ingestion
src/lib/news-ingest.server.ts
Platform Operations
- Supabase Admin Client
src/integrations/supabase/client.server.ts - Article Store
- Admin Console
src/routes/admin.index.tsx - Resource Manager
src/components/admin/resource-manager.tsx - Admin Functions
src/lib/admin.functions.ts
FastAPI Backend
- FastAPI App
backend/app/main.py - Authentication API
backend/app/api/auth.py - Auth Service
backend/app/services/auth_service.py - Content & Media APIs
backend/app/api - PostgreSQL Session
backend/app/database.py
Other components
- Reader
- Lovable AI
- News Feeds
- Editor
Connections 19
- Reader → Web Router: opens
- Web Router → Home Discovery: routes to
- Home Discovery → Public Content Data: loads discovery data
- Reader → News Pages: opens news
- Web Router → News Pages: routes to
- Web Router → Article Detail: routes to
- Reader → Profiles & Intelligence: browses profiles
- Reader → Public Data API: requests datasets
- Feed Ingestion → News Feeds: fetches headlines
- Feed Ingestion → Lovable AI: rewrites stories
- Feed Ingestion → Supabase Admin Client: stores reviewed stories
- Supabase Admin Client → Article Store: writes articles
- Editor → Admin Console: manages content
- Admin Console → Resource Manager: uses
- Resource Manager → Admin Functions: lists and mutates
- FastAPI App → Authentication API: mounts router
- FastAPI App → Content & Media APIs: mounts routers
- Authentication API → Auth Service: registers users
- Auth Service → PostgreSQL Session: persists account