Ärenden, mappar, statusar och taggar i Todomator

Todomators centrum är ärendet (tabellen tbl_ticket, schemat Tickets i schemas/tickets.js). Allt annat organiserar ärenden eller hänger på dem.

Vad ett ärende innehåller

Fält	Betydelse
name	titeln (obligatorisk)
statusid	statusen; ett nytt ärende är pending om du inte säger något annat
folderid	mappen (kund eller projekt) som det tillhör
ownerid, userid, watcherid	författaren, de tilldelade och de som bara följer det
ispublic	synligt för alla; ett publikt ärende har inga tilldelade
ispriority, isbillable	en prioritetsmarkering och en fakturerbar-flagga
markdown, html	innehållet (gränssnittet använder Markdown)
tags	en lista med taggar
date, deadline	ärendets dag (i dag som standard) och en valfri deadline
estimate, worked	uppskattningen och de redan arbetade minuterna (tidrapportering)
reference, source	fri text för att koppla ärendet till något utanför
parentid	det överordnade ärendet, för deluppgifter
attachments	ärendets filer
attrs	fria JSON-data
callback	en adress som får ärendet när det ändras (API:et)

De sex statusarna

Tabellen cl_status skapas med: pending (Pending), open (In progress), review (Review), postponed (Postponed), note (Note) och closed (Closed). Namnen översätts till användarens språk.

Vem som kan se ett ärende

Ett ärende syns för sin ägare, för personerna i userid, för personerna i watcherid och för alla när ispublic är satt. Listan över mappar som en användare ser begränsas på samma sätt: en mapp visas bara om användaren kan se ett ärende i den (användare med sa ser alla). Ärendelistan tar type (till exempel pending, postponed, review, assigned, note, unread eller all), q (sökning), folderid, date, skip och limit (10 som standard).

Mappar och taggar

En mapp har ett namn, en ikon, en färg, en kund, en e-postadress och ett telefonnummer samt flaggor: isbillable (nya ärenden ärver den), isprivate, ispinned, isarchived och isdisabled. Bara personer med behörigheten admin (eller administratörer) hanterar mappar. En tagg har ett namn, en färg och en ikon och kan tillhöra en mapp.

Runt ärendet

• Kommentarer (Comments|create, Comments|update, Comments|remove): Markdown-text som hör till ett ärende.
• Oläst-markeringar och bokmärken: varje användare har sitt eget oläst-tillstånd och sina bokmärken för ett ärende.
• Länkar mellan ärenden och kloning av ett ärende.
• Historik och loggar över ett ärendes ändringar.
• Bilagor: POST /upload/ tar upp till 5 MB per begäran. En fils adress är signerad (/download/<id>-<signature>.<ext>): bilder, video och PDF öppnas i webbläsaren och de andra typerna laddas ner.
• Liveuppdateringar: WebSocketen skickar en refresh-händelse bara till de personer som kan se ärendet, och talar om för de andra vem som tittar på ett ärende just nu.