Files
orion/app/modules/loyalty/static/admin/js/loyalty-programs.js
Samir Boulahtit d8f3338bc8 feat(loyalty): implement Phase 2 - company-wide points system
Complete implementation of loyalty module Phase 2 features:

Database & Models:
- Add company_id to LoyaltyProgram for chain-wide loyalty
- Add company_id to LoyaltyCard for multi-location support
- Add CompanyLoyaltySettings model for admin-controlled settings
- Add points expiration, welcome bonus, and minimum redemption fields
- Add POINTS_EXPIRED, WELCOME_BONUS transaction types

Services:
- Update program_service for company-based queries
- Update card_service with enrollment and welcome bonus
- Update points_service with void_points for returns
- Update stamp_service for company context
- Update pin_service for company-wide operations

API Endpoints:
- Admin: Program listing with stats, company detail views
- Vendor: Terminal operations, card management, settings
- Storefront: Customer card/transactions, self-enrollment

UI Templates:
- Admin: Programs dashboard, company detail, settings
- Vendor: Terminal, cards list, card detail, settings, stats, enrollment
- Storefront: Dashboard, history, enrollment, success pages

Background Tasks:
- Point expiration task (daily, based on inactivity)
- Wallet sync task (hourly)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-05 22:10:27 +01:00

265 lines
8.9 KiB
JavaScript

