Core-API

Core-API/
├── main.py                      # Application entry point
├── app/
│   ├── __init__.py
│   ├── auth_client.py           # Auth service client
│   ├── metrics.py               # Prometheus metrics
│   ├── observability.py         # Logging configuration
│   ├── presentation/
│   │   └── routes.py            # API endpoints
│   ├── service/
│   │   └── task_service.py      # Business logic
│   ├── repository/
│   │   └── postgres_repository.py  # Database operations
│   └── auth/
│       ├── jwt.py               # JWT validation
│       ├── models.py            # Auth models
│       ├── oauth.py             # OAuth handlers
│       └── routes.py            # Auth endpoints
├── docker-compose.yml
└── k8s/                         # Kubernetes manifests

class Task:
    id: int
    title: str
    description: str
    status: str          # "pending", "in_progress", "completed"
    priority: str         # "low", "medium", "high"
    project_id: int
    labels: List[Label]
    created_at: datetime
    updated_at: datetime
    completed_at: Optional[datetime]
    due_date: Optional[date]
    daily_check: bool
    timer_start: Optional[datetime]

class Project:
    id: int
    name: str
    color: str
    user_id: int
    created_at: datetime
    updated_at: datetime

class Goal:
    id: int
    title: str
    description: str
    target_date: date
    status: str           # "pending", "in_progress", "completed"
    progress: int          # 0-100
    user_id: int
    subgoals: List[SubGoal]
    created_at: datetime
    updated_at: datetime

class Habit:
    id: int
    name: str
    frequency: str         # "daily", "weekly"
    streak: int
    completed_dates: List[date]
    user_id: int
    created_at: datetime

class TimeEntry:
    id: int
    task_id: int
    start_time: datetime
    end_time: Optional[datetime]
    duration: int          # seconds
    user_id: int

curl -X POST http://localhost:5000/api/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <access_token>" \
  -d '{
    "title": "Implement new feature",
    "description": "Add authentication flow",
    "priority": "high",
    "project_id": 1,
    "due_date": "2026-04-15"
  }'

{
  "id": 123,
  "title": "Implement new feature",
  "status": "pending",
  "priority": "high",
  "project_id": 1,
  "created_at": "2026-04-06T10:00:00Z"
}

curl -X POST http://localhost:5000/api/tasks/123/start \
  -H "Authorization: Bearer <access_token>"

{
  "message": "Timer started",
  "timer_start": "2026-04-06T10:30:00Z"
}

curl -X GET http://localhost:5000/api/goals/1 \
  -H "Authorization: Bearer <access_token>"

{
  "id": 1,
  "title": "Launch MVP",
  "description": "Release first version",
  "target_date": "2026-06-01",
  "status": "in_progress",
  "progress": 45,
  "subgoals": [
    {"id": 1, "title": "Setup CI/CD", "completed": true},
    {"id": 2, "title": "Add auth", "completed": true},
    {"id": 3, "title": "Create dashboard", "completed": false}
  ]
}

curl -X POST http://localhost:5000/api/habits \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <access_token>" \
  -d '{
    "name": "Morning exercise",
    "frequency": "daily"
  }'

{
  "id": 1,
  "name": "Morning exercise",
  "frequency": "daily",
  "streak": 0,
  "completed_dates": [],
  "created_at": "2026-04-06T10:00:00Z"
}

# Run locally with docker-compose
docker-compose up
 
# Run with custom configuration
docker run -e DATABASE_URL=postgresql://user:pass@host:5432/goalixa \
  -e SECRET_KEY=your-secret \
  goalixa-core-api:latest

apiVersion: apps/v1
kind: Deployment
metadata:
  name: core-api
spec:
  replicas: 3
  selector:
    matchLabels:
      app: core-api
  template:
    metadata:
      labels:
        app: core-api
    spec:
      containers:
      - name: core-api
        image: goalixa/core-api:latest
        ports:
        - containerPort: 5000
        env:
        - name: DATABASE_URL
          valueFrom:
            secretKeyRef:
              name: goalixa-secrets
              key: database-url
        - name: SECRET_KEY
          valueFrom:
            secretKeyRef:
              name: goalixa-secrets
              key: secret-key
        - name: AUTH_JWT_SECRET
          valueFrom:
            secretKeyRef:
              name: goalixa-secrets
              key: jwt-secret
        - name: AUTH_SERVICE_URL
          value: http://auth-service:5001
        resources:
          requests:
            memory: "256Mi"
            cpu: "250m"
          limits:
            memory: "512Mi"
            cpu: "500m"
        livenessProbe:
          httpGet:
            path: /health
            port: 5000
          initialDelaySeconds: 30
          periodSeconds: 10
        readinessProbe:
          httpGet:
            path: /health
            port: 5000
          initialDelaySeconds: 5
          periodSeconds: 5

curl http://localhost:5000/health

{
  "status": "healthy",
  "database": "connected",
  "timestamp": "2026-04-06T10:00:00Z"
}