Case

cdesk

In ontwikkeling

Een toegankelijke command-line-client voor TOPdesk, volgens hetzelfde toetsenbord- en braille-first model.

Wat & waarom

De derde in de familie: TOPdesk-incidenten lezen en doorzoeken vanaf het toetsenbord — incidentenlijsten met FIQL-filters, detailweergave, personen en operators. Fase één (lezen) staat en is gedekt door offline tests; de interactieve TUI volgt zodra de velden tegen een echte TOPdesk-omgeving gevalideerd zijn.

Zelfde ontwerpprincipes als cjira en csphere — en dezelfde discipline: schrijfacties zitten er bewust nog niet in. Eerst valideren tegen de echte API, dan pas schrijven. Liever een eerlijke eerste fase die klopt dan een snelle demo die gokt.

Aanpak

  1. Het gedeelde toegankelijkheidsmodel als vertrekpunt: regelgeoriënteerd, identifier eerst, geen kleur-als-betekenis, geen popups.
  2. De leescommando's eerst, gedekt door offline tests met vastgelegde API-antwoorden.
  3. Schrijfmethodes wél voorbereid in de client-laag, maar niet aangesloten tot de live validatie er is.
  4. Per-gebruiker applicatiewachtwoord; nooit credentials in de repository.

Techniek

  • Python
  • TOPdesk REST API
  • FIQL
  • Offline tests eerst

Beeld & demo

cdesk incidents --query closed==false
I2607-201  [In behandeling]  Beeldscherm vergaderruimte 2 blijft zwart
I2607-198  [Gereed voor behandeling]  Toegang tot de gedeelde projectmap aanvragen
I2607-190  [Wachten op leverancier]  Printer op de 3e verdieping doet het niet
3 incident(s).
Echte cdesk-uitvoer over voorbeelddata: incidenten gefilterd met een FIQL-query — nummer voorop, status als tekst.