Repository Docs & Knowledge Base

Consolidated Spensara documentation repository (722 Markdown & architecture documents in ../repository)

Built Word Documents (.docx): Spensara Overview (.docx) Capability Assessment (.docx) Brink POS Ingestion Analysis (.docx) The Borg Ingestion Architecture (.docx)

Agent Tooling (71)

Automation workflows, orchestration references, and developer tooling guides.

agent-tooling/Front/AGENT.md 1,725 bytes · Updated Oct 23, 2026 10:44 AM EDT

Raw File

Frontend - Laravel Web Application

Laravel 12 web application providing the manager-facing UI for the monitoring system. Front is a BFF only: authentication comes from Keycloak/OIDC and all customer, user, document, activity, and tenant data comes from backend APIs.

Stack

PHP 8.2+ with Laravel 12
Vite 7 for asset bundling
Tailwind CSS 4 for styling
Flowbite for UI components
ApexCharts for data visualization

Routes

/ - Dashboard (requires auth)
/events - Events view
/investigate - Investigation view
/recommendation - Recommendations view
/login - Authentication

Build & Run

bash

# Install dependencies and setup
composer setup

# Development (runs server, sync queue, logs, and vite concurrently)
composer dev

# Or individually:
php artisan serve          # HTTP server
npm run dev                # Vite dev server
php artisan queue:listen   # Optional worker if async queues are enabled

Code Style

Follow PSR-12 coding standard
Use Laravel Pint for code formatting: ./vendor/bin/pint
Controllers in app/Http/Controllers/
Middleware authentication via hydrate-oidc and role
Do not add Eloquent models, migrations, seeders, or local auth/session persistence

Testing