Partners Portal Overview
The Loyalty.lt Partners Portal is a comprehensive web application designed for businesses managing multiple shops, locations, or franchises. It provides centralized control over loyalty programs while allowing for individual shop customization and management.The Partners Portal is built on Remix.js with TypeScript and provides a modern, responsive interface for partner management across all devices.
Key Features
Multi-Shop Management
Manage multiple shops and locations from a single dashboard with unified branding and individual customization.
Partner API Access
Full API credentials management with separate staging and production environments for safe development.
Analytics Dashboard
Comprehensive analytics across all shops with detailed insights into loyalty program performance.
Customer Management
Centralized customer database with cross-shop loyalty tracking and unified customer profiles.
Architecture
Technology Stack
- Frontend
 - Authentication
 - API Integration
 
- Remix.js: Server-side rendered React application
 - TypeScript: Full type safety and developer experience
 - Tailwind CSS: Utility-first CSS framework
 - shadcn/ui: High-quality component library
 - i18next: Internationalization (Lithuanian and English)
 
Application Structure
Layout System
Layout System
- Responsive Design: Mobile-first approach with desktop optimization
 - Sidebar Navigation: Collapsible sidebar with intuitive navigation
 - Header Components: Environment selector, language switcher, notifications
 - Footer Integration: Comprehensive footer with company information and links
 
Environment Management
Environment Management
- Dual Environment: Staging and production environment support
 - Visual Indicators: Clear environment identification in the interface
 - Easy Switching: One-click environment switching with data isolation
 - Cookie Persistence: Environment preference saved across sessions
 
Internationalization
Internationalization
- Primary Language: Lithuanian (lt) as the default language
 - Secondary Language: English (en) support
 - Dynamic Loading: Language resources loaded on demand
 - Persistent Settings: Language preference saved in localStorage
 
Core Modules
Dashboard
- Overview Metrics
 - Recent Activity
 - Quick Actions
 
Key performance indicators across all partner shops:
- Total Customers: Unified customer count across all locations
 - Active Loyalty Cards: Currently active loyalty program participants
 - Points Issued: Total points awarded across all shops
 - Redemption Rate: Points redeemed vs. points earned percentage
 - Revenue Impact: Direct revenue attribution to loyalty programs
 
Shop Management
Shop Creation
Add New Locations
- Shop information and branding
 - Location and contact details
 - API credential generation
 - Initial configuration setup
 
Shop Configuration
Customize Each Location
- Point earning rates
 - Redemption rules
 - Promotional campaigns
 - Staff permissions
 
Performance Tracking
Monitor Shop Performance
- Individual shop analytics
 - Customer acquisition metrics
 - Point transaction volumes
 - Revenue performance
 
Staff Management
Manage Shop Staff
- Staff account creation
 - Role and permission assignment
 - Access level configuration
 - Activity monitoring
 
Customer Management
Unified Customer Database
Unified Customer Database
Cross-Shop Customer Profiles
- Single customer view across all shops
 - Consolidated loyalty card information
 - Combined transaction history
 - Unified communication preferences
 - Cross-location activity tracking
 
Customer Segmentation
Customer Segmentation
Advanced Customer Insights
- Tier-based customer grouping
 - Behavioral segmentation
 - Purchase pattern analysis
 - Engagement level classification
 - Churn risk identification
 
Communication Tools
Communication Tools
Customer Engagement Features
- Bulk email campaigns
 - Targeted promotional messages
 - Loyalty program updates
 - Tier achievement notifications
 - Point expiration reminders
 
Analytics and Reporting
- Loyalty Program Performance
 - Shop Comparison
 - Customer Insights
 - Financial Reporting
 
Program Health Metrics
- Customer acquisition cost
 - Retention rates by tier
 - Average order value impact
 - Point redemption patterns
 - Program ROI calculation
 
API Management
Credential Management
The Partners Portal provides complete API credential management with environment separation and security best practices.
API Key Generation
- Automatic API key and secret generation
 - Environment-specific credentials
 - Key rotation and renewal
 - Usage tracking and monitoring
 
Access Control
- Role-based API permissions
 - Endpoint access restrictions
 - Rate limiting configuration
 - Security audit logging
 
Documentation Access
- Integrated API documentation
 - Code examples and tutorials
 - SDK download links
 - Testing environment access
 
Usage Analytics
- API call volume tracking
 - Error rate monitoring
 - Performance metrics
 - Usage pattern analysis
 
Environment Management
- Staging Environment
 - Production Environment
 - Environment Switching
 
Development and Testing
- Safe testing environment
 - Sample data for development
 - Non-production API endpoints
 - Isolated from live customer data
 - Unlimited testing capabilities
 
