prvng_platform/config/README.md

Platform Service Configuration Files\n\nThis directory contains 16 production-ready TOML configuration files generated from Nickel schemas\nfor all platform services across all deployment modes.\n\n## Generated Files\n\n4 Services × 4 Deployment Modes = 16 Configuration Files\n\n\norchestrator.{solo,multiuser,cicd,enterprise}.toml (2.2 kB each)\ncontrol-center.{solo,multiuser,cicd,enterprise}.toml (3.4 kB each)\nmcp-server.{solo,multiuser,cicd,enterprise}.toml (2.7 kB each)\ninstaller.{solo,multiuser,cicd,enterprise}.toml (2.5 kB each)\n\n\nTotal: ~45 KB, all validated and ready for deployment\n\n## Deployment Modes\n\n| Mode | Resources | Database | Use Case | Load |\n| ------ | ----------- | ---------- | ---------- | ------ |\n| solo | 2 CPU, 4 GB | Embedded | Development | ORCHESTRATOR_MODE=solo |\n| multiuser | 4 CPU, 8 GB | PostgreSQL/SurrealDB | Team Staging | ORCHESTRATOR_MODE=multiuser |\n| cicd | 8 CPU, 16 GB | Ephemeral | CI/CD Pipelines | ORCHESTRATOR_MODE=cicd |\n| enterprise | 16+ CPU, 32+ GB | SurrealDB HA | Production | ORCHESTRATOR_MODE=enterprise |\n\n## Quick Start\n\n### Load a configuration mode\n\n\n# Solo mode (single developer)\nexport ORCHESTRATOR_MODE=solo\nexport CONTROL_CENTER_MODE=solo\n\n# Multiuser mode (team development)\nexport ORCHESTRATOR_MODE=multiuser\nexport CONTROL_CENTER_MODE=multiuser\n\n# Enterprise mode (production HA)\nexport ORCHESTRATOR_MODE=enterprise\nexport CONTROL_CENTER_MODE=enterprise\n\n\n### Override individual fields\n\n\nexport ORCHESTRATOR_SERVER_WORKERS=8\nexport ORCHESTRATOR_SERVER_PORT=9090\nexport CONTROL_CENTER_REQUIRE_MFA=true\n\n\n## Configuration Loading Hierarchy\n\nEach service loads configuration with this priority:\n\n1. Explicit path — {SERVICE}_CONFIG environment variable\n2. Mode-specific — {SERVICE}_MODE → provisioning/platform/config/{service}.{mode}.toml\n3. Legacy — config.user.toml (backward compatibility)\n4. Defaults — config.defaults.toml or built-in\n5. Field overrides — {SERVICE}_* environment variables\n\n## Docker Compose Integration\n\n\nexport DEPLOYMENT_MODE=multiuser\ndocker-compose -f provisioning/platform/infrastructure/docker/docker-compose.yml up\n\n\n## Kubernetes Integration\n\n\n# Load enterprise mode configs into K8s\nkubectl create configmap orchestrator-config \\n --from-file=provisioning/platform/config/orchestrator.enterprise.toml\n\n\n## Validation\n\nVerify all configs parse correctly:\n\n\nfor file in *.toml; do\n nu -c "open '$file'" && echo "✅ $file" || echo "❌ $file"\ndone\n\n\n## Structure\n\n- orchestrator.*.toml — Workflow engine configuration\n- control-center.*.toml — Policy/RBAC backend configuration\n- mcp-server.*.toml — MCP server configuration\n- installer.*.toml — Installation/bootstrap configuration\n\nEach file contains service-specific settings for networking, storage, security, logging, and monitoring.\n\n## Related Documentation\n\n- Configuration workflow: provisioning/.typedialog/provisioning/platform/configuration-workflow.md\n- Usage guide: provisioning/.typedialog/provisioning/platform/usage-guide.md\n- Schema definitions: provisioning/.typedialog/provisioning/platform/schemas/\n- Default values: provisioning/.typedialog/provisioning/platform/defaults/\n\n## Generated By\n\nFramework: TypeDialog + Nickel Configuration System\nDate: 2026-01-05\nStatus: ✅ Production Ready