How sanjaybtechaids-ai/brandguard_1 works
BrandGuard AI is a multi-tenant digital risk protection application. Analysts enroll trusted brand identities, discover and compare suspicious apps, domains, and social accounts, assess risk, then investigate and remediate threats through dashboards and reports. The README documents the overall detection sequence; the source index and excerpts support several API-to-service and service-to-engine links. Some UI and provider wiring is documented but not sampled, so those relationships are identified as documented rather than inferred from folder structure.
Main entry points: route.ts Product API routes · brand-discovery.service.ts Brand discovery · url-verification.service.ts URL verification · brands.service.ts Brand profiles
Components 18
Analyst experience
- SOC workbench
src/app/dashboard/page.tsx - Brand enrollment
src/components/brands/BrandDiscovery.tsx - Threat investigation
src/app/threats/[id]/page.tsx - Reports and alerts
src/app/reports/page.tsx
API access
- Product API routes
src/app/api/brands/route.ts
Brand identity and discovery
- Brand profiles
src/services/brands.service.ts - Brand discovery
src/services/brand-discovery.service.ts - Discovery providers
src/providers/brand.provider.ts - Official app records
src/data/apps.ts
Risk analysis
- Risk scoring
src/lib/risk/risk-engine.ts - Domain normalization
src/lib/risk/normalization.ts - URL verification
src/services/url-verification.service.ts - App monitoring
src/services/apps.service.ts
Threat operations
- Threat management
src/services/threats.service.ts - Report generation
src/services/reports.service.ts - Security alerts
src/services/alerts.service.ts - Supabase data store
src/lib/supabase/server.ts
Other components
- Security analyst
Connections 26
- Security analyst → SOC workbench: uses
README.md - Security analyst → Brand enrollment: enrolls brands
README.md - Security analyst → Threat investigation: investigates
README.md - Security analyst → Reports and alerts: reviews
README.md - Brand enrollment → Product API routes: submits identity
- Product API routes → Brand profiles: manages brands
src/app/api/brands/route.ts - Product API routes → Brand discovery: starts discovery
- Product API routes → App monitoring: serves app data
- Product API routes → URL verification: verifies URLs
- Product API routes → Threat management: serves threats
- Product API routes → Report generation: serves reports
- Product API routes → Security alerts: serves alerts
- Brand discovery → Discovery providers: queries sources
src/services/brand-discovery.service.ts - Brand discovery → Risk scoring: evaluates candidates
src/services/brand-discovery.service.ts - Brand discovery → Brand profiles: uses profiles
src/services/brand-discovery.service.ts - App monitoring → Official app records: loads fallback data
src/services/apps.service.ts - App monitoring → Brand profiles: resolves brand
src/services/apps.service.ts - URL verification → Risk scoring: scores URL
src/services/url-verification.service.ts - URL verification → Domain normalization: normalizes input
src/services/url-verification.service.ts - Risk scoring → Domain normalization: normalizes signals
src/lib/risk/risk-engine.ts - URL verification → Threat management: records findings
src/services/url-verification.service.ts - Threat investigation → Threat management: reviews cases
- Reports and alerts → Report generation: requests dossiers
- Brand profiles → Supabase data store: reads and writes
src/services/brands.service.ts - Brand discovery → Supabase data store: persists results
src/services/brand-discovery.service.ts - Threat management → Supabase data store: reads and writes
src/services/threats.service.ts