feat: Phase 2 - Service Management CRUD API (Backend)

Backend Implementation:
- Service model with comprehensive fields (name, url, type, status, health_endpoint)
- Complete CRUD API endpoints for service management
- Health check mechanism with httpx and response time tracking
- Service status tracking (healthy/unhealthy/unknown)
- Service type categorization (backend, frontend, database, cache, etc.)

API Endpoints:
- GET /api/services - Get all services
- POST /api/services - Create new service
- GET /api/services/{id} - Get service by ID
- PUT /api/services/{id} - Update service
- DELETE /api/services/{id} - Delete service
- POST /api/services/{id}/health-check - Check specific service health
- POST /api/services/health-check/all - Check all services health

Frontend Preparation:
- TypeScript type definitions for Service
- Service API client with full CRUD methods
- Health check client methods

Files Added:
- backend/app/models/service.py - Service data model
- backend/app/schemas/service.py - Request/response schemas
- backend/app/services/service_service.py - Business logic
- backend/app/routes/services.py - API route handlers
- frontend/src/types/service.ts - TypeScript types
- frontend/src/api/service.ts - API client

Updated:
- backend/app/main.py - Added services router
- docs/PROGRESS.md - Added Phase 2 status

Next: Frontend UI implementation (Services list page, Add/Edit modal, Health monitoring)

🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
jungwoo choi
2025-10-28 16:44:33 +09:00
parent f4b75b96a5
commit e60e531cdc
8 changed files with 642 additions and 3 deletions

View File

@ -0,0 +1,81 @@
from datetime import datetime
from typing import Optional, Dict, Any
from pydantic import BaseModel, Field, ConfigDict
from bson import ObjectId
from pydantic_core import core_schema
class PyObjectId(str):
"""Custom ObjectId type for Pydantic v2"""
@classmethod
def __get_pydantic_core_schema__(cls, source_type, handler):
return core_schema.union_schema([
core_schema.is_instance_schema(ObjectId),
core_schema.chain_schema([
core_schema.str_schema(),
core_schema.no_info_plain_validator_function(cls.validate),
])
],
serialization=core_schema.plain_serializer_function_ser_schema(
lambda x: str(x)
))
@classmethod
def validate(cls, v):
if not ObjectId.is_valid(v):
raise ValueError("Invalid ObjectId")
return ObjectId(v)
class ServiceStatus:
"""Service status constants"""
HEALTHY = "healthy"
UNHEALTHY = "unhealthy"
UNKNOWN = "unknown"
class ServiceType:
"""Service type constants"""
BACKEND = "backend"
FRONTEND = "frontend"
DATABASE = "database"
CACHE = "cache"
MESSAGE_QUEUE = "message_queue"
OTHER = "other"
class Service(BaseModel):
"""Service model for MongoDB"""
id: Optional[PyObjectId] = Field(alias="_id", default=None)
name: str = Field(..., min_length=1, max_length=100)
description: Optional[str] = Field(default=None, max_length=500)
service_type: str = Field(default=ServiceType.BACKEND)
url: str = Field(..., min_length=1)
health_endpoint: Optional[str] = Field(default="/health")
status: str = Field(default=ServiceStatus.UNKNOWN)
last_health_check: Optional[datetime] = None
response_time_ms: Optional[float] = None
created_at: datetime = Field(default_factory=datetime.utcnow)
updated_at: datetime = Field(default_factory=datetime.utcnow)
metadata: Dict[str, Any] = Field(default_factory=dict)
model_config = ConfigDict(
populate_by_name=True,
arbitrary_types_allowed=True,
json_encoders={ObjectId: str},
json_schema_extra={
"example": {
"name": "News API",
"description": "News generation and management API",
"service_type": "backend",
"url": "http://news-api:8050",
"health_endpoint": "/health",
"status": "healthy",
"metadata": {
"version": "1.0.0",
"port": 8050
}
}
}
)