# Minastix International - Platform Features Overview
## New Web Application 2026

---

## 📋 Table of Contents
1. [Platform Overview](#platform-overview)
2. [User Roles & Access](#user-roles--access)
3. [Customer Features](#customer-features)
4. [Franchise Features](#franchise-features)
5. [Admin Features](#admin-features)
6. [Enrollment System](#enrollment-system)
7. [E-Commerce Shop](#e-commerce-shop)
8. [Payment Integration](#payment-integration)
9. [Communication System](#communication-system)
10. [Reports & Analytics](#reports--analytics)
11. [Technical Stack](#technical-stack)

---

## 🎯 Platform Overview

### What is the New Minastix Platform?
A comprehensive web application that digitalizes and streamlines the entire Minastix enrollment, franchise management, and e-commerce operations across multiple countries.

### Key Achievements
- **Global Reach**: Supporting 9+ countries (South Africa, Romania, Lesotho, Mauritius, Botswana, Malta, Kenya, Ghana, DRC)
- **Multi-Program Support**: Babynastix, Monkeynastix, and Supernastix
- **Real-Time Integration**: Live data from Minastix API for franchises, venues, and programs
- **Automated Workflows**: Email notifications, payment processing, and enrollment confirmations
- **Modern UX**: Mobile-responsive design with intuitive navigation

---

## 👥 User Roles & Access

### 1. **Admin (Super Admin)**
- Full system access
- View and manage all enrollments across all franchises
- User management and role assignment
- Financial reports and analytics
- Franchise performance monitoring
- System configuration and settings

### 2. **Franchise Owner/Manager**
- View enrollments for their specific franchise
- Access to franchise-specific reports
- Export enrollment data for their locations
- Monitor program performance
- Receive enrollment notifications

### 3. **Customer/Parent**
- Create account and enroll children
- Shop for uniforms and equipment
- View enrollment history
- Manage personal information
- Track orders and payments

---

## 🌟 Customer Features

### Homepage
- **Hero Section**: Eye-catching design with animated gradients
- **Program Cards**: Detailed information for each program (Babynastix, Monkeynastix, Supernastix)
  - Age ranges
  - Curriculum details
  - Visual branding
- **Country Selector**: Animated scrolling flags for easy country selection
- **Location Finder**: GPS-based franchise locator for South Africa

### Enrollment Process (4-Step Wizard)

#### Step 1: Location Selection
- **Smart Filters**: Country → Franchise → Town → Venue
- **GPS Location**: "Find franchise near me" feature
- **Real-Time Data**: Live venue information from Minastix API
- **Visual Feedback**: Nearby franchises with distance calculations

#### Step 2: Child Information
- First Name, Last Name
- Date of Birth
- Gender Selection
- T-Shirt Size (age-appropriate sizing for each program)
- Allergies / Special Needs

#### Step 3: Parent Information
- Parent Name
- Email Address
- Phone Number
- **Preferred Payment Method**: Monthly / Termly / Annual
- **Preferred Contact Method**: Email and/or Phone (checkboxes)

#### Step 4: Review & Checkout
- Summary of all information
- Terms and Conditions acceptance
- **Two Options**:
  1. **Add to Cart**: Continue shopping or add another child
  2. **Pay Now**: Direct to PayFast for immediate payment
- Upsell suggestion for uniforms/apparel

### Shop Features
- **Product Categories**: Uniforms, Equipment, Accessories
- **Program Filtering**: Filter products by Babynastix, Monkeynastix, or Supernastix
- **Size Variants**: Different sizes with individual pricing
- **Product Images**: High-quality product photos
- **Shopping Cart**: 
  - Add multiple items
  - Quantity adjustment
  - Size selection
  - Guest cart support (sessionStorage)
  - Authenticated user cart (database)

---

## 🏢 Franchise Features

### Franchise Dashboard
- **Enrollment Overview**: 
  - Total enrollments for the franchise
  - Recent enrollments list
  - Filter by date range
  - Search functionality

### Data Export
- **CSV Export**: Download enrollment data
- **Comprehensive Fields**:
  - Child details (name, gender, DOB, t-shirt size, allergies)
  - Parent contact information
  - Preferred payment method
  - Preferred contact method
  - Enrollment and payment status
  - Franchise and venue information

### Email Notifications
- Automatic notification when new enrollment occurs
- Detailed enrollment information
- Payment status updates

---

## 🎛️ Admin Features

### Comprehensive Dashboard
Multi-tab interface with complete system oversight:

#### Tab 1: All Enrollments
- **Full Database Access**: View all enrollments across all franchises
- **Advanced Filtering**:
  - By franchise
  - By date range
  - By program
  - By payment status
  - By enrollment status
- **Search**: Find specific enrollments
- **Bulk Export**: CSV download with all fields
- **Pagination**: Handle large datasets efficiently

#### Tab 2: Sales Reports
- **Revenue Analytics**:
  - Total revenue tracking
  - Daily sales graphs (Bar charts)
  - Monthly trends (Line charts)
  - Sales by program/brand (Pie charts)
  
- **Performance Metrics**:
  - Total orders
  - Total enrollments
  - Average order value
  - Conversion rates

- **Shop Analytics**:
  - Items sold breakdown
  - Product performance
  - Revenue by product category
  - Inventory insights

- **Franchise Performance**:
  - Enrollments by franchise (Horizontal bar chart)
  - Top 15 performing franchises
  - Regional analysis

- **Time-Based Filtering**: Today, 3 days, 7 days, 30 days, 90 days, 1 year
- **CSV Export**: Complete sales report export

#### Tab 3: Franchise Management
- **Franchise Directory**:
  - Complete list of all franchises
  - Contact information (email, phone)
  - Location details (address, city, province, country)
  - Status (active/inactive)

- **Sync with API**:
  - "Sync Franchises" button
  - Real-time data from Minastix API
  - Automatic update of franchise information

- **Email Configuration**:
  - Set/update franchise contact emails
  - Ensure enrollment notifications reach the right people

- **Franchise Invitations**:
  - Invite franchise owners to the platform
  - Automatic role assignment
  - Email invitation system

- **Impersonation Mode**:
  - View system as specific franchise
  - Test franchise-specific features
  - Debug franchise issues

#### Tab 4: User Management
- **User Directory**:
  - View all registered users
  - User roles (admin, franchise, user)
  - Registration dates

- **Role Management**:
  - Assign admin privileges
  - Convert users to franchise owners
  - Link users to specific franchises

- **User Invitations**:
  - Invite new users to the platform
  - Pre-assign roles

#### Tab 5: Shop Management
- **Product Catalog**:
  - Add new products
  - Edit existing products
  - Set pricing
  - Manage variants (sizes)
  - Stock availability

- **Product Categories**:
  - Uniforms
  - Equipment
  - Accessories

- **Program Assignment**:
  - Link products to specific programs
  - Ensure correct product visibility

#### Tab 6: Settings
- **Global Settings**:
  - Enrollment amount configuration (R300)
  - Payment gateway settings
  - Email templates
  - System notifications

- **Currency Conversions**:
  - Set conversion rates for international markets
  - Display local currency equivalents

#### Tab 7: Email Testing
- **Test Email System**:
  - Send test parent welcome emails
  - Send test franchise notifications
  - Send test invoices
  - Verify email templates and delivery

---

## 📝 Enrollment System

### Multi-Step Enrollment Process
1. **Program Selection**: Choose Babynastix, Monkeynastix, or Supernastix
2. **Location Selection**: Country → Franchise → Town → Venue
3. **Child Information**: Complete child details
4. **Parent Information**: Contact details and preferences
5. **Review & Payment**: Confirm and pay

### Key Features
- **Progress Indicator**: Visual step tracker
- **Form Validation**: Real-time error checking
- **Data Persistence**: Draft saved during process
- **Mobile Optimized**: Works on all devices

### Post-Enrollment
- **Immediate Confirmation**: On-screen success message
- **Email Confirmation**: Sent to parent
- **Franchise Notification**: Automatic alert to franchise
- **Database Record**: Secure storage of enrollment

---

## 🛍️ E-Commerce Shop

### Product Management
- **Product Catalog**: Full inventory of uniforms and equipment
- **Variants**: Size-based pricing and availability
- **Images**: Product photography
- **Descriptions**: Detailed product information

### Shopping Cart
- **Flexible Cart**: Add products and enrollments together
- **Guest Support**: Shop without account (sessionStorage)
- **User Cart**: Persistent cart for logged-in users
- **Quantity Control**: Adjust quantities before checkout

### Checkout Process
- **Cart Review**: Verify items before payment
- **Total Calculation**: Clear pricing breakdown
- **Payment Integration**: Secure PayFast processing
- **Order Confirmation**: Email and on-screen confirmation

---

## 💳 Payment Integration

### PayFast Integration
- **Secure Processing**: PCI-compliant payment gateway
- **Payment Methods**: 
  - Visa
  - Mastercard
  - EFT
  - Instant EFT

### Payment Flow
1. User adds items to cart (enrollments, products)
2. Proceeds to checkout
3. Redirected to PayFast secure payment page
4. Payment processed
5. Return to success page
6. Order confirmation sent

### Features
- **Signature Generation**: Secure MD5 hashing
- **Payment Verification**: Server-side validation
- **Error Handling**: Failed payment recovery
- **Multi-Currency**: Support for international payments

### Payment Tracking
- **Payment Status**: Pending, Processing, Completed, Failed
- **Payment Reference**: Unique transaction IDs
- **Payment Amount**: Accurate total tracking
- **Payment History**: Full audit trail

---

## 📧 Communication System

### Automated Email Notifications

#### For Parents/Customers:
1. **Welcome Email** (After enrollment)
   - Thank you message
   - Enrollment confirmation
   - Program details
   - What to expect next
   - Franchise contact information

2. **Invoice/Receipt** (After payment)
   - Payment confirmation
   - Itemized breakdown
   - Payment reference
   - Total amount paid
   - Company details

3. **Order Confirmation** (Shop purchases)
   - Items ordered
   - Delivery information
   - Expected timeline

#### For Franchises:
1. **New Enrollment Notification**
   - Child details
   - Parent contact information
   - Program enrolled
   - Payment status
   - Preferred payment method
   - Preferred contact method

2. **Order Notification** (Products shipped to their venue)
   - Product details
   - Quantities
   - Shipping information

#### For Admins:
- All notifications
- Daily/weekly summary reports
- System alerts

### Email System Features
- **Resend API Integration**: Reliable email delivery
- **HTML Templates**: Professional, branded emails
- **Personalization**: Dynamic content based on recipient
- **Delivery Tracking**: Monitor email status
- **Test Mode**: Send test emails before going live

---

## 📊 Reports & Analytics

### Sales Reports (Admin Only)

#### Summary Cards
- **Total Revenue**: Cumulative sales (R)
- **Total Orders**: Count of completed orders
- **Total Enrollments**: New registrations
- **Average Order Value**: Revenue per transaction

#### Visual Analytics
1. **Daily Sales Chart** (Bar Chart)
   - Revenue per day
   - Order volume trends
   - Enrollment patterns

2. **Monthly Trends** (Line Chart)
   - Revenue over time
   - Growth tracking
   - Seasonal patterns

3. **Sales by Program** (Pie Chart)
   - Babynastix revenue
   - Monkeynastix revenue
   - Supernastix revenue
   - Shop products revenue
   - Distribution percentages

4. **Enrollments by Franchise** (Horizontal Bar Chart)
   - Top 15 franchises
   - Enrollment counts
   - Performance comparison

5. **Shop Items Breakdown** (Table)
   - Product name
   - Size
   - Unit price
   - Quantity sold
   - Total revenue
   - Summary totals

#### Time Filtering
- Today
- Last 3 days
- Last 7 days
- Last 30 days
- Last 90 days
- Last year

#### Export Capabilities
- **CSV Export**: Complete sales data
- **Enrollment Export**: All enrollment details
- **Financial Reports**: Revenue breakdowns

### Enrollment Reports

#### Filterable Data
- Date range selection
- Franchise filtering
- Program filtering
- Status filtering

#### Export Fields
- Child information (name, gender, DOB, size, allergies)
- Parent details (name, email, phone)
- Preferred payment method
- Preferred contact method
- Program and franchise information
- Payment and enrollment status
- Registration date

---

## 🔐 Security & Authentication

### User Authentication
- **Secure Login**: Email/password authentication
- **Role-Based Access**: Different permissions per role
- **Session Management**: Secure token handling
- **Password Security**: Encrypted storage

### Data Protection
- **Row-Level Security (RLS)**: Users see only their data
- **Admin Override**: Full access for admin users
- **Franchise Isolation**: Franchises see only their enrollments
- **Encrypted Payments**: PCI-compliant processing

### Privacy
- **Data Privacy**: GDPR/POPIA compliant
- **Consent Management**: Terms acceptance required
- **Data Export**: Users can download their data
- **Right to Deletion**: Admin can remove user data

---

## 🌍 International Support

### Multi-Country Operations
- **9+ Countries**: SA, Romania, Lesotho, Mauritius, Botswana, Malta, Kenya, Ghana, DRC
- **Currency Display**: Local currency conversions shown
- **PayFast Support**: R300 base (ZAR) with conversions
- **Language Support**: English (expandable)

### Country-Specific Features
- **Currency Conversions**:
  - Romania: RON 64 = R300
  - Lesotho: LSL 250 = R300
  - Mauritius: MUR 672 = R300
  - Botswana: BWP 195 = R300
  - Malta: €12.50 = R300
  - Kenya: KES 1,888 = R300
  - Ghana: GHS 164 = R300
  - Congo: CDF 33,146 = R300

- **Flag Display**: Visual country representation
- **Localized Content**: Country-specific information

---

## 🔌 API Integration

### Minastix API Integration
- **Real-Time Data**: Live franchise and venue information
- **School/Venue Listings**: Dynamic location data
- **Franchise Sync**: Regular data updates
- **Program Information**: Current offerings

### Integration Points
1. **Franchise Data**: Names, locations, contacts
2. **Venue Data**: School names, addresses, towns
3. **Program Data**: Available programs per location
4. **Contact Information**: Franchise owner emails/phones

### Sync Features
- **Manual Sync**: "Sync Franchises" button
- **Auto-Update**: Scheduled sync (future)
- **Data Validation**: Error checking
- **Conflict Resolution**: Handle API changes

---

## 📱 Mobile Experience

### Responsive Design
- **Mobile-First**: Optimized for phones and tablets
- **Touch-Friendly**: Large buttons and inputs
- **Fast Loading**: Optimized images and code
- **Offline Support**: Guest cart works offline

### Mobile Features
- **GPS Location**: Find nearby franchises
- **Touch Gestures**: Swipe and tap interactions
- **Mobile Payments**: PayFast mobile support
- **App-Like Feel**: Smooth transitions and animations

---

## 🎨 User Interface

### Design Philosophy
- **Modern**: Gradient backgrounds, smooth animations
- **Clean**: Uncluttered layouts, clear hierarchy
- **Branded**: Minastix colors (lime green primary)
- **Professional**: Business-grade appearance

### Key UI Elements
- **Hero Sections**: Eye-catching landing pages
- **Card Layouts**: Organized information display
- **Progress Indicators**: Step tracking for multi-step flows
- **Modals**: Terms, confirmations, details
- **Toasts**: Success/error notifications
- **Loading States**: Spinners for async operations

### Accessibility
- **Keyboard Navigation**: Tab-friendly
- **Screen Reader Support**: ARIA labels
- **Color Contrast**: WCAG AA compliant
- **Focus Indicators**: Clear focus states

---

## 🚀 Technical Stack

### Frontend
- **React 18**: Modern component architecture
- **React Router**: Client-side routing
- **TailwindCSS**: Utility-first styling
- **Shadcn UI**: Premium component library
- **Lucide Icons**: Modern icon set
- **Recharts**: Data visualization
- **Framer Motion**: Smooth animations
- **React Query**: API state management

### Backend
- **Base44 Platform**: Backend-as-a-Service
- **Deno Functions**: Serverless backend functions
- **Base44 SDK**: Database and auth operations
- **Row-Level Security**: Data access control

### External Services
- **Minastix API**: Franchise/venue data
- **PayFast**: Payment processing
- **Resend API**: Email delivery
- **Google OAuth**: Authentication (configured)

### Data Management
- **Base44 Database**: PostgreSQL-based
- **Real-Time Updates**: Live data sync
- **File Storage**: Image and document storage
- **Session Storage**: Guest cart support

---

## 📈 Key Metrics & Performance

### Current Statistics (as of Jan 2026)
- **Active Programs**: 3 (Babynastix, Monkeynastix, Supernastix)
- **Countries Supported**: 9+
- **Franchises**: 70+ locations
- **Enrollment Amount**: R300 annual
- **Payment Gateway**: PayFast (South Africa)

### Performance Targets
- **Page Load**: < 2 seconds
- **Payment Processing**: < 5 seconds
- **Email Delivery**: < 1 minute
- **API Response**: < 500ms

---

## 🎯 Business Benefits

### For Franchises
✅ **Automated Enrollment**: No manual data entry
✅ **Real-Time Notifications**: Instant alerts for new enrollments
✅ **Easy Reporting**: One-click CSV export
✅ **Professional Image**: Modern, branded platform
✅ **Reduced Admin Work**: Less paperwork and phone calls

### For Parents
✅ **Convenience**: Enroll anytime, anywhere
✅ **Secure Payments**: PCI-compliant processing
✅ **Clear Communication**: Email confirmations and updates
✅ **Online Shopping**: Buy uniforms during enrollment
✅ **Account Management**: View history and manage children

### For Head Office
✅ **Centralized Data**: All enrollments in one system
✅ **Financial Insights**: Real-time sales analytics
✅ **Franchise Monitoring**: Track performance across locations
✅ **Scalability**: Easy to add new franchises/countries
✅ **Cost Savings**: Reduced manual processing

---

## 🔮 Future Enhancements (Roadmap)

### Phase 2 (Q2 2026)
- Automated payment reminders
- Parent portal with class schedules
- Attendance tracking integration
- Multi-language support (Afrikaans, French)
- Mobile app (iOS/Android)

### Phase 3 (Q3 2026)
- Video tutorials and resources
- Progress tracking for children
- Franchise owner training portal
- Advanced analytics dashboard
- Integration with accounting software

### Phase 4 (Q4 2026)
- Loyalty program
- Referral rewards system
- Social media integration
- Event management features
- Certificate generation and printing

---

## 💡 Key Selling Points for Franchises

1. **Zero Upfront Cost**: Included in franchise agreement
2. **Professional Platform**: Enhances brand image
3. **Time Savings**: Reduces admin work by 70%
4. **Instant Notifications**: Know immediately when someone enrolls
5. **Easy Reporting**: Export data anytime for your records
6. **Parent Convenience**: Parents can enroll 24/7 online
7. **Upsell Opportunities**: Parents can buy uniforms during enrollment
8. **Secure Payments**: Parents trust PayFast payment processing
9. **Clear Communication**: Automated emails keep everyone informed
10. **Support Included**: Technical support from head office

---

## 📊 Success Metrics

### Measure of Success
- **Enrollment Conversion Rate**: % of visitors who complete enrollment
- **Average Time to Enroll**: Target < 5 minutes
- **Payment Success Rate**: Target > 95%
- **Franchise Satisfaction**: Target > 90% satisfaction
- **Parent Satisfaction**: Target > 85% satisfaction
- **Email Delivery Rate**: Target > 99%
- **Mobile Usage**: Expected > 60% mobile traffic

---

## 🎉 Conclusion

The new Minastix platform represents a **complete digital transformation** of the enrollment and franchise management process. It provides:

- **Efficiency**: Streamlined processes save time for everyone
- **Professionalism**: Modern, branded experience
- **Scalability**: Easy to grow across countries and franchises
- **Security**: PCI-compliant payments and data protection
- **Insights**: Real-time analytics for informed decisions
- **Communication**: Automated notifications keep everyone connected

This platform positions Minastix as a **technology-forward** organization that values both franchise partners and customer experience.

---

## 📞 Contact & Support

**For Franchise Queries:**
- Email: franchises@minastix.international
- Phone: +27 11 465 8028

**For Technical Support:**
- Email: support@minastix.international
- Platform: In-app help widget

**For General Inquiries:**
- Email: info@monkeynastix.com
- Website: minastix.international

---

*Document Version: 1.0*  
*Last Updated: January 8, 2026*  
*Prepared by: Minastix International Development Team*