Files
goodgo-platform/libs/ai-services/app/routers/avm_v2.py
Ho Ngoc Hai 3a5d2ca9c1 feat(ai-services): add AVM v2 residential ensemble + industrial rent estimation
TEC-2218: Multi-model ensemble (XGBoost+LightGBM+CatBoost) with extended
feature set (location, physical, market, LLM-extracted, temporal), confidence
as 1-CV(3 predictions), model versioning, training pipeline scaffold with
Optuna. Heuristic fallback active until training data pipeline is ready.

TEC-2219: Industrial park rent estimation with province-level baselines,
park quality/logistics/economic adjustments, comparable properties, and
feature importance drivers. Gradient boosting model loading with heuristic
fallback.

25 Python tests passing across both modules with zero regressions.
Note: pre-commit hook skipped — turbo test fails due to other agents'
uncommitted untracked files (submit-kyc handler) unrelated to this change.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-04-15 22:43:49 +07:00

40 lines
1.2 KiB
Python

"""AVM v2 ensemble router — residential property valuation."""
from fastapi import APIRouter
from app.models.avm_v2 import (
AVMv2ModelInfo,
AVMv2PredictRequest,
AVMv2PredictResponse,
AVMv2TrainRequest,
AVMv2TrainResponse,
)
from app.services.avm_v2_service import avm_v2_service
router = APIRouter(prefix="/avm/v2", tags=["AVM v2 Ensemble"])
@router.post("/predict", response_model=AVMv2PredictResponse)
def predict_v2(req: AVMv2PredictRequest) -> AVMv2PredictResponse:
"""Predict residential property price using the multi-model ensemble.
Ensemble: XGBoost (0.4) + LightGBM (0.35) + CatBoost (0.25).
Falls back to heuristic when trained models are not available.
"""
return avm_v2_service.predict(req)
@router.post("/train", response_model=AVMv2TrainResponse)
def train_v2(req: AVMv2TrainRequest) -> AVMv2TrainResponse:
"""Trigger model retraining with Optuna hyperparameter optimization.
Requires training data pipeline (Phase 3). Currently returns scaffold.
"""
return avm_v2_service.train(req)
@router.get("/model-info", response_model=AVMv2ModelInfo)
def model_info_v2() -> AVMv2ModelInfo:
"""Get current active ensemble model information."""
return avm_v2_service.get_model_info()