README

The WOW control room for your AI spend. A dense, Bloomberg-grade React console for padosoft/laravel-ai-finops — dashboards, budgets, policies, approvals, cost-aware routing, forecasting, chargeback, alerts and a FinOps copilot.

What you get

A single React SPA mounted at /admin/ai-finops that drives every laravel-ai-finops endpoint — no mocks, all live data over session + CSRF:

• Dashboard — KPIs, spend trend, top-models donut, budget burn, anomalies.
• Usage Explorer & Call/Trace — filterable ledger + per-step cost flame-graph, with a cost-method badge (actual / computed / estimated / covered), an estimated-tokens marker, and the provider-billed amount.
• Pricing — multi-source (LiteLLM ⊕ OpenRouter ⊕ manual) + sync + overrides; manual mask supports per-1M / EUR and fal.ai media units (per second/image/megapixel + unit rate).
• Diagnostics — health + cost estimator, including estimate-from-prompt (server estimates tokens).
• Budgets · Policies · Approvals · Chargeback · Alerts — full governance, CRUD + workflows.
• Forecast · Cost-aware Routing · What-if · Price Watcher · Credit Pools — the intelligence layer.
• FinOps Copilot · CO₂/ESG · Settings · Diagnostics.

Dark/light themes, command-ready shell, accessible tables/drawers, dense data-first layout.

Quick start

# 1. Install the core (if not already) and this admin panel
composer require padosoft/laravel-ai-finops
composer require padosoft/laravel-ai-finops-admin

# 2. Publish the built admin assets
php artisan vendor:publish --tag=ai-finops-admin-assets

# 3. (optional) publish config to change the route prefix / api base
php artisan vendor:publish --tag=ai-finops-admin-config

Open /admin/ai-finops (behind your app's auth middleware). That's it — the panel reads the core API at config('ai-finops.routes.prefix').

Built assets ship with the package. Building from source: npm ci && npm run build.

Stack

React 19 · Vite 6 · Tailwind v4 · TypeScript · React Router 7 · TanStack Query. The visual design system is a pixel-perfect port of the approved prototype (resources/css/design-system.css). PHP side is a thin Laravel package: a Blade shell + a Vite manifest reader serving the SPA.

Configuration

config/ai-finops-admin.php: route.prefix (default admin/ai-finops), route.middleware (default ['web','auth']), api_base (defaults to the core prefix), app_name, logout_url.

Screenshots

A tour of the panel. Every screen is wired to live laravel-ai-finops endpoints — no mocks.

Dashboard

KPIs, spend trend, top-models donut, budget burn and anomalies — in both themes.

Usage & Call/Trace

Filterable ledger, per-call detail and the agentic per-step cost flame-graph.

Pricing

LiteLLM mirror + sync, with local per-model overrides.

Governance — Budgets, Policies, Approvals, Chargeback, Alerts

Hierarchical budgets, the policy DSL, the approval queue, chargeback allocation and the alert center.

Intelligence — Forecast, Routing, What-if, Price Watch, Credits

Month-end forecasting & anomalies, cost-aware routing, the what-if simulator, the provider price watcher and prepaid credit pools.

Copilot, CO₂/ESG, Settings & Diagnostics

A natural-language FinOps copilot, carbon/ESG footprint, settings and the diagnostics workbench.

Testing

composer install && vendor/bin/phpunit   # PHP: shell renders + bootstrap
npm ci && npm run test                    # Vitest: components + screens (35 tests)
npm run build                             # Vite production build

CI runs PHP (8.3/8.4) + JS build/test on every PR.

License

Apache-2.0 © Padosoft