Motor Asignacion Inteligente

2. Crear funciones puras para scoring

• calculate_distance_score
• calculate_problem_match_score
• calculate_availability_score
• calculate_priority_boost
• calculate_total_score

3. Filtrar candidatos iniciales

• Excluir talleres fuera de radio maximo
• Excluir talleres no compatibles con tipo de problema
• Excluir talleres no disponibles

4. Calcular ranking

• Normalizar cada score en rango 0 a 1
• Aplicar pesos configurables
• Ordenar de mayor a menor

5. Seleccionar mejor candidato

• Tomar primer elemento del ranking
• Aplicar desempate por ETA, capacidad o carga actual
• Retornar razon de seleccion para trazabilidad

6. Encapsular en service desacoplado

• AssignmentService sin dependencia directa de FastAPI
• Repositorios como dependencias inyectables
• Sin codigo HTTP dentro del motor

7. Testing

• Unit tests por funcion de scoring
• Tests de escenarios completos con datos sinteticos
• Casos borde: sin candidatos, empate, datos incompletos

Logica de decision

• Si no hay candidatos validos: devolver lista vacia y motivo claro.
• Si hay empate de score: desempatar por menor tiempo estimado de llegada.
• Si prioridad es alta: aumentar peso de disponibilidad y distancia.

Criterios de calidad

• Funciones pequenas, puras y predecibles
• Parametros de negocio configurables sin tocar codigo core
• Resultado explicable y auditable
• Cobertura de pruebas en reglas criticas

Formato de salida esperado

• Service desacoplado con funciones testeables
• DTOs claros de input/output
• Lista ordenada de candidatos
• Mejor candidato seleccionado con justificacion