How maman08/digitalforensic works
Main Components
• Frontend: The user interface is built in React.js. The extensive “frontend” directory (with components, UI elements, configuration files, etc.) indicates a well-organized dashboard for forensic analysis.
• Backend: Located under the “backend” directory with main.py. This is likely where the FastAPI endpoints reside, processing requests from the frontend and orchestrating forensic tool operations.
• ML/Model Module: The “model” directory contains files such as mlapp.py, CSV datasets, and pickled objects (imputer, label_encoders, sus.pkl) used for AI/ML for threat detection.
• Forensic Tools Integration: While not explicitly shown via source files, the README names third-party forensic tools (e.g., Volatility, Scapy, YARA) that the backend would coordinate.
• Reporting System: Although not directly in the file tree, the README mentions integration with Grafana for real-time dashboard monitoring, which should be represented as an external reporting module.
Relationships and Interactions
• Within the backend, there should be modules or services that interface with forensic tools to extract disk/memory data and network packets.
• The output from both forensic analysis and ML detection should flow to the reporting layer (Grafana) for real-time visualization.
• Optionally, note that the backend might also receive alerts/inputs from external sources (e.g., SSH lateral attack detection tools) before processing.
Architectural Patterns and Design Principles
• Separation of Concerns: Distinct components for UI, backend logic, forensic data processing, and ML-based threat detection.
• Modular Design: Files and folders clearly segment the frontend, backend, and ML/model components, which allow for easier scaling and maintenance.
• Integration with External Tools: The system design should show integration points (or service connectors) with established forensic tools (Volatility, Scapy, YARA) and external reporting services (Grafana).
Relevant Technologies and Frameworks
• Frontend: React.js, likely bundled with Vite (as seen in the .vite directory) and styled with Tailwind CSS.
• Backend: FastAPI (with Python), which acts as the API gateway.
• Forensic Tools: Volatility, Scapy, YARA (listed in the README) for forensic analyses.
• AI/ML: TensorFlow and Scikit-Learn (as per README) along with serialized model artifacts in the model folder.
• Reporting: Grafana, as mentioned for real-time monitoring.