How harlequincs/veritas works
VERITAS is presented as a web vulnerability scanner and security command centre. The visible user workflow is account creation or sign-in, followed by dashboard review of scan sessions and vulnerability summaries, then inspection of findings and a report with remediation-oriented patch content. The tree also exposes target setup, live scans, tickets, notifications, and threat-map surfaces. Evidence is uneven: several product areas are represented only by routes, and the sampled FastAPI backend demonstrates health and database connectivity rather than scan execution.
Main entry points: server.ts Supabase server client · route.ts OAuth callback · dashboard/page.tsx Security dashboard · register/page.tsx Registration
Components 25
Identity and access
- Auth screens
app/auth/page.tsx - Registration
app/register/page.tsx - Auth actions
app/actions/auth.ts - OAuth callback
app/auth/callback/route.ts - Email confirmation
app/auth/confirm/route.ts - Supabase server client
utils/supabase/server.ts - Supabase admin client
utils/supabase/admin.ts - Welcome email
lib/welcome-email.ts
Scanner workspace
- Security dashboard
app/(app)/dashboard/page.tsx - Scan sessions
components/scan-session-table.tsx - Scan activity views
components/live-activity-rail.tsx - Target setup
app/(app)/targets/new/page.tsx - Live scans
app/(app)/scans/live/page.tsx - Threat map API
app/api/threat-map/route.ts
Findings and remediation
- Vulnerability list
app/(app)/vulnerabilities/page.tsx - Finding detail
app/(app)/vulnerabilities/[id]/page.tsx - Reports
app/(app)/reports/page.tsx - Report and patch view
app/report/page.tsx - Remediation tickets
app/(app)/tickets/page.tsx
Public product site
- Marketing site
app/(marketing)/page.tsx
Backend services
- FastAPI endpoints
backend/main.py - SQLAlchemy sessions
backend/database.py
Other components
- Visitor
- Supabase Auth and data
- Postgres database
Connections 16
- Visitor → Registration: creates account
app/register/page.tsx - Registration → Auth actions: submits signup
app/register/page.tsx - Auth actions → Supabase server client: creates client
app/actions/auth.ts - Supabase server client → Supabase Auth and data: auth and data access
- Visitor → Auth screens: signs in
- OAuth callback → Supabase server client: exchanges code
app/auth/callback/route.ts - OAuth callback → Supabase admin client: admin cleanup
app/auth/callback/route.ts - OAuth callback → Welcome email: sends welcome email
app/auth/callback/route.ts - OAuth callback → Supabase Auth and data: checks user row
app/auth/callback/route.ts - Email confirmation → Supabase server client: verifies token
app/auth/confirm/route.ts - Security dashboard → Supabase server client: loads user and scans
app/(app)/dashboard/page.tsx - Security dashboard → Scan sessions: renders
app/(app)/dashboard/page.tsx - Security dashboard → Scan activity views: renders
app/(app)/dashboard/page.tsx - Finding detail → Reports: related report data
- FastAPI endpoints → SQLAlchemy sessions: gets database session
backend/main.py - SQLAlchemy sessions → Postgres database: opens SQL connection