How riyadhami13/vaultdocs-ai works
VaultDocs AI is a local-first contract risk screening app. A user uploads a PDF, the app extracts page text and splits it into chunks, retrieves clauses for a chosen audit focus, and uses a local Ollama model to produce structured findings. Citations are checked against extracted text; the UI presents results and offers a downloadable Markdown report. The sampled code shows PDF ingestion and retrieval calls; some UI-to-validation and report wiring is supported only by the README, so unsampled links are omitted or marked unverified.
Main entry points: app.py Audit Orchestrator · report_generator.py Markdown Report Generator · schemas.py Audit Report Schema · citation_validator.py Citation Validator
Components 12
User Interface
- Audit Dashboard
app.py - Document Viewer
app.py - Results Screen
app.py
Document Ingestion
- PDF Text Extractor
services/pdf_parser.py - Clause Chunker
services/clause_splitter.py
Risk Screening
- Clause Retrieval
services/retriever.py - Audit Orchestrator
app.py - Local Ollama Model
Validation and Reports
- Audit Report Schema
models/schemas.py - Citation Validator
services/citation_validator.py - Markdown Report Generator
reports/report_generator.py
Other components
- Contract Reviewer
Connections 14
- Contract Reviewer → Audit Dashboard: uploads PDF
README.md - Audit Dashboard → PDF Text Extractor: extracts pages
app.py - Audit Dashboard → Clause Chunker: chunks text
app.py - Audit Dashboard → Document Viewer: renders pages
app.py - Contract Reviewer → Audit Orchestrator: starts audit
app.py - Audit Orchestrator → Clause Retrieval: ranks chunks
app.py - Audit Orchestrator → Local Ollama Model: requests analysis
README.md - Audit Orchestrator → Audit Report Schema: validates findings
README.md - Audit Orchestrator → Citation Validator: checks citations
README.md - Audit Orchestrator → Results Screen: shows results
app.py - Results Screen → Document Viewer: navigates excerpts
app.py - Results Screen → Markdown Report Generator: offers download
README.md - Markdown Report Generator → Audit Report Schema: formats findings
reports/report_generator.py - Markdown Report Generator → Citation Validator: formats status
reports/report_generator.py