webmoney/CONFIGURACION_LOCAL.md

🖥️ CONFIGURACION DEL AMBIENTE DE DESARROLLO LOCAL

Sistema Operativo: Windows
Ultima actualizacion: 13 de Diciembre de 2025

---

📦 Software Instalado

Software	Version	Comando de Verificacion
Node.js	24.12.0 LTS	node --version
npm	11.6.2	npm --version
PHP	8.4.15	php --version
Composer	2.9.2	composer --version
Git	2.52.0	git --version
SSH	OpenSSH 9.5	ssh -V
PuTTY	0.83.0	Para plink/pscp

---

🚀 Scripts Automatizados (Basados en Diretrizes v3.0)

scripts/
├── status.ps1       # Ver estado del proyecto
├── dev.ps1          # Iniciar servidores de desarrollo
├── quick-deploy.ps1 # Deploy rapido sin commit
├── release.ps1      # Workflow completo automatizado
└── setup-ssh.ps1    # Configurar SSH sin password (una vez)

Workflow Completo (release.ps1)

El script release.ps1 automatiza TODO el proceso segun las directrices:

1. ✅ Incrementa VERSION automaticamente
2. ✅ Actualiza CHANGELOG.md
3. ✅ Hace deploy al servidor
4. ✅ Abre navegador para test
5. ✅ Espera confirmacion del usuario
6. ✅ Hace commit y push

# Correccion de bug (patch: 1.27.2 -> 1.27.3)
.\scripts\release.ps1 -VersionType patch -ChangeDescription "Corrigido bug X" -ChangeType Fixed

# Nueva funcionalidad (minor: 1.27.2 -> 1.28.0)
.\scripts\release.ps1 -VersionType minor -ChangeDescription "Nuevo widget Y" -ChangeType Added

# Deploy solo frontend
.\scripts\release.ps1 -VersionType patch -ChangeDescription "Ajuste CSS" -Deploy frontend

# Solo documentacion (sin deploy)
.\scripts\release.ps1 -VersionType patch -ChangeDescription "Actualizar docs" -Deploy none

Quick Deploy (Desarrollo)

Para iteraciones rapidas durante desarrollo:

# Deploy solo frontend
.\scripts\quick-deploy.ps1 -Target frontend

# Deploy solo backend
.\scripts\quick-deploy.ps1 -Target backend

# Deploy ambos
.\scripts\quick-deploy.ps1 -Target both

---

🔧 Configuracion Inicial

1. Primera vez - Configurar SSH sin password

.\scripts\setup-ssh.ps1

Esto copia tu clave publica al servidor. Despues podras conectar sin password.

2. Verificar estado

.\scripts\status.ps1

3. Iniciar desarrollo local

.\scripts\dev.ps1

---

🌐 URLs

Desarrollo Local

Servicio	URL
Frontend	http://localhost:5173
Backend API	http://localhost:8000/api

Produccion

Servicio	URL
Aplicacion	https://webmoney.cnxifly.com
API	https://webmoney.cnxifly.com/api
phpMyAdmin	https://phpmyadmin.cnxifly.com
Webmail	https://webmail.cnxifly.com

---

⚙️ Extensiones PHP Habilitadas

• openssl, curl, mbstring, fileinfo
• pdo_mysql, zip, gd, intl, exif, sodium

El archivo php.ini esta en:

C:\Users\marco\AppData\Local\Microsoft\WinGet\Packages\PHP.PHP.8.4_Microsoft.Winget.Source_8wekyb3d8bbwe\php.ini

---

📝 Directrices de Desarrollo (v3.0)

El workflow esta completamente automatizado. Las reglas principales son:

1. Versionamento Semantico: Cada commit incrementa la version
2. Test Obligatorio: Siempre testar en produccion antes de commit
3. Scripts de Deploy: Nunca hacer deploy manual
4. Documentacion: VERSION y CHANGELOG siempre actualizados

Todo esto es manejado automaticamente por .\scripts\release.ps1

---

🆘 Solucion de Problemas

PHP no encuentra extensiones

php -i | Select-String "extension_dir"

Error de permisos en Laravel (OneDrive)

attrib -R "backend\bootstrap\cache" /S /D
attrib -R "backend\storage" /S /D

Git no configurado

git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"