Nastavení/O projektu

O projektu Worki

Dokumentace platformy — co, proč a jak jsme nastavili.

Live URL
app.workidesign.cz
+ worki.pages.dev
Repo
mercanto-europe/worki
D1 database
worki-db
fc6dd324-…
Verze platformy
0.6
Iterace 1: Dossier

1. Co je Worki

Worki je interní platforma Mercanto Europe SE pro konzultingovou firmu zaměřenou na Work Management. Pozicování Work Management Architect (architectureofwork.com). Platforma pokrývá celý cyklus práce s klientem — od průzkumu leadu přes Discovery Workshop, Mapping Sessions, strukturální analýzu, až po finální Asana Blueprint.

Uživatelé: sales (obchod) + konzultanti (delivery). Všechna data se vážou na centrální Klientskou kartu.

2. Technický stack

Astro 5 SSR Cloudflare Pages D1 (SQLite) @clerk/astro Anthropic Claude API Outfit + JetBrains Mono Worki brand: #544DE0 / #2E303E PWA (manifest + sw.js)

Bez externího PDF lib (native window.print() + CSS @page). AI volání přes vlastní proxy /api/ai/proxy s logováním do ai_usage_log. Žádné externí závislosti kromě mammoth (DOCX) a pdf.js (PDF extraction).

3. Klíčový koncept — Client Dossier

Jeden klient = jeden ověřený dossier. Každý nástroj jej čte jako ground truth a zapisuje vlastní findings zpět. Výsledek: AI halucinací ubývá — má ověřený kontext, nemusí hádat kdo je CEO, kolik má firma lidí, co dělají.

Uloženo v clients.intel_json (deep-merge). Struktura roste napříč nástroji:

Client Dossier (clients.intel_json) ↑ ↓ ┌──────────┬──────────┬──┴──────┬──────────┬──────────┐ Průzkum DW Přípr DW Analýza MS Dotaz MS Analýza (write) (read) (read+write)(read) (read+write) ↓ ↓ Strukturální + Asana Blueprint (jen čtou syntézu)

Proč: Reachio i CRM mají stejný problém — AI bez ukotvení halucinuje business fakta. Worki má dossier jako single source of truth. Průzkum se dělá jednou, pak jen rozšiřuje (DW přidá departments, MS přidá WMM health, atd.).

4. IA sidebar

Záměrně minimalistická navigace — každá sekce max 4–5 položek. Víceúčelové nástroje sloučeny do hub pages s tile-switcherem (Kalkulačky, Discovery, Mapping Sessions):

  • Start → Dashboard
  • Obchod → Klienti, Průzkumník, Connect Call, Kalkulačky, Čerpání kreditů
  • Architektura → Discovery (hub: Příprava/Analýza/Databáze), Mapping Sessions (hub: Příprava/Analýza), Strukturální analýza, Asana Blueprint
  • Provoz → Spotřeba tokenů (AI usage log)
  • Nastavení → Profil, Uživatelé, Integrace, O projektu

5. Zjednodušení proti původnímu Jarvis setupu

Podle briefu worki-architektura-brief.md:

  • ✓
    Prezentace pryč — PPTX generátor byl nespolehlivý, výstup Discovery Analýzy teď přímo do Wordu/PDF.
  • ◐
    DW/MS Databáze → tab na klientoviKlient karta má sekce Discovery analýzy / MS Přípravy / MS Analýzy. Globální cross-client Databáze (/architektura/discovery/databaze) zůstává jako index pro konzultanta.
  • ✓
    AI průzkum jen jednouPrůzkumník zapíše do clients.intel_json. DW Příprava i MS Dotazník čtou tentýž dossier — žádné opakované AI volání pro lustraci.
  • ○
    Fireflies OAuthZatím manuální JSON upload. V plánu: Fireflies API integrace — zadat název/datum, worker stáhne transcripty automaticky.
  • ○
    Journey tracker auto-detekceMomentálně hardcoded mock v src/data/clients.js. V plánu: odvodit stav z existence záznamů v dw_sessions / dw_analyses / mapping_sessions / tool_records.

6. Architekturální rozhodnutí a proč

Proč Astro 5 SSR místo Next.js / Reactu

Sdílíme pattern s Reachio + CRM. Astro je lehké (server JS minimální), má is:inline pro zachování vanilla JS — což se hodilo při portu 2000+ řádkových HTML souborů z Jarvisu (DW, MS, kalkulačky). Server-side Cloudflare adapter = D1 binding přímo, žádný external DB.

