Architecture
Complete overview of the BizKitHub SAAS ecosystem: modular business domains, layered API design, PostgreSQL/Redis/S3 data stores, security model, and the underlying technology stack.
BizKitHub is a comprehensive digital platform for business management that combines CRM, e-commerce, payments, invoicing, communication, and automation into one unified system. It is built on modern technologies with a modular architecture that enables flexibility, scalability, and seamless integration.
Business modules
The platform is organized into specialized modules, each handling a specific business domain while sharing a unified data layer.
Core business
- CRM & Contacts — customer management, groups, credits.
- Orders — order lifecycle, payments, invoices.
- Products — catalog, variants, categories.
- Invoicing — invoices, receipts, tax documents.
Communication
- Email system — transactional emails, templates.
- Newsletter — campaigns, segmentation, analytics.
- Calendar — events, reservations, reminders.
Payments
- Payment gateways — support for multiple providers.
- Bank integration — automated transaction matching.
- Vouchers — discounts and promo codes.
Automation
- Workflow engine — end-to-end process automation.
- Scheduled tasks — background jobs and cron.
- AI assistant — analysis, matching, automation.
System overview
The platform follows a layered architecture with clear separation between presentation, business logic, and data layers.
Frontend applications
| Application | Role | URL |
|---|---|---|
| bizkithub.com | Main platform | https://bizkithub.com |
| admin.bizkithub.com | Administration | https://admin.bizkithub.com |
| docs.bizkithub.com | Documentation | https://docs.bizkithub.com |
| status.bizkithub.com | Status page | https://status.bizkithub.com |
| cdn.bizkithub.com | Static assets | https://cdn.bizkithub.com |
| pdf.bizkithub.com | PDF generation | https://pdf.bizkithub.com |
API layers
Public REST API
External integrations with API key authentication. Base URL: api.bizkithub.com/api/v1/
- Rate limiting
- API key authentication
- JSON responses
- Webhook support
BFF layer
Optimized endpoints for frontend applications. Base URL: api.bizkithub.com/bff/
- Session authentication
- Optimized queries
- Real-time sync
- Frontend-specific responses
Business logic layer
A modular architecture with 30+ specialized modules handling all business operations, including: Account, Contact, Order, Product, Payment, Emailer, Calendar, Workflow.
Data layer
BizKitHub uses several storage systems side by side. Each is chosen for the shape of data it holds best, and every system is covered by strict backup, replication and access-control policies regardless of where it sits in the stack.
| Store | Role |
|---|---|
| PostgreSQL | Primary relational database — the source of truth for every business record. |
| Blob storage | Uploaded images, generated PDFs, user files, backups and any other binary content. |
| Redis | Ephemeral real-time data, cache and session storage where the ratio of writes to reads is high. |
| Edge cache | Cached responses assembled from several sources — most commonly API responses, transformed images and other static output — served from the region nearest the caller. |
| Git-backed filesystem | Version-controlled static assets distributed through the platform CDN. Content lives in Git and moves to the edge on deploy. |
Data flow
Understanding how requests are processed through the platform layers.
- Request authentication — API requests are authenticated via API keys or session tokens with rate limiting applied.
- Business logic processing — requests are routed to the appropriate modules where business rules and validations are applied.
- Data persistence — data is stored in PostgreSQL with full ACID compliance and referential integrity.
- Response & events — responses are returned with optional webhook notifications for subscribed events.
Security architecture
Multiple layers of security protect your data and ensure compliance.
- API key authentication — secure API access with rotating keys.
- Rate limiting — protection against abuse.
- Role-based access — granular permissions system.
- Data encryption — TLS 1.3 in transit and encryption at rest.
Technology stack
Built with modern, battle-tested technologies for reliability and performance.
| Category | Technology | Role |
|---|---|---|
| Frontend | Next.js 14 | App Router |
| Database | PostgreSQL | Primary database |
| Database | Drizzle ORM | Type-safe queries |
| Cache | Redis | Caching layer |
| Storage | S3 Storage | File storage |
| Language | TypeScript | End-to-end types |
Platform capabilities
Architecture advantages
- Modular business logic separation
- Unified API across all services
- Horizontal scalability
- Multi-tenant architecture
- Real-time event processing
- Automated workflow execution
Key features
- Full-text search across all entities
- Intelligent data linking
- Multi-language support (CS, EN, SK, PL)
- High availability (99.9% uptime)
- Audit logging
- GDPR compliance
API integration
All platform features are accessible through a comprehensive REST API, enabling seamless integration with external systems.
Available API modules
- Contacts
- Products
- Orders
- Payments
- Calendar
- Emailer
- Vouchers
- Webhooks