SkillHub — projekti viide

Olek: Faas 3 käimas — engagement elutsükkel, hinnamootor, Dokobit-allkirjastatud kahepoolsed platvormi NDA-d, engagement-vestlus + administraatori järelevalve, suunamisprogrammi pakkumismootor (€1/h × 90-päevane omistamine) ja Smart-ID + Mobiil-ID esmase-faktori sisselogimine identiteedi-väravaga kõik elus (v1.0.14). Vt §29 Teekaart ja ülesannete jälgija kogu faasipõhise loendi jaoks ja §28 eelmise seisundi snapshot-i jaoks. Viimati uuendatud: 2026-05-10 Eesmärk: Üks tõe allikas. Iga kõrvalekalle sellest dokumendist tuleb enne teostust selgesõnaliselt kokku leppida ja siia tagasi kanda. Investorile suunatud narratiiv: vt allpool sisukorra järel Kasutajateekonnad — asutaja narratiiv. See peatükk on äriplaani ja investorile esitletava deki alus; kõik ülejäänud peatükid on selle tehniline teostus.

Sisukord

• Kasutajateekonnad — asutaja narratiiv (investorile suunatud proosa; äriplaani alus)

1. Identiteet
2. Visioon ja lifti-pitch
3. Turuanalüüs
4. Konkurents
5. Strateegiline positsioneerimine
6. Kümme häirimisteljet
7. Platvormi ulatus — mida me teeme ja mida mitte
8. Ärimudel
9. Dünaamiline hinnamootor
10. Palgafond ja varahaldus
11. Sertifitseerimissüsteem
12. Koolitusäri
13. Usaldus — arvustused, vaided, blokeerimised
14. Kuus suletud automatiseeritud silmust
15. AI-kiht
16. Tehnoloogiavirn
17. Arhitektuur ja repositooriumi paigutus
18. Kasutajatüübid ja rollimaatriks
19. Andmebaasi domeenid ja tabelid
20. Andmebaasi konventsioonid
21. Disainifilosoofia
22. Disainimärgid ja esteetilised reeglid
23. Turule mineku plaan
24. KPI-d
25. Riskid ja maandused
26. Teekaardi faasid
27. Sõnastik
28. Teostuse seis
29. Teekaart ja ülesannete jälgija

Kasutajateekonnad — asutaja narratiiv

See peatükk on asutaja-hääles läbikäik sellest, kuidas SkillHub teenib raha: automatiseerides tööjõurendi nendele klientidele, kes täna ostavad pärandlikest agentuuridest, ning makstes välja vahe töötaja netopalga (pärast makse ja kohustuslikke makseid) ja kliendile esitatava arve määra vahel. See on äriplaani ja investori-deki alus, ning iga teine selle dokumendi peatükk on nende kolme teekonna tehniline teostus.

Katvus inseneriteekaardi vastu on koondatud §29 Teekaart ja ülesannete jälgija osas; etappide UX-lepped on formaliseeritud inglise keelse PROJECT_REFERENCE.md §31 osas (otsast-otsani sobitus- ja lepingustamisvoog).

A. Klient (tööandja / üüriv ettevõte)

Klient on ettevõte, kes vajab sertifitseeritud käsitsitööd massides ja kiiresti, kindlustundes, et tarnitavad inimesed on need, kelleks nad väidavad end olevat, ja oskavad seda, mida väidavad.

1. Avastus. Klient saavutatakse tasulise reklaami kaudu — Meta, Google, YouTube ning valikuliselt välireklaam (reklaamtahvlid). Reklaam pitchib ühte konkreetset valu (sertifitseeritud, kohapealsed meeskonnad tundidega, läbipaistev hinnastamine) ja viitab skillhub.ee-le ja SkillHubi äppidele App Store'is / Google Plays.
2. Sihtleht ja müügilehter. Pikk üheleheline (mobiili-esimene, veebi-peegeldatud) tutvustab platvormi võimekust ja kutsub korduvalt tegutsema.
3. Registreerimine. CTA avab lühikese vormi: e-posti + telefoni kinnitamine, seejärel ümbersuunamine töölauale. Sealt suunatakse kasutaja ettevõtte profiili täitmisele (juriidiline nimi, registrikood, KMKR, arvelduse aadress, esindaja), mis on värav esimese tööbriifi avaldamisele.
4. Kaks võimalust tööbriifi koostamiseks. a. AI Tööjõu Arhitekt — vestlevas chatis pärib ja eraldab struktureeritud shift_request-i loomulikust keelest. Kasutaja vaatab eraldatud tulemuse üle enne avaldamist. b. Tavavorm — selgesõnalised väljad ametile, asukohale, ajakavale, sertifitseeringutele, töötajate arvule, määrale, tööriistadele, isikukaitsevahenditele, hierarhiale.
5. Sobituse tulemused. a. Kandidaadid leiduvad. Loend kuvab pingerea kandidaate koos AI sobituseprotsendiga, kuid kõik isikuandmed on hägustatud ja luku-ikooniga märgistatud (nimi, foto, e-post, telefon, täpne aadress). Klient saab avada CV-stiilis profiili, lugeda AI verdikti ja kutsuda üht või mitut töötajat. Edukuse-dialoog kinnitab saatmise ja kasutaja suunatakse jaotisesse Töötajad → Kutsed (Ootel), grupeeritud projektide kaupa, filtreeritav staatuse järgi. b. Veel ei ole kandidaate. Tellimus jääb aktiivseks. Iga uus pardalevõetud töötaja hinnatakse Etapi 1 (algoritmiline taastamine) poolt kõikide avatud tellimuste vastu uuesti; läbinud sobitused tõstetakse Etappi 2 (AI-skoor) ja tabamuse korral saab klient push-, e-posti- ja äpisisese teavituse uuest kandidaadist.
6. Töötaja võtab vastu. Klient saab kõikides kanalites teavitused, töötaja liigub Ootel-ist Vastuvõetud kutsetesse. Töötaja profiili avamine käivitab nüüd Platvormi NDA voo: leping renderdatakse täielikult lehel, kasutaja peab kerima lõpuni, et üldse saaks allkirjastada, allkirjastamata PDF on ülevalt allalaaditav, ja lõpus käivitatakse Smart-ID / Mobiil-ID / Dokobit allkirjastamise sessioon. Edu korral satub kasutaja kinnituslehele koos kahepoolse allkirjastatud ASiC-E allalaadimisega ja nupuga „Valmis", mis avab töötaja profiili koos kõigi avatud isikuandmetega.
7. Vestlus. Töötaja ja klient saavad nüüd üksteisele sõnumeid saata. Vestluseid jälgib AI, et avastada katsed SkillHubi ümber minna (platvormi-välised lepingud, kõrvalmaksed). Järelevalve on Platvormi NDA-s avalikustatud, ja esimesel vestluse avamisel kuvatakse GDPR Art. 13 teavitus (eesmärk, säilitusperiood, õiguslik alus, Art. 17 kustutamise kanal) — vt §D.4.
8. Prooviantud nädal. Mõlemad pooled allkirjastavad ühenädalase eellepingu (projektipõhine, SkillHub on tööandja-rollis). Kestus on soovi korral läbiräägitav — kumbki pool võib enne allkirjastamist paluda admini eellepingu pikkust pikendada või lühendada (§D.2). Töötaja logib tunde äpis geo-piiratud kella sissepanekuga; klient märgib eelnevalt tööobjekti ja lubatud raadiuse.
9. Kinnitus ja väljamakse. Klient kinnitab töötaja päevased tunnid; kinnituse järel saab töötaja taotleda väljamakset ja SkillHub maksab palgafondist 24 h jooksul, esitades kliendile arve standardtingimustel.
10. Hinnang ja vaie. Lepingu ajal ja lõpus jätab klient 1–5 tärni hinnangu + kommentaari. Töötaja saab esitada vaide; SkillHubi vaiete-nõukogu lahendab. Avaldatud lävendid (keskmine ≤ 2,5 viimase 10 lepingu üle → 14-päevane peatamine; kolmas peatamine → alaline blokeering — §13) on hinnangu-ajaloos otse näha, nii et „õiglus" tugineb reeglile, mitte kaalutlusele. Tsükkel algab uuesti.

B. Töötaja

Töötaja on tüüpiliselt käsitsitöö professionaal, kellel on vaja kiiresti tööd ja vähe kannatust pikkade vormide jaoks.

1. Avastus. Standardkanalid (Meta, Google, YouTube, välireklaam) pluss suunamisprogramm, mis on ehitatud peamiseks pakkumismootoriks:

   „Inimene registreerub SkillHubis ja saab suunamislingi. Kui tema poolt suunatud sõber registreerub selle lingi kaudu (veeb või Android / iOS äpp) ja täidab oma profiili, siis järgmise 3 kuu jooksul iga kord, kui SkillHubi klient palkab selle töötaja, teenib suunaja €1 iga kinnitatud töötunni eest." Suunamispreemia rahastatakse platvormi marginaalist, mitte lahutatakse suunatud töötaja palgast (vt allpool Vastuväited).

2. Kiire registreerimine. Profiilipilt, linn, töötamise raadius, põhikontakt. Kasutaja saab kohe töölaua ligipääsu.
3. Profiili värav. Kodulehe teavitus teatab, et erialaprofiile ei saa avaldada enne, kui isikuprofiil on 100% täidetud. Kasutaja juhitakse seda lõpetama.
4. Kaks võimalust ameti lisamiseks. a. AI vestlusrobot — loomuliku-keele vestlus, mis CV välja parsib; kasutaja vaatab eraldatud andmed üle, lisab tõendavaid pilte / sertifikaate ja avaldab. b. Tavavorm — käsitsi täitmine neile, kes seda eelistavad. Avaldatud ametid kuvatakse loendis koos redigeerimise / kustutamise tegevustega.
5. Kutse saabunud. Push-, e-posti- ja äpisisene teavitus. Kutset puudutades käivitatakse töötaja-poolne Platvormi NDA (lehel lugemine, lõpuni kerimine, Smart-ID / Mobiil-ID / Dokobit allkiri, ASiC-E allalaadimine). Edu korral satub töötaja projekti briifile, kus kõik varem peidetud kliendi-andmed on nüüd nähtavad (juriidiline isik, registrikood, projekti aadress, kontakt). Töötaja saab firmat veebis uurida ja alustada vestlust tööandjaga.
6. Eelleping. Teine allkirjastamise voog — projektipõhine ühenädalane eelleping SkillHubiga (vaikimisi; soovi korral läbiräägitav, vt §D.2). Sama Dokobit allkirjastamise rada.
7. Objektil. Töötaja ilmub kokkulepitud asukohta ja käivitab äpis ajaarvesti (start / stopp). Klient peab olema loonud projekti / alamülesande ja määranud geopiiri.
8. Kinnitus ja väljamakse. Iga tööpäeva järel arutab töötaja vestluses tundide kinnitamise. Kinnitamise järel taotleb töötaja väljamakse ja saab 24 h jooksul raha pangakontole.
9. Avalik hinnang. Töötaja saab jätta avaliku 1–5 tärni hinnangu + kommentaari ettevõttele; see on nähtav kõikidele tulevastele töötajatele, kes vaatavad selle ettevõtte profiili. Ettevõte saab samasse nõukogusse vaide esitada. See radikaalse-läbipaistvuse hoiak on platvormi tuumikne usaldusmehhanism.
10. SkillHub Verifitseeritud + ⭐ tase. Kodulehe promo kutsub töötajat Verifitseeritud märgi taotlemiseks. Voog on lukustatud (i) 100% täidetud profiili ja (ii) autenditud isiku (Smart-ID / Mobiil-ID / ID-kaart) tagant. Taotluse järel võtab SkillHubi tiim töötajaga ühendust e-posti, push-i ja äpisisese sõnumi kaudu, et leppida kokku kontorisse tuleku aeg: dokumendid digitaliseeritakse, ametid testitakse kohapeal, edu korral märgitakse töötaja kõikides kanalites verifitseerituks. Töötajat saab verifitseerida ainult nende ametite jaoks, mis ta on juba avaldanud, sest verifitseerija valmistub vastavalt. Märk pluss ⭐1–⭐5 sertifitseerimisredel voolavad otse §9 / EN §31.16 hinnamootorisse — kõrgem tase ja verifitseeritud staatus tõstavad proportsionaalselt töötaja brutomäära ja platvormi arvelduse — ning AI-sobitamise skoori, mis on klientidele nähtav.

C. SkillHubi admin

Veebi-esimene, sest töö toimub suurel ekraanil, mobiili pariteediga reisidel.

Admin logib sisse töölaua avalehele, mis võtab kokku iga võtmeplatvormi seisu reaalajas; klõpsamisel avaneb detailvaade.

1. Kasutajad. Filtreeritav rolli (admin, töötaja, tööandja, …), loomise kuupäeva, esimese rolli järgi. Reaview näitab vaid hädavajalikku; klõps avab kasutaja profiili kahe vahekaardiga (Ettevõte / Isiklik), mis peegeldavad töötaja- ja tööandja-poole profiili-ekraane 1:1, vaikimisi loe-ainult režiimis, koos Muuda tegevusega, mis aktiveerib samad sisendid, mida kasutaja näeb. Mobiil peegeldab töötaja / tööandja paigutust; veebi pool on poleeritud SkillHubi disain, sisendi-stiil sisselogimise lehe sarnane.
2. Verifikatsioonid. Kolm vaadet: Verifitseeritud infolehe külastajad, avatud verifitseerimistaotlused ja administraatori pipeline. Tööriistad: sertifikaadi üleslaadimine, sisesed märkmed, etapi / kanban-üleminekud kontoritiimi vahel ja vaide-vestlus töötajaga.
3. Hinnangud. Ühtne loend kõigist töötaja→kliendi ja kliendi→töötaja arvustustest. Iga osaleja avab kogu ajaloo. Lehel asub ka vaiete-nõukogu tööriistakast: sildistamine, kommentaarid, osakondade vahel suunamine, otsuse salvestamine.
4. Ametid ja tööd. Vahekaardid avaldatud töötaja erialade ja tööandja tellimuste ülevaateks / filtreerimiseks / modereerimiseks, sealhulgas blokeerimise tegevus võltspostituste jaoks.
5. Sobitused. Operatsiooniliselt kõige kriitilisem ekraan. Loetleb iga kliendi-kutse, iga töötaja-vastuse, NDA staatuse ja vestluse sisu (vastavus ümbermineku-katsetele). Toob esile, kes on eellepingu allkirjastanud ja kes mitte. SkillHubi allkiri lisatakse serveripoolselt; mõlemad pooled allkirjastavad Smart-ID / Mobiil-ID / ID-kaardiga; admin saab alla laadida ASiC-E faili.
6. Lepingud. Ajaloolised ja praegu aktiivsed lepingud, otsitavad ja eksporditavad.

D. Lukustatud otsused (asutaja resolutsioonid, 2026-05-09)

Allolevad vastuväited toodi asutaja ette otsustamiseks; otsused on v1 jaoks siduvad ja siia salvestatud, et narratiiv, kood ja lepingu-mallid jääksid kooskõlla.

1. Suunamise rahastamise allikas — rahastatud platvormi marginaalist. €1/h × 3-kuuline preemia makstakse SkillHubi vahest, ei lahutata kunagi suunatud töötaja palgast. SkillHubile majanduslikult neutraalne (haarame juba vahe) ja tööõiguslikult puhas (NL / DE / FR / PL miinimumpalga / kollektiivlepingu riskid puuduvad).
2. Eellepingu pikkus — lame üks nädal, soovi korral läbiräägitav. Vaikimisi eelleping on üks nädal. Eelleping on kahe ettevõtte (SkillHub OÜ tööandja-rollis + klient) ja töötaja vahel käsunduslepinguga (EE TLS), mistõttu pooled võivad eellepingu kestust lepinguliselt määrata, mitte töölepingu seaduse alusel. Nii klient kui töötaja võib taotleda erinevat kestust iga konkreetse lepingu kohta; admin kinnitab ja SkillHubi-poolne mall kohandab kestuse-välja. Riigipõhised mallid NL WAADI, DE AÜG, FR ajutise-töö ja PL APT jaoks lisanduvad nende riikide käivitamise slice'idesse, mitte siia.
3. Verifitseerimise skaleerimine — algul majas, hiljem partnerid. Eesti käivitamine verifitseerib töötajaid SkillHubi kontoris kohapeal (see on brändi eristaja). Kui avame riigid 2..N, laiendavad partnerkoolid ja mobiil-verifitseerijad sama protokolli; senikaua on bottleneck tahtlik ja võimekusele vastav. EN §31.14 admini pipeline toetab juba mõlemat režiimi.
4. AI-jälgitud vestlus — disainilt GDPR-vastavalt. Platvormi NDA avalikustab AI-järelevalve selgesõnaliselt (ümbermineku-tuvastus + tavateksti säilitamine vastavusülevaateks). Esimesel vestluse avamisel näeb kasutaja GDPR Art. 13 banneri — eesmärk, säilitusperiood, õiguslik alus (õigustatud huvi + lepingu täitmine), Art. 17 kustutamise kanal mitte-tõenduslike fragmentide jaoks. Kinnitus logitakse. Avalikustamine peab eelnema igale sõnumi salvestamisele.
5. Isiku-avalikustamine — rolli-põhine, mitte kahepoolne. Vastaspoole isikuandmed avanevad hetkel, mil kutsuja ise on allkirjastanud oma kahepoolse Platvormi NDA SkillHubiga. Sellel hetkel on kutsuja lepinguliselt seotud konfidentsiaalsusega ja SkillHub on kaitstud; teine pool jääb oma vaates anonüümseks, kuni allkirjastab oma NDA. See asendab varasemat „oodake mõlemat" lukku; kihiengaažmendi olekumasin liigub endiselt mõlemast accepted_pending_*_platform_nda olekust läbi (st eellepingu faas nõuab endiselt mõlemat NDA-d), kuid isikuandmete vaate lukk on rolli-põhiselt eraldatud (apps/web/server/utils/engagementDetail.ts → computeIdentityUnlocked).
6. Peatamise lävendid — toodud kasutaja-pinnale. §13 invariant (keskmine ≤ 2,5 viimase 10 lepingu üle → 14-päevane peatamine; kolmas peatamine → alaline blokeering) on näidatud nii töötajale kui kliendile hinnangu-ajaloo pindadel ja vaiete-nõukogu UI-s, nii et „õiglus" tugineb avaldatud reeglile.
7. ⭐ tase töötaja-teekonnas. Töötaja-teekond (B.10) sulgeb silmuse: Verifitseeritud märk pluss ⭐1–⭐5 sertifitseerimisredel voolavad otse §9 / EN §31.16 hinnamootorisse — kõrgem tase ja verifitseeritud staatus tõstavad proportsionaalselt töötaja brutomäära ja platvormi arvelduse.

E. Katvuse kaart praeguse builti vastu (seisuga v1.0.13)

Kaks suurimat ehitamata blokki on (1) usaldus- ja teostussilmus (vestlus → eelleping → ajaarvestus → väljamakse → arvustused → vaided) ja (2) admini veebi-äpp. Mõlemad peavad eelnema reaalsele GTM-ile väljaspool suletud Eesti pilooti.

1. Identiteet

• Sisemine koodnimi / töönimi: SkillHub
• Üheksrida: „Stripe sertifitseeritud käsitööle — ettevõtted panevad sertifitseeritud meeskonnad kokku minutitega, töötajad ehitavad kaasaskantava avaliku karjäärikande, iga euro on läbipaistev."
• Kategooria: B2B-tööjõu rendi turuplats sertifitseeritud käsitööliste jaoks ELis.

2. Visioon ja lifti-pitch

SkillHub on täisautomatiseeritud, AI-toega turuplats, mis lubab EL-i ettevõtetel leida, lepingustada, tunde mõõta ja maksta sertifitseeritud käsitöö tegijatele ilma ühegi telefonikõneta. Töötajad saavad kaasaskantava avaliku karjäärikande ja juurdepääsu tasulistele platvormi koolitustele, mis tõstavad nende taset. Iga tehing, tund, hinnang ja vaide otsus on avalikult nähtav — radikaalne läbipaistvus asendab pärandlike tööjõubüroode hägusust.

Platvormi poolelt jääb ainsaks inimsammuks sertifitseerimispaberite ülevaatus. Kõik muu — leidmine, sobitamine, lepingustamine, kella sisselöök, kinnitamine, väljamakse, arvustus, vaide järjestamine — on tarkvara.

3. Turuanalüüs

4. Konkurents

5. Strateegiline positsioneerimine

Pärandagentuuride vastu: oleme oluliselt odavamad (18–28% marginaal vs nende 40–60%), kiiremad (minutid vs päevad) ja läbipaistvad. Digital on-demand mängijate vastu: spetsialiseerume sertifitseeritud käsitöödele tegeliku sertifikaadiredeli ja koolitusmootoriga, mida nad kiiresti järele teha ei saa. Tööjõuhalduse SaaS-i vastu: oleme kahepoolne turuplats, mitte tööriist — meie pakume töötajaid.

6. Kümme häirimisteljet

