# Flux

## Docs

- [Flux API: Authentication, Roles, and Session Shape](https://doc.fluxop.ai/api/authentication.md): Auth modes (mock/entra/none), Entra Easy Auth claim decoding, Flux.Reader and Flux.Admin roles, and the GET /api/session response shape.
- [Cost Anomaly Endpoints](https://doc.fluxop.ai/api/cost-anomalies.md): Seasonal cost anomaly findings at subscription, service, and resource scope with investigation lifecycle, contributor drilldown, and CSV export.
- [Health and Session Endpoints](https://doc.fluxop.ai/api/health-session.md): GET /api/health returns runtime and database status. GET /api/session returns the authenticated user's identity, roles, and data currency information.
- [Azure Integration and Administration API Endpoints](https://doc.fluxop.ai/api/integrations.md): Configure Azure integration, trigger sync, inspect cost reconciliation, manage budgets and allocation, and check operational health via the Flux admin API.
- [Ask Flux Intelligence and Semantic Exploration API](https://doc.fluxop.ai/api/intelligence.md): Chat with Ask Flux, record feedback, attach browser timing, review admin transcripts, and run governed semantic queries over Azure cost and inventory.
- [Inventory and Changes Endpoints](https://doc.fluxop.ai/api/inventory-changes.md): Azure inventory with cost and opportunity enrichment, consecutive-snapshot diffs, and change-volume anomaly baselines. Supports CSV and XLSX export.
- [Opportunities and Evidence Endpoints](https://doc.fluxop.ai/api/opportunities.md): Unified Advisor and Flux Signals opportunity queue with confidence, valuation lineage, evidence packs for change requests, and CSV/XLSX export.
- [Flux REST API — Base URL, Auth, and Endpoint Index](https://doc.fluxop.ai/api/overview.md): FastAPI REST API at /api with Swagger at /docs. Covers base URL, auth modes, response formats, error codes, and the full endpoint index.
- [Reports Endpoints: Cost, FOCUS, Workload, Governance](https://doc.fluxop.ai/api/reports.md): Cost, FOCUS, workload, governance, fiscal outlook, budget, and catalog report endpoints. All require reader auth. Fiscal outlook config requires admin.
- [Right-Sizing Recommendations and Planning Boards API](https://doc.fluxop.ai/api/rightsizing.md): Retrieve VM right-sizing recommendations, manage planning boards and commitment buckets, record VM decisions, and import or export right-sizing plans.
- [Virtual Tags: Dimensions, Rules, and Showback Reports](https://doc.fluxop.ai/api/virtual-tags.md): Manage virtual tag dimensions and rules, preview rule impact, query per-resource effective tags, and bulk-import or roll back tag overrides in Flux.
- [Flux Configuration Reference: All Environment Variables](https://doc.fluxop.ai/configuration.md): Complete reference for every FLUX_ environment variable: server, DuckDB, Azure sync, Cost Management, anomaly detection, AI providers, and authentication.
- [Deploy Flux to Azure App Service — Production Setup](https://doc.fluxop.ai/deployment/azure-app-service.md): Deploy Flux on Azure App Service with managed identity, Easy Auth, and app roles. Covers required production app settings and pre-go-live steps.
- [Azure Pipelines CI/CD for Flux: Build, Test, and Deploy](https://doc.fluxop.ai/deployment/continuous-delivery.md): Azure Pipelines CI/CD for Flux using workload-identity federation. Every main commit triggers build, test, and deployment to App Service without secrets.
- [Configure Entra Authentication and Managed Identity](https://doc.fluxop.ai/deployment/entra-managed-identity.md): Configure Entra app roles and managed identity for Flux. Assign Azure RBAC to enable secretless access to Resource Graph, Advisor, and Cost Management.
- [Cost Management: FOCUS, History, and Anomaly Detection](https://doc.fluxop.ai/features/cost-management.md): Azure costs with FOCUS v1.0 charge ingestion, 90-day daily history, and median/MAD anomaly detection across subscription, service, and resource scopes.
- [Flux Intelligence: Governed AI Assistant for Cloud FinOps](https://doc.fluxop.ai/features/flux-intelligence.md): Ask Flux is a read-only AI assistant backed by 19 bounded governed tools. No database access or credentials — every answer traces to a named source.
- [Azure Inventory: Searchable Estate with Drift Detection](https://doc.fluxop.ai/features/inventory.md): Azure Resource Graph inventory enriched with cost and VM performance data. Snapshot drift detection flags unusual change volume using median/MAD baselines.
- [Opportunities: Unified Advisor and Flux Signals Findings](https://doc.fluxop.ai/features/opportunities.md): Azure Advisor and Flux Signals findings with evidence packs, confidence scoring, provenance-aware valuation, actionability gating, and CSV/XLSX export.
- [Flux Dashboard: Estate Health and Cost at a Glance](https://doc.fluxop.ai/features/overview-dashboard.md): The Flux overview dashboard shows estate shape, regional footprint, month-to-date actual cost, telemetry coverage, and the valued-action opportunity total.
- [VM Right-Sizing: Multi-Source Telemetry and Planning Boards](https://doc.fluxop.ai/features/rightsizing.md): Each VM receives an explicit coverage state. Azure Monitor and LogicMonitor telemetry with Advisor corroboration drives idle and resize classification.
- [Flux: Azure FinOps Intelligence Workspace Overview](https://doc.fluxop.ai/introduction.md): Flux is a governed Azure FinOps workspace that synchronizes inventory, cost, and telemetry into DuckDB and surfaces explainable optimization opportunities.
- [DuckDB Backup and Startup Recovery for Flux App Service](https://doc.fluxop.ai/operations/backup-recovery.md): Flux backs up DuckDB to Azure Blob Storage after each sync and restores the latest valid backup at startup when the database fails validation.
- [Flux Data Model: Tables, Schemas, and Design Principles](https://doc.fluxop.ai/operations/data-model.md): Reference for every DuckDB table Flux manages: inventory snapshots, cost data, anomalies, opportunities, telemetry, intelligence, and operational state.
- [Flux Synchronization: Schedules, Checkpoints, and Recovery](https://doc.fluxop.ai/operations/synchronization.md): A singleton durable sync worker serializes DuckDB writes. Source schedules, per-scope checkpoints, and last-good retention keep data valid after failures.
- [Virtual Tags: Governed Cost Allocation for Azure Resources](https://doc.fluxop.ai/operations/virtual-tags.md): Virtual tags classify Azure costs using governed dimensions without writing native tags. Manage rules, overrides, and showback reports from the Flux UI.
- [Flux Quickstart: Run Locally in Under Five Minutes](https://doc.fluxop.ai/quickstart.md): Install Flux locally, connect to Azure with PowerShell identity, load demo data, and explore inventory, cost, and opportunities in the React dashboard.