eucora-sprint-executor

name: eucora-sprint-executor description: Execute EUCORA Phase 2 enhancements (E1-E21) following CAB-approved governance. Use when implementing any enhancement, creating Django apps, React components, or running sprints. Triggers on mentions of E1-E21, sprint execution, or EUCORA development.

EUCORA Sprint Executor

Execute Phase 2 enhancements with architectural rigor and quality gate enforcement.

Quick Start

1. Read the spec: docs/planning/{enhancement-number}-{name}.md
2. Update tracker: docs/planning/PHASE-2-ENHANCEMENT-TRACKER.md
3. Follow the standard workflow below
4. Run quality checks before completion

Enhancement Priority Order

Spec Document Locations

Standard Workflow

Phase 1: Backend Implementation

# 1. Create Django app
cd backend
python manage.py startapp {app_name}
mv {app_name} apps/

# 2. Add to INSTALLED_APPS in config/settings/base.py
# 3. Create models with CorrelationIdModel mixin
# 4. Create and run migrations
python manage.py makemigrations {app_name}
python manage.py migrate

# 5. Create serializers, views, urls
# 6. Register in config/urls.py

Phase 2: Frontend Implementation

# 1. Create domain directory
mkdir -p frontend/src/routes/{domain}

# 2. Create contracts.ts FIRST (types + endpoints)
# 3. Create page components
# 4. Create hooks for API calls
# 5. Add route to App.tsx
# 6. Add to Sidebar.tsx

Phase 3: Testing

# Backend
cd backend
pytest apps/{app_name}/ --cov --cov-fail-under=90

# Frontend
cd frontend
npm run test -- --coverage
npm run lint
npx tsc --noEmit

Phase 4: Update Tracker

Update docs/planning/PHASE-2-ENHANCEMENT-TRACKER.md:

• Mark tasks complete
• Update progress percentage
• Note any blockers

Quality Gates (MANDATORY)

Before marking ANY enhancement complete:

# Backend checks
cd backend
pytest --cov --cov-fail-under=90
flake8 apps/
mypy apps/

# Frontend checks
cd frontend
npm run build          # Zero errors
npm run lint           # Zero warnings
npm run test           # All passing
npx tsc --noEmit       # Zero type errors

Code Templates

Django Model with Correlation ID

from apps.core.models import TimeStampedModel, CorrelationIdModel

class MyModel(TimeStampedModel, CorrelationIdModel):
    """Model description."""
    name = models.CharField(max_length=255)
    status = models.CharField(max_length=20, default='active')

    class Meta:
        ordering = ['-created_at']

ViewSet with Correlation Filtering

class MyViewSet(viewsets.ModelViewSet):
    serializer_class = MySerializer
    permission_classes = [IsAuthenticated]

    def get_queryset(self):
        qs = MyModel.objects.all()
        correlation_id = self.request.query_params.get('correlation_id')
        if correlation_id:
            qs = qs.filter(correlation_id=correlation_id)
        return qs

Frontend contracts.ts

export interface MyEntity {
  id: string;
  correlation_id: string;
  name: string;
  status: string;
  created_at: string;
}

export const ENDPOINTS = {
  list: '/api/my-entity/',
  detail: (id: string) => `/api/my-entity/${id}/`,
  action: (id: string) => `/api/my-entity/${id}/action/`,
} as const;

React Query Hook

import { useQuery, useMutation } from '@tanstack/react-query';
import { apiClient } from '@/lib/api';
import { MyEntity, ENDPOINTS } from './contracts';

export function useMyEntities() {
  return useQuery<MyEntity[]>({
    queryKey: ['my-entities'],
    queryFn: () => apiClient.get(ENDPOINTS.list).then(r => r.data),
  });
}

Additional Resources

• Enhancement Workflows
• Code Templates
• Commands Reference