berkekcay/acortador-de-enlaces-agente-ready

Implementar una tarea del acortador de enlaces

Sigue estos pasos en orden. Detente y pregunta si la tarea no está clara o necesita algo listado bajo "Preguntar a una persona antes" en AGENTS.md.

1. Leer. Abre AGENTS.md, la tarea seleccionada en docs/TASKS.md y tests/AGENTS.md. Trabaja únicamente en esa tarea.

2. Inspeccionar. Lee main.py (la tabla, encode(), el modelo de solicitud y ambas rutas) y tests/test_main.py. Anota cualquier cosa con la que la tarea interactúe, por ejemplo cómo se generan los códigos o cómo se comparte la base de datos entre ejecuciones.

3. Exponer el plan. Antes de editar, escribe:

   • el comportamiento esperado, incluidos los códigos de estado y cuerpos de respuesta para éxito y cada fallo;
   • los archivos que cambiarás;
   • los casos borde (entrada vacía o extraña, colisiones con códigos existentes, valores que se repiten).

4. Escribir una prueba que falle. Agrega pruebas de comportamiento en tests/test_main.py siguiendo tests/AGENTS.md: al menos un caso de éxito y uno de fallo. Ejecútalas y confirma que fallan por la razón correcta (la funcionalidad falta, no por un error tipográfico):

   pytest tests/test_main.py -k <nombre_nueva_prueba>
   

5. Implementar el cambio más pequeño en main.py que haga pasar las pruebas. Mantén el comportamiento existente y las formas de respuesta. Si la tabla necesita una nueva columna, agrégala de modo que un links.db existente siga funcionando (o explica por qué debe recrearse).

6. Ejecutar todo.

   pytest
   

   Todas las pruebas originales y nuevas deben pasar. Corrige y vuelve a ejecutar hasta que lo hagan.

7. Resumir con esta forma:

   Tarea:
   Comportamiento:
   Archivos cambiados:
   Pruebas agregadas:
   Resultado de pytest:
   Riesgos restantes: