Vibe Legal server — lepingute partii-redlining

KRIITILINE — andmevoo hoiatus. See oskus saadab iga üleslaetud lepingu kogu teksti Google Geminisse AI-põhiseks redline'imiseks. „Too oma võti“ mudel tähendab, et liiklus on seotud sinu kontoga, kuid dokumendi sisu lahkub siiski sinu keskkonnast ja töödeldakse Google'i taristus. Ära käivita kaitstud kliendimaterjalil, kui su büroo pole kinnitanud juriidiliste dokumentide saatmist Google Geminisse asjakohase DPA / büroo AI-poliitika alusel. Kui su büroo pole Geminit kliendi tööks kinnitanud, seadista server osutama kohapealsele mudelile (nt kohalik Llama / Mistral juurutus) või büroo poliitikaga kaetud alternatiivsele teenusepakkujale (nt Azure OpenAI sinu üürniku andmetöötluse tingimustel) enne oskuse käivitamist päris asjadel.

Sihtrühm ja töö kuju

Sihtrühm: Ühendkuningriigis kvalifitseeritud äriõiguse juristid (või järelevalve all olevad paralegalid kvalifitseeritud juristi heakskiidu all), kes loevad jälgitud muudatusi rida-realt ja on valmis AI rakendatud muudatusi tagasi lükkama. Mitte mittejuristidele lõppkasutajatele, iseteeninduslikele lepingu-aktsepteerimise töövoogudele ega järelevalveta paralegali ülevaatusele.

Töö kuju: piiritletud tehinguline partii mastaabis. Iga redline'itud DOCX on mustandettepanek, mitte soovitus, ja operaator peab iga jälgitud muudatuse eraldi aktsepteerima või tagasi lükkama. Töö kuju märkus on oluline, sest partii maht (kuni 5 dokumenti ühes käituses) loob täpselt sellise surve, mis toodab pealiskaudset aktsepteerimist — mastaabis on eskaleerimine olulisem, mitte vähem oluline. Kui sa ei saa ausalt pühenduda partii iga dokumendi muudatusepõhisele ülevaatusele, ära käivita partiid.

Ulatus ja juriidiline kasutus

See oskus pakub juriidilist tuge (esmane redline käsiraamatu alusel), mitte õigusnõu. Kolm juriidilist rikkerežiimi, mille operaator peab omaks võtma:

1. Nõu vs. tugi. Redline'id on positsioonimustandid; vastutav jurist omab iga väljundis võetud positsiooni. Jälgitud muudatus DOCX-is ei ole oskuse, LegalQuantsi ega algse autori soovitus.
2. Kutsesaladus ja konfidentsiaalsus. Kliendilepingu üleslaadimine Google Geminisse (sinu BYOK API-võtme kaudu) suunab dokumendi teksti läbi kolmanda osapoole AI-töötleja ja võib olenevalt Gemini seadistusest ja regioonist hõlmata piiriülest töötlust. See võib kahjustada kutsesaladust ja rikkuda kliendisuhte kirja / kliendi konfidentsiaalsuse kohustusi kliendi nõusoleku ja büroo AI-poliitika katte puudumisel. Käsitle iga käivitust väljaminekuvalis avaldamisena ja kinnita kate enne üleslaadimist.
3. Vastutus. Nimeline üle vaatav jurist peab lõpliku redline'i heaks kiitma. Oskus ei tooda auditijälge sellest, millised AI-toimingud aktsepteeriti või lükati tagasi; üle vaatav jurist vastutab selle kirje jäädvustamise eest väljaspool tööriista.

Millal kasutada

• Mitme lepingu ülevaatus standardiseeritud käsiraamatu alusel
• Lepingute partiitöötlus hoolsuskontrolliks või portfelliülevaatuseks
• Läbirääkimispositsioonide järjepidev rakendamine paljudele dokumentidele
• Jälgitud muudatuste programmiline genereerimine (mitte ainult üksiku dokumendi interaktiivne ülevaatus)
• „Too oma võti“ AI-töövoogude käivitamine tundlikel dokumentidel