Partner Onboarding
Getting Started
1
Account Creation
Partners create their account through the registration process with business verification.
2
Business Verification
Submit business documentation and complete identity verification process.
3
Initial Setup
Configure basic business information, branding, and contact details.
4
First Shop Creation
Set up the first shop location with loyalty program configuration.
5
API Integration
Generate API credentials and begin integration with existing systems.
6
Testing Phase
Complete testing in staging environment before going live.
7
Production Launch
Switch to production environment and launch loyalty program.
Support and Training
Onboarding Assistance
- Dedicated onboarding specialist
 - Step-by-step setup guidance
 - Best practices consultation
 - Technical integration support
 
Training Resources
- Video tutorials and guides
 - Webinar training sessions
 - Documentation and manuals
 - Community forum access
 
Technical Support
- 24/7 technical support
 - Priority support tiers
 - Direct developer assistance
 - Emergency support channels
 
Business Consultation
- Loyalty strategy consulting
 - Program optimization advice
 - Industry best practices
 - Performance improvement guidance
 
Advanced Features
Multi-Tier Partner Support
Franchise Management
Franchise Management
Large-Scale Franchise Operations
- Hierarchical shop management
 - Centralized brand control
 - Individual franchisee permissions
 - Cross-franchise customer tracking
 - Consolidated reporting and analytics
 
White-Label Solutions
White-Label Solutions
Custom Branding Options
- Complete interface customization
 - Custom domain configuration
 - Branded mobile applications
 - Custom email templates
 - Tailored user experience
 
Enterprise Integration
Enterprise Integration
Large Business Requirements
- ERP system integration
 - Custom API development
 - Advanced security features
 - Compliance reporting
 - Dedicated infrastructure
 
Automation and Workflows
- Automated Campaigns
 - Business Rules Engine
 - Integration Workflows
 
Marketing Automation
- Welcome series for new customers
 - Birthday and anniversary campaigns
 - Win-back campaigns for inactive customers
 - Tier upgrade congratulations
 - Point expiration reminders
 
Security and Compliance
Data Protection
The Partners Portal implements enterprise-grade security measures to protect partner and customer data.
Data Encryption
- End-to-end encryption
 - Database encryption at rest
 - Secure transmission protocols
 - Key management systems
 
Access Control
- Multi-factor authentication
 - Role-based permissions
 - Session management
 - Audit trail logging
 
Compliance
- GDPR compliance measures
 - Data retention policies
 - Privacy controls
 - Regulatory reporting
 
Monitoring
- Real-time security monitoring
 - Intrusion detection
 - Anomaly detection
 - Incident response procedures
 
Privacy Controls
Customer Privacy
Customer Privacy
Data Protection Measures
- Granular privacy settings
 - Data anonymization options
 - Customer consent management
 - Right to be forgotten implementation
 - Data portability features
 
Partner Privacy
Partner Privacy
Business Data Protection
- Isolated partner environments
 - Secure data sharing controls
 - Business intelligence privacy
 - Competitive information protection
 - Custom data retention policies
 
Performance and Scalability
Technical Performance
- Application Performance
 - Scalability Features
 - Reliability Measures
 
Optimized User Experience
- Server-side rendering for fast initial loads
 - Progressive enhancement for offline capability
 - Optimized database queries
 - CDN integration for global performance
 - Real-time updates without page refreshes
 
Support and Resources
Getting Help
The Partners Portal includes comprehensive support resources and multiple channels for assistance.
In-App Help
- Contextual help tooltips
 - Interactive tutorials
 - Feature documentation
 - Video guides and walkthroughs
 
Support Center
- Knowledge base articles
 - FAQ and troubleshooting
 - Community forums
 - Feature request portal
 
Direct Support
- Priority support channels
 - Technical assistance
 - Account management
 - Emergency support hotline
 
Training Programs
- Regular webinar sessions
 - Certification programs
 - Best practices workshops
 - Industry-specific training
 
Success Resources
Business Growth
Business Growth
Maximize Loyalty Program ROI
- Success metrics and KPIs
 - Optimization strategies
 - Case studies and examples
 - Industry benchmarking
 - Growth planning tools
 
Technical Excellence
Technical Excellence
Advanced Implementation
- Advanced API usage patterns
 - Custom integration examples
 - Performance optimization tips
 - Security best practices
 - Troubleshooting guides
 
Community Engagement
Community Engagement
Partner Network Benefits
- Partner community forums
 - Networking opportunities
 - Shared learning resources
 - Collaboration initiatives
 - Industry events and meetups
 
Next Steps
Partner API Documentation
Explore the complete Partner API for advanced integrations.
Shop Management Guide
Learn how to manage multiple shop locations effectively.
Analytics and Reporting
Understand the analytics dashboard and reporting features.
API Credentials Setup
Set up and manage your Partner API credentials.