// app/modules/loyalty/static/admin/js/loyalty-programs.js
// noqa: js-006 - async init pattern is safe, loadData has try/catch
// Use centralized logger
const loyaltyProgramsLog = window.LogConfig.loggers.loyaltyPrograms || window.LogConfig.createLogger('loyaltyPrograms');
// ============================================
// LOYALTY PROGRAMS LIST FUNCTION
// ============================================
function adminLoyaltyPrograms() {
return {
// Inherit base layout functionality
...data(),
// Page identifier for sidebar active state
currentPage: 'loyalty-programs',
// Programs page specific state
programs: [],
stats: {
total_programs: 0,
active_programs: 0,
total_cards: 0,
transactions_30d: 0,
points_issued_30d: 0,
points_redeemed_30d: 0,
companies_with_programs: 0
},
loading: false,
error: null,
// Search and filters
filters: {
search: '',
is_active: ''
},
// Pagination state
pagination: {
page: 1,
per_page: 20,
total: 0,
pages: 0
},
// Initialize
async init() {
loyaltyProgramsLog.info('=== LOYALTY PROGRAMS PAGE INITIALIZING ===');
// Prevent multiple initializations
if (window._loyaltyProgramsInitialized) {
loyaltyProgramsLog.warn('Loyalty programs page already initialized, skipping...');
return;
}
window._loyaltyProgramsInitialized = true;
// Load platform settings for rows per page
if (window.PlatformSettings) {
this.pagination.per_page = await window.PlatformSettings.getRowsPerPage();
}
loyaltyProgramsLog.group('Loading loyalty programs data');
await Promise.all([
this.loadPrograms(),
this.loadStats()
]);
loyaltyProgramsLog.groupEnd();
loyaltyProgramsLog.info('=== LOYALTY PROGRAMS PAGE INITIALIZATION COMPLETE ===');
},
// Debounced search
debouncedSearch() {
if (this._searchTimeout) {
clearTimeout(this._searchTimeout);
}
this._searchTimeout = setTimeout(() => {
loyaltyProgramsLog.info('Search triggered:', this.filters.search);
this.pagination.page = 1;
this.loadPrograms();
}, 300);
},
// Computed: Get programs for current page (already paginated from server)
get paginatedPrograms() {
return this.programs;
},
// Computed: Total number of pages
get totalPages() {
return this.pagination.pages;
},
// Computed: Start index for pagination display
get startIndex() {
if (this.pagination.total === 0) return 0;
return (this.pagination.page - 1) * this.pagination.per_page + 1;
},
// Computed: End index for pagination display
get endIndex() {
const end = this.pagination.page * this.pagination.per_page;
return end > this.pagination.total ? this.pagination.total : end;
},
// Computed: Generate page numbers array with ellipsis
get pageNumbers() {
const pages = [];
const totalPages = this.totalPages;
const current = this.pagination.page;
if (totalPages <= 7) {
// Show all pages if 7 or fewer
for (let i = 1; i <= totalPages; i++) {
pages.push(i);
}
} else {
// Always show first page
pages.push(1);
if (current > 3) {
pages.push('...');
}
// Show pages around current page
const start = Math.max(2, current - 1);
const end = Math.min(totalPages - 1, current + 1);
for (let i = start; i <= end; i++) {
pages.push(i);
}
if (current < totalPages - 2) {
pages.push('...');
}
// Always show last page
pages.push(totalPages);
}
return pages;
},
// Load programs with search and pagination
async loadPrograms() {
this.loading = true;
this.error = null;
try {
loyaltyProgramsLog.info('Fetching loyalty programs from API...');
const params = new URLSearchParams();
params.append('skip', (this.pagination.page - 1) * this.pagination.per_page);
params.append('limit', this.pagination.per_page);
if (this.filters.search) {
params.append('search', this.filters.search);
}
if (this.filters.is_active !== '') {
params.append('is_active', this.filters.is_active);
}
const response = await apiClient.get(`/admin/loyalty/programs?${params}`);
if (response.programs) {
this.programs = response.programs;
this.pagination.total = response.total;
this.pagination.pages = Math.ceil(response.total / this.pagination.per_page);
loyaltyProgramsLog.info(`Loaded ${this.programs.length} programs (total: ${response.total})`);
} else {
loyaltyProgramsLog.warn('No programs in response');
this.programs = [];
}
} catch (error) {
loyaltyProgramsLog.error('Failed to load programs:', error);
this.error = error.message || 'Failed to load loyalty programs';
this.programs = [];
} finally {
this.loading = false;
}
},
// Load platform stats
async loadStats() {
try {
loyaltyProgramsLog.info('Fetching loyalty stats from API...');
const response = await apiClient.get('/admin/loyalty/stats');
if (response) {
this.stats = {
total_programs: response.total_programs || 0,
active_programs: response.active_programs || 0,
total_cards: response.total_cards || 0,
transactions_30d: response.transactions_30d || 0,
points_issued_30d: response.points_issued_30d || 0,
points_redeemed_30d: response.points_redeemed_30d || 0,
companies_with_programs: response.companies_with_programs || 0
};
loyaltyProgramsLog.info('Stats loaded:', this.stats);
}
} catch (error) {
loyaltyProgramsLog.error('Failed to load stats:', error);
// Don't set error state for stats failure
}
},
// Pagination methods
previousPage() {
if (this.pagination.page > 1) {
this.pagination.page--;
loyaltyProgramsLog.info('Previous page:', this.pagination.page);
this.loadPrograms();
}
},
nextPage() {
if (this.pagination.page < this.totalPages) {
this.pagination.page++;
loyaltyProgramsLog.info('Next page:', this.pagination.page);
this.loadPrograms();
}
},
goToPage(pageNum) {
if (pageNum !== '...' && pageNum >= 1 && pageNum <= this.totalPages) {
this.pagination.page = pageNum;
loyaltyProgramsLog.info('Go to page:', this.pagination.page);
this.loadPrograms();
}
},
// Format date for display
formatDate(dateString) {
if (!dateString) return 'N/A';
try {
const date = new Date(dateString);
return date.toLocaleDateString('en-US', {
year: 'numeric',
month: 'short',
day: 'numeric'
});
} catch (e) {
loyaltyProgramsLog.error('Date parsing error:', e);
return dateString;
}
},
// Format number with thousands separator
formatNumber(num) {
if (num === null || num === undefined) return '0';
return new Intl.NumberFormat('en-US').format(num);
}
};
}
// Register logger for configuration
if (!window.LogConfig.loggers.loyaltyPrograms) {
window.LogConfig.loggers.loyaltyPrograms = window.LogConfig.createLogger('loyaltyPrograms');
}
loyaltyProgramsLog.info('Loyalty programs module loaded');