Deployment Guide

This section covers local setup and production deployment. Use it as operational reference after reading the Collaborator Guide.

Table of Contents

  1. TOC

Overview

The system can be deployed in several configurations:

Quick Start (Development)

git clone https://github.com/metanull/inventory-app.git
cd inventory-app
composer install
npm install
cp .env.example .env
php artisan key:generate
composer dev

This starts the Laravel server, asset watcher, and queue worker. Access the main back-office at http://localhost:8000/admin.

Architecture Overview

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Web Server    │    │    Laravel      │    │    Database     │
│  (Apache/Nginx) │◄──►│   Application   │◄──►│   (MariaDB)    │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         │                       │
         ▼                       ▼
    Static Assets          Business Logic
      CSS/JS                 Filament /admin back-office
    Uploaded Images        REST API (/api routes)
                           Authentication & Permissions

The Filament /admin panel is the primary production UI. The Vue.js SPA demo exists as a reference for external API consumers and is not part of the core deployment.

Security

Next Steps