Changelog
All notable changes to VENI-AI Platform will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[Unreleased]
Documentation
- Restructured documentation by professional roles (PO, BA, Developer)
- Added Product Owner hub with roadmap, service catalog, and KPIs
- Added Business Analyst hub with requirements and user stories
- Added Developer hub with architecture, guides, and reference
- Updated VitePress navigation with role-based sidebar
- Added comprehensive glossary
- Improved navigation structure
[1.0.0-beta] - 2026-01-10
Added
Shell Application
- Complete Shell application with production-ready features
- Authentication & Access (Keycloak OAuth, JWT tokens, session management)
- Service Discovery (service list, categorization, search, filtering)
- Service Navigation (Module Federation, dynamic loading, breadcrumbs)
- Configuration Management (service registry, admin UI, health checks)
- Token Distribution (BroadcastChannel, cookies, URL parameters)
- Performance Optimization (code splitting, lazy loading)
- Security Hardening (security headers, input validation, rate limiting)
- Monitoring & Observability (error tracking, performance monitoring)
Drive Service
- File upload and management (single & multiple files)
- File download functionality
- Folder hierarchy support
- File and folder CRUD operations
- MinIO integration for object storage
- PostgreSQL database with Drizzle ORM
- Token exchange architecture (Keycloak → Drive JWT)
- Service-specific JWT authentication
Platform Infrastructure
- Docker Compose setup for all services
- Keycloak (Identity Provider) integration
- Traefik (Reverse Proxy) configuration
- MinIO (Object Storage) setup
- Redis (Cache) integration
- Prometheus + Grafana (Monitoring)
- Loki (Log Aggregation)
Templates
- VENI-service template (API + UI)
- Ignis service template (API only)
- UI component templates
CLI Tool
- Service creation (
veni create service) - Service registration (
veni register) - Interactive prompts and validation
Documentation
- Complete platform documentation
- Architecture documentation (SCS pattern)
- Authentication architecture guide
- Developer guides (backend, frontend)
- Deployment guides (Docker, Kubernetes)
- Integration guides
- API reference
- CLI reference
Security
- Service-specific JWT secrets (no shared secrets)
- Token exchange pattern implementation
- JWKS-based Keycloak token verification
- Security headers and CSP
- Rate limiting on public endpoints
- Input validation and sanitization
Release Notes
Version 1.0.0-beta
Release Date: January 10, 2026
Status: Beta - Production Ready (Shell), Beta (Services)
This is the initial beta release of the VENI-AI Platform, featuring:
- ✅ Production-Ready Shell Application - Complete with all core features
- ✅ Drive Service - File management functionality
- ✅ Self-Contained System Architecture - Fully independent services
- ✅ Token Exchange Authentication - Secure service isolation
- ✅ Module Federation - Dynamic microfrontend loading
- ✅ Docker Deployment - Complete infrastructure setup
- ✅ Comprehensive Documentation - Architecture, guides, and references
Known Limitations:
- Drive service Phase 1 features (file sharing, search, preview in development)
- Test coverage below target (38.45%, target: 70%+)
- Some optional features pending (RS256 tokens, Redis integration)
Next Release: Version 1.0.0 (stable) - Planned for Q1 2026
Upgrade Guides
Upgrading from Pre-Release
If you're using a pre-release version, please follow these steps:
- Backup your data - Export databases and files
- Update infrastructure - Pull latest Docker images
- Update services - Pull latest service code
- Run migrations - Execute database migrations
- Update configuration - Review environment variables
- Test thoroughly - Verify all functionality
Breaking Changes:
- JWT secret management changed (each service needs unique secret)
- Authentication architecture updated (token exchange required)
- Service registration API changes
See individual service changelogs for detailed upgrade instructions.
Contributing
See Contributing Guidelines for how to contribute to this project.