coffee_crisis_arcade_edition/development_guidelines.md

Directrices de Desarrollo - Coffee Crisis Arcade Edition

Directrices Principales Confirmadas

1. Sistema Temporal

• TODO migrado de frame based a time based
• Delta time en segundos (float)
• Unidades de tiempo: SOLO segundos (no frames, no milisegundos)

2. Contadores y Timers

• CRECIENTES: para sistemas con múltiples eventos temporales (timeline)
  • Patrón: elapsed_time += deltaTime; if (elapsed_time >= EVENT_TIME) { /* acción */ }
• DECRECIENTES: para contadores con diferentes valores de inicialización
  • Patrón: timer -= deltaTime; if (timer <= 0.0f) { /* acción */ timer = DURATION; }

3. Números Mágicos

• Definidos en constantes
• Preferencia: cabecera de la clase
• Excepción: si es algo local a un método específico

Problemas Pendientes de Reparación (game.cpp)

❌ PENDIENTES

1. param.fade.post_duration_ms verification (líneas 89, 1671)
2. setRotateSpeed verification (línea 797)
3. TOTAL_DEMO_DATA - 200 magic number (línea 1669)
4. Comprehensive magic number search - Buscar 100, 150, 200, 250, 300, 400, 500, 1000

4. Velocidades y Aceleraciones

• Velocidades: pixels/segundo
• Aceleraciones: pixels/segundo²

5. Documentación de Conversiones

• Comentarios explicativos en cambios críticos de timing
• Documentar conversiones frame→tiempo en el código

6. Patrón de Constantes

• Crear constantes para valores repetidos (evitar duplicación)
• Nombres descriptivos para constantes de tiempo

---

Estado: Directrices completas confirmadas