1. Sertifitseerimis-tähtede redel (⭐1–⭐5) — kontrollitud paberid + platvormi koolitused. Avalik profiili-URL töötaja kohta („LinkedIn käsitöölisele"), kaasaskantav ja töötaja oma.
2. Koolitusäri kui pakkumismootor — tasulised kursused toodavad pakkumist; konkurendid peavad selle ostma.
3. Avalik läbipaistvuse sein — iga lõpetatud leping, tunnid, hinnang, väljamakse on anonüümitud-aga-koondatud kujul nähtav. Pärandagentuuridel võimatu kopeerida ilma marginaale paljastamata.
4. Dünaamiline regionaalne hinnamootor — EL-i sinikraede reaalajas hinnaindeks riigi × ameti × sertifikaadi astme × lojaalsuse × nappuse järgi. Avalikult nähtav.
5. Automatiseeritud deposiit + 24-tunnine väljamakse — klient maksab platvormile → topeltkinnitatud tunnid → töötaja maksab 24 h jooksul. Pärandagentuurid maksavad 30–60 päeva.
6. AI tööjõu arhitekt — klient kirjeldab projekti tavakeeles → AI pakub välja meeskonna (rollid, tasemed, tunnid, hind, ajakava).
7. Taust-AI sobitaja koos järjestatud alternatiividega — käivitub pidevalt; näitab täideklappinud kandidaate + alternatiive sobivuse %-ga, et klient saaks otsustada riski vs saadavuse vahel.
8. Vaide-tribunal koos avalikult logitud otsustega — kvaliteet jõustab end ise; halvad osalised valivad end ise välja.
9. Täielikult iseteenindav lepingustamine — vahetuse- või projektipõhine klikiläbi e-leping, riigipõhiselt lokaliseeritud, null telefonikõnesid.
10. Töötaja-omandis maine kaasaskantavus — QR + W3C kontrollitavad tõendid, mille töötaja säilitab ka platvormilt lahkudes; muudab töötajad evangelistideks.

7. Platvormi ulatus

Me teeme

• Sobitame, lepingustame, ajastame, mõõdame tunde, maksame, hindame ja arbitreerime vaidlusi.
• Sertifitseerime töötajaid (paberite ülevaatus + meie koolitusrajad).
• Käitame palgafondi ja maksame töötajatele 24 h jooksul kinnitatud tundide järel.
• Pakume dünaamilist hinnaindeksit avalikult.
• Pakume API-d / veebihaake klientide ERP-dele.

Me selgesõnaliselt EI

• Paku majutust.
• Tegele sisserände, viisade kaasrahastamise ega A1 / lähetuspaberitega kaugemal kui infomaterjal.
• Halda projekte ega juhi platse (meeskonnajuhte ei tarnita meeskonnajuhtidena).
• Anna tööriistu, IKV-d ega transporti.
• Garantee töötaja sooritust kaugemale kui tema sertifitseerimisaste — sertifikaadi tase on leping.

See kitsas ulatus on tahtlik vastutuse tulemüür, kirjas igas raamlepingus.

8. Ärimudel

Tuluvood prioriteetsuse järjekorras:

1. Turuplatsi marginaal: dünaamiline 18–28% kliendi tariifist, läbipaistva vahemiku piires. Töötajad ja kliendid näevad mõlemad hinnaindeksit ja astmete arvutust.
2. Koolituse õppemaks: €19 (sissejuhatus) → €79–€499 (kutserajad) → €29 kiirvalideerimine olemasolevatele professionaalidele. Tulujaotus 70/30 (meie/partner) partnerkooli sisule; 100% kui sisu meie oma.
3. Sertifikaadi kontrollitasu (€29) töötajatele, kes laadivad üles olemasolevad sertifikaadid, mis möödavad meie kursusest.
4. API / integratsiooniaste ettevõtte ERP-dele (Procore, PlanRadar, SAP SF): fikseeritud kuutasu + tasu väljakutse kohta.
5. Esiletõstetud töötaja / prioriteetne sobitamine: töötajad saavad valida väikese tasu eest prioriteetse paigutuse tihedates sobivuses. Piiritletud, et vältida „pay-to-win" domineerimist.

Hinna- ja marginaalipoliitika elab rate_index_*, pricing_multiplier_* ja margin_band_rules tabelites. Skeemi-välised sooduskampaaniad puuduvad.

9. Dünaamiline hinnamootor

Sisendid (avalikult teadaolev, kraabitud + normaliseeritud)

• Eurostat LFS tunnipalgad NACE × riigi järgi.
• Riiklikud kollektiivlepingu miinimumid (CAO, CLA, Tarif).
• Tööportaalide avaldatud tariifid (Indeed, LinkedIn, riiklikud portaalid).
• Konkurentide avalikud hinnalehed, kus saadaval.
• A1 lähetuse kulude erinevused piiriülestel paigutustel.

Valem (lihtsustatud)

ClientRate = BaseRate(country, trade)
           × CertTierMultiplier(⭐1..⭐5)         // 1.00 … 1.45
           × LoyaltyMultiplier(worker_tenure)     // 1.00 … 1.15
           × ScarcityMultiplier(region_demand)    // 0.95 … 1.30
           × (1 + PlatformMargin)                 // marginaalivahemik 0.18 … 0.28

WorkerPay  = ClientRate / (1 + PlatformMargin)
           − MandatorySocial(country)

Marginaalivahemik: 18–28%

• Lööb pärandagentuurid (40–60%) alla.
• Vaikimisi läbipaistev — avalik leht näitab, kuidas iga tariif on koostatud.
• Lojaalsus tõstab töötaja palgakordajat, mitte meie marginaali. Kliendi tariif tõuseb veidi tõestatud töötajatele; platvormi marginaal jääb samaks.

Lojaalsuse redel

Iga 200 kinnitatud tundi → +1% töötaja palgakordajat, ülempiir +15%.

10. Palgafond ja varahaldus

• Reserv: 6% igast arveldusest läheb eraldatud palgafondi.
• Sihtreserv: ≥ 45 päeva jooksvat palgalehte.
• Eesmärk:
  1. Maksta töötajatele 24 h jooksul topeltkinnitatud tundidest, isegi kui klient pole veel arveldanud.
  2. Rahastada vaidetribunali tasusid (paneeli liikmed saavad palka).
  3. Katta lootusetute võlgade mahakandmised.
• Raamatupidamine: kahekirjeline pearaamat (ledger_accounts, ledger_entries) — finantstõe ainus allikas. Stripe on rööbas; pearaamat on kanne.

11. Sertifitseerimissüsteem

• Astmed: ⭐1 (algaja) → ⭐5 (meister).
• Teed tähe juurde:
  1. Lõpeta platvormi kursus + eksam.
  2. Kiirtee: laadi üles olemasolevad tunnustatud sertifikaadid, kontrollitakse väljaandjate registrite vastu (certification_issuers).
• Astme aegumine: sertifikaadid kannavad kehtivusaknaid certification_types.validity_months järgi. Uuendamise meeldetuletused saadetakse 90 / 30 / 7 päeva enne aegumist.
• Ainus käsitsi platvormi samm: certification_reviewer roll. Kõik muud operatsioonid on automatiseeritud.
• Pettusekontroll: OCR + dokumendituvastuse mudel + registrite ristkontroll + juhuslik audit. Tõestatud pettus = jäädav blokk + avalik kanne.

12. Koolitusäri

• Tasuta tase: sissejuhatus + platvormi reeglid + ohutuse alused (kohustuslik nimekirja saamiseks).
• Tasulised rajad: ametipõhised videod + eksam + järelevalvega praktika (€79–€499).
• Kiirvalideerimine olemasolevatele sertifikaatidele (€29).
• Tööandja sponsoreeritud koolitus: klient maksab ette N töötaja koolituse konkreetse projekti jaoks; loob ekslusiivsust ja lojaalsust.
• Partnerkoolid: 30/70 tulujaotus (meie/nemad), kui sisu on nende oma; vastupidi, kui meie oma.
• Juhendaja roll: worker_instructor — sertifitseeritud töötaja, kes loob sisu, teenib tulu osakaalu.

13. Usaldus — arvustused, vaided, blokeerimised

• Topelt-arvustus pärast iga lõpetatud lepingut (klient → töötaja ja töötaja → klient).
• Arvustused on avalikud ja seotud kontrollitud lepinguga (lepinguta arvustust ei ole).
• Vaide aken: 7 päeva pärast arvustuse esitamist.
• Tribunal: 2 juhuslikku sertifitseeritud töötajat + 1 juhuslik kontrollitud kliendihaldur + 1 platvormi arbitraator. Tasu palgafondist.
• Otsus avaldatakse Läbipaistvuse seinal.
• Auto-peatamine: keskmine ≤ 2,5 viimase 10 lepingu kohta → 14-päevane peatamine.
• Jäädav blokk: kinnitatud pettus, ohutusrikkumine või kolmas peatamine.

14. Kuus suletud automatiseeritud silmust

1. Nõudluse vastuvõtt — AI tööjõu arhitekt → struktureeritud shift_request.
2. Sobitamine — taust-sobitaja → järjestatud match_candidates koos protsentidega.
3. Lepingustamine — automaatselt loodud, riigipõhiselt lokaliseeritud e-leping, e-allkirjastatud.
4. Teostus — geo-aiaga kella sisselöök + topeltkinnitatud tunnid.
5. Arveldus — deposiit → palgafond → töötaja väljamakse → platvormi marginaal.
6. Tagasiside ja usaldus — topelthinnang → avalik sein → vaidetribunal → blokeerimisloogika.

Ainult üks koht kogu platvormil nõuab inimest: certification_reviewer.

15. AI-kiht

Kaks koostöös AI-pinda jagavad samu aluseks olevaid mudeleid ja andmeid.

15.1 Kliendile suunatud AI tööjõu arhitekt (vestlev)

• Vestlus-UI kliendi armatuurlaual. Tavakeele sisend: „Mul on vaja valada vundamenti 3-korruselisele jaehoonele Rotterdamis alates 12. maist umbes 6 nädalaks, umbes 8 inimest."
• Eraldab struktureeritud shift_request (ametid, arv, kuupäevad, sertifitseerimisastmed, asukoht, IKV, keeled).
• Näitab reaalajas hinnaeelvaadet enne esitamist.
• Üks-klikk-esitus muudab vestluse päris shift_request reaks, käivitades sobitaja.

15.2 Tausta sobitaja (autonoomne)

• Käivitub kohe, kui shift_request.status='submitted', läbi Cloudflare Queue töö.
• Iga rolli nõude kohta: Vectorize sarnasusotsing töötaja oskuste + asukoha + saadavuse manuse järgi, seejärel reeglifiltrid (sertifitseerimisaste, kaugus, must nimekiri, keel) → kandidaadi kogum.
• Hindab iga kandidaadi 0–100%, talletatakse match_candidates.score; tunnusepõhised panused talletatakse match_feature_values (selgitatavus).
• Esitab kliendile kolm ämbrit:
  • Täielik sobivus (≥ 90%) — pakutakse automaatselt; ühe-kliki broneering.
  • Head alternatiivid (70–89%) — näidatakse sobivuse %-ga ja „miks" jaotusega; klient otsustab, kas võtta veidi madalam sobivus saadavuse nimel.
  • Venitatud variandid (50–69%) — näidatakse ainult kui klient laiendab kriteeriume.
• Käivitub uuesti iga 15 min — kui töötajate saadavus muutub, kandidaadid keelduvad või uued töötajad registreeruvad. Kliendile saadetakse push/e-kiri, kui parem sobivus ilmub enne vahetuse algust.

15.3 Muud AI kasutused

• Pettuse / võltsitud sertifikaadi tuvastus: OCR + dokumendinägemus + registri ristkontroll.
• Arvustuse autentsus: sentiment + stüülanalüüs + plahvatuse tuvastus.
• Tugi-taandus: RAG-vestlusbott platvormi teadmusbaasil (Vectorize).
• Dünaamilise hinnastamise skoorimine: gradient-boosted mudel hinnaindeksil, treenitud iganädalaselt.

15.4 Mudeli marsruutimine

• Cloudflare Workers AI (odav, servas) jaoks: manused, klassifitseerimine, kerge marsruutimine.
• OpenAI / Anthropic AI Gateway kaudu jaoks: vestlev arhitekt, keerukas eraldamine, järelevalve hindamine. AI Gateway annab meile vahemällu, kulupiirid ja tõrkesiirde teenusepakkujate vahel.

16. Tehnoloogiavirn

Kõik andmed hostitud EL-i regioonides (Frankfurt). GDPR artikli 30 register hooldatud esimesest päevast. DPIA sobitusmootorile enne tootmist.

17. Arhitektuur ja repositooriumi paigutus

Nii apps/web kui apps/mobile kannavad kõiki kasutajarolle (klient, töötaja, kool, admin). Jaotus on peamise pinna mitte võimekuse järgi:

• apps/web — peamiselt klientidele (armatuurlauad, statistika, töötajate ülevaade — saavad suure ekraaniga kasu), aga töötajad saavad samuti brauserist ise teenindust.
• apps/mobile — peamiselt töötajatele (kella sisselöök, kohapealsed protsessid, push-teated, mobiili-eeline), aga kliendid saavad vahetusi liikvel hallata.

Eraldi worker-web rakendust pole — see rolli jaotus tühistati apps/web rolli-teadliku marsruutimise kasuks.

skillhub/
├── apps/
│   ├── web/                    # Nuxt 4 + @nuxt/ui v4 + Tailwind v4. Klient-peamine, kõik rollid.
│   │   ├── app/                #   Vue lehed, komponendid, poed, paigutused, i18n.
│   │   ├── server/             #   Nitro API marsruudid + utiliidid (sobitaja, manused, postiklient, auth).
│   │   └── wrangler.toml       #   Per-keskkonna Cloudflare seosed (D1, AI, VECTORIZE, KV, R2).
│   └── mobile/                 # Ionic Vue + Capacitor (iOS + Android). Töötaja-peamine, kõik rollid.
├── packages/
│   ├── shared-core/            # Puhas TS: zod-skeemid (shift_request_draft), ULID-abimees (newId()),
│   │                           #   äriloogika. Kasutab apps/web Nitro JA apps/mobile.
│   ├── db/                     # Drizzle skeem + migratsioonid + seemne SQL. 17 skeemifaili,
│   │                           #   üks domeeni kohta (identiteet, geo, ai-sobitamine, …). 119 tabelit.
│   └── design-tokens/          # Brändi palett (#22ACD3) + Tailwind v4 + Ionic CSS muutujad.
├── infra/
│   └── wrangler/               # (reserveeritud) per-keskkonna wrangler.toml mitme-keskkonna kasvades.
└── docs/
    └── PROJECT_REFERENCE.md    # See dokument. Serveeritud live aadressil /reference (nitro server-asset).

Juuretööriistad: pnpm workspaces + Turborepo. CI/CD: GitHub → Cloudflare Pages (auto-deploy main). Tulevased paketid (shared-api, shared-auth, icons) lisatakse, kui dubleerimise kulu ületab abstraktsiooniläve — hetkel piisab apps/web/server/utils/auth.ts + Better Authi kliendist.

18. Kasutajatüübid ja rollimaatriks

Platvormi-sisesed (meie)

Klient (äri) organisatsioon

Töötaja

Kool / koolituspartner

Välised

Õigused talletatakse kujul permissions(code) + role_permissions(role_id, permission_id) + user_role_assignments(user_id, role_id, scope_type, scope_id), kus scope_type ∈ {global, organization, project, shift}.

19. Andmebaasi domeenid ja tabelid

Normaliseeritud, struktureeritud andmetele JSON-blobi pole. ~95 tabelit 16 domeenis. Kõigil tabelitel on id, created_at, updated_at, deleted_at (pehme kustutus) ja version kus asjakohane.

19.1 Identiteet ja ligipääs (11)

users, user_emails, user_phones, user_credentials, user_sessions, user_mfa_methods, user_oauth_accounts, roles, permissions, role_permissions, user_role_assignments.

19.2 Organisatsioonid (8)

organizations, organization_types, organization_memberships, organization_invitations, organization_addresses, organization_industries, organization_legal_docs, organization_kyb_checks.

19.3 Töötaja profiil (12)

worker_profiles, worker_profile_photos, skills, worker_skills, languages, worker_languages, worker_addresses, worker_transport_means, worker_availability_windows, worker_availability_exceptions, worker_preferences, worker_emergency_contacts.

19.4 Sertifitseerimine (9)

certification_types, certification_issuers, worker_certifications, worker_certification_documents, platform_cert_tiers, worker_cert_tier_history, cert_verification_reviews, cert_verification_review_notes, cert_renewal_schedule.

19.5 Koolitus ja koolid (14)

courses, course_categories, course_prerequisites, course_modules, course_lessons, course_lesson_resources, course_enrollments, course_lesson_completions, exams, exam_questions, exam_question_options, exam_attempts, exam_attempt_answers, proctoring_sessions.

19.6 Projektid, vahetused, määramised (11)

projects, project_sites, project_site_requirements, shift_requests, shift_role_requirements, shifts, shift_assignments, shift_assignment_status_history, shift_cancellations, shift_replacements, shift_invitations.

19.7 Lepingud (7)

contract_templates, contract_template_versions, contracts, contract_parties, contract_clauses, contract_signatures, contract_addenda.

19.8 Tunni-jälgimine (8)

timesheets, time_entries, time_entry_geopoints, time_entry_confirmations, break_entries, time_adjustments, overtime_rules, overtime_calculations.

19.9 Hinnastamine (9)

rate_index_countries, rate_index_trades, rate_index_entries, rate_index_sources, pricing_multiplier_types, pricing_multiplier_values, price_quotes, price_quote_line_items, margin_band_rules.

19.10 Maksed ja varahaldus (13)

stripe_accounts_workers, stripe_accounts_clients, payment_methods, payment_intents, invoices, invoice_line_items, invoice_payments, payouts, payout_line_items, payout_attempts, ledger_accounts, ledger_entries, salary_fund_movements.

19.11 Arvustused, vaided, usaldus (10)

reviews, review_subjects, review_criteria_scores, review_flags, review_responses, appeals, appeal_panels, appeal_panel_members, appeal_votes, appeal_rulings, trust_score_snapshots, ban_records.

19.12 Suhtlus (7)

notifications, notification_channels, notification_preferences, notification_deliveries, email_templates, email_template_versions, chat_threads, chat_messages.

19.13 Vastavus ja audit (8)

audit_logs, gdpr_requests, gdpr_data_exports, consent_records, consent_document_versions, legal_document_versions, data_retention_policies, sanctions_screening_results.

19.14 Geo viide (6)

countries, regions_admin1, cities, postal_codes, timezones, country_licensing_status.

19.15 AI ja sobitamine (6)

match_requests, match_candidates, match_feature_values, match_explanations, ai_model_versions, ai_interactions.

19.16 Integratsioonid ja konfiguratsioon (7)

api_keys, api_key_scopes, webhooks, webhook_subscriptions, webhook_deliveries, feature_flags, feature_flag_assignments, system_settings, shard_routes.

20. Andmebaasi konventsioonid

• Domeeni andmetele JSON-veerge pole. Ainsad erandid: ai_interactions.prompt_snapshot, audit_logs.diff_snapshot — rangelt auditi / silumise jaoks, mitte kunagi koodiradades.
• Polümorfseid FK-sid pole. Selgesõnalised nullitavad FK-veerud kontroll-kitsendustega.
• Raha väiksemates ühikutes (täisarvulised sendid) + selgesõnaline currency veerg.
• Ajatemplid UTC ISO-8601-s, lokaliseeritud ainult esitluses.
• Vaikimisi pehme kustutus; kõva kustutus ainult GDPR-i kustutuse korral.
• Migratsioonid: Drizzle Kit, versioneeritud packages/db/migrations-is, üks migratsioon loogilise muudatuse kohta.
• Mitut entiteeti hõlmavad mutatsioonid käivad teenusekihi kaudu transaktsioonidega. Marsruudikäsitlejad ei sisalda kunagi ad-hoc SQL-i.
• Mitme-rentniku valmidus: igal rentnikule kuuluval tabelil on organization_id (või country_id tuleviku shardimise jaoks). D1 shardi marsruutimine määratletud shard_routes-is, kui horisontaalne skaleerimine algab.
• Indekseerimine: iga FK indekseeritud; iga filtreeritav veerg indekseeritud; liitindekseid kuumadele päringutele dokumenteeritud skeemifaili kommentaarides.

21. Disainifilosoofia

Mobiili-eeline, native-tunnetus, „floating-flat".

Põhipõhimõtted:

1. Ekraan on lõuend. Taust on pind. Interaktiivsed elemendid asetuvad selle peal, mitte sees pesastatud konteinerites.
2. Minimaalne katmine. Pole virnastatud kaarte, pole ümarusega paneele ümarusega paneelides. Maksimaalselt üks visuaalse katmise tase.
3. Hõljuvad elemendid. Nupud, märgid, kiibid ja olulised UI-tükid tunduvad nagu tausta peal — saavutatud peene varju, värvikontrasti ja tüpograafiaga, mitte ääristega.
4. Tugev kontrast, mitte kastid. Hierarhia tuleb tüübi skaalast, kaalust, ruumist ja värvist — mitte ristkülikute joonistamisest.
5. Heldelt valget ruumi. Vähemalt 16 px välimine padding mobiilil; 24–32 px veebis; sisu ei puuduta kunagi serva.
6. Native platvormi kohanduvus. iOS-il kasutab rakendus iOS-i metafoore (swipe-back, lehemodaalid, SF Symbols kus lubatud). Androidil kasutab Material metafoore. Juhitud Ionic mode="ios"/"md" kaudu.
7. Liikumine eesmärgiga. @vueuse/motion ainult oleku üleminekutele ja afordantsidele, mitte kunagi dekoratsioonile.
8. Vaikimisi ligipääsetav. Minimaalselt WCAG AA kontrast iga elemendi peal; minimaalselt 44×44 pt puutealad; fookus nähtav; vähendatud-liikumine respekteeritud.
9. Ühtne pinnakeel. Sama nupp, sama märk, sama nimekirja-rea muster üle veebi ja mobiili — implementeeritud nende vastavates kitt-id, visuaalselt ühtlustatud disaini märkide kaudu.

Esteetilised viiteinspiratsioonid (ainult sisemiselt): Linear, Arc Browser, Things 3, iOS 18 Control Center, Monzo äpp. Mitte: Material 3 kaardi-rohke, Bootstrap-aja konteinerivirnastus, pärandagentuuri veebid.

22. Disainimärgid ja esteetilised reeglid

Märgid elavad packages/design-tokens/-is ja neid kasutavad Tailwindi config (web) ja Ionic CSS-i kohandatud omadused (mobile).

Värvi kavatsus (lõpppalett kasutaja heakskiidu ootel — kohatäitjad)

• Pind: üks soe murdvalge (hele) või sügav lähedasel mustal (tume); mitte kunagi puhas valge ega puhas must.
• Esmane aktsent: üks signaalvärv, kasutatud säästlikult — toimingutele.
• Teisene aktsent: usalduse / kontrollitud / sertifitseeritud indikaatoritele.
• Semantiline: edu, hoiatus, oht, info — vaiksed, mitte kunagi küllastunud.
• Tekst: kolm taset (tugev, vaikimisi, vaigistatud). Mitte rohkem.

Vahede skaala

4, 8, 12, 16, 20, 24, 32, 40, 56, 72, 96 px. Mitte midagi vahepeal.

Raadiuste skaala

0, 4, 8, 12, 16, 9999 (tablett). Nupud vaikimisi 9999 (tablett) või 12; kaardid 16. Mitte kunagi rohkem kui kaks raadiust samal ekraanil.

Tüübi skaala (mobile / web)

• Display: 32 / 48
• Title: 24 / 32
• Headline: 20 / 24
• Body: 16 / 16
• Caption: 13 / 14
• Micro: 11 / 12 Kasutatavad kaalud: ainult 400, 500, 600, 700.

Vari / kõrgendus

Maksimaalselt kaks kõrgendustaset: puhkav (peen, 1–2 px) ja tõstetud (aktiivsetele nuppudele, kleepuvatele ribadele, toastidele). Staatilisel sisul lange-varjud puuduvad.

Mida mitte teha

• Pesastatud kaarte pole.
• Gradiendid puuduvad, välja arvatud maksimaalselt üks ümbritsev hero-gradient pinna kohta.
• Nuppudel ääriseid pole; kasuta tausta + varju.
• Pole väikeseid ikoone ilma seotud puutealata.
• Pole tugevaid täidetud taustu iga nimekirja-elemendi taga — elemendid eralduvad ainult vahede või 1 px peene joonega.

23. Turule mineku plaan

Faas 0 — nädalad 0–4: Vundament

• Juriidiline isik + KMKR (soovitus: NL, parim usaldusväärsus EL-i klientidele; EE e-residentsus kui ainuasutaja ja kiirus on prioriteet).
• Domeen + kaubamärgi pühkimine.
• Stripe Connect taotlus (2–4 nädala ette-aeg — alusta päev üks).
• Ehita tasuta Tööjõu vajaduste analüüsija eraldiseisva lead-gen lehena. Püüab e-kirjad ja struktureeritud nõudluse enne MVP olemasolu.
• Käsitsi-allika 50 piloot-töötajat + 5 piloot-klienti ÜHES riigis + ÜHEL ametil. Soovitus: NL + raketise/sarrusepaigaldus (kõrged tariifid, terav nõudlus, korralik lähetuste koridor).

Faas 1 — nädalad 4–12: MVP, 1 riik, 1 amet

• Tarni silmused 1–5. Silmus 6 esimesed 2 kuud käsitsi.
• 3 sertifitseerimisrada elus.
• Läbipaistvuse sein elus alates lepingust nr. 1.
• Eesmärk: 1 000 lõpetatud töötaja-vahetust 90 päeva jooksul.

Faas 2 — kuud 3–9: 3 riiki, 5 ametit

• Laienda NL → DE → PL. Ametid: raketis, sarrusepaigaldus, keevitamine, lao-ops, kahveltõstuk.
• Käivita tasulised kursused.
• SEO-masin elus (10 000+ programmaatilist lehte).
• Esimene ERP integratsioonipartner (PlanRadar).
• Eesmärk: €500 k GMV / kuus.

Faas 3 — kuud 9–18: Pan-EL skaala

• Lisa FR, BE, PT, CZ, HR, RO.
• Ava API partner-ERP-dele.
• Ettevõtte MSP pakkumine.
• Eesmärk: €5 M GMV / kuus.

Turunduskanalid, prioriteedi järjekorras

1. Programmaatiline SEO (10 k+ pikasaba lehed linn × amet hinnaindeksist).
2. Asutaja-juhitud LinkedIn-i sisu (ops / HR ostja persoona).
3. Külmane väljaminek, mille konksuks on Tööjõu vajaduste analüüsija (mitte müügi-pitch — tasuta tööriist).
4. Töötaja-poole TikTok / YouTube Shorts päris teenistus-kviitungitega.
5. Erialaajakirjandus-PR (NL: Cobouw; DE: Bauindustrie; PL: Muratorplus).
6. Kutsekoolide + ametiühingute partnerlused (kogus-sertifikaadi konveier).
7. Tasuline reklaam viimasena — alles pärast seda, kui orgaaniline baasjoon on mõõdetav.

24. KPI-d

25. Riskid ja maandused

26. Teekaardi faasid

Iga faas lõpeb go/no-go ülevaatusega KPI-de vastu.

• Faas 0 (M0–M1): Vundament. Tulem: Tööjõu vajaduste analüüsija elus, juriidiline isik & Stripe käimas, piloot-konveier tuvastatud.
• Faas 1 (M1–M3): MVP NL-is + raketis/sarrus. Tulem: silmused 1–5 elus, esimesed 1 000 vahetust.
• Faas 2 (M3–M9): Mitme-riigi laienemine. Tulem: 3 riiki, 5 ametit, tasulised kursused, ERP-integratsioon.
• Faas 3 (M9–M18): Pan-EL skaala. Tulem: 9 riiki, ava-API, ettevõtte aste.

27. Sõnastik

28. Teostuse seis

Hetkepilt viimase muudatuselogi sissekande seisuga. Kõik, mida siin pole nimetatud, on endiselt §26 järgi „plaanis".

28.1 Tootmises elus (skillhub-app.pages.dev)

• Monorepo & juurutus: pnpm workspaces + Turborepo; apps/web juurutatakse Cloudflare Pages-ile iga main-i tõuke peale.
• Seosed: D1 (skillhub-prod), Vectorize (skillhub-worker-embeddings, 1024-d kosinus), Workers AI, KV (SKILLHUB_KV), R2 (skillhub-docs).
• Identiteet & auth: Better Auth + Drizzle D1 adapter; ainult magic-link. Päis vahetab sisselogimise CTA ja kasutaja-rippmenüü vahel. /welcome post-sisselogimine määrab rolli /api/me/ensure-role kaudu. Magic-linki saatmine Resend-i kaudu kinnitatud skillhub.ee saatedomeenilt (info@skillhub.ee).
• AI tööjõu arhitekt: /request leht vestleb Anthropic Claude'iga /api/ai/architect kaudu, väljastab range valideeritud shiftRequestDraft (zod) ja renderdab struktureeritud eelvaate.
• Semantiline sobitamine: /api/match manustab kavandi bge-m3-ga, päringab Vectorize-i (top-K 50) homeCountryIso2-ga filtreerituna, hüdraatib töötajaprofiilid D1-st, käivitab reeglipõhise skoorimise (oskuste sobivus, kaugus, keel, usaldus). Kui seosed pole saadaval, kasutab mälusisest seemnekogumit (kohalik dev).
• Sobituse püsivus: iga vectorize-raja käivitus kirjutab match_requests + match_candidates + match_feature_values D1-sse pluss 7-päevase KV-hetkepildi kavandist (match-draft:<id>). GET /api/match/[id] re-hüdraatib ja re-järjestab deep-linki / sügav-värskenduse jaoks kandidaadi-lehel.
• Viite-leht: /reference renderdab seda dokumenti elus, serveerituna Nitro server-asset-ina (töötab Workers-il, faili-süsteemi pole).
• i18n: ET (vaikimisi Eesti käivituseks), EN, NL, DE ühendatud @nuxtjs/i18n v10 kaudu.

28.2 Tootmise andmed (praegune seeme)

POST /api/admin/seed-workers (kaitstud X-Seed-Token-iga) kirjutab idempotentse demo-kogumi: 9 töötajat, 9 oskust, 5 keelt, 4 linna, 9 vektorit. See on suitsutest-kogum — asendatakse päris töötajate liitumisega faasis 2.5.

28.3 Skeem maandunud (Drizzle + D1 migratsioon 0000_initial)

Kõik 17 skeemifaili packages/db/src/schema/-is on D1-s elus: identiteet (Better Authi tabelid), geo, organisatsioonid, töötaja-profiil, sertifitseerimine, koolitus, projektid-vahetused, lepingud, tunnijälgimine, hinnastamine, maksed, arvustused-usaldus, suhtlus, vastavus, ai-sobitamine, integratsioonid. Tabelid on olemas; populatsioon toimub järk-järgult faasi kaupa.

28.4 Mobiilirakendus (apps/mobile) — raamistatud, käivitatav

Ionic Vue 8 + Capacitor 8 + Vite 7, jagab @skillhub/shared-core ja @skillhub/design-tokens veebirakendusega. iOS (SPM) ja Android kestad lisatud; pnpm exec cap sync on integratsioonisamm enne Xcode / Android Studio avamist.

• Marsruudid: /sign-in → /sign-in/check-email → /tabs/{home,shifts,shifts/:id,profile}.
• Auth: better-auth klient magic-link pluginaga. Native WebView-id ei suuda kanda kolmanda-poole-küpsisega seanssi, nii et voo kasutab Ühekordse-Tokeni (OTT) silda: magic-link maandab süsteemibrauseri /api/auth/native-bridge-le, mis genereerib OTT ja suunab skillhub://auth/callback?ott=…-le; rakendus vahetab OTT pikaealise Bearer-tokeni vastu ja talletab selle Capacitor Preferences-isse. apiFetch ümbris süstib tokeni igale päringule (Authorization: Bearer …). Veebi seansid kasutavad endiselt standardset küpsiserada.
• Töötaja vahetuste tsükkel (lugemine + vastamine):
  • GET /api/me/shifts — ootel kutsed + vastuvõetud määramised, ühendatud platsi / projektiga.
  • GET /api/me/shifts/[id] — ühe vahetuse detail, sealhulgas nõuded ja töötaja kutse-olek.
  • POST /api/me/invitations/[id]/respond — vastu võtta / keelduda; vastuvõtul loob shift_assignments rea.
• i18n: ET (vaikimisi) + EN paarsus veebiga.
• Mobiili disainikeel: üksainus AppScreen kest (poolläbipaistev tööriistariba, suur hero-pealkiri, --sh-screen-pad: 20px), uuesti kasutatav sh-tile algprimitiiv (16 px raadius, 1 px peene joonega ääris, varjuta) ja vertikaalse rütmi skaala (--sh-stack-{xs,sm,md,lg,xl}). Esmased toimingud asetuvad otse lõuendile — IonCard ümbriseid pole, pesastatud konteinereid pole. Pinna, brändi ja semantilised CSS-muutujad elavad apps/mobile/src/theme/variables.css-is ja pärinevad @skillhub/design-tokens-ist.

28.5 Veel pole alustatud (järgmised verstapostid)

• Töötaja onboarding-i kirjutamise rada — POST /api/workers, et luua worker_profile + lükata manused Vectorize-i (kasutades uuesti seedWorkerPool-i upsert-abimeest).
• Kliendi onboarding — organizations + organization_members loomis-voog veebis.
• Vahetuse-tellimus → avaldatud vahetus — muuda püsivaks salvestatud sobitus shift_requests reaks + shifts + shift_invitations koos match_request_id lülitusega.
• Demo-andmed esmasele mobiili-sisselogimisele — sea üles töötajaprofiil + paar kutset, et värske sisselogimine maanduks populeeritud avalehel.
• Tunnijälgimine, maksed, sertifitseerimise üleülevaatus-järjekord — Faas 3 ja edasi §26 järgi.

28.6 Operatiivsed märkused

• Saladused (ANTHROPIC_API_KEY, BETTER_AUTH_SECRET, RESEND_API_KEY, SEED_TOKEN) loetakse päringuajal event.context.cloudflare.env-ist, mitte kunagi runtimeConfig-ist — Cloudflare Pages ei avalda projekti saladusi build-runner-ile.
• Vectorize-i metaandmete indeks homeCountryIso2 on loodud; lisa veel (nt hasForkliftCert), kui filtritavad pakkumisnõuded ilmuvad.
• vue-i18n reserveeritud märgid — @, {, }, | on sõnumistringides reserveeritud (lingitud sõnumid, nimega interpolatsioon, mitmus). Et lisada ükskõik millisesse apps/web/i18n/locales/*.json või apps/mobile/src/i18n/locales/*.json lokaalifaili literaalne @ (nt e-posti placeholder), kirjuta see kujul {'@'}. Paljas @ põhjustab komponendi mountimisel sõnumikompilaatorist SyntaxError: 10 ja terve ekraan jääb tühjaks.

29. Teekaart ja ülesannete jälgija

Elav teekaart, mis koondab kõik iteratsioonid alates projekti algusest. Sektsioonid on vaikimisi kokku pandud — klõpsa avamiseks. ✅ tarnitud · 🚧 töös · ⏭️ järgmisena plaanis · ⏸️ blokeeritud / edasi lükatud · 🛑 tühistatud. Viimati konsolideeritud: 2026-05-09 (kaetud v1.0.0 → v1.0.11). Vastab inglise keele §32-le; ingliskeelne versioon docs/PROJECT_REFERENCE.md jääb täielikuks viiteallikaks.

29.1 Seisundi ülevaade

29.2 Üksikasjalik kontroll-loend

29.3 Kinnitatud invariantid

Need reeglid on viidatud §9-le, §15.2-le, §31-le (EN-versioonis) — kordame siin, et nad ei triiviks:

1. Töötajad ei näe kunagi kliendi arvelduse hinda, tööandja palgakulu ega platvormi marginaali.
2. Kliendid ei näe kunagi töötaja brutotunni- ega platvormi marginaali.
3. Identiteedi avamine on rolli-põhine: kutsuja näeb vastaspoole isikuandmeid hetkel, mil ta on allkirjastanud oma kahepoolse Platvormi NDA SkillHubiga (töötaja ↔ SkillHub või klient ↔ SkillHub). Teine pool jääb oma vaates anonüümseks, kuni allkirjastab oma NDA. Eellepingu faas nõuab endiselt mõlemat NDA-d enne allkirjastamise algust.
4. Kogu finantsmatemaatika kasutab täisarvulisi minoorseid ühikuid (sente) — mitte kunagi ujukomaarve.
5. SkillHub OÜ (Devskills OÜ, reg 17171697) on juriidiline tööandja (EoR); toote „tööandja" string viitab kliendile / üürivale ettevõttele.
6. Lowball-tuvastus vähendab tööandja sisestatud määra 15% võrra enne hinnastamist; töötaja preemia lisab 10%; marginaali põrand on 18% (§9, §31.16 EN).

Muudatuste logi