Documentación y comentarios

Genera documentación para este código: docstrings en formato Google/Sphinx para clases y funciones, comentarios en bloque para decisiones complejas, API docs con OpenAPI/Swagger, README con setup y ejemplos de uso.