How lunalynx12/sentra works
Project type and purpose
• This is a full-stack web application (“Sentra”) for file and URL threat scanning, built as an MVP of a malware analysis platform.
• The frontend is a React+TypeScript single-page app (Vite + TailwindCSS). The backend is a FastAPI service in Python using YARA rules for detection, persisting scan history to a database.
File structure
• Top-level directories:
• backend/
– src/main.py (FastAPI entrypoint)
– src/routes/scan.py (API endpoints)
– src/services/{file_scanner, url_scanner}.py (scan logic)
– src/database.py & models.py (ORM + schemas)
– yara_rules/ (collection of .yar rule files)
– ai.py, signatures.txt, docs for additional reference
• frontend/
– src/pages (HomePage, ScannerPage, RegisterPage, SignInPage)
– src/components (Header, Footer, hero, scanner, results)
– utils/mockScan (simulated data flows)
– Vite/Tailwind configs
• requirements.txt (backend deps)
README for additional insights
• Tech stack and feature list
• Scan flow: size check ➔ cache lookup ➔ actual scan ➔ DB store ➔ result display