mirror of
https://github.com/pewdiepie-archdaemon/odysseus.git
synced 2026-08-07 14:08:43 -04:00
Alexandre Teixeira
3.9 KiB
3.9 KiB
Document
Features in this document are generated from ../feature-catalog.json, the canonical inventory.
DOCUMENT-001 — Document & Canvas Artifact Management
- Domain:
document - Status:
verified - Evidence Maturity:
E0 - Commit Verified:
d8a2059df8e53bc7275c45339849d14c8651e73c - Runtime Validation: not-required — No separate environment-dependent runtime validation was identified during this documentation pass.
Purpose
Renders dynamic canvas documents, handles live editing, markdown preview, and side-by-side artifact display.
Evidence summary
routes/document_routes.py—setup_document_routes— Registers document artifact CRUD routes.static/js/document.js—initDocumentView— Renders interactive canvas document panel.
Unknowns
- Concurrent edits on the same document artifact.
DOCUMENT-002 — PDF Form Processing & High-Fidelity Rendering
- Domain:
document - Status:
verified - Evidence Maturity:
E1 - Commit Verified:
d8a2059df8e53bc7275c45339849d14c8651e73c - Runtime Validation: pending — Requires optional PyMuPDF (
fitz) or pypdf runtime dependency.
Purpose
Extracts form fields from PDF files, fills dynamic values, and generates PDF previews.
Evidence summary
src/pdf_runtime.py—load_pymupdf_for_pdf_viewer— Loads optional PyMuPDF runtime for PDF viewing.src/pdf_forms.py—extract_form_fields— Handles PDF form field extraction and filling.tests/test_document_pdf_marker.py—test_marker_removed_without_eating_following_text— Tests PDF text extraction wrapper stripping without content corruption.
Unknowns
- Complex XFA PDF forms may not extract cleanly with standard pdf parsers.
DOCUMENT-003 — Personal Document Indexing & RAG Retrieval
- Domain:
document - Status:
verified - Evidence Maturity:
E0 - Commit Verified:
d8a2059df8e53bc7275c45339849d14c8651e73c - Runtime Validation: not-required — No separate environment-dependent runtime validation was identified during this documentation pass.
Purpose
Indexes local user documents (PDF, DOCX, TXT) into ChromaDB for semantic vector retrieval.
Evidence summary
routes/personal_routes.py—setup_personal_routes— Personal document RAG indexing and search API endpoints.src/personal_docs.py—PersonalDocsManager— Handles file text chunking and vector storage.
Unknowns
- Slow vector embedding indexing step for massive multi-thousand page documents.
DOCUMENT-004 — Document Conversion & Text Extraction Engine
- Domain:
document - Status:
verified - Evidence Maturity:
E0 - Commit Verified:
d8a2059df8e53bc7275c45339849d14c8651e73c - Runtime Validation: not-required — No separate environment-dependent runtime validation was identified during this documentation pass.
Purpose
Converts office formats (.docx, .xlsx, .pptx) and HTML into clean Markdown text representations.
Evidence summary
src/markitdown_runtime.py—convert_to_markdown— Converts binary office documents into structured Markdown text.
Unknowns
- Formatting loss when parsing legacy binary doc/xls files.
DOCUMENT-005 — Document Library UI Navigation
- Domain:
document - Status:
verified - Evidence Maturity:
E0 - Commit Verified:
d8a2059df8e53bc7275c45339849d14c8651e73c - Runtime Validation: not-required — No separate environment-dependent runtime validation was identified during this documentation pass.
Purpose
Provides dedicated UI view for browsing, filtering, and organizing saved user documents.
Evidence summary
static/js/documentLibrary.js—initDocumentLibrary— Renders document library navigation grid.app.py—serve_library— Serves SPA shell for /library route.
Unknowns
- Large folder trees may cause initial DOM render slowdown.