<p align="center">
    <img src="../resources/provisioning_logo.svg" alt="Provisioning Logo" width="300"/>
</p>

<p align="center">
    <img src="../resources/logo-text.svg" alt="Provisioning" width="500"/>
</p>

# Platform Features

Complete documentation for the 12 core Provisioning platform capabilities
enabling enterprise infrastructure as code across multiple clouds.

## Overview

Provisioning provides comprehensive features for:

- **Workspace organization** - Primary mode for grouping infrastructure, configs, schemas, and extensions with complete isolation
- **Intelligent CLI** - Modular architecture with 80+ keyboard shortcuts, decentralized command registration, 84% code reduction
- **Type-safe configuration** - Nickel as source of truth for all infrastructure definitions with mandatory validation
- **Batch operations** - DAG scheduling, parallel execution, multi-cloud workflows with dependency resolution
- **Hybrid orchestration** - Execute across Rust and Nushell with file-based persistence and atomic operations
- **Interactive guides** - Step-by-step guided infrastructure deployment with validation and error recovery
- **Testing framework** - Container-based test environments for validating infrastructure configurations
- **Platform installer** - TUI and unattended installation with provider setup and configuration management
- **Security system** - Complete v4.0.0 with authentication, authorization, encryption, secrets management, audit logging
- **Daemon acceleration** - 50x performance improvement for script-heavy workloads via persistent Rust process
- **Intelligent detection** - Automated analysis detecting cost, compliance, performance, security, and reliability issues
- **Extension registry** - Central marketplace for providers, task services, plugins, and clusters with versioning

## Feature Guides

### Organization and Management

- **[Workspace Management](./workspace-management.md)** - Workspace mode, grouping,
  multi-tenancy, isolation, customization

- **[CLI Architecture](./cli-architecture.md)** - Modular design, 80+ shortcuts,
  decentralized registration, dynamic subcommands, 84% code reduction

- **[Configuration System](./configuration-system.md)** - Nickel type-safe
  configuration, hierarchical loading, profiles, validation

### Workflow and Operations

- **[Batch Workflows](./batch-workflows.md)** - DAG scheduling, parallel
  execution, conditional logic, error handling, multi-cloud, dependency resolution

- **[Orchestrator System](./orchestrator-system.md)** - Hybrid Rust/Nushell,
  file-based persistence, atomic operations, event-driven

- **[Provisioning Daemon](./provisioning-daemon.md)** - TCP service, 50x
  performance, connection pooling, LRU caching, graceful shutdown

### Developer and Automation Features

- **[Interactive Guides](./interactive-guides.md)** - Guided deployment, prompts,
  validation, error recovery, progress tracking

- **[Test Environment](./test-environment.md)** - Container-based testing,
  sandbox isolation, validation, integration testing

- **[Extension Registry](./extension-registry.md)** - Marketplace for
  providers, task services, plugins, clusters, versioning, dependencies

### Platform Capabilities

- **[Platform Installer](./installer.md)** - TUI and unattended modes,
  provider setup, workspace creation, configuration management

- **[Security System](./security-system.md)** - v4.0.0: JWT/OAuth, Cedar RBAC,
  MFA, audit logging, encryption, secrets management

- **[Detector System](./detector-system.md)** - Cost optimization, compliance,
  performance analysis, security detection, reliability assessment

- **[Nushell Plugins](./plugins.md)** - 17 plugins: tera, nickel, fluentd,
  secretumvault, 10-50x performance gains

- **[Version Management](./version-management.md)** - Semantic versioning,
  dependency resolution, compatibility, deprecation, upgrade workflows

## Feature Categories

| Category | Features | Use Case |
| ---------| - ---------| - ---------- |
| **Core** | Workspace Management, CLI Architecture, Configuration System | Organization, command discovery, type-safety |
| **Operations** | Batch Workflows, Orchestrator, Version Management | Multi-cloud, DAG scheduling, persistence |
| **Performance** | Provisioning Daemon, Nushell Plugins | Script acceleration, 10-50x speedup |
| **Quality & Testing** | Test Environment, Extension Registry | Configuration validation, distribution |
| **Setup & Installation** | Platform Installer | Installation, initial configuration |
| **Intelligence** | Detector System | Analysis, anomaly detection, cost optimization |
| **Security** | Security System, Complete v4.0.0 | Authentication, authorization, encryption |
| **User Experience** | Interactive Guides | Guided deployment, learning |

## Quick Navigation

### I want to organize my infrastructure
Start with [Workspace Management](./workspace-management.md) - primary organizational mode with isolation and customization.

### I want faster command execution
Use [Provisioning Daemon](./provisioning-daemon.md) - 50x performance improvement for scripts through persistent process and caching.

### I want to automate deployment
Learn [Batch Workflows](./batch-workflows.md) - DAG scheduling and multi-cloud orchestration with error handling.

### I need to ensure security
Review [Security System](./security-system.md) - complete authentication, authorization, encryption, audit logging.

### I want to validate configurations
Check [Test Environment](./test-environment.md) - container-based sandbox testing and policy validation.

### I need to extend capabilities
See [Extension Registry](./extension-registry.md) - marketplace for providers, task services, plugins, clusters.

### I need to find infrastructure issues
Use [Detector System](./detector-system.md) - automated cost, compliance, performance, and security analysis.

## Integration with Platform

All features are integrated via:

- **CLI commands** - Invoke from Nushell or bash
- **REST APIs** - Integrate with external systems
- **Nushell scripting** - Build custom automation
- **Nickel configuration** - Type-safe definitions
- **Extensions** - Add custom providers and services

## Related Documentation

- **Architecture Details** → See `provisioning/docs/src/architecture/`
- **Development Guides** → See `provisioning/docs/src/development/`
- **API Reference** → See `provisioning/docs/src/api-reference/`
- **Operation Guides** → See `provisioning/docs/src/operations/`
- **Security Details** → See `provisioning/docs/src/security/`
- **Practical Examples** → See `provisioning/docs/src/examples/`
