rdev/internal/service/blueprint_service.go
jordan a69eb7e587 feat(foundary): implement complete backend for conversational project design
Implements all 5 phases of Foundary Studio backend:

Phase 1: Chat Persistence (8 API endpoints)
- Conversations and messages with proper cascading deletes
- PostgreSQL schema with auto-update triggers
- Full CRUD operations with structured logging

Phase 2: Blueprint Entity (5 API endpoints)
- JSONB spec storage with GIN indexes
- Flexible structured data for project specifications
- Version-controlled blueprint management

Phase 3: Architect Service (3 API endpoints)
- Conversational AI orchestration with Claude
- Multi-turn dialogue with context building
- Blueprint spec extraction from conversations

Phase 4: Work Queue Integration
- Verified existing endpoint compatibility

Phase 5: Structured Questions (6 API endpoints)
- Four question types: text, choice, multichoice, yesno
- Answer validation with proper constraints
- Conversation-linked Q&A flow

Architecture:
- Textbook hexagonal architecture (domain → port → adapter → service → handler)
- Zero external dependencies in domain layer
- Consistent error handling with proper wrapping
- Auth scopes on all routes (projects:read, projects:execute)
- Structured logging with operation context and duration tracking
- NULL-safe DTO converters throughout

Database:
- 3 new migrations (019, 020, 021)
- UUIDs for all primary keys
- Proper foreign key constraints with ON DELETE CASCADE
- Optimized indexes including partial index for unanswered questions
- Auto-update triggers for timestamps

OpenAPI Documentation:
- Complete API documentation under 'Foundary' tag
- 22 new endpoints documented with examples
- Request/response schemas for all operations

Logging Improvements:
- Added operation field to all service logs
- Added duration_ms tracking for performance monitoring
- Log response_length instead of full response content
- Consistent use of logging field constants
- Execute-then-log pattern for delete operations

Files: 32 changed, 2800+ lines added
- 7 domain models
- 3 database migrations
- 3 port interfaces
- 3 postgres adapters
- 4 services (conversation, blueprint, question, architect)
- 4 handlers with DTOs
- OpenAPI documentation
- Integration in main.go

🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
2026-02-09 00:50:46 -07:00

120 lines
3.1 KiB
Go

package service
import (
"context"
"fmt"
"time"
"github.com/google/uuid"
"github.com/orchard9/rdev/internal/domain"
"github.com/orchard9/rdev/internal/logging"
"github.com/orchard9/rdev/internal/port"
)
// BlueprintService orchestrates blueprint operations.
type BlueprintService struct {
repo port.BlueprintRepository
}
// NewBlueprintService creates a new blueprint service.
func NewBlueprintService(repo port.BlueprintRepository) *BlueprintService {
return &BlueprintService{repo: repo}
}
// CreateBlueprint creates a new blueprint.
func (s *BlueprintService) CreateBlueprint(ctx context.Context, projectID, name, description string, spec map[string]any) (*domain.Blueprint, error) {
if projectID == "" {
return nil, fmt.Errorf("project_id is required")
}
if name == "" {
return nil, fmt.Errorf("name is required")
}
if spec == nil {
spec = make(map[string]any)
}
blueprint := &domain.Blueprint{
ID: domain.BlueprintID(uuid.New().String()),
ProjectID: projectID,
Name: name,
Description: description,
Spec: spec,
}
startTime := time.Now()
if err := s.repo.CreateBlueprint(ctx, blueprint); err != nil {
return nil, err
}
log := logging.FromContext(ctx)
log.Info("blueprint created",
"blueprint_id", blueprint.ID,
logging.FieldProjectID, projectID,
logging.FieldOperation, "create_blueprint",
logging.FieldDuration, time.Since(startTime).Milliseconds(),
"name", name,
"has_spec", len(spec) > 0,
)
return blueprint, nil
}
// GetBlueprint retrieves a blueprint by ID.
func (s *BlueprintService) GetBlueprint(ctx context.Context, id domain.BlueprintID) (*domain.Blueprint, error) {
return s.repo.GetBlueprint(ctx, id)
}
// ListBlueprints returns all blueprints for a project.
func (s *BlueprintService) ListBlueprints(ctx context.Context, projectID string) ([]*domain.Blueprint, error) {
return s.repo.ListBlueprints(ctx, projectID)
}
// UpdateBlueprint updates a blueprint's metadata and spec.
func (s *BlueprintService) UpdateBlueprint(ctx context.Context, id domain.BlueprintID, name, description string, spec map[string]any) error {
// Get existing blueprint first
blueprint, err := s.repo.GetBlueprint(ctx, id)
if err != nil {
return err
}
// Update fields
if name != "" {
blueprint.Name = name
}
blueprint.Description = description
if spec != nil {
blueprint.Spec = spec
}
startTime := time.Now()
if err := s.repo.UpdateBlueprint(ctx, blueprint); err != nil {
return err
}
log := logging.FromContext(ctx)
log.Info("blueprint updated",
"blueprint_id", id,
logging.FieldProjectID, blueprint.ProjectID,
logging.FieldOperation, "update_blueprint",
logging.FieldDuration, time.Since(startTime).Milliseconds(),
)
return nil
}
// DeleteBlueprint deletes a blueprint.
func (s *BlueprintService) DeleteBlueprint(ctx context.Context, id domain.BlueprintID) error {
startTime := time.Now()
if err := s.repo.DeleteBlueprint(ctx, id); err != nil {
return err
}
log := logging.FromContext(ctx)
log.Info("blueprint deleted",
"blueprint_id", id,
logging.FieldOperation, "delete_blueprint",
logging.FieldDuration, time.Since(startTime).Milliseconds(),
)
return nil
}