Initial curated itworx-knowledge-hub source from 3b1751d0d9dee551aa6994eee0093704dc334817

docs/00-product-vision.md

@@ -0,0 +1,74 @@
+# Product vision
+
+## Product
+
+**ItWorx Knowledge Hub** is a self-hosted knowledge, documentation and project
+intelligence platform for one owner and trusted collaborators.
+
+It replaces the user's current LeafWiki workflow and becomes the durable home for:
+
+- school notes and course material;
+- certification notes;
+- technical reference documentation;
+- infrastructure documentation;
+- troubleshooting knowledge;
+- operational runbooks;
+- project dossiers, decisions and progress;
+- imported attachments and supporting files.
+
+## Problem
+
+The current knowledge is primarily wiki-shaped, while project knowledge is spread across
+repositories, status notes, deployment details and personal memory. A conventional wiki
+can store those texts, but it does not provide enough structure to answer questions such
+as:
+
+- What is the current verified state of a project?
+- Why was an architectural decision made?
+- Which runbook was last validated?
+- Which documents refer to an outdated system?
+- What changed since a previous project milestone?
+- Which content came from the legacy LeafWiki import?
+
+The new platform must preserve the speed and durability of Markdown while making project
+and operational knowledge explicit, searchable and auditable.
+
+## Vision statement
+
+> A private, reliable and recoverable knowledge hub that combines a fast technical wiki
+> with structured project intelligence, and that can later serve external tools through
+> a secure API without depending on those tools.
+
+## Product principles
+
+1. **Knowledge remains useful without AI.**
+2. **Markdown remains portable and readable.**
+3. **Structure is added where it creates real retrieval value.**
+4. **User data is never silently overwritten or discarded.**
+5. **Imports, revisions and backups are reversible and verifiable.**
+6. **Search respects permissions at every layer.**
+7. **The UI optimizes reading, writing and retrieval—not decoration.**
+8. **The first production topology stays operationally simple.**
+9. **External automation uses stable contracts and least privilege.**
+10. **A future MCP server remains an independent service.**
+
+## Primary success outcomes
+
+- The owner can migrate representative LeafWiki content without source modification or
+  lost pages, links and attachments.
+- School and project documentation can be found in seconds.
+- Projects have one reliable current-state view and a traceable history.
+- Accidental edits and deletions can be recovered.
+- A complete backup can be restored into a clean environment.
+- The system runs predictably on Unraid.
+- A separate future MCP service can retrieve compact, permission-filtered context without
+  scraping the UI or reading the database directly.
+
+## Product identity
+
+- Product name: **ItWorx Knowledge Hub**
+- Primary language: Dutch (`nl-BE`)
+- Technical identifiers and API field names: English
+- Suggested hostname: `knowledge.example.com` (replace it with an operator-controlled
+  HTTPS hostname when configuring the reverse proxy).
+- Default local host port: `1240`