OMI Studio 1.0 ADR Register
Kutatásiprojekt-szerződés egyeztetése — 2026-11-15
Az ADR-036 elfogadott célarchitektúrája az ADR-022-t hordozható projekttulajdonlással és tervezett közvetlen tárolással pontosítja. A korlátozott beágyazott JSON-javítás egyezteti a tényleges formátumot, megtartja az ismeretlen adatokat és az eredeti prototípusforrást, és elválasztja a projektmegnyitást a gráfimporttól. A helyi cache nem felhőmentési igazolás. Új erőforrás, archívum, providerátvitel, párhuzamos módosítás vagy publikálás esetén felülvizsgálandó; az ADR-008/019 bizonyítékai megmaradnak.
Állapot: javasolt összehangolt javítás, a kapcsolódó merge/CI még szükséges; a telepítési és providerelfogadás külön lépés. Nem változtatja a kézirat/konténer generációját, és nem igényel adatbázis-migrációt.
Szerződés, kompatibilitás és jelenlegi megvalósítás (angol).
Szövegdobozok és kutatási forráskövetés — 2026-11-13
Az ADR-035 pontosítja az ADR-001/002/004/008/018/019/022/023 döntéseit: központi Draft sémabájtok eredete, külön verziózott kísérleti szövegdobozprofil, régi/jövőbeli adatok megtartása kifejezett szerkesztési konverzióval, valamint ellenőrzött diagramátadás külső forrással vagy sajátmunkanyilatkozattal. Elutasított: eltérő séma, átnevezett editor-JSON, automatikus gráfpublikálás és általános szerkesztési zárolás. Új profil, szinkronizáció vagy hatósági bizonyíték esetén felülvizsgálandó.
Állapot: javasolt összehangolt javítás; a merge/CI és a telepítési elfogadás külön lépés. Nem jár adatbázis-migrációval, új konténergenerációval vagy lektorálási jogosultsággal.
Profil, döntés és elfogadási követelmények (angol).
Privacy/API határjavítás — 2026-11-08
Az ADR-034 az ADR-012/015/016/017/019 pontosítása: additív v1 privacy/fiókmásolat contract, közös legacy handler/kvóta, szigorú Zod-ból OpenAPI és kliens típus, application/repository határ, szabványos hibák/korreláció és natív kiválasztott-origin transport. Az identity adatbázis authority-ja változatlan. Az üzemeltető adatkezelői tényei nem megfelelőségi tanúsítások és nem identity-/szerkesztői-/bírálói grantok. A másolat kifejezetten részleges.
Elvetett alternatíva: törő URL-átnevezés, eltérő legacy policy, teljes User szerializálása és teljes érintetti export állítása. A meglévő pontos RC-commithoz kötött API/privacy gate-ek maradnak. Újravizsgálat: export-/sémabővítés, közös/bírálati adat, új identity authority vagy legacy eltávolítás. Státusz: javasolt javítás, merge/CI és külön éles elfogadás szükséges.
Studio ADR-034; Studio PR #886.
PKP-támogatás és kiadási bizonyíték — 2026-11-07
Az OJS 3.5.0-4/-5/-6 a Stable elfogadási körbe tartozik; az OMP 3.5.0-4/-5/-6 Preview marad. Mind a hat megnevezett E02-feladat/archívum kötelező regressziós bizonyíték. Az aktuális v1 receipt az ojs-3.5.0-6 kapuval 14 kézi kaput követel; a történeti, 13 kapus receiptek változatlanul megmaradnak, és nem hagyják jóvá a kibővített kört.
Az ADR-010 és ADR-019 pontosítása; a Studio ADR-033 rögzíti a javasolt egyeztetést, következményeket és felülvizsgálati feltételeket. Aktuális támogatási döntés.
Publikációs változat határa — 2026-11-04
Az ADR-032 pontosítja ADR-004/005/007/008/009/018/019/021 határát: a kanonikus forrás és az önállóan szerkeszthető publikációs változat együtt létezhet. A forrásrevízió és publikáció/build eredetkapcsolata belső adat; a név/ORCID látható szerzőjelölés, nem revízióazonosító, aláírás vagy lektoráltsági jogosultság. A módosított publikációs tartalom nem örökölhet lektoráltságot pusztán forráshivatkozásból. A hiányzó leképezést/bizonyítékot nem a szerzői szerkesztés zárolásával kell kezelni.
Ellenőrzött forrás, döntés és elfogadási feladatok.
Outbound védelem és elfogadási checkpoint — 2026-11-02
Az ADR-012/014/016/017 a kétszintű outbound védelemmel és kompatibilitási korlátaival pontosul; ADR-019 külön kezeli az issue, forrásteszt, operátori és exact-candidate receipt állapotát. Az alternatívák, következmények és felülvizsgálati feltételek a kapcsolt checkpointban és a Studio ADR-031-ben szerepelnek. Új privátcím-kivételt vagy Stable ígéretet nem hagyunk jóvá.
Aktuális bizonyítékforrás: biztonsági és elfogadási checkpoint. Ez felülírja az alábbi korábbi állításokat, amelyek #765/#774 nyitott állapotát vagy a connection-time pinning implementációjának hiányát írják. A régi megállapítások történetiek; lezárt issue nem pótolja a hiányzó RC-receiptet.
Történeti checkpoint: 2026-11-01. Az eltérő régi checkpointok történeti bejegyzések. A javítás merge/CI-t igényel; valós elfogadás külön szükséges.
Session, integráció és kiadási evidence egységesítése — 2026-11-01
Ellenőrizhető javítások: Studio #813 · Studio #814 · Studio #815 · Studio #816 · Studio #817. Közben a Studio #812 bevezette az E02 collectort. A #817 ezt a meglévő latest-attempt/azonos-SHA/job/archive gate-et használja, az OMI-SPEC-320 conformance-szal együtt; candidate-only buildet, tényleges publikációs byte-hash-t és kézi receipt-bekötést ad hozzá. Nem vezet be párhuzamos workflow-leltárt.
Részletek: Studio ADR-030. A kapcsolódó javítás merge/CI előtt javasolt.
| ADR / kérdés | Döntés | Alternatíva / indok | Következmény / felülvizsgálat |
|---|---|---|---|
| 014/016/017 — Office authority? | Opaque iframe + HTTP CSP sandbox, nincs API-self; null origin/pontos ablak/channel | API-origin same-origin jog elutasítva; külön cookieless host lehetséges, infrastruktúrája nem szükséges | Páros rollout és valós elfogadás; provider storage igénynél újraértékelendő, izoláció nem gyengíthető |
| 004/005/006/007 — session owner? | Application manager, aktív-store projekció, pending/selection recovery; ID szerinti native hely | React manuscriptlista/globális fájl elutasítva; nincs store-rewrite | Checkpoint marad; focus/undo és scoped-handle recovery külön szerződés, nincs portable sessionadat |
| 014/015/020 — registry version? | Additív v1 és közös legacy router/service/repository; declaration nem grant | Payloadverzió önmagában nem HTTP-verzió; nincs executable runtime | Owner/parity teszt; DTO/lifecycle bővüléskor explicit verziódöntés |
| 007/018 — historical preview? | Pontos snapshotmegőrzés, current-document profil és közös golden | Csendes v1-algoritmusváltás/history rewrite elutasítva | Nagyobb history kvótákkal; későbbi normalizálás külön verziózott evidence-preserving konverzió |
| 016/017 — production PDF fallback? | Kötelező socket, worker helyi executor | API-user process fallback elutasítva | Hiány csak PDF-et tilt; valós systemd/ACL/network/resource gate; topology változásnál újraértékelendő |
| 019 — RC engedély? | Prior build SHA/fájlhash + trusted workflow + teljes kézi receipt + strict issue gate | Zöld marker/lezárt issue/újragyártott eltérő byte nem elég | Hiányzó evidence nem promótálható; attestation nem független tanúsítás; scope/gate/workflow váltáskor felülvizsgálat |
Nincs séma/container-generáció, DB migráció vagy általános szerkesztési korlát. A korábbi pending-vesztés állítás a fülváltásra nem bizonyított: az már checkpointolt. A globális útvonalhiba és historical v1 digestváltozás konkrét regresszióval igazolt.
Aktuális egyeztetés: 2026-10-31, alább. A felülírt checkpoint történeti adat; javasolt javításhoz merge/CI kell, helyi evidence nem telepítési elfogadás.
Draft fordítási, exchange- és jogosultsági checkpoint — 2026-10-31
Pontosítás a Studio f41dadf után, a meglévő függőségi iránnyal. Merge-ig javasolt javítás. Konkrét határok: Studio ADR-029.
| ADR / kérdés | Döntés | Alternatíva / indok | Következmény / felülvizsgálat |
|---|---|---|---|
| 011/017/023: reviewed fordítás kiadhat privát note-ot? | Nem. Public-note szűrés output/readiness előtt, mindkét HTML-ben, aktuális láthatósággal. Privát manuscript/history/ledger megmarad. | Minden reviewed alignment dumpja vagy sourcejegyzet törlése privacy/adatvesztés miatt elutasítva. | Kötelező negatív exportgate; private nem blokkol public proofot. Új audience esetén review; anonim review külön szerverprojekció. |
| 004/005/007: fordítási command/horgony tulajdonosa? | Sessionportos application, Zustand/auth facade, meglévő checkpoint. Profil/path kísérleti. | Új store/history vagy editorútvonal szemantikus befagyasztása szükségtelen/hibás. | Plain-session/store/reopen/revert teszt, future opaque. Canonical170/ContentCodec/verziózott locator esetén review. |
| 008/009: exchange riportfolyamat? | Application ExportExchangeSession: warning/inspect/delivery/fail; UI összeállítja a meglévő renderert/deliveryt. | React mint riportauthority vagy renderer-újraírás elutasítva. | Teljes registry/streaming/maradék hívók nyitottak. Új formátum/audience/validator esetén review. |
| 007/011/012/017: kollaboráció authority? | Aktuális elfogadott DB-membership + ACTIVE account; üzenetenként/15 s idle, 5 s deadline; downgrade read-only; expiry/revoke/unavailable bontás. | Portable szerzőség/admincímke/clientboolean nem grant. | Single-node egész kézirat, nincs editorial/segment implicit jog; reconnect nem bypass. Föderáció/topológia/translator scope/revocation SLA esetén review. |
| 001/008/019: új riport = konformancia? | Validation/exchange/self-assessment/core-review/publication-build külön; hiányos/nem jóváhagyott suite indeterminate. | Envelope/másolt validator/helyi zöld suite nem független/Stable bizonyíték. | Pontos verzió/subject/freshness/exclusion, RC-gate marad; core Draft nem írja át producert. Jóváhagyott profil/független evidence esetén review. |
Nincs schema/container/API-v1-átnevezés vagy DB-migráció. Minden kéziratrész, importált tartalom is szerkeszthető és törölhető marad.
Biztonsági határok egyeztetése — 2026-10-30
ADR-012/015/016/017/019 pontosítása, a kevésbé konkrét történeti checkpointok helyett. Ellenőrzött Studio: 540f67a. Az összehangolt javítás merge-ig dokumentáció-/tesztjavaslat; nem állít telepített hostvédelmet.
| ADR / kérdés | Döntés | Alternatíva és indok | Következmény / felülvizsgálat |
|---|---|---|---|
| ADR-012: admin-bootstrap authority? | ACTIVE allow-listes account + egyező, boolean-igazolt OIDC/SAML-email; explicit központi operatorjelölt is ACTIVE és igazolt. Régi grant privát review; külön scholarly/review authority. | Csak email, bármely SSO vagy username nem bizonyít címhez tartozást. Identity-újraírás nem kell. | Megbízható IdP-újrahitelesítés, második owner/recovery és audit; claim nem hamisítható. Új issuer/claim/email-szabály vagy tervezett break-glass esetén review. |
| ADR-015: legacy/v1 cookie írás? | Globális pontos Origin, strukturált 403/no-store; rate/session az érintett nagy parserek előtt. Additív v1 megmarad. | CORS önmagában, teljes integration-kivétel vagy régi kliens kedvéért gyengítés elutasítva. | Script/native szerződésfrissítés, mindkét mount teszt; nincs tömeges átnevezés. Új cookie-kliens/form/v1-mount esetén review. |
| ADR-016: natív marker jelentése? | Marker + nem üres bearer csak Origin-kivétel; valódi bearerellenőrzés, invalid esetén cookie-fallback nélkül. Runtime platformadapterben. | Marker nem hitelesítés, Tauri Origin nem implicit bizalom. | HTTP pozitív/negatív regresszió; SecureStorage/origin-cache munka nyitott. Transport/auth-handoff változáskor review. |
| ADR-017: PKP/PDF határ? | Pontos POST review-launch kivételek session/HMAC/nonce/lejárat/scope mellett. PDF user/processz aktív 1/2, megőrzött 12/100; 429/503/retry. Env allowlist nem OS-sandbox. | Általános connector-kivétel, korlátlan job, teljes env és processzlokális kvóta globálisnak nevezése elutasítva. | Meglévő kód megtartása; worker/filesystem/resource/network és kapcsolódáskori egress elfogadás (#774/#765); többpéldány előtt elosztott kvóta. Topológia/renderer/protokoll változáskor review. |
| ADR-019: milyen gate blokkol? | Gyors security unit + server HTTP/bootstrap contract suite; valódi deployment/IdP/PKP/native és exact-candidate aggregáció továbbra is kötelező. Preview nem kivétel. | Helper/statikus teszt önmagában, mockolt DB mint integráció vagy envteszt mint sandboxbizonyíték elutasítva. | S01–S05, kontrollált rollout/recovery. Capability-promóció/új subprocess/aggregáció esetén review. |
Security rollout és recovery: pontos hibák/kivételek/korlátok. Nincs OMI/container-verzióváltás vagy DB-migráció. Minden kéziratrész szerkeszthető marad; service-admission/publikációs jogosultság nem szerkesztési korlát.
Dátum: 2026-09-19
Értelmezés: ezek javasolt döntések. A Proposed → Accepted átmenet a Phase A architecture freeze része; csapatdöntés nélkül egyik sem tekintendő utólagosan jóváhagyottnak.
Státuszösszesítő
| ADR | Cím | Javasolt státusz a freeze-nél |
|---|---|---|
| ADR-001 | OMI file-format source of truth | Accepted |
| ADR-002 | Schema és verziómezők | Accepted |
| ADR-003 | Kompatibilitási és migrációs politika | Accepted |
| ADR-004 | Tiptap ↔ OMI content boundary | Accepted, AST profile freeze feltétellel |
| ADR-005 | Application-state ownership | Accepted |
| ADR-006 | Persistence authority és document session | Accepted |
| ADR-007 | Revision/history modell | Accepted |
| ADR-008 | Importer/exporter contract | Accepted |
| ADR-009 | Publication pipeline | Accepted |
| ADR-010 | Publishing System Connector API | Accepted |
| ADR-011 | Peer-review domain és anonimitás | Accepted |
| ADR-012 | Identity boundary-k | Accepted |
| ADR-013 | Storage abstraction | Accepted |
| ADR-014 | Integration capability/permission | Accepted |
| ADR-015 | Backend API versioning | Accepted |
| ADR-016 | Cross-platform adapter boundary | Accepted |
| ADR-017 | Security trust boundaries | Accepted |
| ADR-018 | OMI container, provenance és signature | Accepted, SPEC-330 fixture feltétellel |
| ADR-019 | Stable/preview capability policy | Accepted |
| ADR-020 | Általános executable plugin runtime | Deferred |
| ADR-021 | Webes publikációs minősítés és szerkesztői authority | Accepted; delivery contract Preview |
| ADR-032 | Szerkeszthető publikációs változat és forráskövetés | Javasolt pontosítás; forráskötés és tartalomhűség implementációja még nyitott |
| ADR-034 | Privacy API és részleges fiókáttekintés | Javasolt javítás; merge/CI és éles elfogadás szükséges |
| ADR-026 | Federated server discovery authority | Proposed repair / Preview |
ADR-001 — OMI file-format source of truth
Kérdés. A TypeScript interface-ek, a JSON Schema és a specifikáció közül melyik a wire format normatív forrása?
Döntés. A released OMI JSON Schema az interoperabilitási wire contract normatív, géppel végrehajtható forrása az omi repositoryban. A prose specifikáció a szemantikát és a Schema által nem kifejezhető invariantokat definiálja. A Studio immutable release-ből, checksum szerint vendorolja a sémát, abból wire típusokat/codecet generál, és külön domain típusokat tarthat fenn.
Alternatívák. (1) TypeScript-first schema generation; (2) kézzel párhuzamos TS + schema; (3) Studio repository legyen authority.
Döntés oka. Az interoperabilitás több nyelvet és a PKP pluginokat érinti; a TS nem nyelvfüggetlen. A jelenlegi kézi párhuzam már driftet okozott: OMI 0.2.0 schema létezik, a Studio 0.1-et ír, a vendorizált 0.2 fájl üres.
Következmények. Schema release és checksum szükséges; a generált fájlokat nem kézzel szerkesztjük; a domain invariant validator külön marad. Egy schema változás explicit compatibility reviewt indít.
Felülvizsgálati feltétel. Ha a JSON Schema nem képes a wire-alak stabil leírására vagy a támogatott nyelvek mind ugyanabból a másik IDL-ből generálnak bizonyíthatóan azonos sémát.
ADR-002 — Schema és verziómezők
Kérdés. Kell-e új schemaVersion mező a meglévő top-level schema és omi.version mellé?
Döntés. Nem. omi.version az OMI file-format verzió; schema a konkrét schema URI. A reader ellenőrzi a kettő konzisztenciáját. A container, alkalmazás/generator és manuscript revision külön verziómezőt használ saját rétegében.
Alternatívák. (1) Új schemaVersion; (2) csak schema URI; (3) csak omi.version.
Döntés oka. A harmadik mező redundáns és driftforrás. Az URI exact schema identityt, az omi.version könnyen tárgyalható szemantikus formátumverziót ad.
Következmények. Mismatch fatal diagnostic. A kódban erősen típusos FileFormatVersion, ContainerFormatVersion, AppVersion és RevisionId használatos; stringek nem cserélhetők fel.
Felülvizsgálati feltétel. Ha a schema URI-k nem immutable-ek vagy egyetlen format version több, incompatibilis normatív sémát engedne.
ADR-003 — Kompatibilitási és migrációs politika
Kérdés. Milyen backward/forward compatibilityt ígérjen a Studio, és kell-e általános migration framework a korai beta formátumokra?
Döntés. A kompatibilitási kötelezettség az első fagyasztott stabil OMI generációval kezdődik. Pre-stable fájlokra csak explicit best-effort importer vagy elutasítás készül. Minden későbbi breaking séma-változás pontos from → to migrációt, fixture-t, loss reportot és új célfájlba mentést kap. Újabb major karantén/read-only; újabb minor csak explicit forward-policy mellett szerkeszthető.
Alternatívák. (1) minden kísérleti formátum örök migrációja; (2) silent best-effort open/save; (3) mindig csak legfrissebb verzió támogatása.
Döntés oka. Nem volt production dokumentum a pre-stable generációkon, ezért egy nagy framework költsége nem indokolt. A silent downgrade viszont adatvesztési kockázat.
Következmények. A UI megkülönbözteti az importot, migrációt, read-only recoveryt és normál open-t. Migration nem fut mentéskor implicit módon. Stabil verziót a support policy szerint tartani kell.
Felülvizsgálati feltétel. Ha bizonyíték jelenik meg jelentős, éles pre-stable dokumentumállományról, vagy a stabil verziók száma dedikált migrációs gráfot igényel.
ADR-004 — Tiptap ↔ OMI content boundary
Kérdés. Lehet-e a Tiptap/ProseMirror JSON az OMI portable content modellje?
Döntés. Nem. Az OMI portable content AST-t a SPEC-100 és a file schema definiálja. Tiptap marad editor runtime; verziózott, loss-reporting ContentCodec alakít OMI AST és ProseMirror document között. Átmenetileg a codec olvassa a jelenlegi stringelt Tiptap JSON-t.
Alternatívák. (1) PM JSON standardizálása OMI-ként; (2) editorcsere saját AST-editorra; (3) minden exporter továbbra is közvetlenül parse-ol.
Döntés oka. A PM schema editor-plugin konfigurációfüggő, és jelenleg sok consumerhez szivárog. Ugyanakkor a Tiptap implementáció működik és jól tesztelhető, ezért cseréje indokolatlan.
Következmények. Minden rich-text consumer codec API-t használ; unknown node/mark diagnosztikát és round-trip fixture-t kap. Editor undo/selection nem portable.
Felülvizsgálati feltétel. Ha a ProseMirror ökoszisztéma hosszú távú kompatibilis, nyelvfüggetlen wire standardot publikál, amely az OMI minden szemantikáját losslessly hordozza.
ADR-005 — Application-state ownership
Kérdés. Ki birtokolja a manuscript state-et és valósítja meg a use-case-eket: Zustand action, React komponens vagy application service?
Döntés. A platformfüggetlen application core hajtja végre a commandokat/use-case-eket és birtokolja a document sessiont. Zustand UI/session projection és compatibility facade; React csak intentet küld és view-modelt olvas. Editor runtime külön session owner.
Alternatívák. (1) jelenlegi nagy Zustand store megtartása authorityként; (2) másik state libraryre teljes átírás; (3) komponens-local state.
Döntés oka. A probléma nem a Zustand technológia, hanem a kevert élettartam és felelősség. State library csere önmagában nem oldaná meg.
Következmények. Parancsok optimistic revision preconditiont kapnak; UI mutációk fokozatosan delegálnak. Pure model functionök megmaradnak.
Felülvizsgálati feltétel. Ha a UI projection költsége vagy concurrency modellje bizonyítottan más state runtime-ot igényel.
ADR-006 — Persistence authority és document session
Kérdés. Mi authoritative a native file, recovery cache, server snapshot, cloud copy és nyitott UI state közül?
Döntés. Egy DocumentSession explicit source/location és last-saved revision/digest alapján kezeli az authorityt. A portable OMI file/container a felhasználó által mentett dokumentum artifact; IndexedDB recovery cache, a cloud byte-store, a server workflow snapshot pedig külön megnevezett replica/snapshot. Native location opaque handle, nem domain path.
Alternatívák. (1) last-write-wins minden store között; (2) mindig server authority; (3) Zustand state implicit authority.
Döntés oka. A Studio offline/native és external workflow használatot is támogat; nincs egyetlen univerzális store. Az implicit authority adatvesztést és konfliktust rejt el.
Következmények. Save precondition, conflict receipt, atomic replace/recovery journal kell. Cloud provider nem módosít manuscript semanticsot.
Felülvizsgálati feltétel. Ha egy jövőbeli collaboration service explicit multi-writer authorityt és CRDT/transaction modellt vezet be.
ADR-007 — Revision/history modell
Kérdés. Mi a kapcsolat az editor undo, working changes és tartós revision history között, és hogyan tároljuk a történetet?
Döntés. Editor undo session-local. Working changes application-level semantic commandok. Revision immutable, lineáris commit; revert új commit. A jelenlegi szemantika megmarad, de RevisionRepository port mögé kerül. Az első adapter maradhat full snapshot; content-addressed snapshot/delta csak benchmark alapján.
Alternatívák. (1) PM undo log mint history; (2) azonnali CRDT/event sourcing; (3) revision teljes eltávolítása és file backup.
Döntés oka. A jelenlegi revision model erős és tesztelt. A gond a tárolási skálázás és ownership, nem a szemantika.
Következmények. History storage algoritmusa belső; export profile külön dönti el, mennyi history portable. Branching/collaboration nincs az 1.0 stable contractban.
Felülvizsgálati feltétel. Ha multi-user concurrent editing vagy benchmark alapján a full snapshot elfogadhatatlan és delta szükséges.
ADR-008 — Importer/exporter contract
Kérdés. Hogyan kapjon közös architektúrát az eltérő formátumok importja és exportja?
Döntés. Registry-alapú Importer és Renderer contract, közös descriptor/capability, diagnostics, fidelity/loss, provenance, progress/abort és streaming source/artifact modellel. A platform-specific delivery külön ArtifactDeliveryPort.
Alternatívák. (1) formátumonként önálló UI/service; (2) egy óriás switch; (3) minden renderer CLI process.
Döntés oka. A meglévő importerek/exporterek megtarthatók adapterként, de a közös diagnosztika és delivery hiánya miatt a UI és store túl szorosan kapcsolódik hozzájuk.
Következmények. Formátum capability stable/preview státusza runtime lekérdezhető. A renderer nem hív file pickert. Large-file igény deklarált.
Felülvizsgálati feltétel. Ha a streaming/process isolation igény két külön contract-családot tesz szükségessé; ekkor a közös result/evidence továbbra is megmarad.
ADR-009 — Publication pipeline
Kérdés. Mi legyen a reprodukálható publikációs build végleges sorrendje és contractja?
Döntés. Validált committed OMI revision → immutable rendering context → versioned publication profile/resources → pinned renderer → target validators → artifact set → build manifest/hash/signature → delivery/transfer. Pre- és post-validation kötelező.
Alternatívák. (1) exporter közvetlenül a live store-ból; (2) profile/CSS beágyazása a manuscript domainbe; (3) validáció csak upload után.
Döntés oka. A jelenlegi build manifest és artifact hashing jó alap; a live state/raw Tiptap/profile augmentation viszont reprodukálhatósági rést okoz.
Következmények. Semantic és byte reproducibility külön claim. Renderer/font/validator verzió a manifestben. Hibás artifact nem továbbítható stable connectoron.
Felülvizsgálati feltétel. Ha interactive/live publication artifact nem írható le deterministic buildként; annak külön artifact class/ADR kell.
ADR-010 — Publishing System Connector API
Kérdés. OJS és OMP külön integráció maradjon-e, vagy legyen közös connector contract?
Döntés. Közös Publishing System Connector API kezeli a capability discoveryt, signed launchot, submission/metadata/contributor/file olvasást, review assignment/form/recommendationt, revision/attachment/artifact uploadot és workflow returnt. OJS/OMP profile adapter és vendor extension marad. A külső rendszer authoritative a saját workflow-state-jében.
Alternatívák. (1) két teljesen külön kliens; (2) legkisebb közös nevező, extension nélkül; (3) OJS modell ráerőltetése OMP-re.
Döntés oka. A két plugin már közös omi-integration/1 fogalmakat valósít meg. A közös contract csökkenti a driftet, miközben a journal/monograph különbségek valódiak.
Következmények. Shared schema/fixture suite kell. Writeback idempotens outbox saga. Új journal/press/repository rendszer ugyanazt a portot implementálhatja.
Felülvizsgálati feltétel. Ha legalább két új rendszer bizonyítja, hogy a contract túl PKP-specifikus vagy hibás common abstraction.
ADR-011 — Peer-review domain és anonimitás
Kérdés. A peer review a publishing connector része vagy önálló domain, és hol érvényesül a double-blind szabály?
Döntés. Önálló, publishing-system-neutral review domain: assignment, round, projection, workspace, attachment, form, recommendation, visibility és writeback. Az anonymous projection szerveroldali security boundary, committed source revisionből; soha nem UI-szűrés.
Alternatívák. (1) OJS/OMP DTO közvetlen használata; (2) teljes manuscript letöltése és mezők elrejtése a kliensen; (3) kézi anonymized copy.
Döntés oka. A jelenlegi server-side allowlist jó alap, és a reviewer scope PKP oldalon is enforce-olt. Az anonimitás sérülése magas következményű, ezért explicit domain és leak corpus kell.
Következmények. Asset metadata, filename, EXIF/SVG/provenance is projection tárgya. Assignment-scoped ID-k és no-store cache. AI/integration confidential access csak server grantből.
Felülvizsgálati feltétel. Ha új review model (open review/post-publication review) más visibility policyt igényel; a projection boundary akkor is megmarad.
ADR-012 — Identity boundary-k
Kérdés. Hogyan viszonyul account, auth provider, scholarly agent, institution, contribution és publication evidence?
Döntés. Hat külön entitás/kapcsolat. Az identity DB authoritative account/auth/membership/admin adatra. A main DB StudioPrincipal projection workflow FK-khoz. A scholarly agent és contribution az OMI manuscript része. Account–agent link explicit verified evidence; email/ORCID egyezés nem automatikus merge. Authorization külön policy.
Alternatívák. (1) egyetlen User modell mindenre; (2) ORCID mint primary user ID; (3) két független authoritative user DB.
Döntés oka. A publikációs attribution hordozható és történeti, az account pedig revokálható operatív identitás. A jelenlegi két Prisma schema duplikációja authority-driftet okozhat.
Következmények. Principal projection reconcile/outbox kell. Signatures/evidence külön store. Provider link/revoke nem írja át automatikusan a manuscript author listáját.
Felülvizsgálati feltétel. Ha közös transactional database-re konszolidálás bizonyíthatóan egyszerűbb és nem mossa össze a domain fogalmakat.
ADR-013 — Storage abstraction
Kérdés. Hogyan legyen egységes a native file, browser file, Android SAF, Apple Files, sync folder és cloud storage?
Döntés. Két portcsalád: DocumentStorage/DocumentLocation a felhasználó által kezelt dokumentumhoz, RemoteObjectStore backup/sync byte objectekhez. Platformadapter kezeli a pickert/permission/bookmarkot; a provider nem értelmez manuscript semanticsot.
Alternatívák. (1) minden provider saját save use-case; (2) mindenből server upload; (3) path string univerzális identifierként.
Döntés oka. A platform permission modellek eltérnek, de az open/read/writeAtomic/conflict fogalom közös. A path nem reprezentál browser/SAF/security-scoped handle-t.
Következmények. Opaque handle csak session/persistence rétegben. ETag/digest conflict kötelező. Letöltött cloud copy ugyanazon validatoron megy át.
Felülvizsgálati feltétel. Ha valódi multi-device synchronization merge semanticsot igényel; az új Sync Service külön domain, nem storage provider bővítés.
ADR-014 — Integration capability és permission modell
Kérdés. Milyen manuscript adatot kaphat Zotero, Mendeley, DeepL, AI, storage, OJS/OMP, ORCID vagy OIDC connector?
Döntés. Default-deny, server-issued ExecutionGrant: actor, provider/connection, document+revision, purpose, data-access scope, capability, confidential scope, expiry, single-use/idempotency. A payloadot a szerver minimalizálja. AI/translation output default suggestion, nem közvetlen mutáció.
Alternatívák. (1) user consent után teljes manuscript; (2) provider manifest által kért scope automatikus elfogadása; (3) kliensoldali allow flag.
Döntés oka. A manuscript és peer-review adat érzékeny; a jelenlegi kliens-supplied confidential mező nem authority. A különböző providernek eltérő minimális adatra van szüksége.
Következmények. Scope taxonomy és audit retention kell. Credential külön encrypted repository. Review-confidential grant assignmentből származik.
Felülvizsgálati feltétel. Ha on-device, adatot el nem hagyó providerhez egyszerűbb local grant profile indokolt; audit és scope akkor is marad.
ADR-015 — Backend API versioning
Kérdés. Át kell-e nevezni minden jelenlegi route-ot /api/v1 alá, és mi legyen a stabil contract?
Döntés. Additív /api/v1 first-party API közös Zod/OpenAPI schema, error envelope, idempotency, optimistic concurrency és correlation policyval. A régi route compatibility facade ugyanazt az application handlert hívja, deprecation telemetryvel. Nincs egyszeri tömeges rename.
Alternatívák. (1) in-place route rename; (2) URL-verzió nélkül header-only; (3) a jelenlegi route-ok örök befagyasztása.
Döntés oka. A jelenlegi kliensek működnek; azonnali rename kockázatos. A v1 namespace egyértelmű support és contract diff lehetőséget ad.
Következmények. Két route felület ideiglenesen együtt él. Business logika route-ból application service-be kerül. External PKP protocol saját profile/versiont tarthat.
Felülvizsgálati feltétel. Ha a Studio kizárólag egy atomikusan frissülő kliens-szerver deployment lesz; az external connectorok miatt verziózott DTO akkor is kell.
ADR-016 — Cross-platform adapter boundary
Kérdés. Hogyan használhat ugyanaz a core webet, Windows/Linux/macOS desktopot, Androidot és iOS/iPadOS-t?
Döntés. Application portok: file picker/storage, secure storage, auth handoff, updater/installer, system fonts/resources, capability detection, share/open-with és notifications. Konkrét web/Tauri/Android/Apple adapter csak composition rootban választódik.
Alternatívák. (1) platform checkek minden service-ben; (2) külön fork/platform; (3) minden funkció a legkisebb web közös nevezőn.
Döntés oka. A jelenlegi Tauri/mobile kód használható, de közvetlen importok és user-agent detection szivárognak. Porttal a core egységes, a platform capability őszinte marad.
Következmények. Contract test suite minden adapterre. A stable/preview besorolás artifactonként deklarált. iOS lehet preview anélkül, hogy core fork keletkezne.
Felülvizsgálati feltétel. Ha egy platform életciklusa olyan use-case szemantikát igényel, amely porttal nem fejezhető ki; előbb application policy bővítés, nem domain fork.
ADR-017 — Security trust boundaries
Kérdés. Hol kell untrusted adatot kezelni és mely kontrollok blokkolják a domainbe jutást?
Döntés. Explicit boundary minden imported JSON/container/DOCX/PDF/HTML/XML/asset, OAuth/OIDC credential, connector, review confidential adat, AI provider, plugin és publication artifact előtt. Minden boundary quota + safe parse + validation + authorization + content-free audit kombinációt kap a saját kockázata szerint.
Alternatívák. (1) validáció csak UI-ban; (2) „trusted file” feltételezés lokális opennél; (3) általános sanitizer minden formátumra.
Döntés oka. A tényleges kód már sok jó, de széttartó kontrollt tartalmaz (ZIP limits, LIBXML_NONET, SSRF helper, signed launch). Ezeket threat-boundaryként kell egységesíteni, nem lecserélni.
Következmények. Hostile synthetic corpus, fuzz és negative auth matrix release gate. Diagnosztika/log nem tartalmaz manuscript contentet/pathot. Security fix kompatibilitási ígéretet felülírhat dokumentált módon.
Felülvizsgálati feltétel. Új input/protocol/provider vagy trust assumption változásakor kötelező threat-model review.
ADR-018 — OMI container, provenance és signature
Kérdés. A container csak ZIP transport, vagy a manuscript, history, assets, profile, output és signature authorityja is?
Döntés. A container külön verziózott packaging layer, manifesttel, canonical paths-szal, checksummal és opcionális profile/history/output/evidence entrykkel. A manuscript JSON marad portable semantic core. Signature a manifest és exact artifact digestet fedi; nem ad hoc top-level manuscript mező és nem localStorage state.
Alternatívák. (1) egyetlen nagy JSON base64 assetekkel; (2) container és schema egy verzió; (3) aláírás a manuscript objektumba injektálva.
Döntés oka. A jelenlegi container parser biztonságos és az implementáció már a szükséges részek nagy részét tudja. A külön réteg lehetővé teszi a JSON interoperabilitást és a nagy asset/history externalizálását.
Következmények. SPEC-330 manifest schema és cross-repo golden fixture kell. Container validáció kétlépcsős. Signature/evidence kulcs lifecycle külön.
Felülvizsgálati feltétel. Ha streaming/remote content-addressed csomagolás a ZIP korlátait meghaladja; új container major lehet, OMI JSON változása nélkül.
ADR-019 — Stable/preview capability policy
Kérdés. Minden meglévő funkciót 1.0 stable-ként kell-e garantálni?
Döntés. Nem. Stable/preview/experimental/deferred capability manifest határozza meg platformonként és formátumonként a supportot. A kód megléte vagy smoke teszt nem egyenlő stable ígérettel. Preview funkció hibája nem blokkol általánosan, de privacy/data-loss/security hiba igen.
Alternatívák. (1) minden UI-ban látható funkció stable; (2) preview funkciók törlése; (3) egyetlen globális platform státusz.
Döntés oka. JATS/HTML/DOCX és egyes platformok evidence szintje eltér az EPUB/DTP/iOS állapotától. A működő kódot nem kell kidobni, de a kompatibilitási ígéret legyen bizonyíték-alapú.
Következmények. Runtime UI, dokumentáció és release metadata ugyanabból a manifestből készül. Promotion külön gate-et igényel; demotion stable 1.x-ben csak súlyos okkal.
Felülvizsgálati feltétel. Minden release planningkor és amikor egy capability promotion corpusát teljesíti.
PKP-kör pontosítása (2026-11-07). A kifejezetten előírt OJS/OMP -4/-5/-6 E02-regressziós feladatok/archívumok Preview OMP esetén is kötelezőek. Az OJS -6 külön kézi kaput kap, így a v1 receipt 14 kapus. Ez a kivétel nem emeli az OMP besorolását, és nem engedi el a biztonsági, adatvédelmi vagy adatvesztési kapukat.
ADR-020 — Általános executable plugin runtime
Kérdés. Része legyen-e az 1.0-nak egy harmadik fél kódját futtató általános plugin rendszer?
Döntés. Deferred. Az 1.0 built-in, review-olt connector adaptereket és deklaratív manifest/capability registryt támogat. Tetszőleges plugin code execution, sandbox, signing marketplace és permission UX külön post-1.0 program.
Alternatívák. (1) in-process JavaScript plugin; (2) remote HTTP plugin teljes manuscript hozzáféréssel; (3) minden integráció hardcoded marad örökre.
Döntés oka. A jelenlegi registry nem execution sandbox. Egy biztonságos plugin runtime új threat boundary és termék, nem stabilizálási részfeladat.
Következmények. Az 1.0 kommunikáció nem ígér arbitrary plugin futtatást. Új integráció adapterként és scoped granttel vehető fel. A registryben nem aktiválható executable payload.
Felülvizsgálati feltétel. Ha van legalább három külső plugin use-case, threat model, sandbox technológia, signing/distribution policy és dedikált maintenance owner.
ADR-021 — Webes publikációs minősítés és szerkesztői authority
Kérdés. Hogyan jelölheti egy webes artefaktum, hogy szaklektorált, ha a folyóirat vagy kiadó nem használ OJS-t vagy OMP-t, anélkül hogy a webconnector vagy egy kliensoldali kapcsoló válna authority-vé?
Döntés. A publikációs cél és a lektorálási minősítés külön fogalom. Minden Studio webes artefaktum látható, akadálymentes és géppel olvasható not-peer-reviewed vagy peer-reviewed jelölést kap. A körpecsét nyelvfüggetlen, rögzített felirata OMI · PEER REVIEW · VERIFIED vagy OMI · PEER REVIEW · NOT VERIFIED; a mellette álló magyarázat lokalizált marad. A VERIFIED a Studio által rögzített workflow-bizonyítékra vonatkozik, nem az OMI tartalmi vagy tudományos minőségi jóváhagyására. A lektorált értékhez teljes Studio-natív tudományos lektori forduló, valamint külön, szerveroldali szerkesztői elfogadó döntés szükséges, amely a pontos commitolt revízióhoz és manuscript-state digesthez kötődik. A lektori feladat lezárása önmagában nem elfogadás. Ha OJS/OMP birtokolja a workflow-t, az marad authoritative; külső assignment nem hozhat létre Studio-natív döntést. A WordPress/webhely adapter kizárólag ArtifactDeliveryPort. A jelölés a hash kiszámítása előtt az artefaktum bájtjainak része, a szerver által kiadott execution grant pedig a kiválasztott célkonfiguráció pontos verziójához kötődik, és kézbesítés előtt újra ellenőrzi a bizonyítékot. A deklarált WordPress transport projection kivonhatja az article elemet és áthelyezheti a beágyazott médiát, de a ténylegesen elküldött tartalom digestje külön receiptbe kerül a jóváhagyott önálló artefaktum digestje mellett. A nyilvános bizonyíték csak decision ID-t, digestet, fordulót és időpontot tartalmaz; lektori identitást, bizalmas megjegyzést vagy javaslatot nem. A pecsét workflow-bizonyítékot jelez, nem a közlés igazságát.
OJS/OMP nélküli folyóirat vagy kiadó publikációs autoritása emellett egyszer használatos, a venue domainje alatt elhelyezett DNS TXT kihívással hitelesíthető. A DNS TXT rekord természeténél fogva nyilvános: az értéke nem titkos hitelesítő adat és nem azonosít szerkesztőt. A bizonyíték abból származik, hogy egy bejelentkezett Studio-fiók egy friss, szerver által kiadott kihívást a megadott DNS-név alatt, lejárat előtt képes közzétenni. A kihívás szerveroldalon ehhez a fiókhoz kötött és csak egyszer használható fel; a nyilvános TXT érték kiolvasása más fióknak nem ad jogosultságot. A DNS feletti rendelkezés ezért szervezeti autoritás-bizonyíték, nem peer-review bizonyíték. A sikeres DNS-hitelesítés a kezdeményezőnek DOMAIN_ADMIN szerepet ad. Egy aktív domain-admin további DOMAIN_ADMIN, EDITOR vagy EDITOR_IN_CHIEF tagságot delegálhat már létező Studio-fiókoknak új DNS TXT rekord nélkül. A delegált adminisztrátorok ugyanazt a venue-adminisztrációs jogot kapják; a szerver az utolsó aktív domain-admin visszavonását tiltja. Publisher-verified elfogadást csak szerkesztői szerep, a kézirat-workspace szerkesztői jogosultsága és lezárt Studio-natív tudományos lektori forduló együtt tehet lehetővé. A döntés az assurance-rétegtől független publication-content digesthez is kötődik, és változtathatatlan snapshotban őrzi a venue, domain, DNS-hitelesítés azonosítóját/idejét és a szerkesztői szerepkört. A későbbi DNS-ellenőrzés a domain folyamatos nyilvános állítását ellenőrzi, nem egy titok birtoklását; későbbi DNS- vagy tagságváltozás nem írja át a történeti provenance-t.
Alternatívák. (1) felhasználó által kapcsolható „lektorált” boolean; (2) automatikus következtetés lezárt assignmentből; (3) minden lektorált közléshez kötelező OJS/OMP; (4) a WordPress vagy fogadó webhely állítsa be a státuszt; (5) lektornevek vagy vélemények beágyazása.
Döntés oka. Független folyóiratoknak és kiadóknak PKP-rendszer nélkül is szükségük lehet Studio-lektorálásra és webes kézbesítésre. A default-deny minősítési boundary ezt úgy teszi lehetővé, hogy nem gyengíti az anonimitást, a külső workflow authority-t, a provenance-t, illetve a lektori javaslat és a szerkesztői elfogadás különbségét.
Következmények. Egy új szerkesztés új revíziót hoz létre, ezért a korábbi döntés nem használható az új artefaktum lektorált jelöléséhez. Nem lektorált tudományos vagy közérdekű közlés továbbra is megengedett, de nem lehet kétértelmű. Az idempotency identity tartalmazza a minősítési bizonyítékot és a célkonfiguráció verzióját. A webes kézbesítés Preview marad az outbox recovery, tamper, accessibility, receiver-contract és privacy tesztekig. Hamis lektorált pecsét, hiányzó nem lektorált jelölés, nem deklarált vagy receipt nélküli transport transformation, illetve lektori identitásszivárgás Preview státusz mellett is release blocker.
Felülvizsgálati feltétel. Ha review-taxonomy vagy külső evidence szabványt választunk, nem PKP connector ad authoritative szerkesztői döntést, vagy post-publication/open review új nyilvános minősítési állapotot igényel.
Nyitott, freeze előtt számszerűsítendő paraméterek
Ezek nem új ADR-k, hanem az elfogadott döntések konkrét értékei:
| Paraméter | Döntési input | Határidő |
|---|---|---|
| Első stabil OMI file-format verziószám | SPEC-100/150/160/320 readiness | A fázis vége |
| Forward-minor policy | unknown core field round-trip bizonyíték | A05 |
| Container size/entry/depth limitek | jelenlegi parser + platform memory benchmark | A07/E01 |
| History snapshot/delta küszöb | 120k/500k word benchmark | B07/D06 |
| Stable exporter lista | fixture/fidelity/validator evidence | C14 |
| Webes assurance és receiver contract | tamper, transport-digest, recovery, privacy és accessibility evidence | C15 |
| Supported OJS/OMP exact verziók | Docker E2E matrix | C07/C08 |
| Token/session TTL és credential rotation | security review | B10/C12 |
| Performance és bundle budget | current baseline + representative devices | D06 |
| RC soak hossza és blocker SLA | release ownership | E05 előtt |
2026-10-12 — Az aktuális implementáció egyeztetése
Ez a szakasz felülírja a korábbi keltezett részek aktuális implementációra vonatkozó állításait; a korábbi audit történeti bizonyíték marad. Ellenőrzött Studio main: 6242dbae4e6e7be3f9bff9470f64647554f363d8; OMI: bc932272d0cbe18b8e45f758fbdb0d6076344bbf.
A Studio az OMI-SPEC-320@0.3.0 Draft sémát írja és validálja. A schema URI és az omi.version elegendő; az alkalmazás, a konténer és a revision külön verziózott. A korábbi kísérleti 0.2 formátumhoz nem keletkezik új migrációs kötelezettség. Ez nem stabil sémafreeze vagy 1.0 kiadási engedély (ADR-001–003).
Az OMI-SPEC-225 strukturált sourceAttributions kapcsolatokat vezetett be, prov:wasDerivedFrom predikátummal és explicit assertion státusszal. Ezek nem azonosak az idézéssel, technikai importeredettel, licenccel vagy igazolt szerzőséggel. A szemantikus kapcsolat már létezik; a teljes import/export lefedettség még nem (ADR-023).
A Studio #674 PR a blokk és leszármazottai törlésekor egyetlen revision-műveletben rendezi a forráskapcsolatokat. A korábbi history, a bibliográfia és a független kapcsolatok megmaradnak. A történeti revision visszaállítása helyreállítja a forrásgráfot is (ADR-007).
Ugyanez a PR a HTML/JATS exportban source-attribution-not-preserved figyelmeztetést ad minden nem reprezentált kapcsolatnál. A validForExport nem veszteségmentességi igazolás; az OMI megőrzi a teljes gráfot. Nem keletkezik automatikus idézet vagy licencállítás (ADR-008/009/023).
A #674 nyitott javítási javaslat, nem main-garancia. Kötelező teszt: beszúrás → checkpoint → teljes blokkág törlése → checkpoint → mentés/újranyitás → korábbi revision visszaállítása; továbbá export-veszteségjelzés és a forrásdokumentum változatlansága. Csak szintetikus vagy nyilvános fixture használható.
A PR-terv sorrendje: célzott életciklusjavítás (Phase B), exportdiagnosztika (Phase C), baseline-egyeztetés (Phase A), majd a többi törlési/összevonási útvonal, konténeres round-trip, anonimizált projekció és exporter-leképezések bizonyítása RC előtt. Az eredeti A02–A08/B05–B07/C03–C05/E02 kapuk továbbra is érvényesek. A működő szerkesztőt, snapshot historyt és renderereket meg kell tartani; teljes újraírás nem indokolt.
2026-10-13 — ODT: előzetes biztonsági és hűségi besorolás
A korábbi #674 forráséletciklus-javítás már main-ban van (5825c15a1bc3860a3371eaa1c20111bfe4b74ea5); a korábbi javaslati státusz történeti adat.
Az ODT import/export a Studio #675-ben került main-ba (5417e19cb26550508b66c780107eea87382b5f2f). Ez interoperabilitási formátum, nem új OMI-séma vagy tartós munkafájl. Besorolása Preview / előzetes; Stable előtt független ODF-validáció, irodai programok közötti kompatibilitás és valós dokumentumos elfogadás szükséges.
A Studio #678 PR két reprodukált hiány javítását javasolja: a ZIP deklarált méretével megkerülhető kvótát és az exportból jelzés nélkül elvesző sourceAttributions kapcsolatokat. A PR nyitott javaslat, nem main-garancia.
A javasolt importhatár: 200 MiB bemeneti csomag, 25 MiB kibontott részenként, 100 MiB összes kibontott adat és 4096 bejegyzés. A tényleges bájtszámlálás megszakítja a kibontást a korlátnál. Fejléc-, határ-, CRC32-, duplikált/veszélyes útvonal- és átfedésellenőrzés védi a parser előtti határt; titkosított, symlinkes, ZIP64 és többkötetes csomag nem támogatott. Az ismételt olvasás gyorsítótárat használ; a CRC integritásvizsgálat, nem hitelességi aláírás (ADR-008/017).
Az exporter kapcsolatanként source-attribution-not-preserved diagnosztikát és látható figyelmeztetést ad. Az OMI megőrzi a forrásgráfot/historyt; nem keletkezik kitalált idézet, licenc vagy szerzőségi bizonyíték (ADR-008/009/023).
Kötelező regresszió: hamis STORE/DEFLATE méret, tényleges kibontási megszakítás, összesített/bejegyzéskvóta, CRC- és fejlécsérülés, duplikált útvonal, csonkolás, szabályos data-descriptor csomag és változatlan OMI melletti forrásveszteség-jelzés. Csak szintetikus vagy nyilvános fixture használható. Az előzetes besorolás nem mentesít a biztonsági kapuk alól (ADR-019).
PR-sorrend: #675 után a célzott #678 javítás, majd független ODF- és irodai kompatibilitási bizonyíték Stable előtt. A schema/API/ContentCodec/natív biztonság/exact-commit RC kapuk megmaradnak; teljes újraírás nem szükséges.
Architektúrajavítási ellenőrzőpont — 2026-10-15: munkatérmód és passkey
ADR-001/002/005: az egyszerű szerkesztési mód kéziratazonosítóhoz kötött, helyben tárolt Studio-munkatérbeállítás. Új dokumentumban és revision snapshotban nem szerepel editorMode; a Studio 0.3 sémájának egyeznie kell az OMI forrásával. A már importált ismeretlen mezők megőrzése továbbra is érvényes: a javítás nem töröl kiterjesztést és nem értelmezi jogosultságként. Másik telepítésre átvitt fájl nem viszi magával a helyi módbeállítást. Az egyszerű vizuális szerkesztő megmarad.
ADR-012/015/016/017: a passkey meglévő helyi accountot hitelesít; nem tudományos identitás és nem publikációs bizonyíték. A klienscontract /api/v1/auth/passkeys; a korábbi /api/auth/passkeys azonos handlereket és rate limitet használó kompatibilitási adapter. A route kezeli a HTTP-választ és cookie-t, a szolgáltatás a WebAuthn use-case-eket, a repository adapter az identity-adatbázist. Megmarad a lejáró, egyszer használható challenge, az RP/origin/user handle és user verification ellenőrzése. Credential nem kerül OMI-ba.
A támogatás webes originre korlátozott, külön capability adapterrel. Tauri-origin nem hirdeti ezt a folyamatot támogatottnak. A natív támogatás ellenőrzött böngésző–alkalmazás hitelesítési átadást és contractteszteket igényel. A PostgreSQL-migráció, valódi authenticator-regisztráció/belépés/visszavonás, negatív origin/RP/aláírásteszt és natív átadás továbbra is kiadási követelmény; mockolt routeteszt ezt nem igazolja.
A javítás ellenőrzése: dokumentumonkénti módizoláció, változatlan hordozható bájtok és history, sémaegyezés, natív-origin elutasítása és v1/legacy route-egyezés replay-elutasítással. Ez merge és CI előtti javítási terv, nem kész 1.0 freeze.
ADR-024 — Hagyományos DOCX callback-authority és helyreállítás
Állapot: Javasolt; javítás merge és elfogadás előtt.
Kérdés: Hogyan védhető ki a késői felülírás az ismételt részmentések megtörése nélkül?
Döntés: A kanonikus head a Studio tulajdona. A session induló revisionhöz kötött. A status-6 és az ütköző status-2 változtathatatlan, owner-only letölthető helyreállítási pillanatkép; csak végleges status-2 frissíthet sorzár/CAS mellett. A korábbi head backupja és a nyugta egy tranzakció. A deduplikáció dokumentum/editor key/status/callback URL digest alapján történik; a forrás-URL nem tárolódik. Tárolás előtt streamkvóta és ZIP/OPC/XML-integritás szükséges. Additív v1 és közös service/repository határ.
Alternatívák: utolsó beérkező ír; minden részmentés után sessionletiltás; nem dokumentált provider-sorszám feltételezése; ütköző mentés eldobása.
Indok: a részmentés normális. A beérkezési sorrend nem bizonyítja a szerkesztési sorrendet, a provider serverVersion szoftververzió, nem mentési sorszám.
Következmények: új tárolás és recovery-letöltés; külön retention/kvótapolitika szükséges, e javítás nem töröl csendben mentést. A végleges lezárás authoritative; crash-részmentés letöltéssel állítható helyre. Telepítéskor sessiondrain és a régi sessionök lejáratása szükséges. PostgreSQL és valódi provider lifecycle teszt kell promóció előtt.
Felülvizsgálat: igazolt monoton mentési sorszám vagy tartós provider-sessioncontract; a retention és tárhelykvóta külön döntésben.
ADR-025 — Kreditfogyasztó felismerési intent és grant
Állapot: Javasolt; javítás merge és elfogadás előtt.
Kérdés: Hogyan engedélyezhető és egyeztethető a bizonytalan hálózati kimenetelű fizetős beküldés?
Döntés: Lejáró szervergrant ellenőrzése után, az egyszeri fizetős POST előtt account/workspace/request key szerint egyedi intent készül kapcsolat-, provider-origin-, képdigest-, modell-, cél- és uploaded-image scope-kötéssel. ACCEPTED megőrzi a process ID-t; UNKNOWN/SUBMITTING nem enged új beküldést ugyanazzal a kulccsal. Elfogadott ismétlés meglévő jobot olvas, eltérő payload ütközés. A status account/workspace szerint izolált. A kliens küldés előtt menti a kulcsot. Kép, credential és felismert szöveg nem kerül a naplóba. Bizalmas kézirat/lektoradat automatikus exportjára nincs engedély.
Alternatívák: puszta consent checkbox; minden timeout újraküldése; csak böngészőmemóriában tartott intent; külső exactly-once számlázás ígérete.
Indok: a timeout nem bizonyít elutasítást. Az adatbázis-egyediség helyi párhuzamos beküldést véd, nem hoz létre elosztott tranzakciót a providerrel.
Következmények: additív perzisztencia és v1-statuscontract, megőrzött ismeretlen kimenetelek és explicit provider-oldali egyeztetés. Generikus retry nem fogyaszthat újra kreditet. A job-handle accountkötött; a ledger nem OMI-history vagy publikációsidentitás-bizonyíték.
Felülvizsgálat: igazolt provider-idempotencia/egyeztetési API vagy bizalmas kutatási export igénye esetén, a képesség engedélyezése előtt.
2026-10-21 — Federált szerverjegyzék javítása (ADR-026)
A szerverjegyzék külön discovery-authority: nem account-, kézirat-, lektorálási vagy publikációs jogosultságforrás. A DNS a domain feletti rendelkezést igazolja. Az „online” kizárólag friss hitelesített heartbeatet jelent; nem szolgáltatás-egészség, kompatibilitás, kapacitás vagy megbízhatóság igazolása. A böngésző a kiválasztott originre lép; a natív kliens megtartja az origin/token határt. Nincs kézirat- vagy fióktovábbítás és automatikus terheléselosztás.
Új contract: /api/v1/server-registry; a régi útvonal azonos handlerre és rate limitre mutató facád. A route → application service → repository, illetve GitHub audit adapter felelősségek különválnak. A nyilvános DNS-érték mellett külön titkos kérelmezői capability szükséges, 24 órás lejárattal. Atomikus PENDING → VERIFYING → ACTIVE állapotátmenet véd; bizonytalan audit esetén nincs automatikus újraküldés. Az aktív regisztrációk megmaradnak, a korábbi függőket újra kell indítani. A tokenrotáció, visszavonás és heartbeat az aktuális állapotot és tokenhash-t is összehasonlítja.
Ez javítási javaslat, nem lezárt 1.0 garancia. Kötelező a negatív és két útvonalas teszt, a tényleges PostgreSQL-migráció és konkurens lifecycle-teszt, valamint kontrollált DNS/GitHub elfogadási és helyreállítási próba. Telepítési sorrend: migráció → API → kliensek/CLI/honlap. Addig Preview. A natív SecureStorage és originhez kötött account/cache ownership külön nyitott feladat.
ADR-026 — Federált szerverfelderítés authority-határa
Állapot: javasolt javítás; Preview, amíg a CI és üzemeltetői elfogadás nem teljesül.
Kérdés: hogyan hirdethetik független Studio-példányok az elérhetőségüket account-, szerkesztői és kézirat-authority megszerzése nélkül?
Döntés: opt-in metadata-jegyzék, alkalmazási forgalom továbbítása nélkül. A registry adatbázisa authoritative a regisztráció, token és heartbeat tekintetében; a GitHub issue auditnyom, nem aktuális tagsági adatbázis. Külön privát, lejáró kérelmezői capability és nyilvános DNS-bizonyíték, atomikus aktiválás, hash-elt titkok és feltételes rotáció/visszavonás szükséges. Bizonytalan audit elkülönített állapotban marad, egyeztetésig. v1 contract és közös legacy facád; route/service/repository/adapter szétválasztás.
Alternatívák: csak DNS (nem hitelesíti a token címzettjét); GitHub mint élő adatbázis (felesleges kapcsolás); bizonytalan issue POST automatikus ismétlése (duplikáció); proxy/terheléselosztó (más feladat).
Indok: nyilvános bizonyíték újrajátszásának és tokenversenynek a kivédése a decentralizált működés megőrzésével.
Következmények: additív migráció, kizárólag a régi függő regisztrációk érvénytelenítésével. Az üzemeltető titokban őrzi a verification capability-t. Elveszett aktiválási válasz és bizonytalan audit kontrollált egyeztetést és új regisztrációt igényel. A heartbeat nem egészség- vagy kompatibilitásigazolás. Valódi adatbázis-versenytesztek és külső elfogadás szükséges.
Felülvizsgálat feltétele: külön registry-host, moderáció, DNS-újraellenőrzési szabály, tartós audit-outbox vagy egyeztető eszközök, kompatibilitástanúsítás, automatikus fiók-/kéziratmozgatás.
2026-10-22 — Dokumentumszintű importeredet pontosítása (ADR-023)
Ez a pontosítás felülírja a teljes kézirat sajátmű-nyilatkozatának tartalomhoz horgonyzását. Az OMI-SPEC-225@0.2.0 megengedi saját mű importját bibliográfiai forrásmegjelölés nélkül. A szerző kifejezett sajátmű-választása DOCX/ODT/PDF importnál a https://openmanuscript.org/extensions/manuscript-import-origin/1 dokumentumkiterjesztésben marad meg: version: 1, sourceFormat, importedAt, assertion: author-declared:self-authored-outside-omi. Ez önnyilatkozat, nem hivatkozás vagy igazolt szerzőség. Fájlnév, elérési út, URL, accountazonosító, szakasz-, blokk- és horgonyazonosító nem kerül bele. Más importutak objektumonkénti szabályai megmaradnak.
A dokumentum minden része szabadon szerkeszthető, cserélhető, mozgatható és törölhető. A rekord dokumentummetaadat, nem tartalomkapcsolat; az összes importált tartalom cseréje sem hoz létre hibás horgonyt. Történeti importnyilatkozatot rögzít, nem a későbbi módosítások szerzőségét. A munkafájl, a revision snapshot és a history nélküli core-snapshot megőrzi a meglévő névteres kiterjesztésben, sémaverzió-emelés nélkül. A nyilvános publikációs projekció kihagyja a rekordot az eredeti módosítása nélkül; az anonim szerveroldali review-projekció továbbra is allow-list alapján készül, és nem tartalmazza.
Ellenőrzés: saját DOCX/ODT/PDF import, tartalom és címsor törlése/cseréje, mentés–újranyitás, history nélküli core-snapshot round-trip, revision snapshot, nyilvános export és anonim review-szűrés. A meglévő szerkesztő, importparser és history engine megtartandó. Adatbázis-migráció és régi jelölések konverziója nem szükséges. A javítás a Studio PR merge-je és CI-ellenőrzése előtt tervezett állapotú.
2026-10-25 — Kiadói profilimport javítása (ADR-009)
A fájl-, URL- és katalógusimport közös, mélyebb contractvalidátoron haladjon át aktiválás előtt: kötelező szabálycsoportok, enumok, véges és korlátos méretek, hivatkozásstílusok, védelmi mezők, csatolt stílus szerkezete és JSON-komplexitás; prototípuskulcsok elutasítandók. Hibás adat nem menthető és nem aktiválható. Mindhárom útvonal a ténylegesen fogadott bájtok SHA-256 értékét rögzíti. Katalógusimportnál ez egyezzen a katalógus digestjével is. A hash tartalomazonosító, nem kiadói személyazonosság-igazolás. Az importált védelmi metaadat nem jogosultsági bizonyíték.
A generikus és bölcsészeti profilok új bibliográfiai/jegyzetalapértékei 0.2.0 verziót kapnak. Az explicit 0.1.0 definíciók megmaradnak; hiányzó verzió nem helyettesíthető csendben újabbal. A meglévő publication-build manifest továbbra is a feloldott profil digestjét őrzi. A renderelési alapértékek változása új profilverziót igényel. Ehhez a javításhoz alkalmazásverzió-emelés és OMI-sémamigráció nem szükséges.
Ellenőrzés: hibás beágyazott bemenetek, checksumeltérés, hibás UTF-8, determinisztikus bájthash, régi/új profilfeloldás, meglévő publication-build és renderer tesztek. Ez az alpha profilmodell alkalmazási contractja, nem új befagyasztott OMI-séma. A streamelt hálózati méretkorlátok és a független kiadói aláírás további stabilizálási feladatok. A checkpoint a Studio PR merge-je és CI-je előtt tervezett állapotú.
2026-11-08 — Automatikus napi szerverjegyzék (ADR-026 frissítése)
A nyilvános, éles Studio API-k induláskor és naponta automatikusan jelzik a már meglévő saját HTTPS-címüket. A központ friss kihívással ellenőrzi a cím rögzített nyilvános azonosító végpontját; a kapcsolódáskor ellenőrzött és rögzített nyilvános DNS-címek, az átirányítás tiltása, a méret- és időkorlát védi a lekérést. A nyilvános metaadatokat a szerver saját válaszából menti. Nem szükséges külön DNS-bejegyzés, token vagy regisztrációs parancs. A központ saját bejegyzését közvetlenül kezeli, HTTP-önhívás nélkül. A visszavonások és bizonytalan kézi auditok továbbra sem írhatók felül. A korábban leírt DNS/privát bizonyíték eljárás a kézi kompatibilitási út marad.
A honlap külön napi végpontot olvas, és a nyitva hagyott oldalt is automatikusan frissíti, honlapszerkesztés, új build vagy deploy nélkül. A 48 óránál régebbi jelzésű bejegyzések a következő napi listából kimaradnak; az utolsó jelzés és a lista ideje látható. Ez discovery-adat, nem fiókjogosultság vagy valós idejű üzemállapot-garancia. Lásd az automatikus szerverjegyzéket és a Studio üzemeltetői útmutatóját.