Mis see on

Vibe Legal projekti 2. osa — lepingute redline'imise partiitöötluse server.

• Wordi lisandmoodul (1. osa) → interaktiivne läbirääkimine, üks leping korraga
• Server (see) → partiiülevaatus, hunnik lepinguid, mis on märgistatud sinu käsiraamatu alusel

Kuidas see töötab

Arhitektuur

Upload DOCX → Extract structure → Send to AI with playbook → 
AI returns operations (AMEND/INSERT/DELETE) → 
Apply as tracked changes → Download redlined document

Peamised disainiotsused

• Täpsed muudatused, mitte ümberkirjutamised — AI rakendab sihitud toiminguid, mitte täielikku asendamist
• Korralikud jälgitud muudatused — väljund on Wordi natiivsed jälgitud muudatused (läbikriipsutus/allakriipsutus), mitte kommentaarid ega sisene tekst
• Käsiraamatust juhitud — määratle oma läbirääkimispositsioon Markdownis; AI rakendab seda järjepidevalt
• Too oma võti — sinu Gemini API-võti jääb brauserisse; dokumendid ei säili serveris
• Partiirežiim — kuni 5 dokumenti korraga, töödeldakse järjestikku

Näidiskäsiraamatud

# NDA Review (Recipient)
## Priority Issues
1. Term length — push for 2-3 years, not perpetual
2. Carve-outs — ensure public info exclusion
3. Residuals — delete or narrow heavily

## Watch For
- Perpetual confidentiality obligations
- Broad injunctive relief language
- Unilateral fee provisions

Kasutamine

Üksiku dokumendi ülevaatus

1. Lae üles leping (DOCX)
2. Vali käsiraamat
3. Töötle → lae alla redline'itud dokument

Partiirežiim

1. Lae üles kuni 5 dokumenti
2. Vali käsiraamat
3. Töötle järjestikku
4. Lae alla eraldi või ZIP-ina

Käsiraamatu loomine

Kirjuta läbirääkimispositsioonid Markdownis:

# SELLER'S PLAYBOOK
## Priority Issues
1. Payment terms — require payment on delivery
2. Liability cap — maintain full purchase price cap

## Watch For
- Unlimited liability language
- Buyer-friendly termination rights

Kindlusvöödid (lepingu kohta)

Iga AI rakendatud jälgitud muudatust tuleks vaadata selle kindlusvöö valguses. Oskus tuleks seadistada märgistama iga toimingu väljundis (nt kõrvalfaili kokkuvõttememo kaudu iga DOCX-i jaoks), et jurist saaks triaažida, mitte iga muudatust pimesi lugeda:

• Kõrge — toiming on nummerdatud käsiraamatu punkti otsene, sõnasõnaline rakendus klauslile, mille sõnastus langeb käsiraamatu päästikuga tihedalt kokku (nt käsiraamat ütleb „kustuta jääkteadmiste klausel“; dokument sisaldab selgelt tuvastatud jääkteadmiste klauslit; AMEND/DELETE rakendatud).
• Keskmine — käsiraamatu punkt kohaldub, kuid dokumendi sõnastus lahkneb või toiming nõuab otsustust ulatuse osas (nt „kitsenda hagi tagamist“). Jurist peab lugema ümbritsevat klauslit, mitte ainult redline'i.
• Madal / ülevaatus — toiming puudutab vastutuse ülempiiri, hüvitamist, IP üleandmist, andmekaitset, kohalduvat õigust või lõpetamise klauslit; AI põhjendus on ebaselge; selle dokumendi toimingute arv ületab käsiraamatus seatud läve; või dokument langeb teadaolevasse rikkealasse (tabelid, joonealused märkused, pesastatud nummerdus, mitteingliskeelne). Ära esita vastaspoolele kavandatava muudatusena, kuni nimeline ülevaataja on aluspositsiooni heaks kiitnud.

Redline'itud DOCX ilma kindlusvöödita on üle vaatamata väljund. Käsitle seda läbivalt Madalana.

Ulatusest väljas

See oskus ei käsitle:

