Platform Roadmap
IMPLEMENTATION RULES: Before implementing this plan, read and follow:
- WORKFLOW.md - The implementation process
- PLANS.md - Plan structure and best practices
Status: Active
Goal: Track prioritized investigations and planned work for the UIS platform
Last Updated: 2026-03-17
Open Investigations
Items that still need work, grouped by priority.
Priority 0: Cleanup & Documentation
All items completed — see Completed table below.
Priority 1: Infrastructure Hardening
| # | Investigation | Status | Summary |
|---|---|---|---|
| 2 | Version pinning | Backlog | 18 of 21 Helm charts unpinned. Pin versions to prevent breaking changes. |
| 2b | Service version metadata | Backlog | Decide how service scripts expose version info for docs generation. |
| 3 | Gravitee fix | Backlog | Only unverified service. Hardcoded credentials, no remove playbook, wrong namespace. |
Priority 2: New Service Deployments
| # | Investigation | Status | Summary |
|---|---|---|---|
| 5 | Enonic app deployment pipeline | Investigation complete | Sidecar pulls JARs from GitHub Releases into $XP_HOME/deploy. |
| 8 | Enonic content deployment | Backlog | Content migration between environments. Manual workflow works initially. |
| 14 | EspoCRM | Backlog | Install EspoCRM CRM platform in UIS. |
Priority 3: Platform Improvements
| # | Investigation | Status | Summary |
|---|---|---|---|
| 9 | Authentik user config | Investigation complete | Move user-configurable Authentik data from manifests/ to .uis.extend/. |
| 12 | Docs markdown update logic | Backlog | uis-docs-markdown.sh can only skip or overwrite — no merge/update mode. |
| 15 | Undeploy --purge flag | Backlog | Add --purge flag to ./uis undeploy to delete associated PVCs. |
| 16 | Verification playbooks usage | Backlog | Audit which verification playbooks have active callers. |
| 17 | Provision-host tools and auth | Backlog | Tools and authentication setup for provision-host container. |
Priority 4: Backstage Enhancements
| # | Investigation | Status | Summary |
|---|---|---|---|
| 18 | Backstage enhancements | Backlog | Evaluate Scaffolder, TechDocs, Grafana plugin, and other features. Enhancement 1 (API Entities) complete. |
| 19 | Backstage auth | Backlog | Add Authentik OIDC authentication to Backstage, replacing guest access. |
Priority 5: Future Work
Requires real infrastructure or has no immediate need.
| # | Investigation | Status | Summary |
|---|---|---|---|
| 10 | Host docs migration | Backlog | Legacy host docs describe old deployment approach. Blocked by remote targets. |
| 11 | Remote deployment targets | Investigation complete | Azure AKS, Multipass, Raspberry Pi. Needs real infrastructure to test. |
Completed
Items where the work has been implemented.
| # | Investigation / Plan | Completed | Summary |
|---|---|---|---|
| 1 | Elasticsearch upgrade | 2026-03-09 | ES 8.5.1 → 9.3.0. PLAN |
| 4 | Enonic XP deployment | 2026-03-10 | CMS platform, manifest 085. PLAN |
| 6 | OpenMetadata deployment | 2026-03-10 | Data governance v1.12.1, manifest 340. PLAN |
| 7 | Nextcloud + OnlyOffice | 2026-03-11 | Collaboration platform, manifest 620. PLAN |
| — | Backstage metadata & generator | 2026-03-11 | Service metadata fields and catalog generator. |
| — | Backstage deployment | 2026-03-12 | Deploy RHDH 1.9 with K8s plugin and catalog. |
| — | Backstage API entities | 2026-03-13 | 7 API entities with providesApis/consumesApis relationships. |
| 13 | Container pull command | 2026-03-12 | Added ./uis pull to PowerShell wrapper. |
| — | Documentation rewrite | 2026-02-27 | Complete docs restructure. |
| — | Documentation generation | 2026-03-02 | Automated docs from service metadata. |
| — | Dev template ingress cleanup | 2026-03-04 | Remove old ingress templates. |
| — | PowerShell ErrorActionPreference | 2026-03-04 | Fix error handling in PS wrapper. |
| — | Backstage investigation | 2026-03-11 | Initial investigation — led to PLAN-001/002/004. |
| — | Rename packages→services | 2026-03-17 | Renamed docs/packages/ → docs/services/, updated all links, scripts, and config. Part of #20 Old system cleanup. |
| — | Delete old deployment system | 2026-03-17 | Deleted provision-host/kubernetes/ (60 scripts, ~6,149 lines), scripts/packages/, and ./uis provision command. Part of #20 Old system cleanup. |
| — | How Deployment Works | 2026-03-17 | User-facing doc page in advanced/ covering deploy flow, dependencies, health checks, stacks, and metadata fields. Part of #20 Old system cleanup. |
| — | Documentation gap filling | 2026-03-17 | CI/CD and generator docs, integration testing guide, stack creation guide, service-overrides cleanup, getting-started improvements. Part of #20 Old system cleanup. |
Service Migration (Historical)
The original service migration is tracked in STATUS-service-migration.md. Summary: 25 of 26 services verified, only Gravitee remains (broken before migration — see #3 Gravitee fix). Automated test suite (./uis test-all) covers 23 services with 47/47 PASS.