https://github.com/dhruv0306/antivirus
A full-stack antivirus application built with Spring Boot and React, following X.800 security architecture. Features real-time file scanning, quarantine management, and system protection with a modern dashboard interface. Built with security-first approach and comprehensive threat detection capabilities.
https://github.com/dhruv0306/antivirus
antivirus cybersecurity file-analysis file-scanning java malware-analysis malware-detection quarantine-system react real-time-protection security security-dashboard spring-boot system-protection threat-detection x800-architecture
Last synced: about 2 months ago
JSON representation
A full-stack antivirus application built with Spring Boot and React, following X.800 security architecture. Features real-time file scanning, quarantine management, and system protection with a modern dashboard interface. Built with security-first approach and comprehensive threat detection capabilities.
- Host: GitHub
- URL: https://github.com/dhruv0306/antivirus
- Owner: Dhruv0306
- Created: 2025-03-31T05:42:17.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-15T17:49:00.000Z (about 1 year ago)
- Last Synced: 2025-04-15T18:45:18.970Z (about 1 year ago)
- Topics: antivirus, cybersecurity, file-analysis, file-scanning, java, malware-analysis, malware-detection, quarantine-system, react, real-time-protection, security, security-dashboard, spring-boot, system-protection, threat-detection, x800-architecture
- Language: Java
- Homepage:
- Size: 1.54 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Antivirus Project
A full-stack antivirus application built with Spring Boot (Backend) and React (Frontend) that provides real-time file scanning, quarantine management, and system protection.
## 🚀 Project Overview
This project implements a comprehensive antivirus solution following the X.800 security architecture standard, with the following key features:
- Real-time file scanning and monitoring
- Quarantine management system
- System protection and security
- Scan history tracking and reporting
- User-friendly dashboard interface
- File analysis and threat detection
- Database-driven virus signature management
## 🛠️ Tech Stack
### Backend
- **Framework**: Spring Boot
- **Database**: H2 Database
- **Build Tool**: Maven
- **Java Version**: 17+
- **Key Dependencies**:
- Spring Web
- Spring Data JPA
- Spring Security
- H2 Database
- Lombok
- JUnit 5
### Frontend
- **Framework**: React.js
- **State Management**: React Hooks
- **UI Library**: Material-UI
- **Build Tool**: npm/yarn
- **Key Dependencies**:
- React Router
- Axios
- Material-UI
- React Query
- Jest & React Testing Library
## 📁 Project Structure
```
antivirus/
├── src/
│ ├── main/
│ │ ├── java/com/antivirus/
│ │ │ ├── config/ # Configuration classes
│ │ │ ├── controller/ # REST controllers
│ │ │ ├── model/ # Data models
│ │ │ ├── repository/ # JPA repositories
│ │ │ ├── service/ # Business logic
│ │ │ └── util/ # Utility classes
│ │ └── resources/
│ │ ├── application.properties
│ │ └── static/ # Static resources
│ └── test/
│ └── java/com/antivirus/ # Test classes
├── frontend/
│ ├── src/
│ │ ├── components/ # React components
│ │ ├── pages/ # Page components
│ │ ├── services/ # API services
│ │ ├── utils/ # Utility functions
│ │ └── App.js # Main App component
│ └── public/ # Static assets
├── quarantine/ # Quarantine storage
├── logs/ # Application logs
└── flowchart/ # Project documentation
```
## 🚀 Getting Started
### Prerequisites
- JDK 17 or higher
- Node.js 14.x or higher
- Maven 3.6.x or higher
- npm 6.x or higher
### Backend Setup
1. Navigate to the project root directory
2. Run Maven build:
```bash
mvn clean install
```
3. Start the Spring Boot application:
```bash
mvn spring-boot:run
```
4. Backend will be available at `http://localhost:8080`
5. H2 Console will be available at `http://localhost:8080/h2-console`
### Frontend Setup
1. Navigate to the frontend directory:
```bash
cd frontend
```
2. Install dependencies:
```bash
npm install
```
3. Start the development server:
```bash
npm start
```
4. Frontend will be available at `http://localhost:5000`
## 🔧 Configuration
### Backend Configuration
- Database configuration: `src/main/resources/application.properties`
- Logging configuration: `src/main/resources/logback.xml`
- Security configuration: `src/main/java/com/antivirus/config/SecurityConfig.java`
### Frontend Configuration
- API endpoint configuration: `frontend/src/config.js`
- Environment variables: `frontend/.env`
- Theme configuration: `frontend/src/theme.js`
## 📝 Development Guidelines
### Code Style
- Backend: Follow Google Java Style Guide
- Frontend: Follow Airbnb React/JSX Style Guide
### Git Workflow
1. Create feature branches from `develop`
2. Use conventional commits
3. Submit PRs for review
4. Merge to `develop` after approval
### Testing
- Backend: JUnit 5 for unit tests
- Frontend: Jest and React Testing Library
- Run tests:
```bash
# Backend
mvn test
# Frontend
npm test
```
## 🔍 Key Features Implementation
### File Scanning System
- Real-time file monitoring using Java NIO
- Signature-based detection using virus database
- Heuristic analysis for unknown threats
- File quarantine system with isolation
- Scan history tracking and reporting
### Dashboard Features
- Real-time system status monitoring
- Scan history visualization
- Quarantine management interface
- System health metrics
- Threat detection statistics
### Security Features
- Role-based access control
- Secure file handling
- Quarantine isolation
- API authentication
- Session management
## 📊 Logging and Monitoring
- Application logs: `logs/` directory
- Scan history: `scan_history.log`
- Database logs: `antivirus_db.trace.db`
- Performance metrics: Prometheus integration
- Health checks: Actuator endpoints
## 🔒 Security Considerations
- File system permissions
- Quarantine isolation
- API authentication
- Secure file handling
- Input validation
- XSS protection
- CSRF protection
## 🤝 Contributing
1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request
## 📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
## 👥 Authors
- [Dhruv0306](https://github.com/Dhruv0306) - Initial work
- [Sameer7188](https://github.com/Sameer7188) - Front-End work
## 🙏 Acknowledgments
- Spring Boot team
- React team
- Material-UI team
- All contributors and maintainers