sistema-abogadas-litoral/README.md

Abogadas Litoral

Aplicacion web para gestion de turnos de un estudio juridico, desarrollada con Laravel y Vite.

Tabla de contenido

• Tecnologias y versiones
• Requisitos previos
• Instalacion
• Comandos utiles
• Testing
• Flujo de trabajo con Git
• Estructura principal
• Notas

Tecnologias y versiones

Versiones tomadas del proyecto actual:

• PHP: ^8.2
• Laravel Framework: ^12.0
• PHPUnit: ^11.5.3
• Node.js: recomendado >=20
• npm: recomendado >=10
• Vite: ^7.0.7
• Bootstrap: ^5.3.8
• FullCalendar: ^6.1.20
• Spatie Laravel Backup: ^9.3
• DomPDF (barryvdh/laravel-dompdf): ^3.1

Archivos fuente de versionado:

• composer.json
• package.json

Requisitos previos

• PHP 8.2 o superior
• Composer 2.x
• Node.js y npm
• Base de datos (segun entorno):
  • En .env.example la conexion por defecto es sqlite
  • En config/database.php el fallback de Laravel esta en mysql

Instalacion

Opcion rapida (script del proyecto)

composer run setup

Este script ejecuta:

1. composer install
2. Creacion de .env desde .env.example (si no existe)
3. php artisan key:generate
4. php artisan migrate --force
5. npm install
6. npm run build

Opcion manual

composer install
copy .env.example .env
php artisan key:generate
php artisan migrate
npm install
npm run build

Si usas Linux/Mac, reemplaza copy por:

cp .env.example .env

Comandos utiles

Levantar entorno de desarrollo completo (servidor, cola, logs y Vite):

composer run dev

Levantar solo backend:

php artisan serve

Levantar solo frontend:

npm run dev

Compilar assets para produccion:

npm run build

Testing

Ejecutar tests:

composer run test

o

php artisan test

Flujo de trabajo con Git

1) Crear rama de trabajo

git checkout main
git pull origin main
git checkout -b feature/nombre-cambio

2) Commits pequenos y descriptivos

Formato recomendado:

• feat: agrega agenda semanal
• fix: corrige validacion de telefono
• docs: actualiza readme de instalacion

3) Subir rama y abrir Pull Request

git add .
git commit -m "feat: descripcion breve"
git push -u origin feature/nombre-cambio

4) Actualizar tu rama con cambios de main

git checkout main
git pull origin main
git checkout feature/nombre-cambio
git merge main

Estructura principal

• app/: modelos, controladores, middleware y logica principal
• resources/views/: vistas Blade
• resources/js/ y resources/css/: frontend
• routes/: rutas web, api y consola
• database/migrations/: migraciones
• tests/: pruebas unitarias y feature
• scripts/: utilidades de scheduler en Windows

Datos de acceso (Entorno de desarrollo)

Las credenciales de administrador se generan automáticamente al ejecutar las migraciones con seeders:

php artisan migrate:fresh --seed

O si prefieres solo los seeders sin resetear migraciones:

php artisan db:seed

Consulta database/seeders/ para ver los datos que se cargan.

Notas

• No subir archivos sensibles al repositorio (.env, claves, tokens).
• Mantener este README actualizado ante cambios de version o arquitectura.