​

Guía para Agregar Ciudades de Curaçao en Producción

​

✅ Características de Seguridad

• ✅ No elimina datos: Solo agrega ciudades, nunca borra ni modifica datos existentes
• ✅ Idempotente: Puede ejecutarse múltiples veces sin problemas
• ✅ Transaccional: Usa transacciones de base de datos (si hay error, se revierte todo)
• ✅ Verifica duplicados: Comprueba si las ciudades ya existen antes de agregarlas
• ✅ Modo dry-run: Permite ver qué se agregaría sin hacer cambios reales

​

📋 Pre-requisitos

1. Asegúrate de que el país Curaçao existe en la tabla countries
   • Código ISO2: CW
   • Si no existe, ejecuta primero: php artisan db:seed --class=CountriesSeeder
2. Haz una copia de seguridad de la base de datos (recomendado pero no crítico, ya que solo agregamos datos):
   # Ejemplo con MySQL
   mysqldump -u usuario -p nombre_bd > backup_antes_curacao_$(date +%Y%m%d_%H%M%S).sql
   

​

🚀 Proceso de Despliegue

​

Paso 1: Modo Dry-Run (Recomendado)

php artisan cities:add-curacao --dry-run

• Qué país se encontró
• Cuántas ciudades ya existen
• Qué ciudades se agregarían
• NO realizará ningún cambio en la base de datos

​

Paso 2: Ejecutar en Producción

php artisan cities:add-curacao

1. Buscará el país Curaçao (CW)
2. Verificará qué ciudades ya existen
3. Mostrará las ciudades que se agregarán
4. Pedirá confirmación antes de proceder
5. Agregará solo las ciudades que no existen
6. Mostrará un resumen de lo agregado

​

Paso 3: Verificación

# Ver todas las ciudades de Curaçao en la base de datos
php artisan tinker
>>> App\Models\Cities::where('country_code', 'CW')->pluck('name')

1. Ve a cualquier formulario de checkout
2. Selecciona el país “Curaçao”
3. Verifica que aparezcan las ciudades (Willemstad, Bandariba, etc.)

​

📊 Ciudades que se Agregan

1. Willemstad (Capital)
2. Bandariba
3. Bandabou
4. Sint Michiel
5. St. Michiel
6. Santa Rosa
7. Sint Michiel Liber
8. Brievengat
9. Barber
10. Dorp Soto
11. Otrabanda
12. Sabana Westpunt
13. Westpunt
14. Lagun
15. Tera Kora
16. Nieuwpoort
17. Playa Kanoa
18. Playa Kalki
19. Boca San Pedro
20. Rincon
21. Dorp Sint Willebrordus
22. Groot Sint Joris
23. Sint Joris
24. Klein Sint Joris

​

🔄 Ejecutar Múltiples Veces

​

⚠️ Troubleshooting

​

Error: “Curaçao (CW) not found in countries table”

php artisan db:seed --class=CountriesSeeder

​

Error de permisos de base de datos

​

Las ciudades no aparecen en el checkout

1. Verifica que el endpoint /api/get-states?country=CW devuelva las ciudades
2. Limpia la caché si es necesario: php artisan cache:clear
3. Verifica que el código JavaScript esté cargando las ciudades correctamente

​

📝 Notas Adicionales

• El CSV cities_202505192231.csv ya ha sido actualizado con estas ciudades
• Si ejecutas el seeder completo de ciudades (CitiesSeeder), estas ciudades también se incluirán
• El comando usa transacciones, por lo que si hay algún error, todos los cambios se revierten automáticamente

​

🔗 Archivos Relacionados

• Comando: app/Console/Commands/AddWillemstadCity.php
• CSV: cities_202505192231.csv
• Modelo: app/Models/Cities.php
• Endpoint API: routes/web.php (línea 44: /api/get-states)