How kamranzafar/docman-ai works
Docman AI is a document-management and RAG application. Its main flow accepts a document through the REST API, records metadata and stores file content, then starts a durable Temporal ingestion workflow that extracts, embeds, and indexes content. After indexing, summary and classification run asynchronously; search provides metadata, vector, and hybrid retrieval. The map also includes revision storage, Kafka-based index-metadata synchronization, and MCP agent access. Several internal implementations were not sampled, so README-documented relationships are cited rather than presented as inspected call paths.
Main entry points: DocumentController.java REST controller · DocumentServiceImpl.java Document service · DocumentMcpTools.java MCP tools · DocumentWorkflowImpl.java Ingestion workflow
Components 22
API and agent access
- REST controller
docman-api/src/main/java/org/kamranzafar/docman/api/DocumentController.java - MCP tools
docman-mcp-server/src/main/java/org/kamranzafar/docman/mcp/DocumentMcpTools.java
Document lifecycle
- Workflow manager
docman-workflow/src/main/java/org/kamranzafar/docman/wf/DocumentWorkflowManager.java - Document service
docman-service/src/main/java/org/kamranzafar/docman/service/impl/DocumentServiceImpl.java - Document metadata
docman-domain/src/main/java/org/kamranzafar/docman/model/Document.java
Ingestion and AI
- Ingestion workflow
docman-workflow/src/main/java/org/kamranzafar/docman/wf/impl/DocumentWorkflowImpl.java - Workflow activities
docman-workflow/src/main/java/org/kamranzafar/docman/wf/impl/DocumentActivitiesImpl.java - Index service
docman-service/src/main/java/org/kamranzafar/docman/service/impl/DocumentIndexServiceImpl.java - AI summarization
docman-service/src/main/java/org/kamranzafar/docman/service/impl/DocumentSummaryServiceImpl.java - AI classification
docman-service/src/main/java/org/kamranzafar/docman/service/impl/DocumentClassificationServiceImpl.java
Search and retrieval
- Search service
docman-service/src/main/java/org/kamranzafar/docman/service/impl/DocumentSearchServiceImpl.java
Storage and events
- Revision history
docman-persistence/src/main/java/org/kamranzafar/docman/repository/DocumentRevisionRepository.java - Object storage
docman-service/src/main/java/org/kamranzafar/docman/service/impl/ObjectStoreServiceImpl.java - Vector store
docman-vector-opensearch/src/main/java/org/kamranzafar/docman/vectorstore/opensearch/OpenSearchDocumentVectorStore.java - Metadata repository
docman-persistence/src/main/java/org/kamranzafar/docman/repository/DocumentMetadataRepository.java - Kafka event bus
- Index sync consumer
docman-api/src/main/java/org/kamranzafar/docman/service/DocumentIndexSyncConsumer.java
Other components
- API client
- AI agent
- Temporal service
- MinIO
- OpenSearch
Connections 27
- API client → REST controller: calls API
README.md - REST controller → Document service: manages metadata
docman-api/src/main/java/org/kamranzafar/docman/api/DocumentController.java - REST controller → Object storage: uploads content
docman-api/src/main/java/org/kamranzafar/docman/api/DocumentController.java - REST controller → Workflow manager: starts workflow
docman-api/src/main/java/org/kamranzafar/docman/api/DocumentController.java - REST controller → Search service: dispatches searches
docman-api/src/main/java/org/kamranzafar/docman/api/DocumentController.java - AI agent → MCP tools: uses tools
README.md - MCP tools → Search service: queries retrieval
docman-mcp-server/src/main/java/org/kamranzafar/docman/mcp/DocumentMcpTools.java - MCP tools → Document service: looks up documents
docman-mcp-server/src/main/java/org/kamranzafar/docman/mcp/DocumentMcpTools.java - MCP tools → Object storage: gets download links
docman-mcp-server/src/main/java/org/kamranzafar/docman/mcp/DocumentMcpTools.java - Document service → Metadata repository: persists metadata
docman-service/src/main/java/org/kamranzafar/docman/service/impl/DocumentServiceImpl.java - Document service → Revision history: records revisions
docman-service/src/main/java/org/kamranzafar/docman/service/impl/DocumentServiceImpl.java - Workflow manager → Temporal service: starts execution
docman-workflow/src/main/java/org/kamranzafar/docman/wf/DocumentWorkflowManager.java - Temporal service → Ingestion workflow: runs workflow
README.md - Ingestion workflow → Workflow activities: runs activities
README.md - Workflow activities → Object storage: reads file
README.md - Workflow activities → Index service: indexes content
README.md - Index service → Vector store: writes chunks
README.md - Vector store → OpenSearch: stores vectors
docman-vector-opensearch/src/main/java/org/kamranzafar/docman/vectorstore/opensearch/OpenSearchDocumentVectorStore.java - Ingestion workflow → AI summarization: runs after indexing
README.md - Ingestion workflow → AI classification: runs after indexing
README.md - AI summarization → Kafka event bus: publishes result
README.md - AI classification → Kafka event bus: publishes result
README.md - Document service → Kafka event bus: publishes metadata changes
README.md - Kafka event bus → Index sync consumer: delivers updates
README.md - Index sync consumer → Vector store: patches chunk metadata
README.md - Search service → Vector store: runs vector retrieval
docman-service/src/main/java/org/kamranzafar/docman/service/impl/DocumentSearchServiceImpl.java - Search service → OpenSearch: runs lexical retrieval
README.md