PROFORMAX

×

LARAVEL

Gestión moderna y eficiente de proformas, clientes y productos para empresas.

---

📚 Índice

• Características
• Creación de la base de datos
• Instalación rápida
• Comandos útiles
• Configuración recomendada
• Tips y personalización
• Estructura del proyecto
• Notas finales

---

✨ Características

• ✅ Gestión completa de proformas y borradores
• 📄 Generación de PDFs profesionales (con barryvdh/laravel-dompdf)
• 📱 Interfaz responsive optimizada
• 👨‍💻 Sistema multi-usuario
• 📝 Gestion rápida de proformas
• 🎨 Personalización visual y branding

---

🗄️ Creación de la base de datos

🏗️ ¡Un paso y listo!

Crea una base de datos llamada proformax con cotejamiento utf8mb4_unicode_ci antes de migrar 🚦. Así tendrás soporte para todos los caractéres y emojis que necesites.

---

🚀 Instalación rápida

# 1. Clona el repositorio
$ git clone <url-del-repo>
$ cd proformax

# 2. Instala dependencias PHP
$ composer install

# 3. Configura tu entorno
$ cp .env.example .env
# Edita .env con tus credenciales de la bd creada

# 4. Genera clave, migra y llena la base de datos
$ php artisan key:generate
$ php artisan migrate --seed

# 5. Haz público el almacenamiento para los logos
$ php artisan storage:link

# 6. (Opcional) Publica la paginación con Tailwind
$ php artisan vendor:publish --tag=laravel-pagination

¡ARRANCA EL PROYECTO EN TU NAVEGADOR!

php artisan serve

Accede a http://127.0.0.1:8000 para ver la app en acción 🚀

---

🧹 Comandos útiles

• Limpiar cachés de Laravel:

  php artisan config:clear && php artisan route:clear && php artisan view:clear && php artisan config:cache

• Limpiar caché de Composer:

  composer dump-autoload

---

⚙️ Configuración recomendada (php.ini)

Aumenta los límites para subir archivos y memoria:

upload_max_filesize = 20M
post_max_size = 25M
max_file_uploads = 20
memory_limit = 256M

---

🛠️ Tips y personalización

• Autenticación personalizada:
  • Para forzar redirección a login, edita: vendor/laravel/framework/src/Illuminate/Auth/Middleware/Authenticate.php

    protected function unauthenticated($request, array $guards)
    {
        throw new AuthenticationException(
            'Unauthenticated.',
            $guards,
            $request->expectsJson() ? null : route('login'),
        );
    }
    // Y comenta el método redirectTo()

• Personaliza los colores y el branding en resources/views/appsita.blade.php y los assets de Tailwind.
• Agrega tus propios campos en los modelos y migraciones según las necesidades de tu empresa.

---

📦 Estructura del proyecto

proformax/
├── app/
│   ├── Models/           # Modelos Eloquent (Company, Customer, Product, Paper, User)
│   └── Http/Controllers/ # Lógica de negocio y endpoints
├── database/
│   ├── migrations/       # Migraciones de tablas
│   └── seeders/          # Datos de ejemplo
├── resources/views/      # Vistas Blade (UI)
├── public/storage/       # Archivos subidos (logos, etc)
└── ...

---

💡 Notas finales

• Sistema optimizado para empresas multiusuario.
• UI moderna con TailwindCSS y generación de PDFs con DomPDF.
• Si tienes problemas, limpia cachés y revisa permisos de storage/ y .env.

---

¡Listo para usar y personalizar! 🚀