# Reglas heurísticas para yates motor planeo 20-30 m.
#
# Este archivo captura el conocimiento de Álvaro sobre qué sistemas y qué
# equipos lleva típicamente un yate motor planeo del segmento objetivo.
# El motor de reglas del Studio (Sprint 2) consulta este archivo en el
# Paso 5 del wizard para proponer equipos al integrador.
#
# Filosofía: PROPONE, no impone. El integrador siempre puede ajustar.
# data_source de cada propuesta es "seed_estimate" y queda en
# docs/seed_data_notes.md hasta que Álvaro lo valide contra proyectos reales.

meta:
  version: 1
  rule_id: yacht_motor_planeo
  applies_to:
    vessel_types: ["yacht_motor"]
    vessel_subtypes: ["planing", "semi_planing"]
    length_overall_m:
      min: 18.0
      max: 32.0
  data_source: seed_estimate

# ----- Sistemas que típicamente se incluyen -------------------------------

systems_default_enabled:
  - main_engine
  - transmission
  - shaft_propeller
  - thruster
  - trim_tabs
  - genset
  - shore_power
  - msb
  - solar
  - fuel
  - lube_oil
  - fw_cooling
  - sw_cooling
  - bilge
  - potable_water
  - watermaker
  - fire_detection
  - fire_extinguishing
  - hvac
  - engine_vent
  - nav_lights
  - deck_lights
  - interior_lights
  - emergency_lights
  - fuel_tanks
  - water_tanks
  - grey_black_tanks
  - windlass
  - anchor_system

systems_optional:
  - gyrostabilizer    # Seakeeper se vuelve muy común en este rango
  - joystick_docking
  - inverter_charger
  - battery_bank
  - searchlights
  - davits
  - gangway

# ----- Equipos propuestos por sistema --------------------------------------

equipment_proposals:

  main_engine:
    # Para yates de 20-25 m, MTU o Volvo en pares. Para 25-32 m, MTU.
    count: 2
    candidates:
      - model_ref: mtu_12v_2000_m96
        when:
          length_overall_m: { min: 22.0, max: 32.0 }
        rationale: "Estándar de oro en este rango. Buena disponibilidad de partes y servicio."
      - model_ref: volvo_d13_900hp
        when:
          length_overall_m: { min: 18.0, max: 26.0 }
        rationale: "Más liviano y económico que MTU 2000. Servicio mundial Volvo Penta."
    location_template:
      port:    { x_pp_pct: 0.25, y_cl: -0.9, z_bl: 1.2 }
      starboard: { x_pp_pct: 0.25, y_cl:  0.9, z_bl: 1.2 }
    tag_prefix_template: "ME_{side}"
    sides: ["PORT", "STBD"]

  genset:
    count: 1
    candidates:
      - model_ref: northern_lights_m65c13
        when:
          length_overall_m: { min: 18.0, max: 30.0 }
        rationale: "Confiabilidad probada. Aceptado por clase RINA/Lloyd's con poco trámite."
    location_template:
      default: { x_pp_pct: 0.20, y_cl: 0.0, z_bl: 1.0 }
    tag_prefix_template: "GEN_{idx}"

  fuel:
    # Sin modelo concreto — el integrador definirá tanques estructurales en Paso 6.
    sensors_per_tank:
      - level
      - temperature
    typical_tank_count: 2
    tag_prefix_template: "TANK_FUEL_{idx}"

  bilge:
    typical_pump_count: 3
    tag_prefix_template: "BILGE_{location}"
    locations_template: ["FWD", "MID", "AFT"]

# ----- Permissives típicos a sugerir ---------------------------------------

permissives_template:

  - id: start_main_engine
    action_id_template: "START_{tag_prefix}"
    apply_to: ["main_engine"]
    conditions:
      - tag_ref_template: "{tag_prefix}.OIL_PRESS"
        operator: ">"
        threshold: 0.3
        message_on_fail: "Presión aceite previa al arranque demasiado baja (lubricación insuficiente)."
      - tag_ref_template: "{tag_prefix}.COOLANT_TEMP"
        operator: ">"
        threshold: 5.0
        message_on_fail: "Refrigerante por debajo de 5°C — pre-calentar antes de arrancar."
      - tag_ref_template: "{tag_prefix}.ESTOP_ACTIVE"
        operator: "is_false"
        message_on_fail: "Pulsador E-stop activado — desbloquear antes de arrancar."
    on_fail_message: "Pre-condiciones de arranque del motor principal no cumplidas."

  - id: start_genset
    action_id_template: "START_{tag_prefix}"
    apply_to: ["genset"]
    conditions:
      - tag_ref_template: "{tag_prefix}.OIL_PRESS"
        operator: ">"
        threshold: 0.3
        message_on_fail: "Presión aceite previa baja."
      - tag_ref_template: "{tag_prefix}.COOLANT_TEMP"
        operator: ">"
        threshold: 0.0
        message_on_fail: "Refrigerante demasiado frío para arranque seguro."
    on_fail_message: "Pre-condiciones de arranque del genset no cumplidas."

# ----- Topología sugerida de tarjetas AR-NMEA-IO --------------------------

topology_template:
  # Patrón típico para yate planeo con 2 motores + 1 genset + tanques + auxiliares:
  # 5-7 tarjetas distribuidas. Una maestra Modbus en el PC industrial.
  cards_estimate:
    min: 5
    typical: 6
    max: 8
  buses:
    - id: bus_main
      protocol: modbus_rtu
      role: "Maestra en PC industrial central. Esclavas distribuidas."
    - id: bus_n2k
      protocol: nmea2000
      role: "Backbone NMEA 2000 del buque. Motores y gensets en modo dual."