Proč vlastní AI proxy místo přímého volání

/api/ai/proxy skrývá ANTHROPIC_API_KEY (nikdy nejde do browseru), loguje každé volání do ai_usage_log (model, tokens, cache hit, cost) — základ pro /provoz/tokeny dashboard a per-klient atribuci.

Proč dossier místo tool_records per call

tool_records zůstává jako archiv (kdo kdy udělal jaký průzkum). Dossier je aktuální snímek — deep-merged fakta, která AI dostane do promptu. Bez tohoto rozdělení by AI dostávala buď zastaralou verzi (nejstarší lustrace), nebo neúplná data (poslední tool_record bez předchozích).

Proč hub pages s iframe místo jedné stránky per nástroj

Sidebar by při 9 nástrojích (3 DW + 3 MS + 3 kalkulačky) zabral polovinu výšky. Hub = 3 dlaždice nahoře + iframe dole, deep-link přes ?tool=. Vnořené Astro stránky používají ?embed=1 pro skrytí vlastního sidebaru (detekce client-side).

Proč JetBrains Mono na čísla

Finanční kalkulačky (tarify, provize), WMM scoring, token usage — čísla v proporcionálním fontu jsou nečitelná. Tabular-nums v JetBrains Mono srovnají sloupce.

7. D1 schéma

  • users — Clerk identity + role (super_admin / admin / sales / consultant / viewer)
  • clients — klientské karty + intel_json dossier + journey_cc/dw/ms/sa/bp
  • dw_sessions — DW Příprava (checklist, poznámky, rizika)
  • dw_analyses — DW Analýza (overall_score, engagement, findings, komentář) + cross-link na klient kartu
  • mapping_sessions — MS Příprava (dotazník per oddělení, avg_maturity)
  • tool_records — generický archiv výstupů (brand, tool, summary, data)
  • ai_usage_log — každé Claude volání (tokens, cost, model, client_id)

8. Přehled API endpointů

# Klienti + dossier GET /api/clients # seznam POST /api/clients # vytvořit GET /api/clients/:id # detail PUT /api/clients/:id # update (včetně journey_x) DELETE /api/clients/:id # smazat GET /api/clients/:id/intel # dossier PATCH /api/clients/:id/intel # deep-merge dossier POST /api/clients/resolve # najdi/vytvoř podle jména # Analýzy GET/POST /api/dw-sessions # DW Příprava GET/POST /api/dw-analyses # DW Analýza GET/POST /api/mapping-sessions # MS Příprava GET/POST /api/tool-records # Generický archiv (lustrace, MS analýza, …) # AI POST /api/ai/proxy # Claude passthrough + ai_usage_log POST /api/ai/research # Claude + web_search (Průzkumník)

9. Brand & Design system

  • Night blue #2E303E — sidebar, topbar v dark režimu
  • Bright purple #544DE0 — primary accent
  • Pigeon grey #BAC6D3 — sidebar text
  • Sunny cream #F6EFB1 — highlight badges
  • Fonty: Outfit (UI), JetBrains Mono (čísla)
  • Všechny tokeny v public/styles/main.css (alias --primary → --bright-purple)
  • Light/dark mode toggle, PWA installable

10. TODO — co zbývá

  • ○
    Strukturální analýza Astro portZatím iframe do /worki/analyza-struktura-procesy.html.
  • ○
    Asana Blueprint Astro port
  • ○
    Unifikovaný print template (PrintableReport.astro) — jeden vzhled pro všechny print výstupy (DW, MS, Connect Call 2-pager)
  • ○
    Journey tracker auto-detekce — klientská karta odvodí CC/DW/MS/SA/BP ze záznamů v D1
  • ○
    Fireflies OAuth — automatický fetch transcriptů
  • ○
    Realtime CRM sync — klientské karty obousměrně do Raynetu
  • ○
    Clerk secret key do CF Pages secrets — reálný login místo test klíče
  • ○
    Migrace mercanto-asana-proxy do vlastního /api/asana/*

11. Kontakty & provoz

Vlastník: Mercanto Europe SE
Primární uživatelé: Jan Straka, Jan Straka Jr.
Deploy: npm run deploy (Astro build + Wrangler push)
D1 migrace: npx wrangler d1 execute worki-db --remote --file=migrations/00XX.sql
Dokumentace: tato stránka + README.md + worki-platform-brief.md + worki-architektura-brief.md (lokálně v ~/Downloads/)

Poslední aktualizace: 14. dubna 2026 · Iterace 1 dokončena (Client Dossier foundation)