Process · simple — répondre à une question RH

Le cas. Un manager demande : « combien d'heures sup' dans mon équipe ce mois-ci, et quelle semaine a été la pire ? » La réponse est dans l'outil RH.

Ce que l'exemple montre. Une station qui ne fait que répondre : des lectures, un cadre « rapport », aucune écriture joignable, donc ni sélection ni submit guard.

examples/actuelle/process-simple.yaml

# Process · simple — HR questions answered from the HR tool. Reads only: nothing is chosen,
# nothing is submitted, so there is no selection, no submit_guard and no write in the allowlist.
station:
  id: rh-reporting
  name: Reporting RH

global:
  language: fr
  currency: EUR
  locale: fr-FR

domain:
  domain_type: saas
  entity_name: feuille d'heures
  entity_name_plural: feuilles d'heures


agent:
  tone: professional
  name: Reporting RH
  persona: "un analyste RH qui parle chiffres, brièvement"
  rules:
    - "Ne jamais avancer une heure qui n'a pas été mesurée : tout chiffre vient du rapport."
  emoji: false
  portals:
    web:
      widget:
        origins: [https://rh.example.fr]

apis:
  - name: rh-lecture
    openapi_url: https://rh-api.example.fr/openapi.json
    base_url: https://rh-api.example.fr
    operations:                                   # reads only — the write is not reachable
      - {id: listTeams, access: read}
      - {id: getOvertimeReport, access: read}
    auth: {type: api_key, key_name: X-RH-Key, key_location: header, key_env: RH_API_KEY}

skills:
  - name: equipes
    invoke: {method: listTeams}
  - name: rapport-heures-sup
    invoke: {method: getOvertimeReport}
    render:
      component: report
      report:
        headline: total_overtime_hours   # the number that answers
        headline_label: "heures supplémentaires"
        unit: h
        series: weeks
        point_label: week_starting
        point_value: overtime_hours
        highlight: worst_week            # marked, never re-sorted

Ce qui se passe

question	Core	résultat
« quelles équipes ? »	equipes → listTeams	la liste, en cartes
« les heures sup' de l'équipe Logistique »	rapport-heures-sup → getOvertimeReport	un chiffre en titre, une barre par semaine, la pire marquée
« valide les feuilles d'Awa »	aucune skill n'écrit	l'agent dit ce qu'il peut faire à la place

À retenir

• Pas d'écriture dans operations : l'outil RH peut en avoir, la station ne les atteint pas.
• Les deux skills n'appellent que des opérations access: read : Core en déduit qu'elles ne font que répondre, et aucune ligne d'un rapport ne peut entrer dans une sélection, quelle que soit la porte.
• Pas de submit_guard : une garde devant une porte qui n'existe pas ferait croire qu'elle existe.