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
| Store | Role |
|---|---|
| PostgreSQL | Primary database |
| Redis | Cache & sessions |
| S3 storage | Files & media |
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