3ea. WebCollab — expozice, opravy a složka /exp/

Tato kapitola doplňuje 3e WebCollab o část, která v návodu dříve chyběla: expozice (výstavní exponáty), evidence závad, přehled oprav podle expozic a zjednodušené rozhraní /exp/ pro obsluhu na provozu.

WebCollab není jen projektové řízení k akcím — u muzeí, science center a provozů s expozicemi slouží hlavně k evidenci exponátů, prohlídkám, hlášení vad a předávání úkolů technikům ve skupině Oprava exponátů.

Tato kapitola doplňuje 3e o datový model úkolů (jak systém počítá stavy, zpoždění a % dokončení) a o část expozic. Obecný přehled složek webcoll/ zůstává v kapitole 3e.

Projekty a úkoly — jedna tabulka, dvě role

V databázi DOVIS jsou projekty i úkoly uloženy v tabulce webcollab_tasks (prefix session webcollab + název tabulky). Rozlišení je podle pole parent:

• Projekt — řádek s parent = 0. Má vlastní id; toto id je zároveň projectid všech úkolů v projektu. Na úvodní obrazovce modulu (webcoll/default) vidíte projekty jako barevné bloky (žlutý = běží, zelený = hotový, červený = po termínu).
• Úkol — řádek s parent > 0. Pole parent ukazuje na nadřazený úkol (nebo na id projektu u úkolů první úrovně). Pole projectid vždy odkazuje na kořenový projekt.

Volitelné vazby v webcollab_tasks: idakce (akce v DOVIS), exposition (exponát z webcollab_exposition), taskgroupid (typ práce — Administrativa, Servis…), usergroupid (kdo projekt/úkol vidí), owner / creator (řešitel / zadavatel).

flowchart TD
    P["Projekt parent=0 projectid=id"] --> U1["Úkol 1. úrovně parent=projectid"]
    P --> U2["Úkol 1. úrovně"]
    U1 --> S1["Podúkol parent=id úkolu"]
    U1 --> S2["Podúkol"]
    S1 --> S3["Další úroveň parent=id podúkolu"]
    U2 --> EXP["exposition = id exponátu"]

Úrovně vnoření úkolů

Hierarchie není omezena na jednu úroveň pod projektem. V kódu se na úvodní stránce vykreslují až čtyři úrovně (projekt → úkol → podúkol → další podúkol) — odsazené řádky pod hlavičkou projektu, jak na demu po přihlášení na demo.iskasa.eu/webcoll/.

1. Úroveň 0 — projekt — hlavička s názvem (např. „004 Expozice STC 2026 2. pololetí“), termínem, stavem, odkazem Přidat úkol.
2. Úroveň 1 — úkoly přímo pod projektem (parent = id projektu).
3. Úroveň 2 a 3 — podúkoly (parent = id nadřazeného úkolu). Nový podúkol přidáte ikonou u řádku úkolu (obrazovka taskedit2).

Úkoly z expozic (/exp/) se zakládají jako úkoly první úrovně pod projektem přiřazeným exponátu (parent = projectid z expozice, exposition = id exponátu).

Důležitá pole tabulky webcollab_tasks

Související tabulky: webcollab_taskgroups (skupiny úkolů), webcollab_usergroups + webcollab_usergroups_users (práva týmů), webcollab_tasksdatum (historie stavů po dnech), webcollab_taskscore (bodové hodnocení úkolů), webcollab_expositiontask (vazba expozice ↔ úkol).

Stavy úkolů a projektů

Stav je v poli status (text) a statusid (číslo pro řazení a barvy). České popisky vycházejí z jazykových řetězců modulu.

Automatické přepnutí na Aktivní: když vlastník úkolu (owner) poprvé otevře detail (webcoll/taskview) a úkol je ve stavu created, systém ho přepne na active (statusid = 2).

Dokončení: ve detailu úkolu tlačítko / akce Dokončeno nastaví status = done, statusid = 6 a vyplní completion_time. Uzavřený úkol se nepočítá do aktivních přehledů expozic (statusid < 6).

Sledování plnění projektu (% hotovo)

Pod hlavičkou každého projektu na úvodní stránce vidíte text „Tento projekt je hotov na X %“ a pruh: zelená = dokončená část, červená = zbývá. Hodnota je v poli completed u řádku projektu (parent = 0).

Výpočet (skript webcoll_task/TaskVypocty) po každé změně úkolů v projektu:

