Skip to content

feat: read-only archival metadata from the storage layer (D3 proof of concept) - #1

Merged
rubenvdlinde merged 1 commit into
developmentfrom
feature/initial-app
Nov 16, 2026
Merged

rubenvdlinde merged 1 commit into
developmentfrom
feature/initial-app

Conversation

@rubenvdlinde

Copy link
Copy Markdown
Contributor

First version of archiefmeta: a read-only "Archive" tab in the Files sidebar that shows MDTO fields (classificatie, bewaartermijn, zorgdrager, identificatie) from the storage layer, each with its source and read time.

Design: sources behind IMetadataSource (S3 Object Lock + legal hold, S3 user metadata and tags, administrator via occ, Nextcloud file ID fallback). Values stored as core file metadata with EDIT_FORBIDDEN behind IMetadataStore, so the move to the Nextcloud 36 schema API (nextcloud/server#66355) is one class. See docs/architecture.md.

Verified locally

  • COMPOSER_PROCESS_TIMEOUT=0 composer check: php -l, php-cs-fixer (nextcloud/coding-standard) 0 issues, PHPStan level 8 no errors, PHPUnit 54 tests / 233 assertions OK. Exit 0.
  • npm run lint (eslint, @nextcloud/eslint-config) exit 0, npm run build OK.
  • composer audit: no advisories. npm audit: 24 low/moderate, all transitive (webdav, minimatch, eslint and vite plugins).
  • tests/Integration/live-test.sh on the vng-ol instance (Nextcloud 34.0.0.12, S3 primary storage with Object Lock GOVERNANCE 1d, external S3 mount): 25 passed, 0 failed. Evidence in docs/integration-evidence.md.
    • Object Lock retention appears on upload with source s3-object-lock; tags, metadata and legal hold appear after refresh.
    • PROPPATCH on nc:metadata-archiefmeta-* refused for owner and for a share recipient with edit rights: HTTP 500, FilesMetadataException: you do not have enough rights to update 'archiefmeta-classificatie' on this node. Stored values unchanged afterwards.
    • App API: GET 200 for a share recipient, 404 for a file the user cannot access, POST/PUT/PATCH/DELETE 405.
  • Sidebar tab checked in a browser (English, Dutch, empty state, keyboard selection). Screenshots in docs/screenshots/.

No CI is configured on this repository yet.

Known limits

🤖 Generated with Claude Code

Adds the archiefmeta app: a read-only "Archive" tab in the Files sidebar
with the MDTO fields classificatie, bewaartermijn, zorgdrager and
identificatie. Each value carries its source and read time.

- Sources behind IMetadataSource: S3 Object Lock retention and legal hold,
  S3 user metadata and tags (mdto-*), administrator values set with occ,
  and the Nextcloud file ID as a visibly non-durable fallback.
- Values stored as core file metadata with EDIT_FORBIDDEN behind
  IMetadataStore, so a later switch to the schema API is one class.
- Refresh on write, copy and move, and through occ archiefmeta:refresh.
- Read-only OCS endpoint; no write endpoint.
- PHPUnit unit tests, live integration test script, demo script,
  English and Dutch strings.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant