Goalixa Architecture

Last Updated: April 2026

What Is Goalixa?

Goalixa is a personal productivity platform designed to help individuals transform big goals into actionable plans, organized projects, and daily tasks. The platform combines goal setting, project management, habit tracking, and time optimization into a unified experience that helps users stay focused and productive.

Built as a modern cloud-native microservices application, Goalixa demonstrates production-ready architecture patterns with clear service boundaries, comprehensive observability, and GitOps-based deployment.

User Request Journey: How Services Communicate

When a user interacts with Goalixa, requests flow through a carefully orchestrated chain of microservices:

Request Flow Breakdown:

1. User Action — User interacts with the PWA or web interface
2. Ingress — Nginx Ingress routes HTTPS traffic to the appropriate service
3. BFF — Backend for Frontend acts as the API gateway, handling authentication proxy and request aggregation
4. Auth Service — Validates JWT tokens and provides user context
5. Core API — Processes business logic and data operations
6. Data Layer — PostgreSQL for persistent storage, Redis for caching
7. Response — Data flows back through BFF to the user with optimal caching

Services Overview

Goalixa consists of specialized microservices, each with a single responsibility:

Service Details:

Auth (Authentication Service)

• Dual-Token System: Access tokens (15-minute TTL) + Refresh tokens (7-day TTL)
• Security: HTTP-only cookies, token rotation on refresh
• OAuth: Google OAuth integration for social login
• Database: Dedicated PostgreSQL database (authdb)

Core API (Main Business Logic)

• 3-Layer Architecture: Presentation → Service → Repository
• Features: Task timer, goal tracking, project management, habits, reports
• Database: Dedicated PostgreSQL database (goalixa)
• Backup: Automated database backups

BFF (Backend for Frontend)

• API Gateway: Unified entry point (/bff/*)
• Aggregation: Optimized endpoints like /bff/aggregate/dashboard
• Caching: Redis-based performance optimization
• Auth Proxy: Automatic token validation and refresh

Syntra (AI DevOps Service)

• Multi-Agent System: CrewAI-powered task orchestration
• Capabilities: Kubernetes operations, code review, incident investigation
• Planning: AI-driven task breakdown and execution

Infrastructure

Goalixa runs on a cloud-native infrastructure designed for high availability and scalability:

Infrastructure Components:

• Virtual Machines: Linux servers hosting the Kubernetes cluster
• Kubernetes Cluster: Container orchestration with namespace separation (staging/production)
• Pods: Each service runs multiple replicas for high availability
• Services: Kubernetes Services provide stable networking endpoints
• Ingress: Nginx Ingress Controller for HTTPS routing

Data Storage

Goalixa uses a multi-database architecture optimized for different data types:

Database Details:

CI/CD Pipeline

Goalixa uses a modern GitOps-based CI/CD pipeline for automated deployments:

Pipeline Stages:

1. Continuous Integration (GitHub Actions)

• Trigger: Push to staging or main branch
• Build: Multi-architecture Docker builds (amd64/arm64)
• Test: Run unit tests and integration tests
• Push: Deploy images to Harbor registry

2. Container Registry (Harbor)

• Private Registry: Harbor container registry
• Image Tagging: {service}/{service}:latest
• Multi-Arch: Support for different CPU architectures
• Vulnerability Scanning: Automated security scans

3. Continuous Deployment (ArgoCD)

• GitOps: Configuration stored in Git repository
• Automatic Sync: Detects image changes and auto-deploys
• Helm Integration: Parameter-based deployments
• Environments: Separate applications for staging/production

Branch Strategy:

GitOps with ArgoCD

ArgoCD is the backbone of Goalixa’s deployment automation, implementing true GitOps practices:

How ArgoCD Works:

1. Declarative Configuration: All Kubernetes manifests stored in Git
2. Automatic Sync: ArgoCD detects changes and applies them automatically
3. Desired State: Git is the single source of truth for cluster state
4. Self-Healing: ArgoCD reconciles drift between actual and desired state

Benefits:

• Version Control: All deployment changes tracked in Git
• Rollback: Easy rollback to previous Git commits
• Audit Trail: Complete history of deployment changes
• Collaboration: Team can review deployment changes via PRs

Harbor Container Registry

Harbor serves as Goalixa’s private Docker registry with enterprise-grade features:

Key Features:

• Security Scanning: Vulnerability scanning for all images
• Access Control: Role-based access control (RBAC)
• Replication: Image replication between registries
• Notary: Content trust for image signing
• Webhooks: Notifications on image pushes

Monitoring & Observability

Goalixa implements comprehensive monitoring across the entire stack:

Monitoring Components:

1. Prometheus (Metrics Collection)

• Scrape Interval: Every 30 seconds
• Targets: BFF Service, Auth Service, Core API, Node Exporters

2. Grafana (Visualization & Dashboards)

• Custom Dashboards: Service-specific dashboards
• Metrics: Request rate, latency, error rates, resource utilization

3. Alertmanager (Alert Routing)

• Alert Sources: Prometheus alert rules
• Routing: Intelligent alert grouping and routing
• Channels: Slack, Email (configurable)

4. Node Exporters (Host Metrics)

• CPU: Usage, load averages
• Memory: Usage, swap, buffers
• Disk: Usage, I/O statistics
• Network: Traffic, errors

Architecture Principles

Goalixa’s architecture is built on these core principles:

1. Microservices

• Single responsibility per service
• Independent deployment and scaling
• Clear service boundaries

2. Backend for Frontend (BFF)

• Optimized API for frontend needs
• Request aggregation reduces round trips
• Authentication proxy simplifies frontend

3. GitOps

• Infrastructure as code
• Declarative configuration
• Automated deployment

4. Observability First

• Comprehensive metrics collection
• Structured logging
• Proactive alerting

5. Security by Design

• Dual-token authentication
• HTTP-only cookies
• Short-lived access tokens
• Secrets management

Technology Stack Summary

Built with ❤️ using modern cloud-native practices