How pendeks/software-engineering-project works
DocuMind is the active product: a workspace-scoped document intelligence service with a React interface, asynchronous document processing, and cited RAG answers. Users create workspaces, upload documents, wait for processing, then ask questions and receive answers with citations. The graph also includes the documented FlowDesk product as a separate implemented portfolio project; DeployFlow has no runtime source in the supplied tree. Source excerpts are partial, so some subsystem boundaries are represented only where the source index or README supports them.
Main entry points: api.py REST API · processing.py Document processing · worker.py Job worker · embeddings.py Embedding provider
Components 19
DocuMind interface
- DocuMind app
documind/web/src/App.tsx - API client
documind/web/src/api.ts
DocuMind service
- REST API
documind/src/documind/api.py - Settings
documind/src/documind/config.py - Upload validation
documind/src/documind/document_validation.py
Document pipeline
- Job worker
documind/src/documind/worker.py - Document processing
documind/src/documind/processing.py - Embedding provider
documind/src/documind/embeddings.py - Answer generation
documind/src/documind/answering.py - Source retrieval
documind/src/documind/retrieval.py
Persistence
- Domain models
documind/src/documind/models.py - Database setup
documind/src/documind/database.py - Local file storage
documind/src/documind/storage.py - SQL database
- Local filesystem
FlowDesk
- FlowDesk platform
flowdesk/src/server.ts
Other components
- Workspace user
- Azure OpenAI
- FlowDesk user
Connections 29
- Workspace user → DocuMind app: uses
documind/web/src/App.tsx - DocuMind app → API client: requests
documind/web/src/App.tsx - API client → REST API: calls
- REST API → Settings: loads
documind/src/documind/api.py - REST API → Database setup: creates sessions
documind/src/documind/api.py - REST API → Upload validation: validates uploads
documind/src/documind/api.py - REST API → Local file storage: stores files
documind/src/documind/api.py - REST API → Domain models: persists metadata
documind/src/documind/api.py - REST API → Answer generation: answers questions
documind/src/documind/api.py - REST API → Embedding provider: embeds questions
documind/src/documind/api.py - REST API → Document processing: queues jobs
documind/src/documind/api.py - Job worker → Settings: loads
documind/src/documind/worker.py - Job worker → Database setup: initializes
documind/src/documind/worker.py - Job worker → Document processing: processes jobs
documind/src/documind/worker.py - Job worker → Local file storage: provides storage
documind/src/documind/worker.py - Job worker → Embedding provider: provides embeddings
documind/src/documind/worker.py - Document processing → Local file storage: reads documents
documind/src/documind/processing.py - Document processing → Embedding provider: embeds chunks
documind/src/documind/embeddings.py - Document processing → Domain models: writes chunks
documind/src/documind/processing.py - Document processing → Upload validation: extracts validated content
documind/src/documind/processing.py - Answer generation → Source retrieval: retrieves sources
documind/src/documind/answering.py - Answer generation → Embedding provider: embeds question
documind/src/documind/answering.py - Answer generation → Azure OpenAI: generates answer
documind/src/documind/answering.py - Embedding provider → Azure OpenAI: requests vectors
documind/src/documind/embeddings.py - Source retrieval → Domain models: queries chunks
documind/src/documind/retrieval.py - Domain models → Database setup: uses base
documind/src/documind/models.py - Database setup → SQL database: initializes
documind/src/documind/database.py - Local file storage → Local filesystem: reads and writes
documind/src/documind/storage.py - FlowDesk user → FlowDesk platform: uses
README.md