Current → 1.0 Gap Analysis
Kutatásiprojekt-szerződés egyeztetése — 2026-11-15
A prototípus org.omi.research-project/1 íróját a központi omi-research-project/0.1.0 sémával kell egyeztetni. Követelmény az eredeti forrás megőrzése, ismeretlen erőforrások megtartása, a megnyitás/hozzáadás azonossági különbsége, a projektcache visszanyitása/visszavonása és a hibás írás utáni kötésbiztonság. A közvetlen felhőátvitel, providerintegritás és konfliktuskezelés, archívumfeloldás és nyilvános projekció továbbra is nyitott.
Á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
A Studio saját sémaeltérését és verziózatlan szövegdoboz-tartalmát központi Draft definíció, független sémából generált profilvalidátor, rögzített forrás és közös minta rendezi. A diagramok forráskövetési hiányát pontos előnézet/jóváhagyás, forrás/bibliográfia/származási kapcsolat és belső sajátmunkanyilatkozat kezeli. A teljes ContentCodec, exporthűség és valós kiadási elfogadás ettől még nem kész.
Á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
A Studio a829afba6eb6e9a68da34a9bc21d0315101c7536 új, verzió nélküli privacy/fiókmásolat API-t és közvetlen application→Prisma kapcsolatot vezetett be; az OMI 2491bc0f54b0a02cea6bcf5d1dcb98b969d7ac18 ezeket dokumentálta. Célzott javítás szükséges.
| Határ | Javasolt javítás | Kötelező bizonyíték |
|---|---|---|
| API | Additív v1, közös legacy handler/kvóta, Zod/OpenAPI/hibacontract | Két mount, izoláció, hibák, kvóta megkerülésének tiltása, sémaegyezés |
| Identity | Injektált repository port, szűk mezőválasztás, opcionális szereposzlop fallback | Titokkizárás, korlátozás, hiányzó fiók/DB-hiba, loginregresszió |
| Authority/export | Üzemeltetői tájékoztató elkülönítése; kifejezetten részleges másolat | Anonim notice, privát letöltés, natív szerverválasztás, éles elfogadás |
A npm run test:privacy a meglévő kötelező CI/release gate része. A mockolt persistence nem PostgreSQL-, éles vagy jogi elfogadás. Merge és ellenőrzés előtt ez javasolt javítás; az egyéb 1.0 blokkolók megmaradnak.
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.
A kiadási szabályok eltérését egyeztetjük; az aktuális jelölt CI-je és a tényleges kézi elfogadás továbbra is szükséges, korábbi zöld futásból nem következik. Aktuális támogatási döntés.
Publikációs változat határa — 2026-11-04
A korábbi kerettördelési drift minősítése pontosítandó: az önállóan szerkeszthető publikációs szöveg nem önmagában kettős forrás-authority. A tényleges hiány a kiinduló revízió/publikációs változat kötése, az import szövegesítése és ismételt hozzáfűzése, valamint a hiányos gazdagtartalom-export. A meglévő history, túlcsordulási őr és kiterjesztés-round-trip nem zárja le ezeket. A látható név/ORCID nem azonosít dokumentumrevíziót.
Ellenőrzött forrás, döntés és elfogadási feladatok.
Outbound védelem és elfogadási checkpoint — 2026-11-02
A connection-time outbound transport már megvalósított HARDEN alap: WebDAV, PKP, konfigurált publikálás/AI, OIDC/ORCID/JWKS és Office callback útvonalak használják. A hostszűrés részleges, és nem bizonyítja az összes outbound helper lefedettségét. Marad a további útvonalak leltára, a kontrollált negatív hostteszt és a bizonyítékok egységesítése.
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.
| Komponens | Státusz | Ellenőrzött probléma → javítás | Maradó kockázat / bizonyíték |
|---|---|---|---|
| EuroOffice iframe/embed host | HARDEN | API-origin külső kód same-origin joggal → opaque sandbox és HTTP CSP, pontos ablak/channel, nincs API-self kapcsolat | Magas a páros API/native rollout és valós provider/device elfogadás előtt; böngészős negatív parent/storage/API teszt |
| App/store/recovery | REFACTOR | Reactben tárolt manuscriptlista → application session manager és aktív-store adapter | Közepes; fülváltás eddig is checkpointolt. Két pending dokumentum, batched open, selection/history/recovery teszt |
| Native manuscript fájl | HARDEN | Globális last-file útvonal más dokumentumot írhat felül → ID szerinti futásidejű társítás | Magas adatvesztési hiba javítva; tényleges IO-adapter mockkal A/B mentés. Scoped-handle újraengedélyezés külön munka |
| Extension route | SPLIT | Verziózott payload unversioned URL-en és közvetlen SQL → közös additív v1/router/service/repository | Közepes; HTTP 401, strict manifest, owner izoláció és legacy parity; valós PostgreSQL elfogadás külön |
| Container history | HARDEN | Beágyazott történeti preview-törlés megváltoztathatja a v1 digest subjectet → pontos snapshot megőrzés és explicit profil | Magas; tényleges reader + független ZIP/CRC/hash golden. Történet nagyobb lehet; nincs csendes v1-átértelmezés |
| PDF process config | HARDEN | Production helyi fallback → kötelező socket és külön worker-executor | Magas valós host/systemd/ACL/egress bizonyítékig; csak PDF elérhetőségét korlátozza |
| Release guard | HARDEN | Issue/local marker nem elég → pontos prior build, tényleges fájlhash, azonos SHA workflow és teljes kézi receipt | Magas promóciós kockázat; idegen/hiányzó subject/gate/hash negatív tesztek; CI nem pótol eszközt/hostot |
A kapcsolódó PR merge/CI előtt javasolt állapot. Normatív OMI séma és OJS/OMP protokoll változatlan. ADR-004/005/006/007/014/015/016/017/018/019 és Studio ADR-030 frissítendő.
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
Auditált Studio: f41dadf. A javítási bizonyíték nem merge-/telepítési elfogadás.
| Komponens | Státusz | Igazolt rés | Cél / átállás / kockázat |
|---|---|---|---|
translationExport.ts → translation planner | HARDEN | Reviewed rejtett/editor-only jegyzet mindkét HTML-ben megjelenhetett. | Meglévő public-note predikátum az output/readiness előtt; privát állapot megtartása, release-security negatív fixture. Magas adatvédelmi kockázat merge-ig. |
translationActions.ts | REFACTOR | Use-case közvetlenül Zustandot és auth-store-t kezel. | translationCommands.ts atomikus sessionporttal, régi action facade megmarad; plain-session/store/reopen/history/revert teszt. Közepes coupling; nincs history-újraírás. |
translation.ts profil/path | KEEP + HARDEN | Hasznos átmeneti fingerprint/path, de nem stabil editorfüggetlen horgony. | Kísérleti profil/művelet; unknown megőrzése; későbbi locatorváltás explicit verziózva. Közepes kompatibilitási kockázat. |
| Exportpanel riportfolyamata | REFACTOR | Reactben futott bájt/riport/cancel/fail vezérlés. | ExportExchangeSession application service; renderer/sidecar/delivery megtartása. Registry/streaming/még nem instrumentált utak nyitottak. Közepes evidence-kockázat. |
| Kollaboráció policy/ticket/live | KEEP + HARDEN | Új per-message/15 s idle recheck, 5 s deadline nem szerepelt a baseline-ban. | DB-authority, read-only downgrade, bontás/reconnect, single-node whole-manuscript határ rögzítése. Denial és tesztek megmaradnak. Közepes availability/authority kockázat. |
| 180/340/350/core-review és CI | KEEP + HARDEN | Többféle riport összetéveszthető tanúsítással vagy RC-elfogadással. | Pontos verzió/subject/freshness/scope és incomplete/indeterminate. Másolt validator nem független bizonyíték; artifact gate-ek maradnak. Közepes governance-kockázat. |
Nincs OJS/OMP-protokollváltás vagy DB-migráció. Szerkesztés nem korlátozott. Studio ADR-029. Az új core Draft review-cél, nem a writer verziódeklarációjának csendes átírása.
Biztonsági határok egyeztetése — 2026-10-30
Auditált Studio: 540f67a. E checkpoint pontosításai mellett a korábbi sorok történeti állapotot jelölnek.
| Jelenlegi komponens | Státusz | Probléma / megmaradó rés | 1.0 cél és következő lépés | Kockázat |
|---|---|---|---|---|
verifiedFederatedIdentity.ts, central/institutionAccess service | KEEP + HARDEN | ACTIVE allow-listes bootstrap már egyező, igazolt OIDC/SAML-emailt kér; régi grant nem ellenőrződik visszamenőleg. Az adminútmutató még bármely SSO-kapcsolást elegendőnek írta. | Útmutató-javítás, privát grantreview, megbízható IdP-újrahitelesítés, tesztelt második owner/helyreállítás, service negatív tesztek. Bizonyíték nem hamisítható, utolsó owner nem vonható vissza. ADR-012/017. | Közepes: bootstrapelutasítás / történeti grant |
cookieOriginGuard.ts, requireSession.ts, app.ts | KEEP + HARDEN | Szigorú Origin implementált, régi scriptek elhagyhatják. Korábbi tesztek főként helper/statikus mountellenőrzések. | Pontos natív/PKP kivételek és downstream hitelesítés megtartása; valódi HTTP invalid-bearer/session/parser regresszió; kliensátállás dokumentálása. ADR-015/017. | Közepes: 403 / túl tág kivétel |
pdfImportAdmission.ts, pdfImportRoutes.ts | KEEP + HARDEN | Aktív/megőrzött limit, 429/503 és retry fejléc megvan; nincs uploadfoglalás vagy elosztott kvóta; restart elveszti az állapotot. | Aktív 1/2, megőrzött 12/100 user/processz és 30 perces lusta lejárat dokumentálása. Többpéldányos támogatás előtt koordinált admission. ADR-017. | Közepes: összesített memória/terhelés és recovery |
pdfWorkerEnvironment.ts, Poppler/Vivliostyle hívás | KEEP + HARDEN | API-titkok öröklése kizárt, de azonos OS-user, HOME/fájlelérés és hálózat megmarad. | Meglévő szűrés/teszt megtartása; külön worker/fájlrendszer/erőforrás izoláció (#774), kapcsolódáskori egress (#765). Sandbox nem tekinthető késznek. ADR-016/017. | Magas, amíg nincs telepítési bizonyíték |
ci.yml, 1.0-readiness.yml, security tesztek | HARDEN | Bővült unit gate; nem bizonyít valódi IdP-t, adatbázis-versenyt vagy hostizolációt. | HTTP/bootstrap contract suite backend-előkészítés után; E02 azonos commit/digest host/PKP/natív bizonyítékokkal. ADR-019. | Magas, ha ezek nélkül történik RC-promóció |
Célzott dokumentáció- és tesztjavítás, nem schema/API tömeges migráció. Új DB-migráció nincs. Átállás és recovery. Az OMI/PKP pluginokban ehhez nem kell protokollváltás.
Baseline: Studio eca2cf45762116e1c00a89b3397840ed89109511; OMI e2f421707f1154c0ed30cb7750e0689a837e9b0a; OJS plugin 6c0842fc1ce6c4a1ea75f7b27660af8011be303b; OMP plugin 4f7a2c0a2f29f68e3ad05ac73ca7652bc6410ac7
Dátum: 2026-09-19
1. Értékelési kulcs
| Státusz | Jelentés ebben a dokumentumban |
|---|---|
| KEEP | A felelősség és a megoldás alapvetően helyes; legfeljebb normál karbantartás kell. |
| HARDEN | Jó 1.0 alap, de conformance, hibakezelés, security, performance vagy fixture-bővítés szükséges. |
| REFACTOR | A működés megtartandó, de a modulhatár vagy dependency direction módosítandó. |
| SPLIT | Egy jelenlegi egység több tulajdonost/élettartamot/felelősséget kever. |
| MERGE | Ugyanaz a fogalom vagy contract indokolatlanul több párhuzamos implementációban él. |
| REPLACE | A jelenlegi megoldás ezen a szűk ponton nem alkalmas 1.0 contractnak; nem az egész alrendszer újraírását jelenti. |
| REMOVE | Üres, használaton kívüli vagy félrevezető kód, amelynek nincs 1.0 szerepe. |
| DEFER | A kód megtartható kísérletként, de nem része az 1.0 stable ígéretnek. |
2. Összesített megállapítás
Az értékelés nem formális LOC-mérés, hanem fájl-, call-path-, teszt- és contract-alapú becslés:
- a jelenlegi működő viselkedés és implementáció kb. 75–85%-a megtartható;
- kb. 45–55% lényegi szerkezeti módosítás nélkül KEEP/HARDEN kategória;
- kb. 25–35% wrapperrel, áthelyezéssel vagy ownership-szétválasztással megtartható;
- valódi REPLACE/REMOVE igény kb. 5–10%, és ez főként az üres sémafájlra, a validálatlan open pathra, a natív token tárolására, üres/árva modulokra és néhány kísérleti állapotra korlátozódik.
A számsávok nem sprintbecslések. A refaktorálási költség magasabb lehet a lecserélendő kód arányánál, mert sok hívóhely közvetlenül ismeri a Tiptap-contentet vagy a Zustand store-t.
3. OMI format és domain
| Jelenlegi komponens | Státusz | Probléma / bizonyíték | 1.0 célállapot | Átállási lépés | Kockázat |
|---|---|---|---|---|---|
OMI static/schemas/omi-manuscript-0.2.schema.json | HARDEN | 632 soros végrehajtható schema és 8 fixture létezik, de a website CI/build nem futtatja automatikusan a file-format suite-ot. | Normatív, release-elt, immutable schema artifact checksum-mal. | Schema release job + CI conformance gate + changelog. | medium |
Studio src/schemas/omi-manuscript-0.2.json | REPLACE | A fájl 1 byte/üres; hamis benyomást kelt arról, hogy a Studio validál 0.2 ellen. | Az OMI release-ből vendorizált exact schema, rögzített SHA-256-tal. | Automatikus sync/check script; eltéréskor CI fail. | high |
src/types/omi.ts envelope (schema, omi.version) | REFACTOR | A Studio 0.1 URI/versiont hoz létre és exportál, miközben a normatív draft 0.2.0. | Generált wire type + explicit envelope/version codec. | Új codec shadow validationnel, majd create/open/save átállítása. | high |
src/types/omi.ts teljes aggregate | SPLIT | Egy fájlban structure, identity, notes, citations, assets, history és app-state típusok; részben model↔types ciklus. | Kis core/omi/* modulok, aciklikus publikus barrel. | Típusonként move/re-export; import-boundary lint. | medium |
src/model/content.ts | REMOVE | Üres placeholder; közben a tényleges content contract az OmiBlock.content string. | Valódi content AST/codec entry point vagy nincs fájl. | SPEC-100 döntés után új modul; addig az üres fájl törlése. | low |
src/model/manuscript.ts, annotations.ts, contributors.ts | REMOVE | Üres, félrevezető domain entry pointok. | Canonical modul vagy explicit re-export; üres fájl nincs. | Usage check, re-export shim, majd törlés. | low |
OmiBlock.content: string | REFACTOR | Tiptap JSON string vagy legacy text portable domain mezőként; exporterek közvetlenül parse-olják. | Verziózott OMI content AST; Tiptap adapter mögött. | Előbb ContentCodec facade, callsite-migráció, utána wire változás. | high |
src/model/inlineSemantics.ts | HARDEN | Jó szemantikai mapping alap; Tiptap node/mark fogalmakhoz részben kötött. | OMI szemantika core-ban, PM mapping adapterben. | Pure types/functionök kivonása, codec round-trip teszt. | medium |
src/model/sectionStructure.ts, studyMetadata.ts, frontMatter.ts | KEEP | Pure, jól tesztelt struktúra/metadata helpers. | OMI manuscript subdomain. | Áthelyezés re-exporttal; viselkedés változatlan. | low |
src/model/identity.ts, contributorName.ts | HARDEN | Scholarly-agent szemantika használható; accounttal való link és evidence boundary nem mindenütt explicit. | Accountfüggetlen agent/contribution domain, külön evidence link. | Invariant/fixture bővítés; transport mapping. | medium |
src/model/metadata.ts, scholarlyMetadata.ts, localizedText.ts, keywords.ts | KEEP | Pure és tesztelt domain logika. | Core metadata modul. | Mechanikus move késői PR-ban. | low |
src/model/citations.ts, citationClusters.ts | HARDEN | Működő citation model és tesztek; content parsing több helyen Tiptaphoz kötött. | Core reference/citation identity és editor-neutral anchors. | Citation domain megtartása; content lookup adapterre állítása. | medium |
src/model/cslRendering.ts | REFACTOR | Rendering policy ugyanabban a model rétegben, mint a citation domain. | Renderer/application service. | Pure CSL normalization marad; output formatting adapterbe. | low |
src/model/notes.ts, noteCitations.ts, noteRichText.ts | HARDEN | Jó funkcionális lefedettség; note body/rich text ugyanazt a codec-problémát örökli. | Core notes + portable rich-text content. | ContentCodec mögé terelés, referential-integrity tests. | medium |
src/model/namedAnchors.ts, crossReferences.ts | HARDEN | Stabil ID-k és hierarchikus xref tesztek léteznek; PM position nem lehet authority. | OMI stable anchor ID + semantic target; editor projection külön. | Anchor invariant + deletion/tombstone behavior fixture. | medium |
src/model/assets.ts | HARDEN | Asset metadata elkülöníthető, de data URL/path/storage concern felbukkan importokban. | Asset identity/role/digest a core-ban; byte store külön port. | AssetRef contract, importer externalization, MIME/hash gate. | medium |
src/model/tombstone.ts | KEEP | Domain deletion/history segéd jó alap. | History/anchor integrity része. | Property-based references-after-delete teszt. | low |
src/model/proofing.ts | REFACTOR | Teljes before/after string és UTF-16 offset sérülékeny strukturális editnél. | Stable anchor + semantic operation alapú tracked change/proofing. | Adapterrel olvasni a régit; új operation model, round-trip fixture. | high |
| Publication correction reprezentáció | REFACTOR | Proofing/history/publication build között implicit, nincs egyértelmű published-artifact kapcsolat. | Külön correction event source artifact/revision hivatkozással. | Domain type + build manifest link; UI később migrál. | medium |
| Unknown extension handling | REPLACE | Nincs igazolt lossless policy; object spread nem jelent future-version kompatibilitást. | Namespaced raw extension bag + explicit forward policy/quarantine. | Extension codec és golden round-trip; future fixtures. | high |
4. Editor engine és application core
| Jelenlegi komponens | Státusz | Probléma / bizonyíték | 1.0 célállapot | Átállási lépés | Kockázat |
|---|---|---|---|---|---|
src/components/BlockEditor.tsx | SPLIT | Több száz sorban editor config, JSON serialization, change dispatch és React UI. | Tiptap session/codec külön; vékony React host. | Extract EditorSessionFactory és ContentCodec; snapshot UI tesztek. | high |
src/editor/extensions/Omi* | HARDEN | Gazdag semantic extension készlet; portable és PM elnevezések nincsenek formalizálva. | Editor-adapter extensionök, dokumentált mapping table-lel. | Node/mark contract fixtures és unknown-node diagnostics. | medium |
src/editor/continuousManuscriptDocument.ts | HARDEN | Jó study projection és stabil ID használat; közvetlen current block content alakhoz kötött. | OMI↔PM study projection a ContentCodecen át. | Codec injection, round-trip és corrupted content tests. | medium |
src/editor/progressiveStudyMounting.ts | KEEP | Explicit küszöbök és tesztelt progressive mounting; helyes nagy-dokumentum stratégia. | Editor runtime service. | Teljesítménybudget és telemetry hozzáadása. | low |
src/editor/blockFocusRegistry.ts | KEEP | Runtime-only focus ownership világos. | Editor session szolgáltatás. | Move/re-export; lifecycle cleanup test. | low |
src/editor/manuscriptDomSelection.ts, selection extensionök | HARDEN | Használható cross-section kiválasztás; DOM/PM állapot kezelése érzékeny remountra. | Runtime selection service stable OMI anchor projectionnel. | Remount/mobile/IME/browser matrix teszt. | medium |
src/editor/clipboardPaste.ts, manuscriptClipboard.ts | HARDEN | Hasznos sanitizer/structured copy útvonal; content contracthoz kötött. | Importer-like clipboard adapter diagnostics/loss reporttal. | Közös import diagnostics; hostile HTML fixture. | medium |
src/app/useStudioStore.ts | SPLIT | Portable domain, revision, selection, UI panelek, timer és use-case mutáció egy 1244 soros store-ban. | Zustand csak UI/session projection; application core birtokolja a use-case-eket. | Facade bevezetés, actionönként delegálás, selector compatibility. | high |
src/app/*Actions.ts | REFACTOR | Sok action közvetlen Zustand set/get-tel dolgozik; néhol operation uniont as never kerüli meg. | Platformfüggetlen command handler + UI adapter. | Use-case slice-onként kivonás; characterization tests. | high |
| Több 2,5 s checkpoint timer | MERGE | Több útvonal saját timeoutot ütemezhet; lifecycle/race nehezen bizonyítható. | Egy CheckpointScheduler document sessionönként. | Timer injection és fake-clock teszt; régi timer eltávolítás. | medium |
src/store/workspaceStore.ts, src/model/workspace.ts | REMOVE | Nagy localStorage alpha workspace/collaboration állapot, aktív hívóhely nem igazolt. | 1.0 core-ban nincs; külön experiment, ha szükséges. | Import/reference audit, feature flag/export, majd törlés. | medium |
src/document/createBlankManuscript.ts | REFACTOR | Hasznos factory, de 0.1 envelope-ot gyárt. | Application create use-case a canonical codec/factoryval. | Paraméterezett current stable version, fixture update. | high |
src/document/migrateIdentityModel.ts, migrateVersioningModel.ts | DEFER | Pre-stable kompatibilitási maradványok; nincs production kötelezettség. | Egyszeri explicit legacy importer, nem általános migration framework. | Fixture-rel dokumentálni vagy eltávolítani freeze előtt. | low |
5. History és persistence
| Jelenlegi komponens | Státusz | Probléma / bizonyíték | 1.0 célállapot | Átállási lépés | Kockázat |
|---|---|---|---|---|---|
src/model/versioning.ts | HARDEN | Erős immutable lineáris revision/change/revert szemantika és tesztek; tárolási feltételezések beleszövődnek. | Core history semantics + repository port. | Előbb adapter a jelenlegi snapshotokra, utána optimalizáció. | medium |
src/model/workingState.ts | KEEP | Jó különbségtétel working change és revision között. | Application history session. | Public contract tisztítása, behavior változatlan. | low |
src/model/revisionIntegrity.ts, stateDigest.ts | HARDEN | Digest/integrity jó alap; canonical serialization és schema version pinning szükséges. | Canonical digest input és algorithm/version metadata. | Cross-runtime golden hash fixture. | medium |
| Full snapshot per revision | REFACTOR | Nagy dokumentumnál O(revision × size), és a history több tárolóban duplikálódik. | RevisionRepository, content-addressed checkpoint/delta lehetőséggel. | Benchmark + repository wrapper; formatváltás csak utána. | high |
src/app/lastSessionPersistence.ts | REFACTOR | IndexedDB-ben manuscript/history/UI/session keveredik; restore validáció nem ugyanaz a canonical gate. | Recovery cache külön authorityvel és validationnel. | Cache schema/version, recovery receipt, corruption tests. | high |
src/services/nativeManuscriptFile.ts | REPLACE | Modulglobális current path; JSON.parse cast schema/version validation nélkül; közvetlen felülírás kockázata. | Session-owned opaque location + validated open + atomic save. | Új port/adapter párhuzamosan, feature flag, fault-injection tests. | high |
src/services/exportOmi.ts | REFACTOR | Object spread + JSON stringify; validáció nélkül; localStorage signature beemelése a rootba. | Canonical serializer, validation gate, külön evidence bundle. | Serializer shadow output diff; signature externalization. | high |
src/services/assetRepository.ts | HARDEN | IndexedDB/memory adapter jó seed. | AssetByteStore implementáció quota/integrity/lifecycle policyval. | Port bevezetés; hash/MIME/eviction tests. | medium |
src/services/omiContainerImport.ts | KEEP | Erős ZIP biztonság: méret/entry/CRC/SHA/path/symlink/encryption/ambiguity védelem. | Biztonságos container transport parser. | Kód megtartása; semantic codec leválasztása és fuzz. | low |
src/services/omiContainer.ts | REFACTOR | Valós manifest/assets/history/profile/output csomag; 0.1/pre-stable contract és domain/presentation keverés. | SPEC-330 szerinti versioned container writer. | A jelenlegi manifestből normatív schema; dual-read, új-write. | high |
| Publication signature localStorage | REPLACE | Nem credential/evidence store, nem hordozható és könnyen összekeveredik a manuscript semantics-szal. | Secure evidence repository; manifest/artifact digesthez kötve. | Read-only migration/export, majd localStorage út eltávolítás. | high |
6. Import/export és publication
| Jelenlegi komponens | Státusz | Probléma / bizonyíték | 1.0 célállapot | Átállási lépés | Kockázat |
|---|---|---|---|---|---|
| Import actionök összessége | MERGE | DOCX, PDF, OMI, office, music és reference import eltérő return/error/progress modellt használ, részben közvetlenül store-ba ír. | Közös Importer + registry + diagnostics/fidelity/provenance. | Contract elsőként; adapterenként wrap, behavior fixture. | high |
docxImportStrategy.ts, docxManuscriptImport.ts, monograph modulok | HARDEN | Érdemi struktúra/fidelity/preflight/limit logika és sok teszt. | DOCX importer adapter. | Wrapper; synthetic corpus, cancel/memory/loss golden. | medium |
docxImportActions.ts | REFACTOR | 0.1 OMI-t épít és közvetlen store state-et ír. | Import application use-case draft/commit lépéssel. | Adapter output → draft, UI review, command commit. | high |
| Server PDF import | HARDEN | Strukturális/typográfiai elemzés létezik, de természeténél fogva lossy és API-specifikus. | Best-effort importer explicit fidelity reporttal. | Diagnostics normalization, job timeout/abort, public fixtures. | medium |
officeImport.ts HTML/table/image | HARDEN | Detached parsing és sanitizer jó alap; data URL és közös quota policy további kontrollt igényel. | Import adapters asset externalizationnel. | Közös source/diagnostics, hostile corpus. | medium |
musicImport.ts + file routing | REFACTOR | MusicXML működik; .mid/.midi parserre a külső `musicxml? | xml` feltétel miatt nem jut el a vezérlés. | Capability-alapú music importer probe. | Kis routing fix külön PR-ban + MIDI fixture, majd common wrapper. |
referenceInterchange.ts | HARDEN | RIS/BibTeX/CSL-JSON támogatás és teszt jó alap. | Reference importer/exporter normalized provenance-nal. | Duplicate/conflict/encoding corpus. | low |
| Zotero/Mendeley reference manager | HARDEN | Működő provider service, de credential/sync/audit contract egységesítendő. | ReferenceManagerConnector, scoped credential és sync receipt. | Existing client wrap, incremental token migration. | medium |
| Export service-ek összessége | MERGE | Sok önálló export*.ts, eltérő delivery és diagnostics; egyesek közvetlenül Tiptap contentet parse-olnak. | Renderer registry + egységes result; delivery külön. | Interface + wrappers, callsite migráció formátumonként. | high |
exportFileDelivery.ts | KEEP | Jól elkülöníthető browser/native delivery seed. | ArtifactDeliveryPort adapter. | Interface implementálása, renderer importok tiltása. | low |
exportJats.ts, JATS validators | HARDEN | Erős schema/JATS4R/release tests; content és profile mapping formalizálandó. | Stable JATS renderer + pinned validator receipts. | RenderingContext adapter, golden/canonical XML tests. | medium |
exportHtml.ts, HTML artifact/package | HARDEN | Jó output és tesztek; aktív tartalom/remote resource policy legyen explicit. | Stable standalone/package renderer CSP/security profile-lal. | Security corpus + a11y gate + deterministic manifest. | medium |
webPublicationArtifact.ts, NewsletterPublishingPanel.tsx | REFACTOR | A committed-build hash, a látható lektorált/nem lektorált pecsét és a gépi metadata erős alap; a checkpoint/evidence/build orchestration még React/Zustandból indul. | PrepareWebPublication application use-case immutable minősített artefaktummal. | A renderer és UI megtartása; orchestration application facade mögé, characterization tesztekkel. | medium |
webPublication.ts, v1 route-ok, grant és delivery outbox | HARDEN | Server validation, SSRF, scoped grant, idempotency és content-clearing receipt erős; recovery worker, receiver contract, retention operation és failure E2E hiányos. | Preview ArtifactDeliveryPort explicit retry/reconciliation evidence-szel. | Fault-injection és receiver-contract teszt minden Stable promotion előtt. | high |
exportDocx.ts | HARDEN | Jelentős export logika és index tests; közös renderer contract hiányzik. | DOCX renderer fidelity reporttal. | Wrap, golden unzip/XML structural tests. | medium |
exportPdf.ts, vivliostylePdfRenderer.ts | HARDEN | Pinned renderer teszt/build létezik; font/environment és byte determinism nem teljesen rögzített. | Print PDF renderer versioned resource manifesttel. | Font bundle/fallback receipt, visual regression, timeout sandbox. | high |
exportEpub.ts, exportLatex.ts | DEFER | Működő export code, de stable fidelity evidence korlátozott. | Preview renderer ugyanazon contracton. | Wrap és fixture corpus; stable csak külön gate után. | low |
exportIdml.ts, exportXtg.ts, exportMif.ts, exportSla.ts | DEFER | Implementáció és smoke/shape tesztek vannak, de célalkalmazásos acceptance kevés. | Preview DTP rendererek; nem blokkolják az alap 1.0-t. | Common wrapper; synthetic acceptance corpus, későbbi promotion. | low |
src/model/publicationProfile.ts module augmentation | REFACTOR | Presentation policy az OMI manuscript típusát bővíti. | Külön versioned publication profile/build input. | Mapping adapter és referenciamező; régi embedded profile dual-read. | high |
| Paragraph/publisher styles | HARDEN | Gazdag működő rendszer. | Renderer-neutral style intent + target mapping. | Existing functions wrap; unsupported mapping loss report. | medium |
src/model/publicationBuild.ts, build manifest/artifact/hash | KEEP | Committed-head, manifest, provenance és hashing jó 1.0 seed. | Publication pipeline orchestrator/evidence. | Contract név/mező freeze, deterministic tests. | low |
publicationSignatureVerification.ts, server crypto | HARDEN | Verifikáció létezik; evidence placement/key lifecycle tisztázandó. | Exact artifact+manifest signature és rotálható evidence. | Key ID/version, revocation és cross-runtime fixtures. | medium |
7. OJS/OMP és review
| Jelenlegi komponens | Státusz | Probléma / bizonyíték | 1.0 célállapot | Átállási lépés | Kockázat |
|---|---|---|---|---|---|
| Studio OJS és OMP client/route párok | MERGE | Nagyrészt közös launch/submission/review/file/writeback capability, párhuzamos DTO és branching. | Common Publishing System Connector API + profile adapterek. | Capability/schema package, registry; OJS/OMP wrapper külön PR. | high |
server/src/integrations/ojs/* | HARDEN | Signed launch, scope, context, review form/recommendation/writeback jelentős implementáció. | OJS connector adapter. | Közös contract mapping + idempotency receipts. | medium |
server/src/integrations/omp/* | HARDEN | Native context/writeback és fejezet confinement jó; közös contract nincs. | OMP connector adapter, monograph extensions. | Közös suite + OMP profile extensions. | medium |
OJS plugin omi-integration/1 implementation | HARDEN | Széles capability és szerveroldali PKP object auth; verzió/profile contract fixture hiányzik közösen. | Támogatott OJS verziókra contract-tested adapter. | Shared fixture package + Docker E2E exact matrix. | medium |
OMP plugin omi-integration/1 implementation | HARDEN | Reviewer csak assigned chaptert lát; native reviewer/author workflow erős. | OMP profile adapter ugyanazon common contracton. | Shared fixture package + round/stage mapping tests. | medium |
| Direct submission local + external update | REFACTOR | A két rendszer nem atomikus; branchelt handler és retry/receipt authority nem egységes. | Transactional outbox + idempotent connector saga. | Outbox table/worker; dual-write shadow; failure UI. | high |
server/src/services/peerReviewService.ts | SPLIT | Domain transition, persistence és serializer/visibility részben együtt. | Review domain policy + repository + projection serializers. | Characterization/role-matrix tests, majd kivonás. | medium |
editorialDecisionService.ts, EditorialDecision | HARDEN | Helyesen különíti el a lezárt review evidence-t a szerkesztői döntéstől, és revision/state digesthez köti az elfogadást; a reviewer workspace source provenance és döntési audit erősítendő. | Studio-natív szerkesztői authority a neutral review contracton. | Assignment source-revision digest, immutable decision/audit fixture és negatív external-assignment teszt. | high |
reviewManuscriptService.ts | HARDEN | Jó szerveroldali allowlist/size/sanitization projection, de ad hoc article snapshot és SVG/data URI kérdés. | Versioned anonymous OMI projection service. | Projection report, metadata/asset stripping, leak corpus. | high |
| Reviewer workspace/revision | HARDEN | Assignment scoped snapshot és visibility működik. | Review domain workspace, immutable source revision link. | Source digest/version és lifecycle invariant. | medium |
| Recommendation mapping | HARDEN | OJS és OMP értékek részben külön modellek. | Core controlled recommendation + connector mapping. | Mapping exhaustiveness/unknown tests. | low |
| Review-confidential integration flag | REPLACE | Kliens által küldött allow/confidential jel nem lehet security authority. | Server-derived ExecutionGrant assignmentből és policyból. | Route schema szűkítése; deny tests; audit. | high |
8. Identity, backend és API
| Jelenlegi komponens | Státusz | Probléma / bizonyíték | 1.0 célállapot | Átállási lépés | Kockázat |
|---|---|---|---|---|---|
server/prisma/identity/schema.prisma | HARDEN | Teljes account/auth/provider/institution/admin modell, működő migrációkkal. | Egyetlen identity authority. | Policy/documentation alignment, backup/migration/recovery tests. | medium |
server/prisma/schema.prisma duplikált User/Session/Identity | SPLIT | Ugyanazok a fogalmak két DB-ben; bridge azonos UUID-t tükröz FK-k miatt. | Main DB csak StudioPrincipal projection és workflow FK. | Logikai rename/API előbb; dual-read reconcile; későbbi DB migration. | high |
studioPrincipalBridge.ts | HARDEN | Hasznos compatibility bridge, de az authority/reconciliation nincs teljesen formalizálva. | Idempotens principal projection service outbox/reconcile jobbal. | Metrics, drift repair, failure tests. | medium |
| Local account password auth | HARDEN | Kód scryptet használ, dokumentáció részben Argon2id/future állapotot állít. | Verziózott password-hash policy és rehash-on-login. | Dokumentáció igazítása; paraméter/version mező; security test. | medium |
| ORCID/Google/Microsoft/institutional OIDC | HARDEN | Provider flows rendelkezésre állnak; identity linking és redirect policy egységesítendő. | Provider identity adapterek közös auth policyval. | Shared state/nonce/PKCE/redirect contract, negative tests. | medium |
| Institution/central admin | HARDEN | Külön route/service és audit modellek léteznek. | Policy service identity DB authorityval és /api/v1 contracttal. | Route adapter + authorization matrix. | medium |
| Author signature | REFACTOR | Portable manuscript és account/evidence/storage fogalmak összecsúsznak. | Publication identity evidence külön store/manifestben. | Evidence DTO + artifact binding; old read compatibility. | high |
Personal OJS/OMP credential mezők + UserIntegration | MERGE | Provider secret két helyen/modelben is élhet. | Egy CredentialRepository, provider-specific profile metadata. | Inventory/migrate/dual-read, checksum, majd régi mezők eltávolítása. | high |
| Native bearer token localStorage | REPLACE | XSS és desktop webview kompromittálódás esetén kinyerhető. | Platform secure storage; browser HttpOnly session. | SecureStorage port/plugin, token migration/logout fallback. | high |
server/src/routes/* vegyes /api és /integrations | REFACTOR | Nincs egységes stabil verzió/error/idempotency contract; csak institution admin részben v1. | Additív /api/v1, közös schema és handler. | V1 facade route-onként; deprecation telemetry. | high |
| Route → Prisma közvetlen felelősségek | SPLIT | Több route/service határ eltérő; transaction/audit nem konzisztens. | Route→application→repository. | Kritikus review/credential/submission use-case-ekkel kezdeni. | medium |
| Zod request schemas | HARDEN | Sok route-on van validation, de nincs egyetlen OpenAPI/DTO source. | Shared Zod/OpenAPI transport contract. | Error envelope + schema registry; contract tests. | medium |
server.ts shutdown | HARDEN | Main Prisma disconnect látható, identity kliens lifecycle nem egyértelmű. | Mindkét DB, worker és renderer rendezett shutdown. | Lifecycle manager/integration test. | low |
9. Integration, storage és platform
| Jelenlegi komponens | Státusz | Probléma / bizonyíték | 1.0 célállapot | Átállási lépés | Kockázat |
|---|---|---|---|---|---|
src/integrations/contracts.ts, registry.ts | HARDEN | Jó provider/capability vocabulary seed; kliens–szerver capability nevek közt eltérés (document.suggest/suggest). | Egy megosztott capability schema. | Generate/import common constants; exhaustive negotiation test. | medium |
server/src/integrations/integrationExecution.ts | REFACTOR | Timeout/limits/audit/hashed payload jó, de data scope és confidential authority részben requestből jön. | Server-issued scoped ExecutionGrant, minimal payload builder. | Új grant endpoint/policy; régi request mezők figyelmen kívül/deny. | high |
| DeepL/AI integration | HARDEN | Provider execution létezik; retention/purpose/suggestion boundary egységesítendő. | Scoped connector, explicit consent és audit. | Built-in adapter wrapper; no-direct-write default. | medium |
| Extension registry | DEFER | Manifest/endpoint registry van, executable sandbox nincs. | 1.0-ban built-in connector registry; arbitrary plugin runtime később. | Stable claim szűkítése; remote endpoint allowlist. | low |
server/src/cloud/CloudStorageProvider.ts | KEEP | Jó provider abstraction. | Remote object storage port. | Név/capability alignment; semantic logic tiltása. | low |
| WebDAV/Nextcloud provider | HARDEN | Encryption/ownership/checksum és trusted URL védelem jó alap. | Hardened remote byte store. | Redirect SSRF tests, ETag conflicts, recovery corpus. | medium |
| Google Drive/OneDrive/Dropbox OAuth providers | HARDEN | Közös OAuth provider működik; scope/token lifecycle/retry bővítendő. | Provider adapterek common storage receipt contracttal. | Scope inventory, refresh/revoke tests, resumable upload ahol kell. | medium |
| SharePoint | DEFER | Nincs explicit külön adapter; Graph/OneDrive profilból később levezethető. | Külön capability profile csak tesztelt implementáció után. | Nem blocker az alap 1.0-ra. | low |
localCloudFolder.ts | KEEP | Helyesen lokális szinkronizált mappaként kezeli a storage-ot. | SyncFolderAdapter. | Atomic/conflict behavior teszt. | low |
src/services/deviceStorageMode.ts, platform detection | HARDEN | User-agent/Tauri alapú döntés; capability és platform fogalom összekeveredhet. | Capability detection + injected platform adapter. | Composition root és contract tests. | medium |
| Tauri capabilities/config | KEEP | Szűk allowlist, updater és desktop build workflow használható. | Desktop platform adapter. | Secure storage/share/open-with portok hozzáadása. | low |
| Android SAF/updater/distribution | HARDEN | Tesztek és release workflow vannak; dokumentum-location lifecycle/recovery szükséges. | Android adapter stable matrixszal. | Persisted URI permission + process death/update tests. | medium |
| iOS/iPadOS | DEFER | Workflow/simulator nyomok vannak, release scope experimental/preview. | Ugyanaz a core, Apple Files/Keychain/auth adapter; stable csak evidence után. | Build/simulator gate nonblocking, privacy/data-loss blocking. | medium |
| System fonts | REFACTOR | Platform font discovery közvetlen publishing függésbe kerülhet. | Platform font resolver → versioned resource manifest. | Font receipt/fallback; renderer nem kérdez platformot közvetlenül. | medium |
10. CI, teszt és dokumentáció
| Jelenlegi komponens | Státusz | Probléma / bizonyíték | 1.0 célállapot | Átállási lépés | Kockázat |
|---|---|---|---|---|---|
| Studio unit/pretest suite | KEEP | 441/441 sikeres; széles model/import/export/UI-source coverage. | Gyors PR gate, characterization védőháló. | Megtartani; új boundary tests hozzáadása. | low |
| Frontend lint/build | HARDEN | Sikeres; kb. 3,76 MB main JS chunk és ineffective dynamic import warning. | Bundle/perf budget és valódi code splitting. | Baseline budget; route/renderer lazy load. | medium |
| Server typecheck/build | KEEP | Prisma generationnel sikeres. | Kötelező PR gate. | Mindkét schema migration check hozzáadása. | low |
| Publication release suites | KEEP | JATS/JATS4R/Vivliostyle/build/submission/artifact jelentős tesztek. | Publication gate része. | Exact versions/artifact evidence manifest. | low |
| Playwright E2E | HARDEN | Kevés kritikus flow; néhány teszt source-regex jellegű, nem runtime bizonyíték. | Core user journey + recovery/a11y E2E. | Regex testeket runtime behaviorrel kiegészíteni. | medium |
| PKP integration workflow | HARDEN | Valós Docker flow értékes, de path-filter miatt nem fut minden RC commiton. | OJS/OMP exact matrix + RC aggregator. | Reusable workflow; RC-n filter nélkül. | medium |
| Desktop/Android workflows | HARDEN | Exact audited commiton zöld build; install/save/update runtime matrix külön bizonyítandó. | Artifact install/smoke/evidence gate. | Signed artifact smoke VM/device farmon. | medium |
| iOS workflows | DEFER | Nem futott az audited exact commiton; scope experimental. | Preview evidence; stable későbbi promotion. | RC aggregate nonblocking, security blocker marad. | low |
.github/workflows/1.0-readiness.yml | HARDEN | Jó SBOM/benchmark/readiness kezdet, de path-filteres. | Egyetlen exact-RC aggregate, minden kötelező gate-tel. | workflow_call + release-candidate dispatch/tag policy. | high |
| OMI website CI | REFACTOR | npm run build nem tartalmazza a test:file-format suite-ot. | Schema conformance minden schema/spec változásnál és release-nél. | Külön job vagy build dependency. | high |
| Parser/security testing | HARDEN | Sok konkrét ellenőrzés van, de közös fuzz/hostile corpus nincs minden inputhoz. | Biztonsági fixture corpus és fuzz budget. | Synthetic malicious ZIP/XML/HTML/JSON/assets. | medium |
| Accessibility | REFACTOR | Nincs látható teljes release-blocking a11y suite. | WCAG 2.2 AA automated + manual smoke kritikus flowkra. | Axe Playwright, keyboard/focus, screen-reader checklist. | medium |
| Recovery testing | REFACTOR | Session restore tesztek vannak, de kill-during-save/atomic rollback kevés. | Fault-injected save/recovery/update/outbox gate. | Adapter fault harness és corrupt fixtures. | high |
| OMI governance/status dokumentumok | REPLACE | Több státusz lemaradt a működő container/review/citation implementációtól. | Generated/evidence-linked status matrix. | Code owner review + release evidence linkek. | low |
| Real manuscript fixture policy | KEEP | A release/privacy irány helyes: privát kézirat nem kerül Git/CI-be. | Csak synthetic/public/tesztcélú corpus, content-free log. | CI secret/content/path scanner és contributor guide. | low |
11. Kiemelt dokumentált eltérések
- SPEC-320 0.2 vs Studio 0.1: jelenleg a specifikáció tükrözi a kívánt interoperabilitási irányt; a Studio a tényleges működést. A kettő egyikét sem szabad önmagában „helyesnek” tekinteni: a 0.2 schema hiányzó Studio-integrációja 1.0 blocker.
- Container státusz: a specifikáció/governance egyes részei kezdetlegesnek írják, miközben a Studio fejlett ZIP/manifest/checksum implementációval rendelkezik. Itt a működő implementációból kell a normatív contractot visszaírni, nem új konténert tervezni.
- Identity dokumentáció: egyes security leírások az intézményi/central identityt jövőként és Argon2idként írják; a kód már két-DB-s identity rendszert és scryptet használ. A jelenlegi működés a technikai valóság, de az authority és hash policy formalizálása kötelező.
- Review státusz: a kód szerveroldali anonim projectiont, visibility serializer-t és OJS/OMP writebackot tartalmaz, ami több dokumentált státusznál előrébb van. A hiány itt nem a teljes alrendszer, hanem a közös domain contract és security corpus.
- Zöld CI jelentése: a jelenlegi commit CI-je jó egészségi jel, de path filterek és az OMI conformance job hiánya miatt nem azonos a teljes 1.0 release bizonyítékkal.
12. Amit kifejezetten nem szabad újraírni
- Tiptap editor és a jelenlegi OMI extensionök: adapterhatár kell, nem editorcsere.
- A lineáris immutable revision szemantika: repository kell, nem új history termék.
omiContainerImport.tsbiztonsági parser: normatív contract és fuzz kell, nem új ZIP parser.- A DOCX/JATS/HTML feldolgozók: közös interface és fixture kell, nem nulláról új implementáció.
- Publication build manifest/hash alap: evidence contractként kell stabilizálni.
- Cloud storage provider és SSRF segédek: porthoz kell igazítani.
- Tauri/Android shell és release workflow: hiányzó platform portokat kell hozzáadni.
- OJS/OMP plugin authorization és object-scope ellenőrzés: közös contract suite alá kell helyezni.
13. Freeze előtti P0/P1 gap-ek
| Prioritás | Gap | Freeze feltétel |
|---|---|---|
| P0 | Üres Studio schema + 0.1/0.2 eltérés | Canonical schema pinned, open/save validation és quarantine működik |
| P0 | Tiptap JSON a portable content contractban | SPEC-100 content grammar és adapter migration terv/fixture elfogadva |
| P0 | Container contract nincs összhangban SPEC-330-cal | Manifest/path/security/version profile fagyasztva |
| P0 | Double-blind/AI scope authority részben kliensvezérelt | Server-issued grant és leak/negative tesztek |
| P0 | Native token localStorage | Secure storage migráció kész a stable native platformokon |
| P1 | Zustand/app ownership keveredés | Application facade és első create/open/save use-case-ek aktívak |
| P1 | Két identity authority látszata | Identity DB authority + StudioPrincipal projection döntés és reconcile kész |
| P1 | OJS/OMP párhuzamos contract/writeback | Common connector DTO + outbox/idempotency terv implementálva |
| P1 | Path-filteres release bizonyíték | Exact-RC aggregate workflow elérhető |
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.
Külső integrációk javítási ellenőrzőpontja — 2026-10-18
| Komponens | Besorolás | Cél és teendő | Bizonyíték / kockázat |
|---|---|---|---|
| EuroOffice callback | HARDEN / SPLIT | Revision-CAS, callback-nyugta, service/repository, változtathatatlan helyreállítási mentések | Ismételt/késői/párhuzamos callback; PostgreSQL és valódi provider elfogadása szükséges |
| DOCX letöltés | HARDEN | Tényleges streamkvóta és ZIP/OPC/XML-integritás a tárolás előtt | Sérült csomag, CRC, hamis méret és kibontási korlát; nem teljes OOXML-konformancia |
| API/platform | REFACTOR | Additív v1, legacy adapterek, közös transport | Natív originváltáskor a korábbi token nem vihető át; SecureStorage továbbra is külön feladat |
| Kreditfogyasztó felismerés | HARDEN | Lejáró grant és képdigesthez kötött tartós intent | Elfogadott ismétlés, payloadütközés, UNKNOWN kimenetel; a külső számlázás exactly-once garanciája nem állítható |
A külön DOCX-tárolás szándékos, nem OMI-sémaváltozás. A korábbi egyszerű szerkesztési mód eltávolítása felülírja a történeti munkatérmód-leírást; editorMode nem kerül vissza a hordozható modellbe. A javítások merge és migrációs/CI-bizonyíték előtt tervezett állapotúak.
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.
| Component | Status | Gap / target | Next step | Risk |
|---|---|---|---|---|
| Registry routes / service / repository | SPLIT / HARDEN | Private proof, v1 and CAS replace route-owned verification | Merge repair, migration and dual-mount tests | high |
| Registry audit and operational recovery | HARDEN | Quarantine unknown side effects; no blind replay | Operator DNS/GitHub/recovery acceptance; future durable audit tooling | medium |
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ú.