otghcloud/aurora-access-core

Laravel package providing Aurora Access Control core domain, admin UI, routes, and runtime services.

v1.3.15 2026-08-11 18:16 UTC

Requires

• php: ^8.3
• laravel/framework: ^13.8
• laravel/pail: ^1.2
• laravel/sanctum: ^4.0
• laravel/tinker: ^3.0
• laravel/ui: ^4.6
• livewire/livewire: ^3.0
• php-mqtt/laravel-client: ^1.8

Requires (Dev)

• fakerphp/faker: ^1.23
• laravel/pint: ^1.29
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.6
• pestphp/pest: ^4.7
• pestphp/pest-plugin-laravel: ^4.1

MIT

• framework
• laravel

Published on Packagist.org on 2026-08-11 18:17 UTC

README

Aurora Access Core is a Laravel package that provides the access-control domain, API routes, admin UI, migrations, commands, and runtime services.

This README is intentionally consumer-focused.

Quick Setup (One Command)

Download and run the installer:

curl -fsSL https://raw.githubusercontent.com/otghcloud/aurora-access-core/main/setup.sh | bash

The setup script will:

• Prompt for install directory
• Validate required tooling (PHP, Composer, npm) and PHP extensions
• Prompt for database, Redis, and MQTT settings
• Prompt for initial admin user details (name, email, password)
• Create a fresh Laravel app and install Aurora Access Core
• Run migrations and frontend build

Security note:

• Review remote scripts before running in sensitive environments.

Setup Script Options

bash setup.sh --help

Supported options:

• --target <directory>: target directory for the Laravel app
• --core-version <constraint>: package constraint for otghcloud/aurora-access-core
• --with-adapters: install adapter packages during setup
• --use-local-packages <dir>: use local package paths from <dir>/packages/* (development/smoke use)
• --validate-only: verify installer prerequisites and exit without creating an app
• --non-interactive: skip prompts and use DEFAULT_* environment variables

Non-interactive example:

DEFAULT_TARGET_DIR=./aurora-access \
DEFAULT_APP_NAME="Aurora Access Control" \
DEFAULT_APP_URL="http://localhost" \
DEFAULT_DB_CONNECTION=sqlite \
DEFAULT_DB_DATABASE=database/database.sqlite \
DEFAULT_REDIS_HOST=127.0.0.1 \
DEFAULT_REDIS_PORT=6379 \
DEFAULT_MQTT_HOST=127.0.0.1 \
DEFAULT_MQTT_PORT=1883 \
DEFAULT_ADMIN_NAME="Admin User" \
DEFAULT_ADMIN_EMAIL="[e-mail]" \
DEFAULT_ADMIN_PASSWORD="change-me-123" \
bash setup.sh --non-interactive

Manual Installation

composer require otghcloud/aurora-access-core

Optional adapter packages:

composer require \
  otghcloud/aurora-access-adapter-edgelink \
  otghcloud/aurora-access-adapter-modbus \
  otghcloud/aurora-access-adapter-opc \
  otghcloud/aurora-access-adapter-serial-wiegand

Integration Checklist

1. Run package migrations:

php artisan migrate

1. Ensure your environment includes database, Redis, and MQTT values required by your deployment.

2. Create and authorize administrative users in your host app.

To create the initial login user directly via artisan:

php artisan app:create-initial-admin-user --name="Admin User" --email="[e-mail]" --password="change-me-123"

What gets registered

• Routes:
  • Web/admin routes from routes/web.php
  • API routes under /api from routes/api.php
• Console:
  • Commands and schedule registrations from routes/console.php
• Migrations:
  • Core access-domain migration set
• Config:
  • mqtt-client.php defaults
• Views:
  • Package Blade templates used by the admin/auth UI

Publishing assets

php artisan vendor:publish --tag=aurora-access-core-config
php artisan vendor:publish --tag=aurora-access-core-migrations
php artisan vendor:publish --tag=aurora-access-core-views