1. Spočítají se všechny úkoly v projektu s parent > 0 (všechny úrovně vnoření).
2. Spočítají se úkoly se stavem status = 'done'.
3. completed = round(hotové / celkem × 100). Když v projektu není žádný úkol, je 0 %.

Příklad z dema: projekt „004 Expozice STC…“ s 97 % znamená, že téměř všechny podúkoly jsou ve stavu hotovo; červený zbytek pruhu = podíl nedokončených. Po dosažení 100 % může tvůrce projektu z detailu použít akci Dokončit tento projekt (archivace / uzavření projektu).

Zpoždění a termíny

Zpoždění se počítá jako rozdíl dnů mezi dneškem a polem deadline (DateDiff ve dnech).

• Zbývá X dnů — u projektu v hlavičce (např. „zbývá 193 dnů od teď“); pokud zbývá ≤ 5 dnů, číslo se zvýrazní.
• X den opožděn — červený text u projektu nebo úkolu, když je deadline v minulosti a úkol není hotový (na screenshotu např. „37 den opožděn“ u úkolu Kino STC).
• Barva hlavičky projektu: žlutá = běží s dostatečným předstihem; červená = projekt po termínu a není hotový; zelená = projekt dokončený (statusid = 6).
• Barva řádku úkolu: světle zelená = aktivní s termínem v budoucnosti; červený podklad = po termínu.

Při každém načtení přehledu projektů se u aktivních úkolů kontroluje termín a případně se aktualizuje statusid z 2 na 3 (aktivní → aktivní zpožděný).

Typický průběh zpracování úkolu

1. Založení — formulář taskedit / tasknew nebo automaticky z /exp/VlozZavadu (stav created, výchozí termín často +7 dnů).
2. Přiřazení — vlastník (owner), skupina uživatelů, skupina úkolů (u expozic typicky skupina Servis a usergroup Údržba provozní / opravy exponátů).
3. Převzetí — vlastník otevře taskview → stav se změní na active.
4. Realizace — popis, fórum, přílohy, podúkoly, změna termínu nebo priority.
5. Uzavření — stav done → přepočet % projektu; u oprav expozic zmizí z fronty Nové opravy a z aktivních výpisů u exponátu.
6. Archiv — staré projekty/úkoly v menu Archív (archive = 1).

stateDiagram-v2
    [*] --> Novy: založení created
    Novy --> Aktivni: vlastník otevře taskview
    Aktivni --> Aktivni: práce fórum přílohy
    Aktivni --> Pozastaveny: cantcomplete
    Aktivni --> Hotovy: Dokončeno done
    Pozastaveny --> Aktivni: obnovení
    Hotovy --> [*]
    note right of Aktivni: po deadline statusid 3 červeně

Úkoly z expozic — vazba na projekt

Každá hlavní expozice nebo exponát může mít projectid v tabulce webcollab_exposition. Úkol z hlášení závady se vkládá do webcollab_tasks s:

• parent = projectid expozice (úkol 1. úrovně),
• projectid = stejný projekt,
• exposition = id exponátu,
• taskgroupid = skupina pro exponáty (v instalaci typicky Servis),
• usergroupid = skupina pro opravy exponátů,
• počáteční stav created — technik ho převezme ve frontě Nové opravy.

Pokud u stejného exponátu už existuje otevřený úkol (statusid < 6), nový popis se doplní do pole text existujícího úkolu místo založení nového.

Tři úrovně: expozice → exponát → závada

Data expozic jsou v tabulkách s prefixem session webcollab (typicky …exposition, …expositionprint, …tasks).

1. Hlavní expozice (idK = 0) — místnost, sekce nebo celek (např. „Velký svět techniky“, „U6“). Má inventární číslo, název, popis, vazbu na projekt WebCollab.
2. Položka / exponát (idK > 0) — konkrétní kus v expozici (čárový kód EAN, QR, inventární číslo). Podřízená hlavní expozici.
3. Záznam prohlídky / závada — řádek v expositionprint (kdo, kdy, popis) a volitelně úkol v tabulce tasks s vyplněným polem exposition.

flowchart TD
    H["Hlavní expozice idK=0"] --> P["Exponát položka idK>0"]
    P --> PR["Záznam prohlídky expositionprint"]
    PR -->|zaškrtnut vadný| T["Úkol ve WebCollab skupina Oprava exponátů"]
    T --> N["Nové opravy"]
    N --> TV["Detail úkolu"]

