QA: vault-import e2e pack and documentation #119

New Issue

fable-5 · 2026-07-14T16:36:41+02:00

fable-5 commented

2026-07-14 16:36:41 +02:00

Context

The milestone's quality gate: an end-to-end proof over the real fixture vault in CI, plus documentation of the resolution rules users will ask about.

Scope

Playwright pack apps/web/e2e/import-vault.spec.ts (own CI step): build the fixture vault into a ZIP in a helper; as pond admin import it under a parent page with an extra label; assert the sidebar tree structure, a rewritten wikilink navigates to the right page, nested tag labels exist, an image renders, the frontmatter mode is honored; a non-admin does not see the section; the failure path (invalid zip) surfaces the translated error.
Cover the #115 create-from-404 flow here if it did not land with its own spec.
Docs (en + docs/de mirror): vault import guide — supported link forms, the duplicate-basename rule (lexicographically first path), depth-merge behavior, tag→label mapping, limits (64 MiB ZIP / 256 MiB unpacked), all-or-nothing semantics; a pointer from the pond-admin guide.

Acceptance criteria

Pack green in CI and 3× flake-free locally.
Docs describe the rules above; features.md gets its bullet.

Technical notes

apps/web/e2e/helpers.ts, apps/web/e2e/import.spec.ts and page-tree.spec.ts as patterns, .gitea/workflows/ci.yml (chained pack steps + rate-limit reset), docs/manual/pond-admin-guide.md, docs/features.md.

Dependencies

Requires #115, #117, #118.

Size

~1 day.

## Context The milestone's quality gate: an end-to-end proof over the real fixture vault in CI, plus documentation of the resolution rules users will ask about. ## Scope - Playwright pack `apps/web/e2e/import-vault.spec.ts` (own CI step): build the fixture vault into a ZIP in a helper; as pond admin import it under a parent page with an extra label; assert the sidebar tree structure, a rewritten wikilink navigates to the right page, nested tag labels exist, an image renders, the frontmatter mode is honored; a non-admin does not see the section; the failure path (invalid zip) surfaces the translated error. - Cover the #115 create-from-404 flow here if it did not land with its own spec. - Docs (en + docs/de mirror): vault import guide — supported link forms, the duplicate-basename rule (lexicographically first path), depth-merge behavior, tag→label mapping, limits (64 MiB ZIP / 256 MiB unpacked), all-or-nothing semantics; a pointer from the pond-admin guide. ## Acceptance criteria - [ ] Pack green in CI and 3× flake-free locally. - [ ] Docs describe the rules above; features.md gets its bullet. ## Technical notes `apps/web/e2e/helpers.ts`, `apps/web/e2e/import.spec.ts` and `page-tree.spec.ts` as patterns, `.gitea/workflows/ci.yml` (chained pack steps + rate-limit reset), `docs/manual/pond-admin-guide.md`, `docs/features.md`. ## Dependencies Requires #115, #117, #118. ## Size ~1 day.

fable-5 added this to the M13 — Create-from-link & Obsidian import milestone 2026-07-14 16:36:41 +02:00

fable-5 added the

docs

qa

labels 2026-07-14 16:36:41 +02:00

fable-5 referenced this issue from a commit

2026-07-14 16:45:29 +02:00

Offer creating the page on the not-found screen (#115)

fable-5 referenced this issue from a commit

2026-07-14 18:26:28 +02:00

Vault import dialog in the pond settings (#118)

fable-5 referenced this issue from a commit

2026-07-14 18:28:47 +02:00

QA: wire the M13 packs into CI, document the vault import (#119)

fable-5 referenced this issue

2026-07-14 18:40:36 +02:00

Offer creating the page on the page-not-found screen #115

fable-5 commented

2026-07-14 18:40:38 +02:00

Implemented in 2d51a55. Both new packs run in CI after the graph pack (each preceded by the login rate-limit reset): create-missing-page.spec.ts and import-vault.spec.ts. The pond-admin guide gained a full vault-import chapter (the three dialog choices; what happens to folders, links incl. the duplicate-name rule, tags, images, embeds; the limits; all-or-nothing), the user guide explains following a link to a page that does not exist yet, and features.md carries both bullets — German mirrors updated throughout.

Implemented in 2d51a55. Both new packs run in CI after the graph pack (each preceded by the login rate-limit reset): `create-missing-page.spec.ts` and `import-vault.spec.ts`. The pond-admin guide gained a full vault-import chapter (the three dialog choices; what happens to folders, links incl. the duplicate-name rule, tags, images, embeds; the limits; all-or-nothing), the user guide explains following a link to a page that does not exist yet, and features.md carries both bullets — German mirrors updated throughout.

fable-5 closed this issue

2026-07-14 18:40:38 +02:00

Sign in to join this conversation.