# Jegyek, mappák, állapotok és címkék a Todomatorban

> A Todomator adatmodellje: mit tartalmaz egy jegy, a hat állapot, ki láthat egy jegyet, mappák ügyfeleknek és projekteknek, címkék, megjegyzések, hivatkozások és mellékletek.

Framework: todomator
Product: Todomator (todomator@1.7)
Language: hu
Content-SHA256: cc694c59c82e0efc8d6abcea30f3ffae823d918f78a2bb804db2a432af0a46c6
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: 
Review: not-recorded

A Todomator középpontja a **jegy** (`tbl_ticket` tábla, `Tickets` séma a `schemas/tickets.js` fájlban). Minden más jegyeket szervez, vagy rájuk épül.

## Mit tartalmaz egy jegy

| Mező | Jelentés |
|---|---|
| `name` | a cím (kötelező) |
| `statusid` | az állapot; az új jegy `pending`, hacsak mást nem mondasz |
| `folderid` | a mappa (ügyfél vagy projekt), amelyhez tartozik |
| `ownerid`, `userid`, `watcherid` | a szerző, a hozzárendelt személyek és azok, akik csak követik |
| `ispublic` | mindenki számára látható; a nyilvános jegynek nincsenek hozzárendelt személyei |
| `ispriority`, `isbillable` | egy prioritásjelölés és egy számlázható jelző |
| `markdown`, `html` | a tartalom (a felület Markdownt használ) |
| `tags` | a címkék listája |
| `date`, `deadline` | a jegy napja (alapértelmezés szerint ma) és egy opcionális határidő |
| `estimate`, `worked` | a becslés és a már ledolgozott percek ([időkövetés](/en/todomator/time-tracking/)) |
| `reference`, `source` | szabad szöveg, amellyel a jegyet külső dologhoz kötheted |
| `parentid` | a szülő jegy, részfeladatokhoz |
| `attachments` | a jegy fájljai |
| `attrs` | szabad JSON adatok |
| `callback` | egy cím, amely megkapja a jegyet, ha az megváltozik ([API](/en/todomator/create-tickets-with-the-api/)) |

## A hat állapot

A `cl_status` tábla a következőkkel jön létre: `pending` (Pending), `open` (In progress), `review` (Review), `postponed` (Postponed), `note` (Note) és `closed` (Closed). A neveket lefordítja a felhasználó nyelvére.

## Ki láthat egy jegyet

A jegyet a tulajdonosa, a `userid` szereplői, a `watcherid` szereplői és mindenki látja, ha az `ispublic` be van állítva. A felhasználó által látott mappák listáját ugyanígy korlátozza: egy mappa csak akkor jelenik meg, ha a felhasználó lát benne egy jegyet (az `sa` jelzőjű felhasználók mindet látják). A jegylista fogadja a `type` (például `pending`, `postponed`, `review`, `assigned`, `note`, `unread` vagy `all`), a `q` (keresés), a `folderid`, a `date`, a `skip` és a `limit` (alapértelmezés szerint 10) paramétereket.

## Mappák és címkék

A **mappának** van neve, ikonja, színe, ügyfele, e-mailje és telefonja, valamint jelzői: `isbillable` (az új jegyek öröklik), `isprivate`, `ispinned`, `isarchived` és `isdisabled`. A mappákat csak az `admin` jogosultságú személyek (vagy az adminisztrátorok) kezelik. A **címkének** van neve, színe és ikonja, és mappához tartozhat.

## A jegy körül

- **Megjegyzések** (`Comments|create`, `Comments|update`, `Comments|remove`): a jegyhez csatolt Markdown szöveg.
- **Olvasatlan jelölések és könyvjelzők**: minden felhasználónak saját olvasatlan állapota és könyvjelzői vannak egy jegyhez.
- **Hivatkozások** a jegyek között és a jegy **klónozása**.
- A jegy módosításainak **előzményei és naplói**.
- **Mellékletek**: a `POST /upload/` kérésenként legfeljebb 5 MB-ot fogad. A fájl címe aláírt (`/download/<id>-<signature>.<ext>`): a képek, a videó és a PDF megnyílik a böngészőben, a többi típus letöltődik.
- **Élő frissítések**: a WebSocket `refresh` eseményt csak azoknak küld, akik láthatják a jegyet, a többieknek pedig jelzi, hogy ki nézi éppen a jegyet.