README.md

---
title: Construction Scope Validator
emoji: 🏗️
colorFrom: blue
colorTo: green
sdk: docker
pinned: false
---

# Construction Scope Validator API

FastAPI service that validates and enriches LLM-generated construction scope of work with database-verified stages, tasks, and materials.

## Features

- 🎯 Stage name validation and matching
- 📋 Task recommendation based on stage and context
- 🔨 Material suggestion with pricing
- 📊 Confidence scores for all matches
- 🚀 Fast embedding-based search

## API Endpoints

- `GET /` - Service info
- `GET /health` - Health check
- `POST /validate` - Main validation endpoint
- `POST /match-stage` - Test stage matching
- `POST /match-room` - Test room matching

## Usage
```python
import requests

response = requests.post(
    "https://mlbench123-sudoco-scopeofwork.hf.space/validate",
    json={
        "scope_of_work": [
            {
                "area": "Living Room",
                "items": [
                    {
                        "stage": "Demolition",
                        "task": "Remove walls",
                        "material": "Demolition tools",
                        "quantity": 1,
                        "unit": "set"
                    }
                ]
            }
        ]
    }
)

print(response.json())
```

## Model

Uses fine-tuned Sentence Transformer (all-MiniLM-L6-v2) with 89.4% accuracy for stage-task-material matching.