43 lines
1.6 KiB
Markdown
43 lines
1.6 KiB
Markdown
# 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 |