How mohammedalhashmi182-collab/al-narjs-ai works
Al-Narjis AI is an Arabic-first AI-agent platform with a public site, customer portal, agent services, and card checkout. The main user journey is discovering a plan or agent, using the portal to engage the platform, and paying for a plan; owners also manage leads and run workflow, schedule, and queue automation. The map preserves documented voice, document-generation, knowledge retrieval, and integration capabilities. Some connections rely on README descriptions or source-index references; unsampled implementation details are not asserted.
Main entry points: main.py Application and public site · workflow_engine.py Workflow engine · session.py Application database · sales_routes.py Sales dashboard
Components 22
User experience
- Application and public site
src/main.py - Customer portal
src/interfaces/portal_routes.py - Agent pages
src/services/agent_pages.py
Agent platform
- Plans and agent roster
src/services/catalog.py - Agent registry
src/core/agent_registry.py - Model provider
src/core/model_provider.py - Prompt engine
src/core/prompt_engine.py - Knowledge retrieval
src/ai/rag.py - Voice advisor
src/services/voice_live.py
Automation and sales
- Workflow engine
src/automation/workflow_engine.py - Schedule service
src/automation/scheduler.py - Queue worker
src/automation/queue_worker.py - AI CEO
src/automation/ceo_engine.py - Sales dashboard
src/interfaces/sales_routes.py - Lead pipeline
src/services/lead_pipeline.py
Commerce and integrations
- Payments
src/services/payments.py - Store integrations
src/integrations/routes.py - Document generation
src/services/docgen/pipeline.py
Data and knowledge
- Application database
src/db/session.py - Domain models
src/models/__init__.py
Other components
- Visitor / customer
- Platform owner
Connections 27
- Visitor / customer → Application and public site: browses site
README.md - Visitor / customer → Customer portal: uses portal
README.md - Platform owner → Sales dashboard: manages leads
src/interfaces/sales_routes.py - Application and public site → Plans and agent roster: reads plans
src/main.py - Application and public site → Agent registry: uses registry
src/main.py - Agent pages → Plans and agent roster: reads roster
- Workflow engine → Agent registry: gets agents
src/automation/workflow_engine.py - Workflow engine → Prompt engine: renders prompts
src/automation/workflow_engine.py - Workflow engine → Model provider: requests completion
src/automation/workflow_engine.py - Workflow engine → Queue worker: runs via queue
- Application and public site → Workflow engine: exposes workflows
src/main.py - Application and public site → Schedule service: starts scheduler
src/main.py - Application and public site → Queue worker: starts worker
src/main.py - Application and public site → AI CEO: exposes AI CEO
src/main.py - AI CEO → Application database: records decisions
src/automation/ceo_engine.py - Sales dashboard → Lead pipeline: manages pipeline
src/services/lead_pipeline.py - Lead pipeline → Payments: creates payment
src/services/lead_pipeline.py - Payments → Plans and agent roster: checks plan
src/services/payments.py - Visitor / customer → Payments: checks out
README.md - Customer portal → Application database: reads customer data
src/interfaces/portal_routes.py - Sales dashboard → Application database: queries leads
src/interfaces/sales_routes.py - Application database → Domain models: maps entities
src/db/session.py - Application and public site → Voice advisor: offers voice advisor
README.md - Application and public site → Knowledge retrieval: offers knowledge retrieval
src/main.py - Application and public site → Document generation: offers document packs
- Application and public site → Store integrations: mounts integration routes
src/integrations/routes.py - Store integrations → Application database: persists integration state