add readme

README.md

@@ -0,0 +1,155 @@
+# CBS CyberScan - Escaner Web Antivirus
+
+<p align="center">
+  <img src="https://condorbs.net/favicon.ico" alt="CBS Logo" width="50"/>
+</p>
+
+## Descripción
+CBS CyberScan es una aplicación web que proporciona un servicio de escaneo de archivos y URLs en tiempo real. Utiliza ClamAV como motor de análisis antivirus y ofrece una interfaz moderna y cibernética para una experiencia de usuario mejorada.
+
+## Características Principales
+- 🔍 Escaneo de archivos locales
+- 🌐 Análisis de archivos desde URLs
+- 🔄 Verificación de hashes (MD5, SHA1, SHA256)
+- 💾 Almacenamiento de resultados en base de datos
+- ⚡ Interfaz en tiempo real con WebSockets
+- 📊 Estadísticas detalladas de escaneo
+- 🎯 Detección y conteo de amenazas
+
+## Requisitos del Sistema
+- Python 3.8+
+- MySQL/MariaDB
+- ClamAV
+- Navegador web moderno
+
+## Dependencias Principales
+```plaintext
+Flask==3.0.2
+flask-socketio==5.3.6
+python-dotenv==1.0.1
+mysql-connector-python==8.3.0
+filetype==1.2.0
+requests==2.31.0
+```
+
+## Instalación
+
+1. Clonar el repositorio:
+```bash
+git clone https://condorcs.net/mrhacker/cbs-web-antivirus-scanner.git
+cd cbs-web-antivirus-scanner
+```
+
+2. Crear y activar entorno virtual:
+```bash
+python -m venv venv
+
+# En Linux/Mac:
+source venv/bin/activate
+
+# En Windows:
+.\venv\Scripts\activate
+```
+
+3. Instalar dependencias:
+```bash
+pip install -r requirements.txt
+```
+
+4. Configurar la base de datos:
+```sql
+CREATE DATABASE cbswebscan;
+USE cbswebscan;
+
+CREATE TABLE file_scans (
+    id INT AUTO_INCREMENT PRIMARY KEY,
+    filename VARCHAR(255),
+    md5_hash VARCHAR(32),
+    sha1_hash VARCHAR(40),
+    sha256_hash VARCHAR(64),
+    file_type VARCHAR(50),
+    scan_result TEXT,
+    scan_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+```
+
+5. Configurar variables de entorno:
+Crear archivo `.env`:
+```plaintext
+DB_HOST=localhost
+DB_USER=your_username
+DB_PASSWD=your_password
+DB_NAME=cbswebscan
+DB_CHARSET=utf8mb4
+DB_COALLITION=utf8mb4_unicode_ci
+```
+
+## Uso
+
+1. Iniciar el servidor:
+```bash
+python app.py
+```
+
+2. Acceder a la aplicación:
+Abrir en el navegador: `http://localhost:5000`
+
+## Historial de Versiones
+
+### v2.0.0 (Actual)
+![CBS CyberScan v2.0.0](screenshots/v2.0.0.png)
+- Interfaz completamente rediseñada con estilo cibernético
+- Sistema de escritura tipo terminal
+- Panel de estadísticas en tiempo real
+- Efectos visuales y animaciones mejoradas
+- Mejor manejo de amenazas y resultados
+
+### v1.0.0
+![CBS CyberScan v1.0.0](screenshots/v1.0.0.png)
+- Primera versión estable
+- Funcionalidades básicas de escaneo
+- Interfaz simple y funcional
+
+## Estructura del Proyecto
+```plaintext
+cbs-cyberscan/
+├── app.py                 # Aplicación principal
+├── requirements.txt       # Dependencias del proyecto
+├── .env                  # Variables de entorno
+├── static/              # Archivos estáticos
+├── templates/           # Plantillas HTML
+│   └── index.html       # Interfaz principal
+└── README.md            # Documentación
+```
+
+## Seguridad
+- Los archivos se escanean en un entorno aislado
+- Verificación de hashes para evitar escaneos duplicados
+- Limpieza automática de archivos temporales
+- Validación de tipos de archivo y URLs
+
+## Contribuir
+1. Fork del repositorio
+2. Crear rama para nueva característica (`git checkout -b feature/nueva-caracteristica`)
+3. Commit de cambios (`git commit -am 'Agregar nueva característica'`)
+4. Push a la rama (`git push origin feature/nueva-caracteristica`)
+5. Crear Pull Request
+
+## Screenshots
+
+Para agregar capturas de pantalla de nuevas versiones:
+1. Crear carpeta `screenshots` si no existe
+2. Nombrar las imágenes siguiendo el formato `vX.X.X.png`
+3. Actualizar la sección "Historial de Versiones" de este README
+
+
+## Autores
+- Kevin Muñoz
+
+## Soporte
+Para reportar problemas o solicitar ayuda:
+- Crear un issue en GitHub
+- Contactar a helpdesk@condorbs.net
+
+---
+Desarrollado con ❤️ por Kevin Muñoz