OMI Studio 1.0 Refactoring and PR Plan
Kutatásiprojekt-szerződés egyeztetése — 2026-11-15
A02/A04/A06/B06 és ADR-008/022/036: központi projekt-envelope/séma/minta rögzítése, natív CSP mellett működő generált validálás, független JSON-fogyasztás és régi formátumok veszteséget jelző migrációja. Előbb projektalapú cache és kifejezett megnyitás/hozzáadás, utána külön bizonyítékkal a közvetlen tárolóadapter, konfliktuskezelés és ellenőrzött nyilvános projekció. Nem engedélyez stabil promóciót vagy kiadási kapu elhagyását.
Á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
A02–A06/B06: központi Draft sémaegyeztetés, commit/checksum rögzítés, generált profilvalidálás, régi/jövőbeli tartalom megőrzése és DOCX/JSON/konténer körbejárási tesztek. C11/ADR-022/023: ellenőrzött pillanatkép atomikus forráskövetéssel, előzményekkel és privátadat-szűréssel. A kötelező OMI-SPEC-320 bizonyíték továbbra is a pontos kiadásjelölthöz tartozik; az OMI és Studio módosítását össze kell hangolni.
Á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 A09/A10 feladata az új privacy/fiókmásolat felületre is érvényes: additív v1 és közös legacy mount; szigorú Zod DTO-ból OpenAPI/kliens típus; szabványos olvasási hibák/korreláció; injektált repository port az alkalmazás és az identity Prisma között. A session-izoláció, szűk mezőválasztás, korlátok, opcionális szereposzlop kompatibilitása és a részlegesség jelzése maradjon meg.
Ellenőrzés: npm run test:privacy, szerver/frontend build, opcionális munkaszerep login-/projection-regresszió és privacy böngészőtesztek. A meglévő CI-lépés tartalmazza a DTO/OpenAPI-egyezést, a két mount közös kvótáját/izolációját és a natív origin ellenőrzését. A pontos RC-commithoz kötött és kézi üzemeltetői gate-ek nem gyengülnek. API → web/natív kliens telepítési sorrend; nincs új migráció vagy szerkesztési korlát.
Merge és CI előtt javaslat. Hiányzó adatkezelői tényeket nem lehet kitalált adatokkal helyettesíteni, a részleges fiókmásolat pedig nem teljes érintetti export.
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.
Ez a bizonyítékkör vonatkozik a C06–C09, D08 és E02–E05 egységekre. Az eredeti 54 egység és függőségi sorrend megmarad. Aktuális támogatási döntés.
Publikációs változat határa — 2026-11-04
Az eredeti 54 feladat marad. B01/B03/B07 az alkalmazás/session/history bekötés; B05/B06 a forrás ContentCodec feladata, nem a szerkeszthető publikációs változat megszüntetése. C03–C05 a forrás–publikáció leképezés, változatlan buildbemenet és veszteségjelentés specifikálása/tesztelése. C15/E03 az adott tartalomhoz kötött lektoráltság, adatvédelem, kifejezett frissítés/konfliktus, recovery és teljesítmény. A dokumentáció nem implementálja ezeket, és nem enyhíti E02–E05 követelményeit.
Ellenőrzött forrás, döntés és elfogadási feladatok.
Outbound védelem és elfogadási checkpoint — 2026-11-02
Az eredeti 54 A01–F03 egység és függőségeik megmaradnak. C12/C13 a merge-elt pinned transportot stabilizálja, nem új rendszert vezet be. A D fázis a közös UID/szolgáltatás-cgroup és a külön PDF-worker tényleges elfogadását rögzíti. E02 továbbra is azonos candidate workflow/artifact és owner/manual receipt bizonyítékot igényel; az issue lezárása ezt nem helyettesíti.
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.
Az R01–R07 javítások a meglévő 54 elemű A–F tervet egészítik ki, nem számozzák át. Az editor, Yjs, revision és rendererek maradnak.
| Javítás / fázis | Cél / fájlok | Előfeltétel | Kötelező teszt | Breaking / technikai kockázat |
|---|---|---|---|---|
| R01 / D | Opaque Office sandbox, iframe + embed host + CSP | Meglévő owner launch | Valós host/browser parent/storage/API tiltás; Windows/Android mentés/újranyitás | Páros API/native rollout; közepes, javítatlan security magas |
| R02 / B | DocumentSessionManager, store adapter, App/recovery, native ID-helyek | Meglévő store/history | Két pending dokumentum, batched open, selection/checkpoint/recovery, tényleges mockolt native A/B írás | Nincs portable változás; közepes |
| R03 / C | Extension v1/legacy közös router/service/repository és kliens | Meglévő manifest validator | 401/validáció/owner/parity | Additív; alacsony–közepes |
| R04 / A+C | Szerializációs profil, pontos history, két repó közös golden és 330 implementációs megjegyzés | 320/330 reader és v1 digest | Reader + független ZIP/CRC/hash, historical digest és unknown-profile denial | Kísérleti additív profil; közepes |
| R05 / D | Production socketkövetelmény, worker local executor és guide | Meglévő systemd socket | Production hiány/false opt-out tiltás, nincs fallback, valós host/secret/resource/network elfogadás | PDF nem elérhető konfigurációig; közepes |
| R06 / E | RC evidence script, prior-build és JSON input, pontos artifact reuse | Strict issue gate és tényleges elfogadás | Hiányzó/idegen SHA/run/gate/hash elutasítása; sikeres azonos-SHA build/CI/CodeQL/PKP/readiness | Beta marad; közepes technikai, magas kiadásbiztonsági súly |
| R07 / A | Öt EN/HU baseline, ADR-030, nem normatív 330 profil | R01–R06 konkrét kód és fixture | EN/HU build, 54-unit roadmap gate, fixture-egyezés | Nincs schema/DB/release bump; alacsony |
Az adapterek külön visszavonhatók, a userfájl/recovery/pontos history megőrzendő. Office rollback csak biztonságos páros API/native verzióval. Globális mentési útvonal, külső fő-WebView script, production PDF fallback és release bypass nem állítható vissza. Valós kézi/device/provider/host bizonyítékot nem gyártunk teszteredményből.
Aktuális egyeztetés: 2026-11-01 — bizonyítékalapú megvalósítási felülvizsgálat. A korábbi checkpoint történeti adat; javasolt javításhoz merge/CI kell, helyi bizonyíték nem telepítési elfogadás.
2026-11-01 – az ütemterv felülvizsgálata
A részletes új állapotjelentés elkülöníti a működő, részben igazolt, előkészített és külső elfogadásra váró feladatokat. Az A01–F03 ütemtervben 54 tervezési egység szerepel (A=10, B=13, C=15, D=8, E=5, F=3), nem 53. A Studio #811-es PR-je csak az A10 függőségi határellenőrzés első, körülhatárolt részét készíti el. A már merge-elt #810 a kiadási kaput szigorítja, de nem teljes E02-aggregátor. A #765/#774 VPS-elfogadása, #271 glib, a hordozható AST/ContentCodec, natív SecureStorage és a független megfelelőség még nyitott. A régebbi tervezési táblázatok nem aktuális teljesítési nyilatkozatok.
Draft fordítási, exchange- és jogosultsági checkpoint — 2026-10-31
B06/B07/C01–C05/C11/E02 kiegészítése. Meglévő modellek, rendererek, Yjs és history megtartandó.
| Egység / fázis | Cél / fájl | Előfeltétel | Teszt | Breaking / technikai kockázat |
|---|---|---|---|---|
| T01 — azonnali security | Public-note szűrés a translationExport.ts output/readiness előtt; negatív fixture és release-security bekötés. | Meglévő public-note predikátum | Két mód; hidden/editor/workflow/origin; késői láthatóságváltás; új/stale public note; private nem blokkol; eredeti sértetlen | Privát output szándékosan eltűnik; low technikai / high javítatlan privacy |
| T02 — B application | translationCommands.ts port, app/translationActions.ts facade. | Translationmodell/checkpoint; T01 után review | Plain-session és valódi store, pending event, sourcebasis, reopen/revert és hibás parancs atomicitása | Nincs API/schema-váltás; medium |
| T03 — C exchange | ExportExchangeSession, standard panel riportfolyamatának átkötése. | Meglévő report/bájtvizsgáló service | Warning/digest, inspect előtti completion tiltása, fail/cancel; meglévő export/sidecar és build | Helyi riportcontract változatlan; medium |
| T04 — A dokumentáció | Öt EN/HU baseline + Studio ADR-029; ADR-028/core-review összehangolása. | T01–T03 reviewzható eredménye | EN/HU build, kód/fixture/verzió trace | Nincs kompatibilitásváltás; low |
| T05 — későbbi B/C | Registry/port előbb, maradék hívók migrációja utána; editorfüggetlen fordításhorgony verziózott codec-konverzióval. | T02/T03, A06/B06 és normatív profil | Adapterparitás, byte/fidelity diagnosztika, unknown/eltolt path/cross-editor round-trip; külön migration PR | Lehetséges profiltörés; high, csendes átértelmezés tilos |
| T06 — E elfogadás | Kollaboráció reauth/reconnect/privacy, külső interoperabilitás, exact-candidate evidence. | T01–T04 és többi RC-feltétel | Valódi transport downgrade/revoke/unavailable, offline denial, anonim felületek, jóváhagyott profil/független evidence | Hiányában high promóciós kockázat; beta/self-assessment nem tanúsítás |
T01–T03 kis javításként külön commitokban vagy ebben a sorrendben külön PR-okban szállítható. Adapterkiszervezés külön rollbackelhető; privát HTML-szivárgás nem állítható vissza. Privát jegyzet ellenőrzése nem válhat publikus export- vagy szerkesztési feltétellé. Nincs schema/container/DB-migráció. Sessionlokális receipt, teljes célvalidáció/streaming és nem instrumentált export további scope.
Biztonsági határok egyeztetése — 2026-10-30
A B09–B11/C12 és D/E biztonsági bizonyítékok kis bővítése; nem auth/PDF-újraírás. A Studio 540f67a állapotáig merge-elt védelmek megtartandók.
| Egység / fázis | Cél, modulok, várható fájlok | Előfeltétel | Bizonyíték | Változás / rollback kockázat |
|---|---|---|---|---|
| S01 — A/B egyeztetés | Igazolt email/központi auth leírása; docs/server/security-contract-rollout.md; két server contract teszt, package script és CI/readiness bekötés. | Bootstrap/Origin/PDF védelem #775-ig merge-elve | Release-security, valódi HTTP Origin/session/parser és mockolt repositorys provisioning, server compile | Low; nincs runtime/DB-változás. Teszt/dokumentáció külön visszavonható, védelem megmarad |
| S02 — A freeze checkpoint | Öt baseline EN/HU, ADR-012/015/016/017/019; környezetszűrés és telepítési sandbox szétválasztása. | S01 review; main-kód önálló ellenőrzése | Dokumentáció/MDX-linkbuild; contract→kód/teszt visszakövetés | Low; nem minden legacy API befagyasztása |
| S03 — D worker/egress | Külön workeridentity/container, titokmentes mountok, CPU/RAM/pid/temp/network korlát; kapcsolódáskori célvédelem (#774/#765). Várható deployment manifest, PDF/network adapter, ops doc; csomagolás a tényleges telepítésekhez. | S01 és operátori deploymentleltár | Host canary: credential/private/metadata tiltás és erőforráskorlát; engedélyezett integrációk/fontok/média/render/recovery | High; font/hálózat/renderer sérülhet. Kontrollált canary és biztonságos artifact rollback; teljes hozzáférés nem állítható vissza |
| S04 — D kapacitás | Közös atomikus admission/lifecycle, ha többpéldányos PDF támogatott; különben deklarált korlát. PDF job/admission repositoryport és deploymentconfig. | S01; támogatott topológia döntése | Többprocesszes konkurens kvóta, felszabadítás/lejárat/restart/ownership | Medium; contract/adapter előbb, migráció külön. A processzmap nem elosztott |
| S05 — E02 RC | Unit/HTTP, privát grantreview/recovery, browser/native/PKP és telepített izoláció/egress ugyanahhoz a commit/digesthez. | S01–S03; S04 ahol kell; E02 többi feltétele | Kötelező pozitív/negatív elfogadás, privát kézirat és credential Git/CI nélkül | High, ha hiányzik; promóció blokkolása, szerkesztés és explicit beta megmarad |
S01: npm run test:security-boundary-contracts a backend-függőségek és Prisma-generálás után CI/readiness alatt; a test:release-security gyors unit gate megmarad. Mock nem helyettesít valódi host/IdP/adatbázis-tesztet. S01/S02 nem igényel DB-migrációt. Régi grant áttekintése a meglévő adminszabályok szerint történik; nem korlátozhatja a szerző kéziratszerkesztését.
Freeze előtt pontos cookie-kompatibilitás, natív/PKP kivétel, igazolt-email authority, PDF státusz/limit és deployment evidence owner kell. RC előtt sikeres biztonsági bizonyíték is kötelező; a baseline frissítése önmagában nem E02-teljesítés.
Baseline: Studio eca2cf45762116e1c00a89b3397840ed89109511 és a 2026-09-19-i OMI/PKP commitok
Cél: kis, külön tesztelhető, visszagörgethető PR-okkal eljutni 1.0.0-rc.1, majd 1.0.0 kiadásig.
1. Végrehajtási elvek
- Contract vagy adapter előbb, callsite-migráció utána, régi út eltávolítása legutoljára.
- Minden PR egyetlen elsődleges architekturális változást végezzen; mechanikus move ne keveredjen szemantikai változással.
- Magas kockázatú PR előtt characterization/golden fixture kerüljön be.
- A meglévő fájlformátumot az átmenet alatt dual-read/new-write vagy shadow-validation védi; nincs csendes in-place conversion.
- A régi route/store facade addig marad, amíg minden ismert kliens/callsite át nem állt.
- A rollout feature flagje nem kompatibilitási stratégia: az adatformatum és identity/security váltásoknak explicit rollback/forward tervük van.
- Tesztanyag kizárólag synthetic, nyilvános vagy kifejezetten tesztcélú; privát manuscript cím, szerző, fájlnév, tartalom és lokális path nem kerül Gitbe vagy CI-logba.
2. Függőségi kép
flowchart TB
A["A: contracts and freeze"] --> B["B: core boundaries"]
A --> C["C: interoperability"]
B --> C
B --> D["D: platform hardening"]
C --> E["E: release candidate"]
D --> E
E --> F["F: 1.0 release"]
A fázison belül az alábbi PR-számok topologikus sorrendet jelentenek. Párhuzamosítható PR-t külön jelölünk.
3. Phase A — Architecture freeze
Kilépési feltétel: elfogadott compatibility policy; normatív schema/container/content contract candidate; /api/v1 és connector contract irány; dependency boundary lint; feature support matrix.
| PR | Cél | Érintett modulok / várható fájlok | Előfeltétel | Kötelező teszt | Breaking-change kockázat | Technikai kockázat |
|---|---|---|---|---|---|---|
| A01 | Rögzítse az 1.0 stable/preview/deferred scope-ot és a három verzióvonalat. | OMI/Studio docs/architecture, docs/release/1.0-scope.md, ADR-k | nincs | docs link/check; support matrix completeness | nincs runtime break | low |
| A02 | Tegye az OMI 0.2 schema-fixture suite-ot kötelező OMI CI-vé és release artifacttá. | OMI package.json, .github/workflows/website-build.yml vagy új conformance workflow, tests/file-format, schema | A01 | 8 meglévő + új negative/future fixture; schema checksum | schema artifact freeze után breaking | medium |
| A03 | Vendorolja a released sémát a Studioba és vezessen be OmiEnvelopeClassifier/validator modult shadow módban. | src/schemas/*, új src/core/omi/format/*, build sync script, tests | A02 | checksum drift, valid/invalid/future classification; jelenlegi docs shadow report | nincs: még nem blokkol | medium |
| A04 | Vezessen be explicit open policyt és future-schema quarantine/read-only eredményt. | nativeManuscriptFile.ts, omiContainerImport.ts, új application/documents/open*, UI error/read-only state | A03 | new-major/minor/invalid/oversize fixtures; nincs overwrite; raw recovery | user-visible új elutasítás, szándékos | high |
| A05 | Vezessen be pre-save/export validation gate-et és unknown-extension preservation fixture-t. | exportOmi.ts, save actions, format serializer, extension bag | A03, A04 | open→save semantic equality; invalid save blocked; unknown payload hash | hibás dokumentum többé nem menthető csendben | high |
| A06 | Fagyassza a SPEC-100 portable content AST candidate-et, és adjon ContentCodec contractot a jelenlegi Tiptap JSON fölé. | OMI content spec/schema; Studio új core/omi/content, editor-tiptap/codec; richText.ts, inlineSemantics.ts | A01 | legacy text + jelenlegi PM JSON → AST → PM golden; unknown node diagnostics | contract még internal/candidate | high |
| A07 | Fagyassza a SPEC-330 container manifest/path/checksum/security candidate-et a működő Studio parserből. | OMI container spec/schema/fixtures; Studio omiContainer*.ts, simpleZip.ts | A02, A03 | cross-repo golden containers; corrupt/path/symlink/CRC/SHA/limits | új container writer később breaking | high |
| A08 | Definiálja az egységes diagnostics/fidelity/provenance alapcontractot. | új src/application/diagnostics, import/export type shimek | A01 | serialization, redaction, stable code registry | nincs | low |
| A09 | Hozza létre az /api/v1 transport alapot közös error/idempotency/correlation contracttal, régi route érintése nélkül. | server/src/api/v1, Zod/OpenAPI registry, middleware, app.ts | A01 | contract test, error envelope, auth middleware ordering | nincs, additív | medium |
| A10 | Vezessen be import-boundary architecture testet és compatibility re-export mintát. | ESLint config/custom rule vagy dependency-cruiser, CI, új barrel modulok | A03, A06, A09 | tiltott core→React/Tiptap/Prisma/fetch import fixtures | CI új hibát jelezhet | low |
A fázis blocker-ek: nincs kijelölt owner az OMI schema release-re; SPEC-100 AST nem elég konkrét; SPEC-330 implementáció–spec eltérés nincs lezárva; stable platform/export scope nincs kimondva.
4. Phase B — Core refactoring
Kilépési feltétel: create/open/save és legalább a fő editing/history út application facade mögött; Tiptap adapter boundary működik; portable/persistence/UI state ownership elkülönült; native credential nem localStorage.
| PR | Cél | Érintett modulok / várható fájlok | Előfeltétel | Kötelező teszt | Breaking-change kockázat | Technikai kockázat |
|---|---|---|---|---|---|---|
| B01 | Hozzon létre application portokat és StudioApplication facade-ot a jelenlegi model functionök változtatása nélkül. | új src/application/ports, documents, editing; composition root | A10 | fake repository/clock/ID generator unit tests | nincs | medium |
| B02 | Migrálja a document create/open/save/close/recover use-case-eket a facade mögé. | newDocumentActions.ts, documentLifecycle.ts, nativeManuscriptFile.ts, lastSessionPersistence.ts, store delegate-ek | A04, A05, B01 | create/open/save/reopen; invalid/future; close dirty matrix | belső API; UI viselkedés regresszió lehetséges | high |
| B03 | Bontsa szét a Zustand ownershipot domain snapshot, UI, editor session és persistence projection szerint. | useStudioStore.ts, új ui/state/*, selector compatibility layer | B01, B02 | 441 jelenlegi teszt + selector/action characterization + fake-clock | belső action signatures átmenetileg dual | high |
| B04 | Egyesítse az automatikus checkpoint timereket egy document-scoped schedulerbe. | useStudioStore.ts, history/actions, új scheduler | B03 | fake timer, close/switch/reopen, no duplicate commit | nincs külső break | medium |
| B05 | Terelje a Tiptap-content összes olvasását/írását a ContentCodec facade mögé. | BlockEditor.tsx, continuous doc, citations, notes, xrefs, search, lists, proofing, clipboard, exporterek | A06, B01 | jelenlegi editor/export golden output diff; corrupted node diagnostics | nincs még wire-format break | high |
| B06 | Váltsa az új mentést a portable OMI AST-re; a pre-stable Tiptap-string formátum csak explicit import legyen. | OMI schema/content, codec, serializer, legacy importer, fixtures | B05, A05 | AST round-trip; old experimental fixture import; new-major quarantine | igen: ez az első stable format candidate | high |
| B07 | Vezessen be RevisionRepository portot a jelenlegi full-snapshot algoritmus adapterével. | versioning.ts, workingState.ts, revisionIntegrity.ts, IndexedDB/container adapter | B01, B06 | current history suite; materialize/revert/integrity cross-adapter | nincs szemantikai break | medium |
| B08 | Adjon crash-safe atomic save/recovery journal implementációt és opaque DocumentLocation-t. | native/browser persistence adapterek, nativeManuscriptFile.ts, session state | B02, B07 | kill/fail injection minden írási ponton; backup restore; concurrent digest conflict | path/session internal API változik | high |
| B09 | Formalizálja az identity DB authorityt és a main DB StudioPrincipal projectiont. | két Prisma schema/migration, studioPrincipalBridge.ts, auth service, reconciliation job | A09 | migration rollback snapshot; idempotent ensure; drift/reconcile; auth flows | DB migration, kompatibilis dual-read szükséges | high |
| B10 | Vezesse be a platform SecureStorage portot és migrálja a native bearer tokent. | frontend auth API, native auth handoff, Tauri/Android/Apple adapter/config | B01 | upgrade token migration, logout/revoke, XSS/localStorage absence test | régi natív session kijelentkeztethető fallbackkel | high |
| B11 | Válassza szét account, auth identity, scholarly agent, contribution és evidence mappinget. | model/identity.ts, linked identity routes/service, OMI agents UI/API, author signature | B09 | no implicit email/ORCID merge; verified link/revoke; contribution persistence | DTO változás v1 candidate-ben | high |
| B12 | Cserélje a proofing/tracked-change string-offset modellt stable anchor/semantic operationre adapterrel. | model/proofing.ts, Tiptap proofing extensions, proofreading API/UI | B05, B06 | concurrent edit/anchor remap; Unicode/grapheme; accept/reject round-trip | portable proofing schema változik a freeze előtt | high |
| B13 | Izolálja vagy távolítsa el az árva workspace alpha store-t és az üres domain placeholder modulokat. | src/store/workspaceStore.ts, model/workspace.ts, üres model fájlok, exports | A10, B03, usage audit | full build/tests; no import/reference; optional data export note | csak nem támogatott alpha state | low |
Miért nem egy PR? B03, B05, B06, B08 és B09 külön rollback domén. Store-refaktor közben nem szabad wire-formatot váltani; schema-váltás közben nem szabad DB authorityt migrálni. A jelenlegi viselkedést B05-ig változatlan codec védi.
5. Phase C — Interoperability hardening
Kilépési feltétel: közös importer/renderer/connector/review contractok; OJS és OMP ugyanazt a contract suite-ot teljesíti; publication artifact reprodukálható és validált; schema/container conformance kötelező.
| PR | Cél | Érintett modulok / várható fájlok | Előfeltétel | Kötelező teszt | Breaking-change kockázat | Technikai kockázat |
|---|---|---|---|---|---|---|
| C01 | Vezesse be az Importer registryt source/probe/progress/abort/diagnostics/fidelity contracttal. | új application/import, adapter registry; A08 types | A08, B01, B06 | fake importer, ambiguity/probe, abort, redaction, no store mutation before commit | nincs, wrappers | medium |
| C02 | Csomagolja be az OMI/DOCX/PDF/HTML/table/image/music/reference importereket; javítsa a MIDI routingot. | docx*, pdfImport*, officeImport.ts, musicImport.ts, referenceInterchange.ts, app actions | C01 | formátumonként golden; MIDI .mid/.midi; size/cancel/hostile corpus | import diagnostics változhat, content nem | high |
| C03 | Vezesse be a Renderer registryt és válassza le az ArtifactDeliveryPort-ot. | export*.ts, exportFileDelivery.ts, UI export panelek | A08, B05, B06 | minden exporter wrapper contract; delivery fake; nincs picker rendererből | belső API | high |
| C04 | Válassza le a publication profile-t az OMI module augmentationről és építse meg az immutable RenderingContext-et. | publicationProfile.ts, paragraph styles, publication rendering/build, profile UI/storage | C03 | old embedded profile dual-read; profile version; context golden | új profile storage contract, dual-read kell | high |
| C05 | Pinelje renderer/validator/font/resource verziókat; különítse el semantic és byte reproducibilityt. | build manifest/sidecar, JATS/HTML/PDF rendererek, font service, signature modules | C04 | repeated build hashes; font substitution; timezone/locale; signature cross-runtime | artifact manifest schema változik freeze előtt | high |
| C06 | Készítsen közös Publishing System Connector schema/package-et capability/launch/submission/review/writeback receipt contracttal. | Studio shared types/server; OJS/OMP plugin contract fixtures/docs | A08, A09 | JSON contract fixture mindhárom repo-ban; version negotiation | plugin protocol candidate változás | high |
| C07 | Illessze az OJS klienst és plugint a közös connector API-ra compatibility route-tal. | Studio OJS integrations/routes; OJS plugin routes/services | C06 | supported OJS 3.5.0-4/5 Docker E2E; replay/scope/files/form/recommendation/artifact | régi plugin kompatibilitást meg kell tartani | high |
| C08 | Illessze az OMP klienst és plugint a közös API-ra monograph/chapter extensionökkel. | Studio OMP modules/routes; OMP plugin controllers/services | C06 | OMP Docker E2E; assigned chapter confinement; rounds/stage files/attachments | régi plugin kompatibilitást meg kell tartani | high |
| C09 | Vezessen be durable outbox/idempotent sagát submission/revision/review/artifact writebackra. | Prisma migration, submission/review services, connector worker/status UI | C07, C08, B09 | remote timeout/duplicate/retry/crash; receipt reconciliation; no false rollback | DB/runtime behavior, additive | high |
| C10 | Emelje ki a publishing-system-neutral review domaint és hardenelje az anonymous projectiont. | peer review/review manuscript services, core/review, serializers, asset transforms | B11, C06 | role-transition matrix; identity leak corpus; asset EXIF/SVG; cache/log redaction | snapshot DTO v1 candidate változik | high |
| C11 | Vezessen be server-issued ExecutionGrant modellt integrations/AI/DeepL/reference manager számára. | integration contracts/execution/routes, provider registry, UI dialogs, credential repo | B09, B11, A09 | denied scope, selection-only payload, confidential review, expiry/replay, audit digest | régi request flag többé nem ad jogot | high |
| C12 | Konszolidálja a credential storage-ot és csomagolja közös connectorba Zotero/Mendeley/ORCID/OIDC/provider secret útvonalakat. | identity/main Prisma, reference manager service, secretCrypto, user integrations | B09, C11 | dual-read migration; encrypt/decrypt/key rotation; revoke; no log | DB migration | high |
| C13 | Illessze a cloud storage providereket egységes remote object store contracthoz ETag/conflict receipt-tel. | CloudStorageProvider, OAuth/WebDAV providers, cloud routes/client, local cloud folder | B08, C11 | SSRF redirects, ETag conflict, checksum, token refresh, large/resume behavior | additív adapter; provider UX változhat | medium |
| C14 | Promotálja csak a bizonyított export formátumokat stable-re; a többit jelölje previewként runtime capabilityből. | exporter descriptors, UI, docs, release metadata | C03–C05 | JATS/HTML/DOCX/PDF gates; DTP/EPUB/LaTeX smoke; capability UI | feature label változás | low |
| C15 | Hardenelje a webes kézbesítést és a lektorált/nem lektorált minősítést úgy, hogy a webhely ne váljon workflow-authority-vé; adjon külön DNS-hitelesített publication-venue autoritást domain-admin és szerkesztői szerepkörökkel. | web artifact service/UI, editorial decision és venue-authority service, identity/application Prisma migration, /api/v1/publications/web, venue authority API, WordPress/generic adapter, docs | C03–C05, C09–C11 | exact-revision/content evidence, DNS challenge/revalidation, domain-admin delegálás/utolsó admin védelme, editor grant/revoke/concurrency, hamis/hiányzó pecsét, anonimitás, approval grant, idempotency, timeout/retry/reconcile, accessibility, receiver contract | Preview protocol és DB bővítés | high |
C fázis blocker-ek: támogatott OJS/OMP verziókhoz nincs elérhető test image; fontlicenc nem engedi a reprodukálható bundle-t; JATS/profile követelmény nincs kijelölve; connector DTO owner nincs kijelölve.
6. Phase D — Platform hardening
Kilépési feltétel: minden stable platform ugyanazt a core/application suite-ot használja; platformadapter-contractok teljesülnek; teljesítmény és accessibility budget elfogadva.
| PR | Cél | Érintett modulok / várható fájlok | Előfeltétel | Kötelező teszt | Breaking-change kockázat | Technikai kockázat |
|---|---|---|---|---|---|---|
| D01 | Vezesse be a teljes platform port-készletet: picker/filesystem/secure storage/auth handoff/updater/fonts/share/notifications. | adapters/platform, jelenlegi services, Tauri/mobile config | B08, B10, C03 | contract fake + web/Tauri adapter tests; tiltott direct import lint | nincs külső, belső importváltás | high |
| D02 | Hardenelje a web file/session/recovery és PWA/browser capability fallbackokat. | browser adapter, IndexedDB, last-session, auth | D01 | Chrome/Firefox/WebKit open/edit/save/reopen; quota/denied permission/offline | nincs | medium |
| D03 | Hardenelje a Windows/Linux/macOS Tauri artifactot és frissítést. | Rust/Tauri capabilities, updater, installer workflows | D01 | install, open-with, atomic save, update/rollback, signed artifact; Win11/Ubuntu stable, mac scope szerint | installer/update behavior | high |
| D04 | Hardenelje Android SAF/auth/update/process-death viselkedést. | Android adapter/project, Tauri mobile bridge, release workflow | D01 | Android 10+ picker permission persistence, large file, process death, update | platform behavior | high |
| D05 | Fejezze be az iOS/iPadOS preview adaptereket, stable promotion nélkül. | Apple Files/Keychain/auth/share adapter, simulator/release workflow | D01 | simulator + device smoke; Files permission, background/resume, privacy | preview only | medium |
| D06 | Állítson be performance budgetet és javítsa a main chunk/editor/renderer lazy loadingot. | Vite config, routes/components, exporter imports, progressive mounting | B03, B05, C03 | 10k/120k/500k benchmark; heap/editor count; main chunk budget; no ineffective dynamic import | nincs, loading UX változhat | medium |
| D07 | Tegye release-blockinggá a kritikus accessibility journey-ket. | React UI/focus styles, Playwright axe, manual checklist | B03, D02 | keyboard-only create/edit/review/export; axe; screen-reader smoke; zoom/contrast | UI kisebb változás | medium |
| D08 | Formalizálja a stable/preview platform capability manifestet és runtime kijelzést. | version/release metadata, UI About/help, docs | D02–D07 | build artifact capability snapshot; docs/runtime equality | nincs | low |
7. Phase E — Release Candidate
Kilépési feltétel: ugyanazon commitból előállított 1.0.0-rc.1 artifactok; minden mandatory gate zöld; nincs P0/P1 adatvesztési/security/anonymity blocker; acceptance report aláírva.
| PR | Cél | Érintett modulok / várható fájlok | Előfeltétel | Kötelező teszt | Breaking-change kockázat | Technikai kockázat |
|---|---|---|---|---|---|---|
| E01 | Építsen közös hostile-input/security corpust és fuzz harness-t. | JSON/ZIP/XML/HTML/DOCX/assets/JATS parser tests; CI security jobs | A04, A07, C02, C10 | ZIP bomb/traversal/duplicate; XXE/entity; SVG/script; SSRF; malformed JSON; log redaction | nincs | high |
| E02 | Készítsen exact-commit RC aggregator workflow-t path filter nélkül. | .github/workflows/1.0-rc.yml, reusable workflows, evidence manifest | minden A–D gate | teljes matrix; artifact/SBOM/provenance hash; rerun policy | nincs | medium |
| E03 | Futtasson synthetic/public real-world acceptance corpust és zárt privát acceptance protokollt tartalomfeltöltés nélkül. | test corpus manifest, local-only acceptance script/report template | C14–C15, D08, E01 | format/platform journeys; private run csak content-free pass/fail/metrics reportot ad | nincs | medium |
| E04 | Zárja le az API/schema/container/connector compatibility baseline-t és generálja a release dokumentációt. | specs, OpenAPI/schema snapshots, changelog, support matrix, deprecation policy | E02, E03 | breaking-diff detector; docs links; fixture checksum | freeze után minden eltérés breaking | high |
| E05 | Készítse el és tesztelje 1.0.0-rc.1 artifactokat. | version files, release workflows, installers, plugin packages, website/schema artifacts | E02–E04 | mandatory gate-ek exact tag commiton; install/update/rollback; signatures | release candidate | high |
RC soak és exit
- Minimum egy teljes, előre rögzített soak időszak minden stable platformon.
- P0/P1 bug esetén új RC; nincs „waiver” adatvesztésre, credential leakre, anonymity breachre, schema corruptionre vagy signature mismatchre.
- P2 csak dokumentált workarounddal és ownerrel maradhat, ha nem érinti a stable contractot.
- Privát acceptance kézirat helyben marad; Git/CI-be csak content-free mérőszám és issue reproducerként synthetic minimal case kerülhet.
8. Phase F — 1.0
| PR | Cél | Érintett modulok / várható fájlok | Előfeltétel | Kötelező teszt | Breaking-change kockázat | Technikai kockázat |
|---|---|---|---|---|---|---|
| F01 | Promotálja a legutolsó változatlan RC commitot 1.0.0-ra. | release metadata/changelog/tags; nincs funkcionális kód | RC exit aláírva | artifact hash az RC-vel egyezik vagy indokolt rebuild reproducibility igazolt | nincs új break | low |
| F02 | Publikálja a support/deprecation/security response csatornákat és compatibility fixture csomagot. | docs/site/schema releases/plugin releases | F01 | public links/checksums/download install smoke | nincs | low |
| F03 | Nyissa meg az 1.0.x hardening milestone-t kizárólag kompatibilis változásokra. | GitHub milestones/issue templates | F01 | issue template policy | nincs | low |
Az 1.0.0 nem kaphat funkcionális javítást az utolsó RC-hez képest. Ha kód változik, új RC szükséges.
9. PR dependency register
| PR | Közvetlen függőség | Párhuzamosítható ezzel |
|---|---|---|
| A01 | — | — |
| A02 | A01 | A08, A09 |
| A03 | A02 | A06, A08, A09 |
| A04 | A03 | A06, A07 |
| A05 | A03, A04 | A07–A10 |
| A06 | A01 | A02–A05, A08–A10 |
| A07 | A02, A03 | A04–A06, A08–A10 |
| A08 | A01 | A02–A07, A09–A10 |
| A09 | A01 | A02–A08 |
| A10 | A03, A06, A09 | — |
| B01 | A10 | — |
| B02 | A04, A05, B01 | B09 |
| B03 | B01, B02 | B09, B10 |
| B04 | B03 | B05, B09–B11 |
| B05 | A06, B01 | B09–B11 |
| B06 | A05, B05 | B09–B11 |
| B07 | B01, B06 | B09–B11 |
| B08 | B02, B07 | B09–B12 |
| B09 | A09 | B02–B08 |
| B10 | B01 | B03–B09 |
| B11 | B09 | B03–B08, B10 |
| B12 | B05, B06 | B07–B11 |
| B13 | A10, B03 | B04–B12 |
| C01 | A08, B01, B06 | C06 |
| C02 | C01 | C03, C06 |
| C03 | A08, B05, B06 | C01, C06 |
| C04 | C03 | C01–C02, C06 |
| C05 | C04 | C06–C08 |
| C06 | A08, A09 | C01–C05 |
| C07 | C06 | C08, C10 |
| C08 | C06 | C07, C10 |
| C09 | C07, C08, B09 | C10–C15 |
| C10 | B11, C06 | C07–C09 |
| C11 | B09, B11, A09 | C07–C10 |
| C12 | B09, C11 | C09–C10, C13–C15 |
| C13 | B08, C11 | C09–C12, C14–C15 |
| C14 | C03–C05 | C09–C13, C15 |
| C15 | C03–C05, C09–C11 | C12–C14 |
| D01 | B08, B10, C03 | — |
| D02–D05 | D01 | egymással |
| D06 | B03, B05, C03 | D02–D05, D07 |
| D07 | B03, D02 | D03–D06 |
| D08 | D02–D07 | — |
| E01 | A04, A07, C02, C10 | D fázis |
| E02 | A–D fázis gate-jei | E01, E03 előkészítése |
| E03 | C14–C15, D08, E01 | E02 |
| E04 | E02, E03 | — |
| E05 | E02–E04 | — |
| F01 | RC exit | — |
10. Nagyobb refaktorok indoklása
| Refaktor | Miért nem elég kisebb módosítás? | Miért nem teljes újraírás? |
|---|---|---|
| Tiptap ↔ OMI content boundary | Sok független consumer közvetlenül parse-olja ugyanazt a stringet; egy exporter javítása nem hoz lossless formátumot. | A Tiptap extensionök, editor UI és parsing logika megmarad; codec mögé kerülnek. |
| Zustand/application split | A globális store ownershipja miatt a platformfüggetlen use-case önmagában nem tesztelhető és a timer/persistence/UI együtt mozog. | A jelenlegi action behavior characterization után egyesével delegálható; UI selectorok maradnak. |
| History repository | A full snapshot minden revisionben skálázási gond, de előbb mérést és storage boundaryt igényel. | A revision semantics, IDs, revert és integrity megtartható; csak tároló cserélhető. |
| Identity authority | Két schema ugyanazt a user/session/identity fogalmat hordozza; ad hoc javítás újabb driftet hoz. | Az identity DB és a bridge működik; projection/outbox és fokozatos migration kell, nem új auth rendszer. |
| Connector common API | OJS/OMP capability-k párhuzamos DTO-i később minden új rendszerrel sokszorozódnának. | A két plugin és kliens megmarad adapterként; csak közös contract mögé kerül. |
| Review projection | Anonimitás security boundary, ezért UI field hide nem elég. | A meglévő szerveroldali allowlist/sanitizer a kiindulás; corpus és versioned projection erősíti. |
11. Rollback stratégia
- Schema/open: A03 shadow validator rollbackelhető; A04 után a régi parser csak explicit legacy-importként marad. Már új formátumba mentett dokumentumot nem downgrade-elünk automatikusan.
- Content AST: B05 még változatlan wire outputot ad. B06 aktiválásakor a writer versiont vált; rollback esetén az új fájl read-only/recovery, nem régi writerrel overwrite.
- Store: compatibility selector/action facade tartja a UI-t; slice-onként kapcsolható vissza.
- DB/identity: expand–migrate–contract séma; először nullable/additive mező, dual-read és reconcile, csak később drop. Minden migrationhez tested down/restore eljárás.
- Connector/outbox: connector adapter feature flaggel váltható, de az outbox eventet nem szabad elveszíteni; rollback worker ismeri mindkét payload verziót.
- Platform: adapter selection composition rootban; régi adapter csak addig marad, amíg ugyanazt a security policyt teljesíti.
12. Milestone-javaslat
| Milestone | Tartalom | Exit artifact |
|---|---|---|
1.0-architecture-freeze | A01–A10 | accepted ADR-k, pinned schema/container/content/API candidates |
1.0-core-boundaries | B01–B13 | app facade, portable content, persistence/history/identity boundaries |
1.0-interoperability | C01–C15 | common import/render/connector/review/web-assurance contracts és evidence |
1.0-platform-hardening | D01–D08 | stable platform matrix és budgets |
1.0-rc.1 | E01–E05 | signed exact-commit RC artifact + evidence manifest |
1.0.0 | F01–F03 | változatlanul promotált RC, public compatibility/support policy |
13. Minimális issue-sablon minden PR-hoz
- Contract/ADR hivatkozás.
- Előtte–utána dependency boundary.
- Megtartott jelenlegi viselkedés és szándékos változás.
- Érintett stable/preview capability.
- Synthetic/public fixture linkje.
- Rollback feltétel és adatkompatibilitási megjegyzés.
- Teszt evidence, performance/security hatás.
- Dokumentáció/spec eltérés, amelyet a PR lezár vagy nyitva hagy.
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.
Függőséghelyes integrációjavítás — 2026-10-18
- C16a — perzisztencia, high: additív EuroOfficeSave és RecognitionExecution migráció; session baseRevision; régi sessionök lejáratása. Telepítés előtt az aktív szerkesztőket le kell zárni. Szintetikus PostgreSQL-migráció, párhuzamos CAS/receipt és accounttörlési teszt kötelező.
- C16b — service és parser, medium: a működő editor-config és felismerési kliens megőrzése, EuroOffice use-case-ek leválasztása; streamelt DOCX/ZIP/XML-korlátok. Részmentés helyreállítási pillanatkép, végleges head csak revision-feltétellel. Előfeltétel C16a; owner-only recovery és hostile-input tesztek blokkolnak.
- C16c — contractok és intent, medium: v1 előbb, majd kliensek; legacy adapterek; közös platformtransport; fizetős POST előtt intent, bizonytalan kimenetel megőrzése. Előfeltétel C16a/b; replay, payloadütközés, grantlejárat, accountizoláció és token/originváltás tesztelendő.
- C16d — elfogadás, high: valódi EuroOffice részmentés/lezárás/reopen/crash és Transkribus megszakított beküldés/egyeztetés, Android/web és tulajdonosi recovery. Preview-promóció csak bizonyíték után; külső exactly-once számlázás nem ígérhető.
A közösen telepítendő sémát és szolgáltatásváltást koordinált PR külön commitjaiként lehet vizsgálni. Rollback előtt az EuroOffice és a fizetős Transkribus-végrehajtás letiltása és az aktív szerkesztők lezárása szükséges: a régi kód nem ír kötött sessionmezőket és nem tartja tiszteletben az intentnaplót. Az új táblák és a megőrzött mentések/ismeretlen intentek nem törölhetők; újraengedélyezés csak sématudatos, biztonságos API-val. OMI-formátummigráció nincs. Az RC-aggregátor továbbra is E02.
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.
| PR | Goal / files | Dependency | Tests | Phase / risk |
|---|---|---|---|---|
| C17a | Add registry proof/expiry migration, conditional repository and service; shared v1/legacy routes; CLI/client update | A09, existing registry | negative proof, replay, concurrency, PostgreSQL migration/lifecycle | C / high |
| C17b | ADR-026 and five baseline documents; website v1 read and heartbeat wording | C17a API deployed before website | EN/HU docs and site builds; operator acceptance | C / medium |
| C17c | Controlled DNS/GitHub acceptance and quarantine/lost-response recovery rehearsal | C17a–b | recorded synthetic instance, revoke, audit timeout and outage | E blocker before Stable / 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ú.