Obrazovky ve WebCollab — expozice a opravy

Po přihlášení a přepnutí na aplikaci WebCollab (levé menu → Webcollab) jsou expozice a opravy v podsložce webcoll/ na serveru (např. https://váš-server.cz/webcoll/). Logika formulářů je ve složce webcoll_exposition/.

V levém menu WebCollab (řada 3000+ v configmenu2) najdete skupinu Expozice: Přidat, Seznam, Počty oprav expozic, Seznam oprav, odkaz Hlášení oprav → veřejná adresa /exp/. Položka Nové opravy je v části Nákupy / soubory / hledání.

Průběh: správce založí expozici, technik řeší opravy

1. V menu Expozice → Přidat (webcoll/exposition) založíte hlavní expozici a pod ní položky (exponáty) — inventární číslo, název, popis, případně vazbu na projekt.
2. Vytisknete štítky / QR (modul tisků ve webcoll_exposition) a nalepíte na exponáty.
3. Obsluha na provozu hlásí stav přes /exp/ (viz níže) nebo technik doplňuje závady ve WebCollab.
4. Technik otevře Nové opravy nebo Opravy podle expozic v levém menu, převezme úkol, mění stav v detailu úkolu.
5. Po vyřešení úkol uzavře (stav hotovo); v přehledech lze skrýt dokončené nebo je zahrnout pro audit.

Složka /exp/ — zjednodušené rozhraní pro obsluhu

Adresa typu https://váš-server.cz/exp/ (fyzicky složka exp/ vedle webcoll/ na serveru) je tabletové / provozní UI — bez plného menu WebCollab. Určeno pro průvodce, obsluhu expozic a prohlídky exponátů. Vyžaduje přihlášení do DOVIS (stejná session jako zbytek systému).

Hlavní stránky ve složce exp/

Postup obsluhy v /exp/ (krok za krokem)

1. Přihlaste se do DOVIS a otevřete /exp/ (nebo použijte zástupce / QR na tabletu).
2. Krok 1 — Hlavní expozice: vyberte místnost nebo sekci ze seznamu (např. STC, U6). Stránka se obnoví.
3. Krok 2 — Exponát: vyberte konkrétní položku ze seznamu pod expozicí, nebo načtěte čárový kód — skener může otevřít přímo /exp/?ean=… (viz návod v /exp/navod).
4. Krok 3 — Popis: doplňte text prohlídky / závady (co je špatně, kde, kdy jste to zjistili).
5. Krok 4 — Vadný exponát: pokud je kus nefunkční a má jít technikům k opravě, zaškrtněte ZAŠRTNĚTE – nefunkční exponát. Bez zaškrtnutí se uloží jen záznam prohlídky — technici nedostanou úkol k opravě.
6. Klikněte Potvrdit a vložit do databáze. Systém uloží záznam; u vadného kusu vytvoří úkol ve skupině Oprava exponátů (nebo doplní text k existujícímu otevřenému úkolu u stejného exponátu).
7. Dole uvidíte Poslední opravy u vybraného exponátu — stav úkolu, odkaz na detail ve WebCollab.

sequenceDiagram
    participant O as Obsluha /exp/
    participant DB as Databáze expositionprint
    participant WC as WebCollab tasks
    participant T as Technik Nové opravy
    O->>O: Vybere expozici a exponát
    O->>O: Popis + volitelně vadný
    O->>DB: Uloží prohlídku
    alt vadný = ano
        DB->>WC: Nový nebo doplněný úkol
        WC->>T: Zobrazí ve frontě Nové opravy
    end

Role pro expozice a opravy

Propojení expozic s ostatními částmi DOVIS

• WebCollab projekty — expozice může mít projectid; úkoly z vadných exponátů spadají pod stejný projekt (např. provoz science centra).
• Modul Akce — volitelná vazba akce ↔ projekt (kap. 3e); expozice může být samostatná bez akce.
• Dovio — přílohy u úkolů z expozic procházejí stejným schvalováním jako ostatní dokumenty (3d Dovio).
• Globální hledání — sekce WebCollab – expozice v hledej (inventární číslo, název).
• KPI / návštěvnost — expozice propojené přes WebCollab lze použít v KPI návštěvnosti v modulu Akce.

Časté situace

Související kapitoly

• 3e WebCollab — architektura složek webcoll/, levé menu
• 3c Technici — technické menu (souvislost s řešením oprav)
• 17 FAQ — rychlá navigace