• Jurisdiktsioonid peale Ühendkuningriigi (frontmatter deklareerib jurisdiction: UK; Ühendkuningriigi-väline kohalduv õigus on ulatusest väljas ja oskus peaks peatuma, mitte jätkama).
• Reguleeritud kokkulepped: tarbijakrediit, ACAS-i / seadusega ettenähtud miinimumidele alluvad töölepingud, kinnisvara üleandmised, FCA-ga kooskõlalist sõnastust nõudvad finantsteenuste kokkulepped, reguleeritud hanked (PCR 2015 / PA 2023).
• Lepingud üle ~50 lehekülje või mis tahes leping koos manustatud lisade / graafikutega, mida AI ei näe (ainult pildi-PDF-id, eraldi lisatud tööülesanded jne).
• Tabelid, keeruline pesastatud nummerdus, veerud, tekstikastid, joonealused märkused — käitumine on ettearvamatu ja oskus peaks keelduma nende dokumentide „puhta“ väljundi tootmisest.
• Mitteingliskeelsed dokumendid.
• Dokumendid, kus käsiraamat on tühi, mitmetähenduslik või sisaldab vähem kui minimaalse arvu prioriteetseid punkte, milles kasutaja on oma meeskonnaga kokku leppinud. Ei mingit vaikset jätkamist.
• Lõplik kvaliteedikontroll / täitmiskõlblikkuse tõendus. Väljund on mustandettepanek üle vaatavale juristile, mitte heakskiit.

Eskaleerimine

Peata partii (või peata üksik dokument) ja suuna nimelisele üle vaatavale juristile, kui mõni järgmistest päästikutest rakendub. Partii mastaabis on eskaleerimine olulisem, mitte vähem oluline — partii maht ei ole ettekääne eskaleerimisläve alandamiseks; see on põhjus seda tõsta.

• AI pakub toimingut, mis eemaldab või nõrgendab vastutuse ülempiiri, hüvitamise, IP-üleandmise, andmekaitse või kohalduva õiguse klauslit.
• AI pakub ühele dokumendile rohkem toiminguid, kui käsiraamatus deklareeritud dokumendipõhine ülempiir.
• Lepingu väärtus (kui metaandmed on saadaval) ületab meeskonna praktikaprofiilis seatud läve.
• Dokument sisaldab struktuure, mida oskus ei suuda usaldusväärselt käsitleda (tabelid, joonealused märkused, pesastatud nummerdus, mitteingliskeelne tekst).
• Käsiraamatu mittevastavus dokumendi näilise tüübi või jurisdiktsiooniga (nt saaja-NDA käsiraamat rakendatud avaldaja-poole mustandile; Inglise õiguse käsiraamat rakendatud Šoti või NY õiguse lepingule).
• Kutsesaladuse värav läbimata — st büroo pole Geminit (või seadistatud alternatiivi) selle asja või kliendi jaoks kinnitanud.
• Operaator ei saa ausalt pühenduda partii iga dokumendi muudatusepõhisele ülevaatusele.

Igal sellisel juhul peaks oskus tootma eskaleerimismemo, mitte ainult redline'itud faili, tuvastades päästiku ja mõjutatud dokumendi(d).

Teadaolevad piirangud

• Tabelid — käitumine ettearvamatu
• Keerulised pesastatud nummerdusskeemid
• Raske vormindus (veerud, tekstikastid, joonealused märkused)
• Mitteingliskeelsed dokumendid
• Deterministlik valideerimine puudub — AI-väljundit ei kontrollita enne rakendamist
• Tagasipööramine puudub — vigane AI-vastus võib dokumendi struktuuri rikkuda

Kriitiline: vaata alati iga muudatus üle. Töö koopiatega. See on uurimistarkvara, mitte tootmisvalmis.

Tehnoloogiapakett

• FastAPI (Pythoni taustsüsteem)
• python-docx + lxml (Wordi manipuleerimine)
• React + Vite (kasutajaliides)
• Google Gemini (AI)
• Tailwind CSS (stiilid)

Seadistamine

