How ahmedmontaser123/flow_wise_platform works
FlowWise is a recruitment backend whose implemented user workflow accepts and validates project-organized CV uploads, then supports PDF text extraction and schema-validated LLM extraction. Its README also describes repository-backed recruitment data management. The graph preserves those domain stages and the documented API, storage, and database layers. Some matching, workflow, and analytics capabilities are explicitly planned, not implemented; source excerpts do not establish all runtime wiring, so uncertain links are omitted.
Main entry points: process_controller.py PDF extraction · LLMProviderFactory.py Provider factory · repositories Entity repositories · main.py FastAPI app
Components 17
API and CV intake
- FastAPI app
src/main.py - CV routes
src/routes/cv_router.py - CV validation
src/controllers/cv_controller.py
CV processing
- Project file storage
src/controllers/project_controller.py - PDF extraction
src/controllers/process_controller.py - Parsed CV schema
src/schema/cv_parsed_schema.py - JSON extraction
src/helpers/json_utils.py
LLM integration
- Provider factory
src/stores/LLM/LLMProviderFactory.py - Generation interface
src/stores/LLM/LLMInterface.py - Cohere provider
src/stores/LLM/providers/CohereProvider.py - Groq provider
src/stores/LLM/providers/GroqProvider.py - HuggingFace provider
src/stores/LLM/providers/HuggingFaceProvider.py
Recruitment data
- Entity repositories
src/repositories - Recruitment models
src/models/db/flow_wise/schema - PostgreSQL database
src/models/db/connection_database.py - API data schemas
src/schema
Other components
- HR client
Connections 15
- HR client → FastAPI app: sends request
- FastAPI app → CV routes: registers routes
src/main.py - CV routes → CV validation: dispatches upload
src/routes/cv_router.py - CV validation → Project file storage: gets project path
src/controllers/cv_controller.py - PDF extraction → Project file storage: resolves project files
src/controllers/process_controller.py - PDF extraction → JSON extraction: extracts JSON
src/controllers/process_controller.py - PDF extraction → Parsed CV schema: validates parsed data
src/controllers/process_controller.py - PDF extraction → Generation interface: calls generation methods
src/controllers/process_controller.py - FastAPI app → Provider factory: creates provider factory
src/main.py - Provider factory → Cohere provider: selects provider
src/stores/LLM/LLMProviderFactory.py - Provider factory → Groq provider: selects provider
src/stores/LLM/LLMProviderFactory.py - Provider factory → HuggingFace provider: selects provider
src/stores/LLM/LLMProviderFactory.py - Entity repositories → PostgreSQL database: persists entities
- Entity repositories → Recruitment models: uses models
src/repositories/candidate_repository.py - Entity repositories → API data schemas: uses API schemas
src/repositories/candidate_repository.py