API ja signaalimalli

Mitä käyttöliittymä lukee

Dokumentaation mukaan käyttöliittymän julkinen data tulee oletuksena signals / all_links -muotoisena JSON-vastauksena.

Keskeinen read-path:

GET /api/data
  -> palauttaa käyttöliittymälle signals/all_links-muodon

Tama kuvataan esimerkiksi dokumenteissa:

• arkkitehtuuri.md
• yleiskuva.md
• ai-putki-ja-jdbin.md

Mitä julkaistu signaali kantaa mukana

Live-tuotteen signaali ei ole pelkkä otsikko. Dokumenteissa toistuvat erityisesti:

• sourceFact
• editorialSummary
• whyMatters
• evidenceSources
• consensus
• selectionAudit

Tärkeä erottelu

Käyttöliittymä ei yleensä lue joka pyynnöllä live-JDBINia suoraan, vaan useimmiten snapshot-pohjaisen julkisen JSON-vastauksen.

Silti semanttinen malli tulee samasta julkaisuputken ajattelusta:

putki
-> julkaistu signaaliobjekti
-> /api/data
-> käyttöliittymän kortit ja modaali

Mitä tämä tarkoittaa dokumentaation kannalta

Ennen kuin toimitusputkea selitetään syvältä, on ensin ymmärrettävä:

1. julkaistu yksikkö on signal
2. signal on lähteisiin ankkuroidtu, ei pelkkä AI-kopio
3. käyttöliittymän terminologia tulee signaaliobjektin kentistä ja niiden johdetuista tulkinnoista