MATIH Platform is in active MVP development. Documentation reflects current implementation status.
1. Introduction
Platform Admin

Platform Admin

The Platform Admin is responsible for deploying, configuring, monitoring, and operating the MATIH Platform. Platform Admins manage tenant provisioning, infrastructure health, security configuration, and capacity planning. They work primarily in the Control Plane UI (port 3004) and the Data Plane UI (port 3005).


Role Summary

AttributeDetails
Primary workbenchControl Plane UI (3004), Data Plane UI (3005)
Key servicesTenant Service, IAM Service, Infrastructure Service, Observability API
Common tasksProvision tenants, monitor health, manage users, configure platform
Technical depthHigh -- Kubernetes, Helm, Terraform, observability tools

Day-in-the-Life Workflow

TimeActivityPlatform Feature
9:00 AMReview platform health dashboardObservability API, Grafana dashboards
9:30 AMCheck overnight alertsAlert manager, notification history
10:00 AMProvision new tenantTenant Service provisioning workflow
11:00 AMReview resource utilizationPer-tenant resource quota monitoring
1:00 PMConfigure feature flags for tenantConfig Service, feature flag management
2:00 PMInvestigate service degradationDistributed tracing, log analysis
3:00 PMUpdate platform configurationConfig Service, Helm value updates
4:00 PMReview security audit logsAudit Service, compliance reports

Key Capabilities

Tenant Management

The Tenant Service provides comprehensive tenant lifecycle management:

FeatureDescription
Tenant provisioningMulti-phase provisioning with automatic namespace, database, and service setup
Tenant suspensionGraceful suspension with data preservation
Tier managementFree, Professional, Enterprise tier assignment
Configuration overridePer-tenant feature flags and settings
DNS and ingressPer-tenant DNS zones and TLS certificates

Infrastructure Monitoring

The Observability API aggregates health data across all namespaces:

FeatureDescription
Service healthReal-time health status for all 24 services
Resource utilizationCPU, memory, and storage usage per namespace
Capacity planningTrend analysis for resource consumption
Alert managementAlert routing, acknowledgment, and escalation
SLI/SLO reportingService-level indicator and objective tracking

Security Administration

FeatureDescription
User managementCreate, suspend, and delete user accounts
Role assignmentRBAC role and permission management
API key managementCreate, rotate, and revoke API keys
Audit log reviewSearch and filter the immutable audit trail
Network policy managementReview and update namespace NetworkPolicies

Configuration Management

The Config Service provides centralized configuration:

FeatureDescription
Hierarchical configurationGlobal, environment, service, and tenant-level settings
Feature flagsGradual rollout with tenant-level targeting
Version historyConfiguration change tracking with rollback
Zero-downtime updatesRedis Pub/Sub propagation without service restarts

Backend Services

ServicePortInteraction
tenant-service8082Tenant CRUD, provisioning, configuration
iam-service8081User management, role assignment, API keys
config-service8888Configuration management, feature flags
infrastructure-service8089Resource provisioning, DNS management
observability-api8088Health monitoring, metrics aggregation
audit-service8086Audit trail queries, compliance reports
billing-service8087Usage tracking, subscription management

Related Chapters