Tickets, Ordner, Status und Tags in Todomator

Im Zentrum von Todomator steht das Ticket (Tabelle tbl_ticket, Schema Tickets in schemas/tickets.js). Alles andere organisiert Tickets oder hängt an ihnen.

Was ein Ticket enthält

Feld	Bedeutung
name	der Titel (Pflicht)
statusid	der Status; ein neues Ticket ist pending, sofern Sie nichts anderes angeben
folderid	der Ordner (Kunde oder Projekt), zu dem es gehört
ownerid, userid, watcherid	der Autor, die zugewiesenen Personen und die Personen, die es nur verfolgen
ispublic	für alle sichtbar; ein öffentliches Ticket hat keine zugewiesenen Personen
ispriority, isbillable	eine Prioritätsmarkierung und ein Abrechenbar-Flag
markdown, html	der Inhalt (die Oberfläche verwendet Markdown)
tags	eine Liste von Tags
date, deadline	der Tag des Tickets (standardmäßig heute) und eine optionale Frist
estimate, worked	die Schätzung und die bereits gearbeiteten Minuten (Zeiterfassung)
reference, source	freier Text, um das Ticket mit etwas außerhalb zu verbinden
parentid	das übergeordnete Ticket, für Teilaufgaben
attachments	die Dateien des Tickets
attrs	freie JSON-Daten
callback	eine Adresse, die das Ticket erhält, wenn es sich ändert (API)

Die sechs Status

Die Tabelle cl_status wird angelegt mit: pending (Pending), open (In progress), review (Review), postponed (Postponed), note (Note) und closed (Closed). Die Namen werden in die Sprache des Benutzers übersetzt.

Wer ein Ticket sehen kann

Ein Ticket ist für seinen Eigentümer, für die Personen in userid, für die Personen in watcherid und für alle sichtbar, wenn ispublic gesetzt ist. Die Liste der Ordner, die ein Benutzer sieht, wird genauso eingeschränkt: Ein Ordner erscheint nur, wenn der Benutzer ein Ticket darin sehen kann (Benutzer mit sa sehen alle). Die Ticketliste nimmt type (zum Beispiel pending, postponed, review, assigned, note, unread oder all), q (Suche), folderid, date, skip und limit (standardmäßig 10).

Ordner und Tags

Ein Ordner hat einen Namen, ein Icon, eine Farbe, einen Kunden, eine E-Mail und ein Telefon sowie Flags: isbillable (neue Tickets erben es), isprivate, ispinned, isarchived und isdisabled. Nur Personen mit der Berechtigung admin (oder Administratoren) verwalten Ordner. Ein Tag hat einen Namen, eine Farbe und ein Icon und kann zu einem Ordner gehören.

Rund um das Ticket

• Kommentare (Comments|create, Comments|update, Comments|remove): Markdown-Text, der an ein Ticket angehängt ist.
• Ungelesen-Markierungen und Lesezeichen: Jeder Benutzer hat seinen eigenen Ungelesen-Zustand und Lesezeichen für ein Ticket.
• Verknüpfungen zwischen Tickets und das Klonen eines Tickets.
• Verlauf und Protokolle der Änderungen eines Tickets.
• Anhänge: POST /upload/ nimmt bis zu 5 MB pro Anfrage. Die Adresse einer Datei ist signiert (/download/<id>-<signature>.<ext>): Bilder, Video und PDF öffnen sich im Browser, die anderen Typen werden heruntergeladen.
• Live-Updates: Der WebSocket sendet ein refresh-Ereignis nur an die Personen, die das Ticket sehen können, und teilt den anderen mit, wer gerade ein Ticket ansieht.