How rdanielsstat/hub-platform works
Hub-Platform is a personal idea-management application: users sign in, capture and score ideas, track them through lifecycle statuses, and refine them with notes, links, and dashboard filters. The React client calls a FastAPI backend, whose routers enforce identity and usage limits before using a SQL-backed store. The README documents the product capabilities and deployment/observability design; source excerpts and the SOURCE INDEX substantiate the shown calls. Some frontend and backend feature internals are unsampled, so their relationships are shown only where documented.
Main entry points: main.py FastAPI application · http.ts API client · App.tsx App shell · auth.py Authentication API
Components 22
Web application
- App shell
frontend/src/App.tsx - Sign-in screens
frontend/src/pages/login.tsx - Idea dashboard
frontend/src/pages/dashboard.tsx - Quick capture
frontend/src/components/quick-capture-dialog.tsx - Project details
frontend/src/pages/project-detail.tsx - Notes panel
frontend/src/components/detail/notes-panel.tsx - API client
frontend/src/services/api/http.ts
API and domain
- Authentication API
backend/app/routers/auth.py - Project lifecycle API
backend/app/routers/projects.py - Notes API
backend/app/routers/notes.py - Client error API
backend/app/routers/errors.py - FastAPI application
backend/app/main.py - Project domain
backend/app/models/project.py
Persistence
- SQL data store
backend/app/db/store.py - SQLite / Postgres
backend/app/db/session.py
Security controls
- Usage caps
backend/app/core/quotas.py - Identity controls
backend/app/auth/security.py - IP rate limits
backend/app/auth/rate_limit.py
Observability
- Telemetry setup
backend/observability/__init__.py - Grafana Cloud
- AWS Lambda
Other components
- Personal user
Connections 29
- Personal user → App shell: uses
README.md - App shell → Sign-in screens: routes unauthenticated
frontend/src/App.tsx - App shell → Idea dashboard: routes signed-in
frontend/src/App.tsx - App shell → Project details: routes project
frontend/src/App.tsx - App shell → Quick capture: opens capture
frontend/src/App.tsx - Idea dashboard → API client: loads and filters
- Quick capture → API client: creates idea
- Project details → API client: updates idea
- Project details → Notes panel: renders
frontend/src/pages/project-detail.tsx - Notes panel → API client: manages notes
- Sign-in screens → API client: signs in
- API client → FastAPI application: sends requests
- FastAPI application → Authentication API: registers
backend/app/main.py - FastAPI application → Project lifecycle API: registers
backend/app/main.py - FastAPI application → Notes API: registers
backend/app/main.py - FastAPI application → Client error API: registers
backend/app/main.py - Authentication API → Identity controls: hashes and verifies
backend/app/routers/auth.py - Authentication API → IP rate limits: limits attempts
backend/app/routers/auth.py - Authentication API → SQL data store: reads and writes users
backend/app/routers/auth.py - Project lifecycle API → Usage caps: checks cap
backend/app/core/quotas.py - Notes API → Usage caps: checks cap
backend/app/core/quotas.py - Project lifecycle API → SQL data store: reads and writes projects
backend/app/routers/projects.py - Notes API → SQL data store: reads and writes notes
backend/app/routers/notes.py - Project lifecycle API → Project domain: validates fields
backend/app/routers/projects.py - SQL data store → SQLite / Postgres: persists records
backend/app/db/store.py - FastAPI application → Telemetry setup: initializes
backend/app/main.py - Telemetry setup → Grafana Cloud: exports telemetry
backend/observability/__init__.py - Client error API → IP rate limits: limits reports
backend/app/routers/errors.py - Personal user → AWS Lambda: uses deployed service
README.md