git clone https://github.com/sarturko-maker/vibe-legal-server
cd VibeLegalPython

# Backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python main.py

# Frontend (new terminal)
cd vibelegal-frontend
npm install
npm run dev

Piirangud

• AI teeb vigu — võib „kirjavigu parandades“ eemaldada vastutuse ülempiirid, jätta märkamata ilmsed probleemid, hallutsineerida klausleid
• Vaata alati iga muudatus üle, enne kui väljundile toetud
• Kõrge riskiga või suure väärtusega lepingute puhul eskaleeri kvalifitseeritud juristile
• Tabelid ja keeruline vormindus pole täielikult toetatud

Kvaliteedikontrolli parandused (LegalQuants, 2026-05)

Algne autor: Artur Serov. Parandused LegalQuantsilt Legal Skill Design Framework'i alusel, 2026-05. Tehnilist sisu ei muudetud.

See etapp lisas oskuse sisusse järgmise:

• Gemini andmevoo hoiatus üleval. Eelmine versioon mainis BYOK-i „Kuidas see töötab“ jaotises, kuid ei märkinud silmapaistvalt ja struktuurselt, et kogu lepingutekst lahkub kasutaja keskkonnast ja seda töötleb Google Gemini. Rasvases kirjas andmevoo hoiatus asub nüüd sisulise sisu kohal, selge büroo-heakskiidu väravaga („Ära käivita kaitstud kliendimaterjalil, kui su büroo pole kinnitanud juriidiliste dokumentide saatmist Google Geminisse asjakohase DPA / büroo AI-poliitika alusel“) ja selge võimalusega suunata server kohapealsele mudelile või büroo AI-poliitikaga kaetud alternatiivsele teenusepakkujale. See on üksik kõige suurema mõjuga parandus: partii mastaabis on kutsesaladuse risk kogu partii iga dokumendi kaitstud risk, mitte ainult ühe.
• Kutsesaladus nimetatud ühena kolmest juriidilisest rikkerežiimist. Ulatuse ja juriidilise kasutuse jaotis väidab nüüd struktuurselt, et kliendidokumentide üleslaadimine Geminisse BYOK kaudu võib kahjustada kutsesaladust kliendi nõusoleku ja kliendisuhte kirja katte puudumisel. Nõu-vs-tugi ja vastutus on selle kõrval nimetatud.
• Sihtrühm ja töö kuju tehtud selgeks. Ühendkuningriigis kvalifitseeritud juristid (või järelevalve all olevad paralegalid); piiritletud tehinguline partii mastaabis; nõutav muudatusepõhine ülevaatus; mastaabis on eskaleerimine olulisem, mitte vähem oluline.
• Kindlusvöödid lisatud lepingu kohta. Kõrge / keskmine / madal selgete Madala päästikutega (vastutuse ülempiirid, hüvitamised, IP, andmekaitse, kohalduv õigus, teadaolevalt-rikkuvad struktuurid). Redline'i ilma vöödita tuleb käsitleda üle vaatamata.
• Ulatusest väljas jäiga peatuse loend. Ühendkuningriigi-väline kohalduv õigus, reguleeritud kokkulepped, >50 lk, tabelid/joonealused märkused/pesastatud nummerdus, mitteingliskeelne, tühi/mitmetähenduslik käsiraamat, lõplik kvaliteedikontroll. Ei mingit vaikset jätkamist.
• Eskaleerimisjaotis lisatud. Konkreetsed päästikud (vastutus/hüvitamine/IP/andmekaitse/kohalduva-õiguse toimingud, dokumendipõhised toimingu ülempiirid, lepingu väärtus, struktuurilised mittevastavused, läbimata kutsesaladuse värav), mis peaksid tootma eskaleerimismemo, mitte ainult redline'itud faili.

Selle paranduse etapi ulatusest väljas: välise vibe-legal-server repo kaasamine oskuse kausta, LICENSE lisamine, eval-andmete lisamine või välise repo commit-räsi fikseerimine. Need jäävad algse autori lahtisteks punktideks ja on QA-raportis märgitud.