How oggy-and-the-cockroaches/hackwithhyderabad works
Shipcheck is a web-based pre-shipment code auditor. A developer creates or uploads a project through the dashboard, starts a scan, and views findings and historical comparisons; the backend detects project context, runs category-specific checks, and persists results. The README documents AI remediation, report export, and dashboard progress, though the sampled excerpts do not establish every implementation link. The graph uses documented architecture and sampled code; uncertain wiring is omitted.
Main entry points: scanner.py Scan Orchestrator · main.py FastAPI App · scans.py Scan API · hindsight.py Hindsight Service
Components 20
Dashboard
- Dashboard SPA
frontend/app.js
Application API
- FastAPI App
backend/main.py - Project API
backend/api/projects.py - Scan API
backend/api/scans.py - Reports API
backend/api/reports.py - Hindsight API
backend/api/hindsight.py
Audit Pipeline
- Uploaded Projects
backend/database/schema.py - Project Detector
backend/services/project_detector.py - Scan Orchestrator
backend/services/scanner.py - Security Checks
backend/scanners/security.py - Privacy Checks
backend/scanners/privacy.py - Production Checks
backend/scanners/production.py - Reliability Checks
backend/scanners/reliability.py - Finding Model
backend/scanners/base.py - AI Remediation
backend/services/llm.py
Reports And Memory
- SQLite Store
backend/database/schema.py - Hindsight Service
backend/services/hindsight.py
Other components
- Developer
- Gemini API
- Grok API
Connections 31
- Developer → Dashboard SPA: uses
- Dashboard SPA → FastAPI App: HTTP requests
- FastAPI App → Project API: mounts router
- FastAPI App → Scan API: mounts router
- FastAPI App → Reports API: mounts router
- FastAPI App → Hindsight API: mounts router
- Project API → SQLite Store: reads and writes
- Project API → Uploaded Projects: stores uploads
- Scan API → SQLite Store: records scan
- Scan API → Project Detector: detects context
- Scan API → Scan Orchestrator: runs scan
- Project Detector → Uploaded Projects: inspects project
- Scan Orchestrator → Uploaded Projects: scans files
- Scan Orchestrator → Security Checks: dispatches
- Scan Orchestrator → Privacy Checks: dispatches
- Scan Orchestrator → Production Checks: dispatches
- Scan Orchestrator → Reliability Checks: dispatches
- Security Checks → Finding Model: creates findings
- Privacy Checks → Finding Model: creates findings
- Production Checks → Finding Model: creates findings
- Reliability Checks → Finding Model: creates findings
- Scan Orchestrator → AI Remediation: requests remediation
- AI Remediation → Gemini API: generates analysis
- AI Remediation → Grok API: generates analysis
- Scan API → Hindsight Service: persists and compares
- Hindsight Service → SQLite Store: stores history
- Reports API → SQLite Store: reads and updates
- Reports API → Hindsight Service: compares scans and notes
- Hindsight API → Hindsight Service: records memory
- Dashboard SPA → Reports API: retrieves reports
- Hindsight Service → Gemini API: retains scan context