How akhmadov-360/helix works
Helix is an AI-native, project-based CRM: users manage leads as project workspaces with pipeline phases, contacts, tasks, pages, files, knowledge articles, and activity, then ask a project-scoped RAG assistant about that context. The web app routes user actions through feature views and shared API transport to the NestJS service layer; services own domain operations and data access. Authentication and organization-scoped authorization protect those operations. README documents queued email, embedding, and maintenance work. The graph reflects those documented capabilities; the sampled source excerpts confirm selected controller, session, storage, and embedding behavior, not every subsystem’s wiring.
Main entry points: client.ts API transport · ingest-embeddings.worker.ts Embedding ingestion · index.ts PostgreSQL and pgvector · project-detail-shell.tsx Project workspace UI
Components 25
Web application
- Routes and shell
apps/web/src/routes/_authenticated/index.tsx - Pipeline board
apps/web/src/features/board/board-view.tsx - Project workspace UI
apps/web/src/features/project-detail/project-detail-shell.tsx - Pages and files UI
apps/web/src/features/pages/page-detail-view.tsx - AI chat UI
apps/web/src/features/ai-chat/chat-drawer.tsx - API transport
apps/web/src/shared/api/client.ts
Identity and access
- Authentication API
apps/api/src/modules/auth/auth.controller.ts - Refresh sessions
apps/api/src/modules/auth/sessions/refresh-session.service.ts - Organization management
apps/api/src/modules/organizations/organizations.controller.ts
CRM workflow
- Projects and board
apps/api/src/modules/workspaces/projects.controller.ts - Tasks
apps/api/src/modules/tasks/tasks.controller.ts - Companies and contacts
apps/api/src/modules/crm/contacts.controller.ts - Workspace services
apps/api/src/modules/workspaces/workspaces.service.ts
Workspace content and AI
- Pages and history
apps/api/src/modules/pages/pages.controller.ts - Project attachments
apps/api/src/modules/attachments/attachments.controller.ts - Knowledge base
apps/api/src/modules/kb/kb.controller.ts - RAG chat service
apps/api/src/modules/ai/ai-threads.service.ts - Embedding ingestion
apps/api/src/modules/ai/ingest-embeddings.worker.ts - Vector chunks
apps/api/src/modules/ai/embedding-chunk.repository.ts
Runtime infrastructure
- PostgreSQL and pgvector
packages/db/src/index.ts - Redis job queues
apps/api/src/core/queue/queue.module.ts - S3-compatible storage
apps/api/src/core/storage/s3.service.ts - AI provider adapters
packages/ai/src/provider-registry.ts - Email delivery
apps/api/src/modules/notifications/mailer/mailer.interface.ts
Other components
- CRM user
Connections 39
- CRM user → Routes and shell: uses
- Routes and shell → Pipeline board: opens
- Routes and shell → Project workspace UI: opens
- Project workspace UI → Pages and files UI: opens
- Project workspace UI → AI chat UI: opens
- Pipeline board → API transport: requests
- Project workspace UI → API transport: requests
- Pages and files UI → API transport: requests
- AI chat UI → API transport: streams
- API transport → Authentication API: calls
- API transport → Projects and board: calls
- API transport → Tasks: calls
- API transport → Companies and contacts: calls
- API transport → Pages and history: calls
- API transport → Project attachments: calls
- API transport → Knowledge base: calls
- API transport → RAG chat service: calls
- API transport → Organization management: calls
- Authentication API → Refresh sessions: manages
- Projects and board → Workspace services: delegates
- Projects and board → PostgreSQL and pgvector: reads and writes
- Tasks → PostgreSQL and pgvector: reads and writes
- Companies and contacts → PostgreSQL and pgvector: reads and writes
- Organization management → PostgreSQL and pgvector: reads and writes
- Pages and history → PostgreSQL and pgvector: reads and writes
- Project attachments → S3-compatible storage: stores files
- Project attachments → Redis job queues: queues ingestion
- Knowledge base → PostgreSQL and pgvector: reads and writes
- RAG chat service → Vector chunks: retrieves context
- RAG chat service → AI provider adapters: requests chat
- Embedding ingestion → Redis job queues: consumes jobs
- Embedding ingestion → S3-compatible storage: reads files
- Embedding ingestion → AI provider adapters: creates embeddings
- Embedding ingestion → Vector chunks: writes chunks
- Vector chunks → PostgreSQL and pgvector: queries vectors
- Embedding ingestion → Pages and history: reads page content
- Embedding ingestion → Knowledge base: reads articles
- Embedding ingestion → Project attachments: reads metadata
- Redis job queues → Email delivery: dispatches email jobs