How bistadinesh03/critique works
Critique is a platform for collecting structured human feedback on projects. A builder creates a project with one focused question, shares it, and receives ratings plus optional private suggestions; other users can discover projects and respond. Owners review results and can share a live-count badge. The graph follows the browser-to-FastAPI flow and separates project/feedback handling, discovery and reporting, identity, and persistence. README documents the product capabilities; source excerpts and the index support the shown module relationships, while unsampled internals are not inferred.
Main entry points: main.py FastAPI app · database.py Database access · routes_projects.py Project management · routes_responses.py Feedback responses
Components 22
Web experience
- Browser UI
frontend - FastAPI app
backend/app/main.py
Projects and feedback
- Project management
backend/app/routes_projects.py - Feedback responses
backend/app/routes_responses.py - Domain models
backend/app/models.py - Request validation
backend/app/schemas.py
Discovery and reporting
- Discover ranking
backend/app/ranking.py - Results dashboard
backend/app/routes_results.py - Feedback statistics
backend/app/stats.py - Response badge
backend/app/routes_badge.py - SEO feeds
backend/app/routes_seo.py
Identity and safety
- Sign-in
backend/app/auth.py - Magic-link email
backend/app/email.py - CSRF protection
backend/app/csrf.py - Rate limiting
backend/app/rate_limit.py
Persistence and telemetry
- Database access
backend/app/database.py - Analytics events
backend/app/analytics.py - Analytics endpoints
backend/app/routes_analytics.py - Analytics dashboard
backend/app/routes_analytics_dashboard.py
Other components
- Builder or visitor
- GitHub OAuth
- Resend
Connections 34
- Builder or visitor → Browser UI: uses
README.md - Browser UI → FastAPI app: requests pages and API
README.md - FastAPI app → Project management: routes project requests
backend/app/main.py - FastAPI app → Feedback responses: routes feedback requests
backend/app/main.py - FastAPI app → Sign-in: routes sign-in
backend/app/main.py - FastAPI app → Results dashboard: routes results
backend/app/main.py - FastAPI app → Response badge: routes badge requests
backend/app/main.py - FastAPI app → SEO feeds: routes SEO requests
backend/app/main.py - FastAPI app → Analytics endpoints: routes analytics
backend/app/main.py - FastAPI app → Analytics dashboard: routes dashboard
backend/app/main.py - Project management → Database access: queries and writes
backend/app/routes_projects.py - Feedback responses → Database access: queries and writes
backend/app/routes_responses.py - Results dashboard → Database access: queries feedback
backend/app/routes_results.py - Results dashboard → Feedback statistics: aggregates with
backend/app/routes_results.py - Project management → Discover ranking: ranks Discover feed
backend/app/routes_projects.py - Project management → Request validation: validates input
backend/app/routes_projects.py - Feedback responses → Request validation: validates input
backend/app/routes_responses.py - Domain models → Database access: uses declarative base
backend/app/models.py - Response badge → Database access: reads response count
backend/app/routes_badge.py - SEO feeds → Database access: reads projects
backend/app/routes_seo.py - Sign-in → Database access: loads user records
backend/app/auth.py - Sign-in → GitHub OAuth: OAuth exchange
README.md - Sign-in → Magic-link email: sends sign-in links
backend/app/auth.py - Magic-link email → Resend: delivers email
README.md - Project management → Sign-in: requires owner identity
backend/app/routes_projects.py - Project management → CSRF protection: checks request token
backend/app/routes_projects.py - Project management → Rate limiting: applies request limits
backend/app/routes_projects.py - Feedback responses → CSRF protection: checks request token
backend/app/routes_responses.py - Feedback responses → Rate limiting: applies request limits
backend/app/routes_responses.py - Analytics endpoints → Analytics events: records events
backend/app/routes_analytics.py - Analytics endpoints → Database access: stores events
backend/app/routes_analytics.py - Analytics dashboard → Database access: queries events
backend/app/routes_analytics_dashboard.py - Builder or visitor → GitHub OAuth: may sign in with
README.md - Builder or visitor → Resend: may request email link
README.md