# ==============================================================================
# SERVICE DESCRIPTOR - ERP MECANICAS DIESEL API
# ==============================================================================
# API especializada para talleres mecanicos
# Mantenido por: Backend-Agent
# Actualizado: 2025-12-18
# ==============================================================================

version: "1.0.0"

# ------------------------------------------------------------------------------
# IDENTIFICACION DEL SERVICIO
# ------------------------------------------------------------------------------
service:
  name: "erp-mecanicas-api"
  display_name: "ERP Mecanicas Diesel API"
  description: "API especializada para talleres mecanicos diesel"
  type: "backend"
  runtime: "node"
  framework: "express"
  owner_agent: "NEXUS-BACKEND"

# ------------------------------------------------------------------------------
# CONFIGURACION DE PUERTOS
# ------------------------------------------------------------------------------
ports:
  internal: 3030
  registry_ref: "projects.erp_suite.verticales.mecanicas.api"
  protocol: "http"

# ------------------------------------------------------------------------------
# CONFIGURACION DE BASE DE DATOS
# ------------------------------------------------------------------------------
database:
  registry_ref: "erp_mecanicas"
  schemas:
    - "workshop"
    - "inventory"
    - "quotes"
  role: "runtime"

# ------------------------------------------------------------------------------
# DEPENDENCIAS
# ------------------------------------------------------------------------------
dependencies:
  services:
    - name: "erp-core-api"
      type: "backend"
      required: true
      description: "Core ERP para auth y catalogos"
    - name: "postgres"
      type: "database"
      required: true

# ------------------------------------------------------------------------------
# MODULOS ESPECIALIZADOS
# ------------------------------------------------------------------------------
modules:
  workshop:
    description: "Gestion de taller"
    entities:
      - service_order
      - diagnostic
      - vehicle
      - customer
    endpoints:
      - { path: "/service-orders", methods: ["GET", "POST", "PUT"] }
      - { path: "/diagnostics", methods: ["GET", "POST"] }
      - { path: "/vehicles", methods: ["GET", "POST"] }
      - { path: "/customers", methods: ["GET", "POST"] }

  inventory:
    description: "Inventario de refacciones"
    entities:
      - part
      - stock_movement
      - supplier
    endpoints:
      - { path: "/parts", methods: ["GET", "POST"] }
      - { path: "/stock", methods: ["GET", "POST"] }

  quotes:
    description: "Cotizaciones"
    entities:
      - quote
      - quote_item
    endpoints:
      - { path: "/quotes", methods: ["GET", "POST"] }

  billing:
    description: "Facturacion"
    entities:
      - invoice
      - payment
    endpoints:
      - { path: "/invoices", methods: ["GET", "POST"] }

# ------------------------------------------------------------------------------
# DOCKER
# ------------------------------------------------------------------------------
docker:
  image: "erp-mecanicas-api"
  dockerfile: "Dockerfile"
  networks:
    - "erp_mecanicas_${ENV:-local}"
    - "erp_core_${ENV:-local}"
    - "infra_shared"
  labels:
    traefik:
      enable: true
      router: "erp-mecanicas-api"
      rule: "Host(`api.mecanicas.erp.localhost`)"

# ------------------------------------------------------------------------------
# HEALTH CHECK
# ------------------------------------------------------------------------------
healthcheck:
  endpoint: "/health"
  interval: "30s"
  timeout: "5s"
  retries: 3

# ------------------------------------------------------------------------------
# ESTADO
# ------------------------------------------------------------------------------
status:
  phase: "development"
  version: "0.1.0"
  completeness: 35

# ------------------------------------------------------------------------------
# METADATA
# ------------------------------------------------------------------------------
metadata:
  created_at: "2025-12-18"
  created_by: "Backend-Agent"
  project: "erp-suite"
  vertical: "mecanicas-diesel"
  team: "mecanicas-team"