Справочник по конфигурации¶

from backend.config import settings

# Доступ к значениям конфигурации
app_name = settings.APP_NAME
database_path = settings.DATABASE_PATH
cors_origins = settings.BACKEND_CORS_ORIGINS

# Доступ к конфигурации модели
model_path = settings.classifier_model_path
predictor_settings = settings.classifier_settings

class AppSettings(BaseSettings):
    # Основные настройки
    APP_NAME: str = "CulicidaeLab API"
    API_V1_STR: str = "/api"
    DATABASE_PATH: str = ".lancedb"
    SAVE_PREDICTED_IMAGES: str | bool = False
    BACKEND_CORS_ORIGINS: list[str] = ["http://localhost:8765"]

    # Динамические свойства
    @property
    def classifier_settings(self):
        """Возвращает настройки библиотеки culicidaelab"""

    @property
    def classifier_model_path(self) -> str:
        """Возвращает путь к весам модели классификатора"""

from backend.config import get_predictor_settings

# Получить настройки модели
settings = get_predictor_settings()

# Доступ к параметрам модели
confidence_threshold = settings.get_confidence_threshold()
model_weights_path = settings.get_model_weights_path("segmenter")

# Настройки подключения к базе данных
DATABASE_CONFIG = {
    "path": settings.DATABASE_PATH,
    "timeout": 30,
    "max_connections": 10,
    "vector_dimension": 512,
    "index_type": "IVF_FLAT",
    "metric_type": "L2"
}

species_schema = {
    "id": "string",
    "name": "string",
    "scientific_name": "string",
    "vector": "vector(512)",
    "metadata": "json",
    "created_at": "timestamp"
}

observations_schema = {
    "id": "string",
    "species_id": "string",
    "location": "geometry",
    "confidence": "float",
    "image_path": "string",
    "metadata": "json",
    "created_at": "timestamp"
}
```## Ко
нфигурация сервера

### Настройки FastAPI

```python
# Конфигурация приложения FastAPI
app = FastAPI(
    title=settings.APP_NAME,
    description="CulicidaeLab API для идентификации видов комаров",
    version="1.0.0",
    openapi_url=f"{settings.API_V1_STR}/openapi.json",
    docs_url=f"{settings.API_V1_STR}/docs",
    redoc_url=f"{settings.API_V1_STR}/redoc"
)

# Настройки middleware CORS
app.add_middleware(
    CORSMiddleware,
    allow_origins=settings.BACKEND_CORS_ORIGINS,
    allow_credentials=True,
    allow_methods=["GET", "POST", "PUT", "DELETE"],
    allow_headers=["*"],
)

# Обслуживание статических файлов
app.mount("/static", StaticFiles(directory="backend/static"), name="static")

# Конфигурация ограничения скорости
RATE_LIMITS = {
    "default": "100/minute",
    "prediction": "10/minute",
    "upload": "5/minute",
    "auth": "20/minute"
}

# Разрешенные типы файлов и размеры
UPLOAD_CONFIG = {
    "allowed_extensions": [".jpg", ".jpeg", ".png", ".tiff"],
    "max_file_size": 50 * 1024 * 1024,  # 50МБ
    "scan_for_malware": True,
    "validate_image_format": True
}

# Валидация конфигурации при запуске
def validate_config():
    """Валидация конфигурации приложения"""
    errors = []

    # Проверка обязательных переменных окружения
    required_vars = ["CULICIDAELAB_DATABASE_PATH", "CULICIDAELAB_SECRET_KEY"]
    for var in required_vars:
        if not os.getenv(var):
            errors.append(f"Отсутствует обязательная переменная окружения: {var}")

    # Проверка путей к файлам
    if not os.path.exists(settings.DATABASE_PATH):
        errors.append(f"Путь к базе данных не существует: {settings.DATABASE_PATH}")

    # Проверка файлов модели
    try:
        model_path = settings.classifier_model_path
        if not os.path.exists(model_path):
            errors.append(f"Файл модели не найден: {model_path}")
    except Exception as e:
        errors.append(f"Ошибка конфигурации модели: {e}")

    if errors:
        raise ValueError(f"Валидация конфигурации не удалась: {'; '.join(errors)}")