Requisitos del Sistema de Envío de Mensajes WhatsApp
1. Requisitos Funcionales
1.1 Lectura de Datos
El sistema debe poder leer datos desde una base de datos Microsoft Access
Debe soportar diferentes tipos de consultas SQL
Debe manejar errores de conexión y consulta
Debe retornar los datos en formato DataFrame de pandas
1.2 Procesamiento de Datos
Debe permitir la aplicación de filtros sobre los datos
Debe implementar reglas de negocio personalizables
Debe validar la integridad de los datos
Debe transformar los datos según sea necesario
1.3 Envío de Mensajes
Debe enviar mensajes de WhatsApp usando la API de Twilio
Debe manejar errores de envío
Debe registrar el estado de los envíos
Debe soportar diferentes formatos de mensaje
2. Requisitos No Funcionales
2.1 Arquitectura
El sistema debe seguir los principios SOLID
Debe ser modular y extensible
Debe tener una clara separación de responsabilidades
Debe ser fácil de mantener y modificar
2.2 Seguridad
Las credenciales deben estar protegidas
Los datos sensibles deben ser manejados de forma segura
Debe implementar logging para auditoría
2.3 Rendimiento
Debe manejar grandes volúmenes de datos eficientemente
Debe optimizar el uso de memoria
Debe tener tiempos de respuesta aceptables
3. Diagramas
3.1 Diagrama de Clases
+------------------+ +------------------+ +------------------+
| DataReader | | DataProcessor | | MessageSender |
+------------------+ +------------------+ +------------------+
| - conn_str | | - rules | | - client |
+------------------+ +------------------+ +------------------+
| + read_data() | | + process() | | + send() |
| + close() | | + validate() | | + get_status() |
+------------------+ +------------------+ +------------------+
^ ^ ^
| | |
v v v
+------------------+ +------------------+ +------------------+
| AccessReader | | BusinessRules | | WhatsAppSender |
+------------------+ +------------------+ +------------------+
| + read_data() | | + apply_rules() | | + send() |
+------------------+ +------------------+ +------------------+
3.2 Diagrama de Secuencia
Client -> DataReader: read_data()
DataReader -> AccessReader: execute_query()
AccessReader --> DataReader: return DataFrame
DataReader --> Client: return DataFrame
Client -> DataProcessor: process(data)
DataProcessor -> BusinessRules: apply_rules()
BusinessRules --> DataProcessor: return processed_data
DataProcessor --> Client: return processed_data
Client -> MessageSender: send(message)
MessageSender -> WhatsAppSender: send_message()
WhatsAppSender --> MessageSender: return status
MessageSender --> Client: return status
4. Estructura del Proyecto
project/
├── src/
│ ├── data/
│ │ ├── __init__.py
│ │ ├── [Link]
│ │ └── access_reader.py
│ ├── processing/
│ │ ├── __init__.py
│ │ ├── [Link]
│ │ └── business_rules.py
│ ├── messaging/
│ │ ├── __init__.py
│ │ ├── [Link]
│ │ └── whatsapp_sender.py
│ └── [Link]
├── config/
│ ├── __init__.py
│ └── [Link]
├── tests/
│ ├── __init__.py
│ ├── test_reader.py
│ ├── test_processor.py
│ └── test_sender.py
├── [Link]
└── [Link]
5. Interfaces Principales
5.1 DataReader
class DataReader(ABC):
@abstractmethod
def read_data(self, query: str) -> [Link]:
pass
@abstractmethod
def close(self) -> None:
pass
5.2 DataProcessor
class DataProcessor(ABC):
@abstractmethod
def process(self, data: [Link]) -> [Link]:
pass
@abstractmethod
def validate(self, data: [Link]) -> bool:
pass
5.3 MessageSender
class MessageSender(ABC):
@abstractmethod
def send(self, recipient: str, message: str) -> bool:
pass
@abstractmethod
def get_status(self, message_id: str) -> str:
pass