project initialization

docs/user-guides/modules/education.md

@@ -0,0 +1,996 @@
+# Education Module User Guide
+
+## Overview
+
+The Education Module provides comprehensive solutions for Malaysian educational institutions, including student management, class scheduling, enrollment processing, assessment management, and compliance with Malaysian education standards including KSSR/KSSM curriculum and assessment systems.
+
+### Key Features
+
+- **Student Management**: Complete student registration and records
+- **Class Management**: Scheduling, teacher assignment, resource allocation
+- **Enrollment Processing**: Student registration and admission
+- **Assessment Management**: Malaysian curriculum and assessment systems
+- **Fee Management**: Tuition fee processing and financial aid
+- **Reporting**: Education-specific reports and analytics
+- **Parent Portal**: Parent communication and engagement
+
+## Getting Started
+
+### 1. Institution Setup
+
+#### School/Institution Information
+
+1. Navigate to **Education → Settings → Institution Information**
+2. Enter institution details:
+   ```markdown
+   Required Information:
+   - Institution Name: Registered school name
+   - Ministry of Education Registration: MOE registration number
+   - Institution Type: Primary, secondary, international, etc.
+   - Address: Complete Malaysian address
+   - Contact Information: Phone, email, website
+   - Operating Hours: School operating hours
+   - Academic Year: Current academic year
+   - Principal/Head: Institution head information
+   - Accreditation: Relevant accreditation details
+   ```
+
+#### Academic Calendar Setup
+
+1. Navigate to **Education → Settings → Academic Calendar**
+2. Configure academic year:
+   ```markdown
+   Academic Year Configuration:
+   - Academic Year: Current academic year (e.g., 2024)
+   - Terms/Semesters: Number of terms
+   - Term Dates: Start and end dates for each term
+   - Holidays: Public and school holidays
+   - Examination Periods: Exam schedules
+   - Break Periods: Mid-term and year-end breaks
+   - Special Events: School events and activities
+   ```
+
+#### Grade Level Configuration
+
+1. Navigate to **Education → Settings → Grade Levels**
+2. Set up Malaysian education levels:
+   ```markdown
+   Malaysian Grade Levels:
+   Primary Education (KSSR):
+   - Year 1 (Standard 1)
+   - Year 2 (Standard 2)
+   - Year 3 (Standard 3)
+   - Year 4 (Standard 4)
+   - Year 5 (Standard 5)
+   - Year 6 (Standard 6)
+
+   Secondary Education (KSSM):
+   - Form 1 (Tingkatan 1)
+   - Form 2 (Tingkatan 2)
+   - Form 3 (Tingkatan 3)
+   - Form 4 (Tingkatan 4)
+   - Form 5 (Tingkatan 5)
+   - Form 6 (Lower/Upper Form 6)
+
+   Special Education:
+   - Special Education Classes
+   - Special Integration Programs
+   ```
+
+### 2. Staff Management
+
+#### Teacher Registration
+
+1. Navigate to **Education → Staff → Add Teacher**
+2. Register teaching staff:
+   ```markdown
+   Teacher Information:
+   - Personal Details:
+     • Full Name: Teacher's full name
+     • IC Number: Malaysian IC number
+     • Date of Birth: Date of birth
+     • Gender: Male/Female
+     • Contact Information: Phone, email
+     • Address: Residential address
+
+   - Professional Information:
+     • Teacher Registration: MOE teacher registration number
+     • Qualifications: Academic and teaching qualifications
+     • Specialization: Subject specialization
+     • Teaching Experience: Years of experience
+     • Subjects: Subjects qualified to teach
+     • Grade Levels: Grade levels qualified to teach
+     • Employment Type: Full-time, part-time, contract
+     - Employment Status: Active, on leave, resigned
+
+   - Assignment Information:
+     • Current Subjects: Currently teaching subjects
+     • Current Classes: Assigned classes
+     • Additional Duties: CCA, coordinator roles
+     • Workload: Teaching hours and workload
+   ```
+
+#### Non-Teaching Staff
+
+1. Navigate to **Education → Staff → Add Non-Teaching Staff**
+2. Register administrative staff:
+   ```markdown
+   Non-Teaching Staff Categories:
+   - Administrative Staff: Office administrators
+   - Support Staff: Janitors, security, etc.
+   - Special Education Assistants: Support for special needs
+   - IT Support: Technology support staff
+   - Librarians: Library management
+   - Counselors: Student counseling services
+   - Health Personnel: School nurses or health staff
+   ```
+
+## Student Management
+
+### 1. Student Registration
+
+#### New Student Enrollment
+
+1. Navigate to **Education → Students → New Enrollment**
+2. Register new student:
+   ```markdown
+   Student Information:
+   - Personal Details:
+     • Full Name: Student's full name
+     • IC Number: Malaysian IC number
+     • Date of Birth: Date of birth
+     • Gender: Male/Female
+     • Place of Birth: Place of birth
+     • Nationality: Malaysian or other
+     • Race: Ethnic background
+     • Religion: Religious affiliation
+     • Blood Type: Blood group if known
+
+   - Family Information:
+     • Father's Name: Father's full name
+     • Father's IC: Father's IC number
+     • Father's Occupation: Father's occupation
+     • Mother's Name: Mother's full name
+     • Mother's IC: Mother's IC number
+     • Mother's Occupation: Mother's occupation
+     • Guardian Information: Guardian details if applicable
+     • Siblings: Siblings in the same school
+
+   - Contact Information:
+     • Phone Number: Contact phone number
+     • Alternative Phone: Alternative contact
+     • Email Address: Email for communications
+     • Emergency Contact: Emergency contact person
+     • Emergency Phone: Emergency contact number
+
+   - Address:
+     • Residential Address: Home address
+     • Postal Address: Mailing address if different
+     • City/Town: City or town
+     • State: Malaysian state
+     • Postal Code: Postcode
+     • Country: Malaysia (default)
+
+   - Educational Information:
+     • Previous School: Last school attended
+     • Previous Grade: Last grade completed
+     - Year of Admission: Year of enrollment
+     - Grade Level: Grade level for admission
+     - Stream: Academic stream (Science, Arts, etc.)
+     - Special Needs: Special education requirements
+     - Health Conditions: Medical conditions
+     - Allergies: Known allergies
+     - Dietary Restrictions: Food restrictions
+   ```
+
+#### Student Categories
+
+1. Navigate to **Education → Settings → Student Categories**
+2. Configure student types:
+   ```markdown
+   Student Categories:
+   - Regular Students: Standard enrollment
+   - International Students: Foreign students
+   - Special Education: Students with special needs
+   - Scholarship Students: Scholarship recipients
+   - Exchange Students: Exchange program participants
+   - Part-time Students: Part-time enrollment
+   - Transfer Students: Students transferring from other schools
+   ```
+
+### 2. Student Records
+
+#### Academic Records
+
+1. Navigate to **Education → Students → Academic Records**
+2. Manage academic information:
+   ```markdown
+   Academic Record Components:
+   - Grade History: Academic performance by grade/year
+   - Subject Enrollment: Subjects taken each year
+   - Assessment Results: Test and examination results
+   - Attendance Records: Attendance statistics
+   - Behavior Records: Conduct and discipline
+   - Achievement Records: Awards and achievements
+   - CCA Participation: Co-curricular activities
+   - Leadership Roles: Leadership positions held
+   - Service Hours: Community service hours
+   ```
+
+#### Personal Development Records
+
+1. Navigate to **Education → Students → Development Records**
+2. Track student development:
+   ```markdown
+   Development Areas:
+   - Skills Development: Skills acquired
+   - Talent Development: Talents and abilities
+   - Character Development: Character building
+   - Social Development: Social skills and relationships
+   - Emotional Development: Emotional intelligence
+   - Physical Development: Physical education and health
+   - Aesthetic Development: Arts and creativity
+   - Spiritual Development: Moral and spiritual growth
+   ```
+
+### 3. Special Education Needs
+
+#### SEN Student Management
+
+1. Navigate to **Education → Students → Special Education**
+2. Manage special needs students:
+   ```markdown
+   SEN Support Categories:
+   - Learning Disabilities: Dyslexia, ADHD, etc.
+   - Physical Disabilities: Physical impairments
+   - Sensory Impairments: Visual, hearing impairments
+   - Autism Spectrum: Autism and related conditions
+   - Speech/Language: Communication disorders
+   - Behavioral Issues: Behavioral challenges
+   - Gifted/Talented: Advanced students
+   - Multiple Disabilities: Multiple impairments
+   ```
+
+#### Individual Education Plans (IEP)
+
+1. Navigate to **Education → Students → IEP**
+2. Create IEPs for SEN students:
+   ```markdown
+   IEP Components:
+   - Student Profile: Student background and needs
+   - Assessment Results: Current performance levels
+   - Annual Goals: Educational objectives
+   - Short-term Objectives: Specific learning targets
+   - Teaching Strategies: Instructional methods
+   - Support Services: Required support services
+   - Accommodations: Special accommodations
+   - Assessment Methods: How progress will be measured
+   - Review Schedule: IEP review timeline
+   ```
+
+## Class Management
+
+### 1. Class Setup
+
+#### Class Creation
+
+1. Navigate to **Education → Classes → Create Class**
+2. Create new class:
+   ```markdown
+   Class Information:
+   - Class Name: Class designation (e.g., 1A, 2B)
+   - Grade Level: Grade level for the class
+   - Stream: Academic stream if applicable
+   - Academic Year: Current academic year
+   - Class Teacher: Assigned class teacher
+   - Maximum Capacity: Maximum number of students
+   - Current Enrollment: Current number of students
+   - Classroom Location: Room number or location
+   - Schedule: Class schedule and timing
+   ```
+
+#### Class Configuration
+
+1. Navigate to **Education → Classes → Class Settings**
+2. Configure class parameters:
+   ```markdown
+   Class Settings:
+   - Grading System: Grading scale and criteria
+   - Attendance Policy: Attendance requirements
+   - Homework Policy: Homework expectations
+   - Assessment Schedule: Test and exam schedule
+   - Class Rules: Classroom rules and expectations
+   - Communication Plan: Parent communication strategy
+   - Special Programs: Special programs or projects
+   - Resources: Required resources and materials
+   ```
+
+### 2. Teacher Assignment
+
+#### Subject Assignment
+
+1. Navigate to **Education → Classes → Subject Assignment**
+2. Assign subjects to teachers:
+   ```markdown
+   Subject Assignment Process:
+   - Select Class: Choose the class
+   - Select Subject: Choose the subject
+   - Assign Teacher: Select qualified teacher
+   - Set Schedule: Determine teaching schedule
+   - Assign Classroom: Specify classroom location
+   - Define Workload: Calculate teaching hours
+   - Check Qualifications: Verify teacher qualifications
+   - Confirm Assignment: Finalize the assignment
+   ```
+
+#### Workload Management
+
+1. Navigate to **Education → Staff → Workload**
+2. Manage teacher workloads:
+   ```markdown
+   Workload Components:
+   - Teaching Hours: Classroom teaching time
+   - Preparation Time: Lesson preparation time
+   - Assessment Time: Grading and assessment time
+   - Meeting Time: Staff meetings and committees
+   - CCA Time: Co-curricular activities
+   - Administrative Time: Administrative duties
+   - Professional Development: Training and development
+   - Total Workload: Combined working hours
+   ```
+
+### 3. Resource Management
+
+#### Classroom Management
+
+1. Navigate to **Education → Resources → Classrooms**
+2. Manage classroom resources:
+   ```markdown
+   Classroom Resources:
+   - Physical Setup: Seating arrangements, equipment
+   - Teaching Aids: Whiteboards, projectors, etc.
+   - Learning Materials: Textbooks, workbooks
+   - Technology: Computers, tablets, internet
+   - Storage: Cupboards, shelves, storage areas
+   - Display Areas: Bulletin boards, display spaces
+   - Safety Equipment: First aid, emergency equipment
+   - Special Equipment: Subject-specific equipment
+   ```
+
+#### Teaching Materials
+
+1. Navigate to **Education → Resources → Teaching Materials**
+2. Manage educational resources:
+   ```markdown
+   Material Categories:
+   - Textbooks: Main teaching textbooks
+   - Workbooks: Student workbooks
+   - Reference Books: Supplementary materials
+   - Digital Resources: Online materials, software
+   - Teaching Aids: Charts, models, manipulatives
+   - Assessment Materials: Test papers, rubrics
+   - Multimedia: Videos, audio materials
+   - Art Supplies: Art and craft materials
+   ```
+
+## Curriculum and Assessment
+
+### 1. Malaysian Curriculum Setup
+
+#### KSSR/KSSM Configuration
+
+1. Navigate to **Education → Settings → Curriculum**
+2. Configure Malaysian curriculum:
+   ```markdown
+   KSSR (Primary School) Subjects:
+   Core Subjects:
+   - Bahasa Malaysia
+   - English Language
+   - Mathematics
+   - Science
+   - Islamic Education / Moral Education
+   - Physical and Health Education
+   - Visual Arts Education
+   - Music Education
+
+   Additional Subjects:
+   - Chinese Language (SJKC)
+   - Tamil Language (SJKT)
+   - Arabic Language (JAIS)
+   - Iban Language (Sarawak)
+   - Kadazandusun Language (Sabah)
+
+   KSSM (Secondary School) Subjects:
+   Core Subjects:
+   - Bahasa Malaysia
+   - English Language
+   - Mathematics
+   - Science
+   - Islamic Education / Moral Education
+   - History
+   - Physical and Health Education
+
+   Elective Subjects:
+   - Additional Mathematics
+   - Biology
+   - Chemistry
+   - Physics
+   - Business Studies
+   - Economics
+   - Accounting
+   - Literature in English
+   - Principles of Accounts
+   - Design and Technology
+   - Information and Communication Technology
+   - Visual Arts Education
+   - Music Education
+   - Physical Education
+   ```
+
+#### Subject Configuration
+
+1. Navigate to **Education → Settings → Subjects**
+2. Set up subject details:
+   ```markdown
+   Subject Configuration:
+   - Subject Code: Unique subject identifier
+   - Subject Name: Official subject name
+   - Grade Level: Appropriate grade levels
+   - Credits: Credit hours or weightage
+   - Duration: Class duration per week
+   - Prerequisites: Required prior subjects
+   - Assessment Methods: How subject is assessed
+   - Textbooks: Required textbooks
+   - Resources: Additional resources needed
+   - Learning Outcomes: Expected learning outcomes
+   ```
+
+### 2. Assessment Management
+
+#### Malaysian Assessment Systems
+
+1. Navigate to **Education → Assessment → Assessment Setup**
+2. Configure Malaysian assessment systems:
+   ```markdown
+   Primary School Assessment:
+   - Classroom Assessment (PBS): School-based assessment
+   - UPSR (Year 6): Primary School Assessment
+   - LINUS: Literacy and Numeracy Screening
+   - Special Education Assessment: SEN student assessment
+
+   Secondary School Assessment:
+   - PT3 (Form 3): Lower Secondary Assessment
+   - SPM (Form 5): Malaysian Certificate of Education
+   - STPM (Form 6): Malaysian Higher School Certificate
+   - DLP: Dual Language Program assessment
+   - TVET: Technical and Vocational assessment
+   ```
+
+#### Assessment Creation
+
+1. Navigate to **Education → Assessment → Create Assessment**
+2. Create new assessment:
+   ```markdown
+   Assessment Details:
+   - Assessment Name: Test or exam name
+   - Subject: Associated subject
+   - Grade Level: Target grade level
+   - Assessment Type: Quiz, test, exam, project
+   - Date and Time: Schedule details
+   - Duration: Assessment duration
+   - Total Marks: Maximum possible score
+   - Weightage: Assessment weightage in final grade
+   - Instructions: Student instructions
+   - Grading Criteria: How assessment will be graded
+   ```
+
+### 3. Grading System
+
+#### Malaysian Grading Scales
+
+1. Navigate to **Education → Settings → Grading**
+2. Configure grading scales:
+   ```markdown
+   Malaysian Grading System:
+   Primary School:
+   - Achieved (Tercapai): Competency achieved
+   - Not Achieved (Tidak Tercapai): Competency not achieved
+   - Developing (Membangun): Progressing towards competency
+
+   Secondary School:
+   A: 80-100 (Excellent)
+   B: 70-79 (Good)
+   C: 60-69 (Satisfactory)
+   D: 50-59 (Pass)
+   E: 40-49 (Marginal Pass)
+   F: 0-39 (Fail)
+
+   STPM:
+   A: 80-100 (Excellent)
+   A-: 75-79 (Very Good)
+   B+: 70-74 (Good)
+   B: 65-69 (Good)
+   B-: 60-64 (Good)
+   C+: 55-59 (Satisfactory)
+   C: 50-54 (Satisfactory)
+   C-: 45-49 (Satisfactory)
+   D+: 40-44 (Marginal Pass)
+   D: 35-39 (Marginal Pass)
+   F: 0-34 (Fail)
+   ```
+
+#### Grade Calculation
+
+1. Navigate to **Education → Assessment → Grade Calculation**
+2. Set up grade calculation:
+   ```markdown
+   Grade Calculation Components:
+   - Continuous Assessment: Classroom performance
+   - Quizzes: Regular quiz scores
+   - Tests: Periodic test results
+   - Projects: Project work and assignments
+   - Mid-term Exam: Mid-term examination
+   - Final Exam: Final examination
+   - Participation: Class participation
+   - Homework: Homework completion
+   - Attendance: Attendance records
+   - Extra Credit: Additional credit opportunities
+   ```
+
+## Fee Management
+
+### 1. Fee Structure
+
+#### Tuition Fee Setup
+
+1. Navigate to **Education → Fees → Fee Structure**
+2. Configure fee structure:
+   ```markdown
+   Fee Categories:
+   - Registration Fee: One-time enrollment fee
+   - Tuition Fee: Annual/semester tuition
+   - Development Fee: School development fund
+   - Technology Fee: Computer and IT fees
+   - Laboratory Fee: Science lab fees
+   - Library Fee: Library and resource fees
+   - Activity Fee: Co-curricular activity fees
+   - Examination Fee: External exam fees
+   - Textbook Fee: Book rental or purchase
+   - Uniform Fee: School uniform costs
+   - Transportation Fee: Bus transportation fees
+   - Meal Plan: Cafeteria meal plans
+   - Boarding Fee: Hostel accommodation fees
+   ```
+
+#### Scholarships and Financial Aid
+
+1. Navigate to **Education → Fees → Financial Aid**
+2. Set up financial assistance:
+   ```markdown
+   Financial Aid Categories:
+   - Government Scholarships: KPM scholarships
+   - State Scholarships: State government aid
+   - Corporate Scholarships: Company-sponsored
+   - Institutional Scholarships: School-funded
+   - Need-based Aid: Financial assistance
+   - Academic Scholarships: Merit-based awards
+   - Sports Scholarships: Athletic achievements
+   - Arts Scholarships: Artistic talents
+   - Special Education Aid: SEN student support
+   - Bursaries: Financial grants
+   ```
+
+### 2. Payment Processing
+
+#### Fee Collection
+
+1. Navigate to **Education → Fees → Payment Collection**
+2. Process fee payments:
+   ```markdown
+   Payment Methods:
+   - Cash: Cash payments at office
+   - Bank Transfer: Direct bank transfers
+   - Online Banking: Maybank2U, CIMB Clicks, etc.
+   - Credit/Debit Cards: Card payments
+   - E-wallets: Touch 'n Go, GrabPay, etc.
+   - Cheques: Bank cheques
+   - Installment Plans: Monthly installments
+   - Auto-debit: Automatic deductions
+   ```
+
+#### Payment Tracking
+
+1. Navigate to **Education → Fees → Payment Tracking**
+2. Monitor payment status:
+   ```markdown
+   Payment Tracking Features:
+   - Payment History: All payment transactions
+   - Outstanding Balance: Unpaid amounts
+   - Due Dates: Payment due dates
+   - Late Payment: Late payment tracking
+   - Payment Reminders: Automated reminders
+   - Receipt Generation: Payment receipts
+   - Refund Processing: Refund management
+   - Financial Reports: Fee collection reports
+   ```
+
+## Parent Portal
+
+### 1. Parent Registration
+
+#### Parent Account Setup
+
+1. Parents register through portal or school assistance
+2. Parent account setup:
+   ```markdown
+   Parent Registration Process:
+   - Parent Information: Name, IC, contact details
+   - Student Linkage: Link to student accounts
+   - Verification: Identity verification
+   - Account Creation: Username and password
+   - Security Setup: Security questions and 2FA
+   - Notification Preferences: Communication preferences
+   - Access Permissions: Data access permissions
+   - Agreement: Terms and conditions acceptance
+   ```
+
+#### Parent Dashboard
+
+1. Navigate to **Education → Parent Portal**
+2. Parent portal features:
+   ```markdown
+   Parent Portal Features:
+   - Student Information: View student details
+   - Academic Performance: Grades and assessment results
+   - Attendance Records: Attendance tracking
+   - Fee Information: Fee status and payments
+   - Communication: School communications
+   - Class Schedule: Student timetable
+   - Homework Assignments: Homework and assignments
+   - Calendar: School calendar and events
+   - Progress Reports: Student progress tracking
+   ```
+
+### 2. Parent Communication
+
+#### Communication Tools
+
+1. Navigate to **Education → Communication → Parent Communication**
+2. Parent communication features:
+   ```markdown
+   Communication Methods:
+   - Announcements: School-wide announcements
+   - Messages: Direct messaging with teachers
+   - Emails: Email communications
+   - SMS: Text message notifications
+   - Mobile App: Push notifications
+   - Parent-Teacher Meetings: Meeting scheduling
+   - Progress Reports: Academic progress updates
+   - Emergency Alerts: Emergency notifications
+   ```
+
+#### Parent-Teacher Meetings
+
+1. Navigate to **Education → Communication → PTM**
+2. Manage parent-teacher meetings:
+   ```markdown
+   PTM Management:
+   - Meeting Scheduling: Schedule meeting times
+   - Teacher Availability: Set teacher availability
+   - Parent Booking: Parent booking system
+   - Meeting Reminders: Automated reminders
+   - Meeting Notes: Record meeting outcomes
+   - Follow-up Actions: Track action items
+   - Feedback Collection: Parent feedback
+   - Attendance Tracking: Meeting attendance
+   ```
+
+## Reporting and Analytics
+
+### 1. Academic Reports
+
+#### Student Performance Reports
+
+1. Navigate to **Education → Reports → Student Performance**
+2. Generate student reports:
+   ```markdown
+   Performance Report Types:
+   - Report Cards: Term/semester report cards
+   - Progress Reports: Ongoing progress updates
+   - Subject Performance: Performance by subject
+   - Class Ranking: Class position/ranking
+   - Year-to-Date Progress: Academic progress over time
+   - Strengths/Weaknesses: Academic analysis
+   - Learning Outcomes: Achievement of learning objectives
+   - Attendance Analysis: Attendance impact on performance
+   ```
+
+#### Class Performance Reports
+
+1. Navigate to **Education → Reports → Class Performance**
+2. Generate class reports:
+   ```markdown
+   Class Report Categories:
+   - Class Average: Class performance averages
+   - Subject Performance: Performance by subject
+   - Grade Distribution: Grade distribution analysis
+   - Top Performers: High-achieving students
+   - At-Risk Students: Students needing support
+   - Attendance Analysis: Class attendance patterns
+   - Behavior Reports: Class conduct reports
+   - Teacher Performance: Teaching effectiveness
+   ```
+
+### 2. Administrative Reports
+
+#### Enrollment Reports
+
+1. Navigate to **Education → Reports → Enrollment**
+2. Generate enrollment reports:
+   ```markdown
+   Enrollment Report Types:
+   - Current Enrollment: Current student numbers
+   - Enrollment Trends: Enrollment over time
+   - Demographic Analysis: Student demographics
+   - Intake Analysis: New student intake
+   - Dropout Rates: Student dropout analysis
+   - Transfer Analysis: Student transfers
+   - Retention Rates: Student retention statistics
+   - Projection Reports: Future enrollment projections
+   ```
+
+#### Financial Reports
+
+1. Navigate to **Education → Reports → Financial**
+2. Generate financial reports:
+   ```markdown
+   Financial Report Categories:
+   - Fee Collection: Fee collection statistics
+   - Revenue Reports: Total revenue analysis
+   - Outstanding Payments: Unpaid fees
+   - Scholarship Reports: Financial aid distribution
+   - Budget vs Actual: Budget performance
+   - Expense Reports: Operating expenses
+   - Cash Flow: Cash flow analysis
+   - Financial Health: Overall financial status
+   ```
+
+## Malaysian Education Compliance
+
+### 1. MOE Requirements
+
+#### Ministry of Education Compliance
+
+1. Navigate to **Education → Settings → MOE Compliance**
+2. Configure MOE requirements:
+   ```markdown
+   MOE Compliance Areas:
+   - Curriculum Standards: KSSR/KSSM compliance
+   - Assessment Standards: UPSR, PT3, SPM, STPM
+   - Teacher Qualifications: Minimum teaching qualifications
+   - Infrastructure Standards: School facilities requirements
+   - Safety Standards: Student safety requirements
+   - Reporting Requirements: Mandatory reporting
+   - Audit Requirements: Compliance audits
+   - Documentation: Required documentation
+   - Inspection Readiness: Ministry inspection preparation
+   ```
+
+#### Malaysian Education Act Compliance
+
+1. Navigate to **Education → Settings → Legal Compliance**
+2. Ensure legal compliance:
+   ```markdown
+   Legal Compliance Areas:
+   - Education Act 1996: Compliance with education laws
+   - Private Education Act: Private school regulations
+   - Child Protection Act: Child protection requirements
+   - Personal Data Protection: Data privacy compliance
+   - Employment Laws: Staff employment compliance
+   - Health Regulations: School health standards
+   - Safety Regulations: Building and safety standards
+   - Environmental Regulations: Environmental compliance
+   ```
+
+### 2. Quality Assurance
+
+#### School Quality Standards
+
+1. Navigate to **Education → Settings → Quality Assurance**
+2. Set up quality standards:
+   ```markdown
+   Quality Standards:
+   - Academic Quality: Teaching and learning quality
+   - Administrative Quality: Management efficiency
+   - Infrastructure Quality: Facility standards
+   - Staff Quality: Teacher and staff competence
+   - Student Support: Student services quality
+   - Parent Satisfaction: Parent service quality
+   - Community Engagement: Community involvement
+   - Continuous Improvement: Quality improvement processes
+   ```
+
+#### Performance Indicators
+
+1. Navigate to **Education → Settings → KPIs**
+2. Define key performance indicators:
+   ```markdown
+   KPI Categories:
+   - Academic Performance: Student achievement metrics
+   - Enrollment: Student recruitment and retention
+   - Teacher Performance: Teaching effectiveness
+   - Financial Performance: Revenue and cost management
+   - Parent Satisfaction: Parent feedback metrics
+   - Student Satisfaction: Student experience metrics
+   - Operational Efficiency: Process efficiency metrics
+   - Compliance: Regulatory compliance metrics
+   ```
+
+## Mobile Features
+
+### 1. Student Mobile App
+
+#### Student Mobile Features
+
+1. Students can use mobile app to:
+   ```markdown
+   Student Mobile Capabilities:
+   - Timetable: View class schedule
+   - Homework: Access assignments and deadlines
+   - Grades: View assessment results
+   - Attendance: Check attendance records
+   - Notifications: Receive school notifications
+   - Resources: Access learning materials
+   - Library: Browse library resources
+   - Calendar: View school calendar
+   - Communication: Message teachers
+   - Progress: Track academic progress
+   ```
+
+### 2. Parent Mobile App
+
+#### Parent Mobile Features
+
+1. Parents can use mobile app to:
+   ```markdown
+   Parent Mobile Capabilities:
+   - Child Performance: Monitor child's progress
+   - Attendance: Check attendance records
+   - Timetable: View child's schedule
+   - Homework: Monitor homework assignments
+   - Grades: Access assessment results
+   - Fees: Check fee status and payments
+   - Communications: School communications
+   - Appointments: Schedule parent-teacher meetings
+   - Notifications: Receive important updates
+   - Reports: Access progress reports
+   ```
+
+## Troubleshooting
+
+### 1. Common Issues
+
+#### Enrollment Issues
+
+**Registration Problems**
+- Verify all required information is complete
+- Check IC number format (YYYYMMDD-XX-XXXX)
+- Ensure contact information is accurate
+- Verify grade level placement
+- Contact registration office for assistance
+
+**Document Upload Issues**
+- Check file format requirements
+- Verify file size limits
+- Ensure documents are clear and legible
+- Check internet connection
+- Try using a different browser
+
+#### Assessment Issues
+
+**Grade Calculation Errors**
+- Verify grade scale configuration
+- Check assessment weightage settings
+- Review individual assessment scores
+- Verify student enrollment in subjects
+- Contact academic coordinator
+
+**Attendance Issues**
+- Verify class schedule accuracy
+- Check teacher attendance entry
+- Review student enrollment status
+- Verify system date and time
+- Contact administration office
+
+### 2. Technical Issues
+
+**System Performance**
+- Clear browser cache
+- Update browser to latest version
+- Check internet connection speed
+- Verify system status page
+- Contact technical support
+
+**Mobile App Issues**
+- Ensure latest app version
+- Check device compatibility
+- Restart mobile device
+- Update device operating system
+- Reinstall mobile application
+
+**Data Synchronization**
+- Check internet connection
+- Verify cloud sync settings
+- Update applications
+- Clear application data
+- Contact technical support
+
+## Best Practices
+
+### 1. Academic Excellence
+
+**Teaching Standards**
+- Follow curriculum guidelines
+- Use diverse teaching methods
+- Provide regular feedback
+- Maintain accurate records
+- Engage in professional development
+
+**Student Support**
+- Provide individual attention
+- Offer additional support when needed
+- Create inclusive learning environment
+- Monitor student progress regularly
+- Communicate with parents effectively
+
+### 2. Administrative Efficiency
+
+**Record Management**
+- Maintain accurate student records
+- Keep documentation up to date
+- Implement proper filing systems
+- Regular data backup
+- Ensure data security and privacy
+
+**Communication**
+- Maintain clear communication channels
+- Respond promptly to inquiries
+- Use multiple communication methods
+- Keep parents informed
+- Document all communications
+
+### 3. Malaysian Education Context
+
+**Cultural Sensitivity**
+- Respect Malaysian cultural diversity
+- Use appropriate language
+- Consider religious sensitivities
+- Promote unity in diversity
+- Celebrate cultural festivals
+
+**Regulatory Compliance**
+- Stay updated on MOE regulations
+- Maintain proper documentation
+- Conduct regular audits
+- Train staff on compliance
+- Implement quality assurance
+
+## Conclusion
+
+The Education Module provides comprehensive solutions for Malaysian educational institutions. By following this guide, you can effectively manage your school, maintain compliance with Malaysian education standards, and provide quality education to students.
+
+Remember to:
+1. **Stay Compliant**: Keep up with MOE requirements and Malaysian education standards
+2. **Use Technology**: Leverage mobile and digital features
+3. **Focus on Quality**: Maintain high educational standards
+4. **Train Staff**: Ensure staff are properly trained
+5. **Engage Parents**: Maintain good parent-school relationships
+
+For additional support:
+- **Help Center**: Comprehensive knowledge base
+- **Video Tutorials**: Step-by-step training videos
+- **Community Forum**: Connect with other educators
+- **Technical Support**: education-support@yourplatform.com
+- **Training Resources**: education-training@yourplatform.com
+
+Success with the Education Module comes from understanding Malaysian education requirements, maintaining high academic standards, and providing excellent educational experiences while ensuring compliance with all relevant regulations and standards.

docs/user-guides/modules/healthcare.md

@@ -0,0 +1,807 @@
+# Healthcare Module User Guide
+
+## Overview
+
+The Healthcare Module provides comprehensive solutions for Malaysian healthcare providers, including patient management, appointment scheduling, medical records, billing, and compliance with Malaysian healthcare regulations including PDPA and KKM requirements.
+
+### Key Features
+
+- **Patient Management**: Complete patient registration and records
+- **Appointment Scheduling**: Advanced booking and calendar management
+- **Medical Records**: Electronic Health Records (EHR) with Malaysian standards
+- **Billing and Insurance**: Malaysian insurance provider integration
+- **Prescription Management**: Electronic prescribing and medication tracking
+- **Compliance**: PDPA compliance and Malaysian healthcare regulations
+- **Reporting**: Healthcare-specific reports and analytics
+
+## Getting Started
+
+### 1. Module Setup
+
+#### Clinic/Hospital Information
+
+1. Navigate to **Healthcare → Settings → Clinic Information**
+2. Enter facility details:
+   ```markdown
+   Required Information:
+   - Facility Name: Registered clinic/hospital name
+   - KKM Registration: Ministry of Health registration number
+   - License Number: Professional license number
+   - Address: Complete Malaysian address
+   - Contact Information: Phone, email, website
+   - Operating Hours: Clinic operating hours
+   - Emergency Contact: After-hours contact information
+   - Services: Medical services offered
+   ```
+
+#### Healthcare Provider Setup
+
+1. Navigate to **Healthcare → Settings → Healthcare Providers**
+2. Add medical practitioners:
+   ```markdown
+   Practitioner Information:
+   - Full Name: Doctor's full name as per IC
+   - IC Number: Malaysian IC number
+   - Medical License: MMC registration number
+   - Specialization: Medical specialty
+   - Qualifications: Medical qualifications
+   - Contact Information: Professional contact details
+   - Schedule: Available hours
+   - Consultation Fees: Standard consultation rates
+   ```
+
+#### Department Configuration
+
+1. Navigate to **Healthcare → Settings → Departments**
+2. Set up departments:
+   ```markdown
+   Department Structure:
+   - General Practice: Primary care services
+   - Specialist Care: Various medical specialties
+   - Laboratory: Diagnostic services
+   - Pharmacy: Medication dispensing
+   - Radiology: Imaging services
+   - Emergency: Emergency care services
+   - Administration: Administrative services
+   ```
+
+### 2. Service Configuration
+
+#### Medical Services
+
+1. Navigate to **Healthcare → Settings → Services**
+2. Configure medical services:
+   ```markdown
+   Service Categories:
+   - Consultations: General and specialist consultations
+   - Procedures: Medical procedures and treatments
+   - Diagnostics: Laboratory and imaging services
+   - Vaccinations: Immunization services
+   - Health Screening: Preventive care services
+   - Minor Surgery: Outpatient surgical procedures
+   - Follow-up: Post-treatment follow-ups
+   ```
+
+#### Fee Structure
+
+1. Navigate to **Healthcare → Settings → Fee Structure**
+2. Set up consultation fees:
+   ```markdown
+   Fee Configuration:
+   - New Patient: First consultation fee
+   - Follow-up: Subsequent consultation fees
+   - Specialist: Specialist consultation fees
+   - Procedures: Procedure-specific fees
+   - Diagnostics: Laboratory and imaging fees
+   - Vaccinations: Immunization fees
+   - Emergency: Emergency consultation fees
+   ```
+
+## Patient Management
+
+### 1. Patient Registration
+
+#### New Patient Registration
+
+1. Navigate to **Healthcare → Patients → Register New Patient**
+2. Enter patient information:
+   ```markdown
+   Patient Demographics:
+   - Personal Information:
+     • Full Name: Name as per IC
+     • IC Number: Malaysian IC format (YYYYMMDD-XX-XXXX)
+     • Gender: Male/Female
+     • Date of Birth: Date of birth
+     • Age: Auto-calculated from IC
+     • Blood Type: Blood group if known
+     • Marital Status: Single, Married, Divorced, Widowed
+     • Nationality: Malaysian or other
+     • Race: Ethnic background (optional)
+
+   - Contact Information:
+     • Phone Number: Primary contact number
+     • Alternative Phone: Secondary contact
+     • Email Address: Email for communications
+     • Emergency Contact: Emergency contact person
+     • Emergency Phone: Emergency contact number
+
+   - Address:
+     • Street Address: Complete address
+     • City/Town: City or town
+     • State: Malaysian state
+     • Postal Code: Postcode
+     • Country: Malaysia (default)
+
+   - Medical Information:
+     • Allergies: Known allergies
+     • Medical Conditions: Pre-existing conditions
+     • Current Medications: Ongoing medications
+     • Family History: Family medical history
+     • Last Physical: Last general check-up date
+     • Primary Doctor: Regular healthcare provider
+     • Insurance Provider: Health insurance information
+   ```
+
+#### Medical History
+
+1. Navigate to **Healthcare → Patients → Medical History**
+2. Document medical history:
+   ```markdown
+   Medical History Categories:
+   - Past Medical History: Previous illnesses and conditions
+   - Surgical History: Past surgical procedures
+   - Medication History: Current and past medications
+   - Allergy History: Known allergies and reactions
+   - Family History: Family medical conditions
+   - Social History: Lifestyle factors (smoking, alcohol, etc.)
+   - Immunization History: Vaccination records
+   - Obstetric History: For female patients (if applicable)
+   ```
+
+### 2. Patient Records Management
+
+#### Electronic Health Records (EHR)
+
+1. Navigate to **Healthcare → Patients → EHR**
+2. Manage electronic records:
+   ```markdown
+   EHR Components:
+   - Patient Demographics: Basic patient information
+   - Medical History: Comprehensive medical history
+   - Clinical Notes: Doctor consultation notes
+   - Vital Signs: Blood pressure, weight, height, etc.
+   - Laboratory Results: Blood test and diagnostic results
+   - Imaging Results: X-ray, ultrasound, MRI results
+   - Prescriptions: Current and past medications
+   - Immunizations: Vaccination records
+   - Allergies: Allergy information and reactions
+   - Procedures: Medical procedures performed
+   - Referrals: Specialist referral information
+   ```
+
+#### Document Management
+
+1. Navigate to **Healthcare → Patients → Documents**
+2. Manage patient documents:
+   ```markdown
+   Document Types:
+   - Medical Reports: Specialist reports and test results
+   - Imaging Results: X-rays, MRIs, CT scans
+   - Laboratory Reports: Blood test results
+   - Consent Forms: Treatment consent forms
+   - Insurance Documents: Insurance-related documents
+   - ID Documents: Patient identification documents
+   - Discharge Summaries: Hospital discharge summaries
+   - Referral Letters: Specialist referral letters
+   ```
+
+### 3. Patient Privacy and PDPA Compliance
+
+#### Privacy Settings
+
+1. Navigate to **Healthcare → Settings → Privacy**
+2. Configure privacy settings:
+   ```markdown
+   PDPA Compliance Settings:
+   - Data Collection: Patient consent for data collection
+   - Data Usage: How patient data can be used
+   - Data Sharing: With whom data can be shared
+   - Data Retention: How long to keep records
+   - Access Control: Who can access patient data
+   - Audit Trail: Track data access and modifications
+   - Patient Rights: Data access and correction rights
+   ```
+
+#### Consent Management
+
+1. Navigate to **Healthcare → Patients → Consents**
+2. Manage patient consents:
+   ```markdown
+   Consent Types:
+   - Treatment Consent: Consent for medical treatment
+   - Data Processing: Consent for data processing
+   - Research Participation: Consent for research studies
+   - Marketing Communications: Consent for marketing
+   - Third-party Sharing: Consent for data sharing
+   - Emergency Contact: Emergency contact authorization
+   - Insurance Processing: Insurance claim authorization
+   ```
+
+## Appointment Management
+
+### 1. Appointment Scheduling
+
+#### Creating Appointments
+
+1. Navigate to **Healthcare → Appointments → New Appointment**
+2. Schedule appointment:
+   ```markdown
+   Appointment Details:
+   - Patient Information: Select patient
+   - Healthcare Provider: Choose doctor/specialist
+   - Appointment Type: Type of consultation
+   - Date and Time: Preferred date and time
+   - Duration: Appointment length
+   - Reason for Visit: Chief complaint or reason
+   - Department: Relevant department
+   - Location: Clinic/room location
+   - Priority: Appointment priority level
+   - Status: Appointment status (confirmed, pending, etc.)
+   ```
+
+#### Appointment Types
+
+1. Navigate to **Healthcare → Settings → Appointment Types**
+2. Configure appointment types:
+   ```markdown
+   Appointment Categories:
+   - New Patient: First-time consultation
+   - Follow-up: Subsequent consultation
+   - Specialist: Specialist consultation
+   - Emergency: Emergency consultation
+   - Vaccination: Immunization appointment
+   - Health Screening: Preventive care appointment
+   - Minor Procedure: Outpatient procedure
+   - Review: Medical review appointment
+   - Telephone: Phone consultation
+   - Video: Telemedicine consultation
+   ```
+
+### 2. Calendar Management
+
+#### Clinic Calendar
+
+1. Navigate to **Healthcare → Appointments → Calendar**
+2. View and manage appointments:
+   ```markdown
+   Calendar Views:
+   - Daily View: Appointments for selected day
+   - Weekly View: Week overview
+   - Monthly View: Month overview
+   - Resource View: By healthcare provider
+   - Department View: By department
+   - Status View: By appointment status
+   ```
+
+#### Appointment Reminders
+
+1. Navigate to **Healthcare → Settings → Reminders**
+2. Configure reminder settings:
+   ```markdown
+   Reminder Configuration:
+   - SMS Reminders: Text message reminders
+   - Email Reminders: Email notifications
+   - Phone Reminders: Phone call reminders
+   - Reminder Timing: When to send reminders
+   - No-show Alerts: Late arrival notifications
+   - Cancellation Policy: Cancellation rules
+   - Waitlist: Waitlist management
+   ```
+
+### 3. Appointment Analytics
+
+#### Appointment Statistics
+
+1. Navigate to **Healthcare → Reports → Appointments**
+2. View appointment metrics:
+   ```markdown
+   Appointment Metrics:
+   - Total Appointments: Number of appointments
+   - Appointment Types: Breakdown by type
+   - No-show Rate: Missed appointment percentage
+   - Cancellation Rate: Cancelled appointment rate
+   - Wait Times: Patient wait times
+   - Provider Utilization: Doctor availability
+   - Peak Hours: Busy time periods
+   - Seasonal Trends: Appointment patterns
+   ```
+
+## Medical Records Management
+
+### 1. Clinical Documentation
+
+#### Consultation Notes
+
+1. Navigate to **Healthcare → Clinical → Consultation Notes**
+2. Document consultations:
+   ```markdown
+   SOAP Note Format:
+   - Subjective: Patient symptoms and complaints
+   - Objective: Examination findings and vital signs
+   - Assessment: Diagnosis and clinical assessment
+   - Plan: Treatment plan and follow-up
+   ```
+
+#### Progress Notes
+
+1. Navigate to **Healthcare → Clinical → Progress Notes**
+2. Track patient progress:
+   ```markdown
+   Progress Note Components:
+   - Date and Time: Note creation time
+   - Healthcare Provider: Author of note
+   - Patient Status: Current condition
+   - Treatment Response: Response to treatment
+   - Medication Changes: Medication adjustments
+   - New Developments: New symptoms or findings
+   - Plan Changes: Treatment plan modifications
+   ```
+
+### 2. Prescriptions
+
+#### Electronic Prescribing
+
+1. Navigate to **Healthcare → Prescriptions → New Prescription**
+2. Create prescription:
+   ```markdown
+   Prescription Details:
+   - Patient Information: Patient details
+   - Medication Name: Drug name and strength
+   - Dosage: Medication dosage
+   - Frequency: How often to take
+   - Duration: Treatment duration
+   - Quantity: Total quantity prescribed
+   - Instructions: Patient instructions
+   - Refills: Number of refills allowed
+   - Prescriber: Doctor's information
+   - Date: Prescription date
+   - Signature: Digital signature
+   ```
+
+#### Medication Management
+
+1. Navigate to **Healthcare → Prescriptions → Medication List**
+2. Manage patient medications:
+   ```markdown
+   Medication Tracking:
+   - Current Medications: Active prescriptions
+   - Past Medications: Completed treatments
+   - Allergies: Drug allergies and reactions
+   - Interactions: Drug interaction warnings
+   - Adherence: Medication adherence tracking
+   - Refills: Refill status and history
+   ```
+
+### 3. Laboratory and Diagnostics
+
+#### Lab Orders
+
+1. Navigate to **Healthcare → Laboratory → New Order**
+2. Order laboratory tests:
+   ```markdown
+   Lab Test Categories:
+   - Blood Tests: Complete blood count, chemistry panels
+   - Urine Tests: Urinalysis, drug screening
+   - Imaging: X-ray, ultrasound, MRI, CT scans
+   - Specialized Tests: Genetic testing, biopsies
+   - Screening: Health screening packages
+   - Monitoring: Chronic disease monitoring
+   ```
+
+#### Results Management
+
+1. Navigate to **Healthcare → Laboratory → Results**
+2. Manage test results:
+   ```markdown
+   Results Management:
+   - Result Entry: Enter test results
+   - Normal Ranges: Reference ranges
+   - Abnormal Values: Flag abnormal results
+   - Critical Values: Alert for critical results
+   - Trend Analysis: Track changes over time
+   - Patient Notification: Inform patients of results
+   - Doctor Review: Doctor's interpretation
+   ```
+
+## Billing and Insurance
+
+### 1. Fee Management
+
+#### Service Billing
+
+1. Navigate to **Healthcare → Billing → Services**
+2. Manage service fees:
+   ```markdown
+   Billing Categories:
+   - Consultation Fees: Doctor consultation charges
+   - Procedure Fees: Medical procedure charges
+   - Laboratory Fees: Test and diagnostic charges
+   - Medication Fees: Prescription charges
+   - Room Fees: Facility usage charges
+   - Equipment Fees: Medical equipment charges
+   - Other Fees: Miscellaneous charges
+   ```
+
+#### Insurance Integration
+
+1. Navigate to **Healthcare → Billing → Insurance**
+2. Configure insurance providers:
+   ```markdown
+   Malaysian Insurance Providers:
+   - Government Insurance: SOCSO, civil servants
+   - Private Insurance: Great Eastern, AIA, Prudential
+   - Corporate Insurance: Company health plans
+   - Employee Benefits: Employee health schemes
+   - Travel Insurance: Visitor health insurance
+   - Self-pay: Private payment options
+   ```
+
+### 2. Claims Processing
+
+#### Insurance Claims
+
+1. Navigate to **Healthcare → Billing → Claims**
+2. Process insurance claims:
+   ```markdown
+   Claim Processing:
+   - Claim Submission: Submit to insurance
+   - Claim Status: Track claim progress
+   - Reimbursement: Process reimbursements
+   - Rejections: Handle rejected claims
+   - Appeals: Appeal denied claims
+   - Reports: Generate claim reports
+   - Reconciliation: Match payments to claims
+   ```
+
+#### Patient Billing
+
+1. Navigate to **Healthcare → Billing → Patient Billing**
+2. Manage patient accounts:
+   ```markdown
+   Patient Billing:
+   - Invoice Generation: Create patient invoices
+   - Payment Processing: Accept payments
+   - Payment Plans: Set up installment plans
+   - Outstanding Balances: Track unpaid amounts
+   - Statements: Send account statements
+   - Collections: Manage overdue accounts
+   - Discounts: Apply eligible discounts
+   ```
+
+## Malaysian Healthcare Compliance
+
+### 1. KKM Compliance
+
+#### Ministry of Health Requirements
+
+1. Navigate to **Healthcare → Settings → KKM Compliance**
+2. Configure compliance settings:
+   ```markdown
+   KKM Requirements:
+   - Clinic Registration: Valid KKM registration
+   - License Management: Professional licenses
+   - Facility Standards: Clinic facility requirements
+   - Equipment Standards: Medical equipment compliance
+   - Safety Standards: Patient safety protocols
+   - Quality Standards: Healthcare quality metrics
+   - Reporting Requirements: Mandatory reporting
+   - Inspection Records: Facility inspection history
+   ```
+
+#### Malaysian Medical Guidelines
+
+1. Navigate to **Healthcare → Settings → Medical Guidelines**
+2. Set up clinical guidelines:
+   ```markdown
+   Clinical Guidelines:
+   - Treatment Protocols: Standard treatment procedures
+   - Prescription Guidelines: Medication prescribing rules
+   - Referral Guidelines: When to refer specialists
+   - Emergency Protocols: Emergency treatment procedures
+   - Infection Control: Infection prevention protocols
+   - Patient Safety: Safety procedures and protocols
+   - Ethics Guidelines: Medical ethics and conduct
+   ```
+
+### 2. PDPA Compliance
+
+#### Data Protection
+
+1. Navigate to **Healthcare → Settings → PDPA**
+2. Configure data protection:
+   ```markdown
+   PDPA Implementation:
+   - Data Collection: Patient data collection consent
+   - Data Usage: How data is used and processed
+   - Data Security: Security measures for data protection
+   - Access Control: Who can access patient data
+   - Data Retention: How long data is kept
+   - Data Disposal: Secure data deletion procedures
+   - Breach Notification: Data breach procedures
+   - Patient Rights: Data access and correction rights
+   ```
+
+#### Audit Trail
+
+1. Navigate to **Healthcare → Reports → Audit Trail**
+2. Review data access logs:
+   ```markdown
+   Audit Trail Features:
+   - Access Logs: Who accessed patient records
+   - Modification Logs: Changes to patient data
+   - Access Time: When records were accessed
+   - Access Purpose: Reason for access
+   - User Identification: Who made the access
+   - System Changes: System configuration changes
+   - Security Events: Security-related events
+   - Compliance Reports: Compliance monitoring reports
+   ```
+
+## Reporting and Analytics
+
+### 1. Clinical Reports
+
+#### Patient Statistics
+
+1. Navigate to **Healthcare → Reports → Patient Statistics**
+2. View patient metrics:
+   ```markdown
+   Patient Metrics:
+   - Total Patients: Number of registered patients
+   - New Patients: Patient acquisition rate
+   - Active Patients: Regularly visiting patients
+   - Patient Demographics: Age, gender, location
+   - Patient Retention: Return visit rates
+   - No-show Rates: Missed appointment rates
+   - Patient Satisfaction: Satisfaction survey results
+   ```
+
+#### Clinical Outcomes
+
+1. Navigate to **Healthcare → Reports → Clinical Outcomes**
+2. Analyze treatment outcomes:
+   ```markdown
+   Outcome Metrics:
+   - Treatment Success: Treatment effectiveness
+   - Recovery Rates: Patient recovery statistics
+   - Complication Rates: Treatment complications
+   - Readmission Rates: Hospital readmissions
+   - Medication Adherence: Patient compliance
+   - Screening Rates: Preventive care participation
+   - Vaccination Rates: Immunization coverage
+   ```
+
+### 2. Operational Reports
+
+#### Clinic Performance
+
+1. Navigate to **Healthcare → Reports → Clinic Performance**
+2. View clinic metrics:
+   ```markdown
+   Performance Metrics:
+   - Patient Volume: Number of patients seen
+   - Appointment Utilization: Schedule efficiency
+   - Wait Times: Patient waiting times
+   - Provider Productivity: Doctor efficiency
+   - Revenue per Patient: Average revenue
+   - Cost per Visit: Operational costs
+   - Resource Utilization: Staff and facility usage
+   ```
+
+#### Financial Reports
+
+1. Navigate to **Healthcare → Reports → Financial**
+2. Analyze financial performance:
+   ```markdown
+   Financial Metrics:
+   - Revenue: Total clinic revenue
+   - Expenses: Operating expenses
+   - Profit: Net profit/loss
+   - Insurance Revenue: Insurance payments
+   - Patient Payments: Direct patient payments
+   - Bad Debt: Unpaid accounts
+   - Claim Rejections: Denied insurance claims
+   ```
+
+## Mobile Features
+
+### 1. Mobile Patient Access
+
+#### Patient App Features
+
+1. Patients can use the mobile app to:
+   ```markdown
+   Mobile Capabilities:
+   - Appointments: Book and manage appointments
+   - Medical Records: View personal medical records
+   - Prescriptions: View current prescriptions
+   - Test Results: Access laboratory results
+   - Billing: View and pay bills
+   - Notifications: Receive appointment reminders
+   - Communication: Secure messaging with clinic
+   - Health Tracking: Track personal health metrics
+   ```
+
+### 2. Provider Mobile Access
+
+#### Doctor Mobile Features
+
+1. Healthcare providers can use mobile to:
+   ```markdown
+   Provider Mobile Features:
+   - Schedule: View and manage appointments
+   - Patient Records: Access patient information
+   - Prescriptions: Write and manage prescriptions
+   - Test Results: Review laboratory results
+   - Communication: Message patients and staff
+   - On-call: Manage on-call responsibilities
+   - Telemedicine: Conduct virtual consultations
+   - Documentation: Add clinical notes
+   ```
+
+## Telemedicine Features
+
+### 1. Virtual Consultations
+
+#### Setting Up Telemedicine
+
+1. Navigate to **Healthcare → Settings → Telemedicine**
+2. Configure telemedicine:
+   ```markdown
+   Telemedicine Configuration:
+   - Virtual Scheduling: Online appointment booking
+   - Video Conferencing: Video consultation setup
+   - Payment Processing: Online payment integration
+   - Prescriptions: E-prescribing for telemedicine
+   - Documentation: Virtual visit documentation
+   - Technical Support: Patient and provider support
+   - Privacy: Telemedicine privacy measures
+   ```
+
+#### Virtual Visit Process
+
+1. Navigate to **Healthcare → Telemedicine → Virtual Visit**
+2. Conduct virtual consultations:
+   ```markdown
+   Virtual Visit Process:
+   1. Patient books virtual appointment
+   2. Patient receives virtual room link
+   3. Doctor and patient join virtual room
+   4. Conduct video consultation
+   5. Document consultation findings
+   6. Prescribe medications if needed
+   7. Schedule follow-up if required
+   8. Process payment
+   ```
+
+## Troubleshooting
+
+### 1. Common Issues
+
+#### Appointment Scheduling Issues
+
+**Booking Conflicts**
+- Check provider availability
+- Verify room availability
+- Review double bookings
+- Update calendar synchronization
+- Contact technical support
+
+**Reminder Failures**
+- Verify contact information
+- Check notification settings
+- Review SMS/email configuration
+- Test reminder system
+- Update patient preferences
+
+#### Medical Record Issues
+
+**Access Problems**
+- Verify user permissions
+- Check patient consent settings
+- Review system access logs
+- Reset user access if needed
+- Contact system administrator
+
+**Data Sync Issues**
+- Check internet connection
+- Verify cloud synchronization
+- Update mobile applications
+- Clear application cache
+- Reinstall applications
+
+### 2. Technical Issues
+
+**System Performance**
+- Clear browser cache
+- Update applications
+- Check internet speed
+- Verify system status
+- Contact technical support
+
+**Mobile App Issues**
+- Ensure latest version
+- Check device compatibility
+- Restart mobile device
+- Update operating system
+- Reinstall application
+
+## Best Practices
+
+### 1. Patient Care
+
+**Clinical Excellence**
+- Follow clinical guidelines
+- Maintain accurate records
+- Communicate effectively
+- Respect patient privacy
+- Provide compassionate care
+
+**Patient Experience**
+- Minimize wait times
+- Provide clear instructions
+- Maintain clean facilities
+- Train staff effectively
+- Collect patient feedback
+
+### 2. Operational Efficiency
+
+**Clinic Management**
+- Optimize appointment scheduling
+- Maintain adequate supplies
+- Train staff effectively
+- Monitor performance metrics
+- Implement continuous improvement
+
+**Financial Management**
+- Monitor revenue and expenses
+- Optimize billing processes
+- Manage accounts receivable
+- Control operational costs
+- Plan for growth
+
+### 3. Malaysian Healthcare Compliance
+
+**Regulatory Compliance**
+- Stay updated on KKM regulations
+- Maintain proper documentation
+- Conduct regular audits
+- Train staff on compliance
+- Implement quality improvement
+
+**Data Protection**
+- Follow PDPA guidelines
+- Implement security measures
+- Train staff on privacy
+- Conduct regular security reviews
+- Maintain audit trails
+
+## Conclusion
+
+The Healthcare Module provides comprehensive solutions for Malaysian healthcare providers. By following this guide, you can effectively manage your practice, maintain compliance with Malaysian regulations, and provide excellent patient care.
+
+Remember to:
+1. **Stay Compliant**: Keep up with KKM and PDPA requirements
+2. **Use Technology**: Leverage mobile and telemedicine features
+3. **Focus on Quality**: Maintain high clinical standards
+4. **Train Staff**: Ensure staff are properly trained
+5. **Monitor Performance**: Regularly review metrics and reports
+
+For additional support:
+- **Help Center**: Comprehensive knowledge base
+- **Video Tutorials**: Step-by-step training videos
+- **Community Forum**: Connect with other healthcare providers
+- **Technical Support**: healthcare-support@yourplatform.com
+- **Training Resources**: healthcare-training@yourplatform.com
+
+Success with the Healthcare Module comes from understanding Malaysian healthcare requirements, maintaining high clinical standards, and providing excellent patient care while ensuring compliance with all relevant regulations.

docs/user-guides/modules/retail.md

@@ -0,0 +1,769 @@
+# Retail Module User Guide
+
+## Overview
+
+The Retail Module provides comprehensive solutions for Malaysian retail businesses, including inventory management, sales processing, customer relationship management, and Malaysian market-specific features like SST compliance and local payment methods.
+
+### Key Features
+
+- **Inventory Management**: Track stock levels, manage suppliers, automate reordering
+- **Sales Processing**: Complete POS functionality with Malaysian payment methods
+- **Customer Management**: Loyalty programs, customer insights, personalized marketing
+- **SST Compliance**: Automated SST calculation and reporting
+- **Multi-location**: Support for multiple store locations
+- **Reporting**: Comprehensive sales and inventory reports
+- **Mobile Access**: Full functionality on mobile devices
+
+## Getting Started
+
+### 1. Module Setup
+
+#### Initial Configuration
+
+1. Navigate to **Retail → Settings → General**
+2. Configure basic settings:
+   ```markdown
+   Required Settings:
+   - Store Name: Your business name
+   - Store Address: Malaysian address format
+   - Contact Information: Phone and email
+   - Business Hours: Operating hours
+   - Currency: Malaysian Ringgit (MYR)
+   - Timezone: Asia/Kuala Lumpur (UTC+8)
+   ```
+
+#### SST Configuration
+
+1. Navigate to **Retail → Settings → Tax**
+2. Configure SST settings:
+   ```markdown
+   SST Configuration:
+   - SST Registration Number: Your SST registration number
+   - Standard Rate: 6% (default)
+   - Exempt Categories: Configure tax-exempt products
+   - SST-Registered: Enable if you are SST-registered
+   - Include SST in Prices: Choose pricing strategy
+   ```
+
+#### Payment Methods
+
+1. Navigate to **Retail → Settings → Payment Methods**
+2. Enable Malaysian payment options:
+   ```markdown
+   Available Payment Methods:
+   - Cash: Cash payments
+   - Touch 'n Go: e-wallet payments
+   - GrabPay: e-wallet payments
+   - Credit Cards: Visa, Mastercard, Amex
+   - Debit Cards: Bank debit cards
+   - Online Banking: Maybank2U, CIMB Clicks, etc.
+   - E-wallets: Boost, ShopeePay, etc.
+   ```
+
+### 2. Product Setup
+
+#### Creating Product Categories
+
+1. Navigate to **Retail → Products → Categories**
+2. Create categories for your products:
+   ```markdown
+   Example Categories:
+   - Electronics
+   - Clothing & Apparel
+   - Food & Beverages
+   - Health & Beauty
+   - Home & Living
+   - Sports & Outdoors
+   ```
+
+#### Adding Products
+
+1. Navigate to **Retail → Products → Add Product**
+2. Enter product details:
+   ```markdown
+   Product Information:
+   - SKU: Unique stock keeping unit
+   - Product Name: Descriptive product name
+   - Category: Select appropriate category
+   - Description: Detailed product description
+   - Brand: Product brand
+   - Barcode: Product barcode (optional)
+   ```
+
+3. Configure pricing:
+   ```markdown
+   Pricing Information:
+   - Cost Price: Your cost price
+   - Selling Price: Retail price
+   - SST Rate: 6% or exempt
+   - Discount: Default discount percentage
+   - Promotion: Special pricing if applicable
+   ```
+
+4. Set inventory details:
+   ```markdown
+   Inventory Details:
+   - Current Stock: Current stock quantity
+   - Reorder Point: When to reorder
+   - Maximum Stock: Maximum stock level
+   - Location: Store location
+   - Supplier: Default supplier
+   ```
+
+## Inventory Management
+
+### 1. Stock Management
+
+#### Receiving Stock
+
+1. Navigate to **Retail → Inventory → Receive Stock**
+2. Select supplier and purchase order
+3. Enter received quantities:
+   ```markdown
+   Receiving Process:
+   - Select Supplier: Choose from supplier list
+   - PO Reference: Purchase order number
+   - Receive Date: Date of receipt
+   - Products: List of products received
+   - Quantities: Actual quantities received
+   - Condition: Note any damaged items
+   ```
+
+#### Stock Transfers
+
+1. Navigate to **Retail → Inventory → Stock Transfer**
+2. Configure transfer:
+   ```markdown
+   Transfer Details:
+   - From Location: Source store/location
+   - To Location: Destination store/location
+   - Products: Items to transfer
+   - Quantities: Transfer quantities
+   - Transfer Date: Date of transfer
+   - Reason: Purpose of transfer
+   ```
+
+#### Stock Adjustments
+
+1. Navigate to **Retail → Inventory → Stock Adjustment**
+2. Make adjustments:
+   ```markdown
+   Adjustment Types:
+   - Damage: Write off damaged stock
+   - Loss: Account for lost stock
+   - Found: Add found items
+   - Count Correction: Fix counting errors
+   - Expiry: Remove expired items
+   ```
+
+### 2. Supplier Management
+
+#### Adding Suppliers
+
+1. Navigate to **Retail → Suppliers → Add Supplier**
+2. Enter supplier information:
+   ```markdown
+   Supplier Details:
+   - Company Name: Supplier business name
+   - Contact Person: Primary contact
+   - Phone: Contact phone number
+   - Email: Contact email
+   - Address: Supplier address
+   - Payment Terms: Payment conditions
+   - Products: Products supplied
+   - Lead Time: Delivery time
+   ```
+
+#### Purchase Orders
+
+1. Navigate to **Retail → Purchasing → Create PO**
+2. Create purchase order:
+   ```markdown
+   PO Creation:
+   - Supplier: Select supplier
+   - Order Date: Order placement date
+   - Expected Delivery: Delivery date
+   - Products: Required items and quantities
+   - Prices: Agreed prices
+   - Terms: Payment and delivery terms
+   ```
+
+### 3. Inventory Reports
+
+#### Stock Status Report
+
+1. Navigate to **Retail → Reports → Inventory → Stock Status**
+2. Generate report with filters:
+   ```markdown
+   Available Filters:
+   - Product Category: Filter by category
+   - Stock Level: Low stock, normal, high stock
+   - Location: Specific store locations
+   - Supplier: Filter by supplier
+   - Date Range: Specific time period
+   ```
+
+#### Inventory Valuation
+
+1. Navigate to **Retail → Reports → Inventory → Valuation**
+2. View inventory value:
+   ```markdown
+   Valuation Methods:
+   - FIFO: First In, First Out
+   - LIFO: Last In, First Out
+   - Weighted Average: Average cost method
+   - Specific Cost: Track specific costs
+   ```
+
+## Sales Processing
+
+### 1. Point of Sale (POS)
+
+#### Sales Transaction
+
+1. Navigate to **Retail → POS → New Sale**
+2. Process sale:
+   ```markdown
+   Sales Process:
+   1. Add Products: Scan or select products
+   2. Enter Quantities: Specify quantities
+   3. Apply Discounts: Add customer discounts
+   4. Calculate Total: System calculates total with SST
+   5. Select Payment: Choose payment method
+   6. Process Payment: Complete payment
+   7. Generate Receipt: Print or email receipt
+   ```
+
+#### Payment Processing
+
+**Cash Payments**
+- Enter amount received
+- Calculate change
+- Complete transaction
+
+**E-wallet Payments**
+- Select e-wallet type (Touch 'n Go, GrabPay)
+- Generate QR code
+- Wait for customer payment
+- Confirm payment
+
+**Card Payments**
+- Insert/swipe card
+- Enter PIN if required
+- Process transaction
+- Get authorization
+
+**Online Banking**
+- Select bank
+- Generate payment reference
+- Customer completes online payment
+- Confirm payment received
+
+### 2. Sales Management
+
+#### Sales Orders
+
+1. Navigate to **Retail → Sales → Sales Orders**
+2. Create sales order:
+   ```markdown
+   Sales Order Details:
+   - Customer: Select customer
+   - Order Date: Order placement date
+   - Products: Items and quantities
+   - Prices: Agreed prices
+   - Discounts: Any applicable discounts
+   - Delivery: Delivery instructions
+   - Payment Terms: Payment conditions
+   ```
+
+#### Invoices
+
+1. Navigate to **Retail → Sales → Invoices**
+2. Generate SST-compliant invoice:
+   ```markdown
+   Invoice Requirements:
+   - Business Details: Your business information
+   - SST Registration: Your SST number
+   - Customer Details: Customer information
+   - Invoice Number: Unique invoice number
+   - Date: Invoice date
+   - Items: Products/services provided
+   - SST Amount: SST calculation
+   - Total Amount: Total including SST
+   - Payment Terms: Payment conditions
+   ```
+
+#### Returns and Refunds
+
+1. Navigate to **Retail → Sales → Returns**
+2. Process return:
+   ```markdown
+   Return Process:
+   - Original Invoice: Reference original sale
+   - Return Date: Date of return
+   - Products: Items being returned
+   - Reason: Return reason
+   - Condition: Item condition
+   - Refund Method: How to process refund
+   - Restock: Whether to restock item
+   ```
+
+### 3. Sales Reports
+
+#### Sales Summary
+
+1. Navigate to **Retail → Reports → Sales → Summary**
+2. View sales performance:
+   ```markdown
+   Sales Metrics:
+   - Total Sales: Gross sales amount
+   - Net Sales: Sales after returns
+   - SST Collected: Total SST amount
+   - Average Transaction: Average sale value
+   - Items Sold: Total units sold
+   - Top Products: Best-selling items
+   ```
+
+#### Sales by Category
+
+1. Navigate to **Retail → Reports → Sales → By Category**
+2. Analyze category performance:
+   ```markdown
+   Category Analysis:
+   - Category Sales: Sales by product category
+   - Category Profit: Profit by category
+   - Category Margin: Profit margin by category
+   - Category Growth: Growth trends by category
+   ```
+
+## Customer Management
+
+### 1. Customer Registration
+
+#### Adding Customers
+
+1. Navigate to **Retail → Customers → Add Customer**
+2. Enter customer information:
+   ```markdown
+   Customer Information:
+   - Personal Details:
+     • Full Name: Customer's full name
+     • IC Number: Malaysian IC (optional)
+     • Phone: Contact phone number
+     • Email: Email address
+     • Date of Birth: For age verification
+
+   - Address:
+     • Street Address: Complete address
+     • City: City or town
+     • State: Malaysian state
+     • Postal Code: Postcode
+     • Country: Malaysia (default)
+
+   - Preferences:
+     • Communication: Preferred contact method
+     • Language: Preferred language
+     • Interests: Product interests
+   ```
+
+#### Customer Groups
+
+1. Navigate to **Retail → Customers → Groups**
+2. Create customer segments:
+   ```markdown
+   Customer Groups:
+   - VIP Customers: High-value customers
+   - Regular Customers: Frequent shoppers
+   - New Customers: Recently acquired
+   - Wholesale: Business customers
+   - Senior Citizens: Age 60+ customers
+   - Students: Student customers
+   ```
+
+### 2. Loyalty Program
+
+#### Setting Up Loyalty Program
+
+1. Navigate to **Retail → Settings → Loyalty Program**
+2. Configure loyalty program:
+   ```markdown
+   Loyalty Configuration:
+   - Program Name: Name of your loyalty program
+   - Points per RM: Points earned per ringgit spent
+   - Redemption Rate: Points needed for rewards
+   - Tiers: Customer benefit tiers
+   - Expiry: Points expiration policy
+   - Benefits: Tier-specific benefits
+   ```
+
+#### Customer Tiers
+
+1. Navigate to **Retail → Settings → Loyalty Tiers**
+2. Define customer tiers:
+   ```markdown
+   Tier Structure:
+   - Bronze Tier: Entry level (0-500 points)
+     • 1 point per RM spent
+     • Birthday discount: 5%
+
+   - Silver Tier: Mid level (501-2000 points)
+     • 1.2 points per RM spent
+     • Birthday discount: 10%
+     • Early access to sales
+
+   - Gold Tier: High level (2001+ points)
+     • 1.5 points per RM spent
+     • Birthday discount: 15%
+     • Early access to sales
+     • Exclusive events
+   ```
+
+### 3. Customer Communication
+
+#### Email Marketing
+
+1. Navigate to **Retail → Marketing → Email Campaigns**
+2. Create email campaign:
+   ```markdown
+   Campaign Setup:
+   - Campaign Name: Descriptive campaign name
+   - Target Audience: Customer segments
+   - Email Template: Choose or create template
+   - Content: Campaign content
+   - Schedule: Send date and time
+   - Personalization: Dynamic content fields
+   ```
+
+#### SMS Marketing
+
+1. Navigate to **Retail → Marketing → SMS Campaigns**
+2. Create SMS campaign:
+   ```markdown
+   SMS Campaign:
+   - Message Content: SMS text (160 characters)
+   - Recipients: Target customer list
+   - Send Time: Scheduled send time
+   - Personalization: Customer name insertions
+   - Opt-out: Include opt-out instructions
+   ```
+
+## Malaysian Market Features
+
+### 1. SST Compliance
+
+#### SST Configuration
+
+1. Navigate to **Retail → Settings → SST**
+2. Configure SST settings:
+   ```markdown
+   SST Settings:
+   - SST Registration: Your SST registration number
+   - Tax Rates: Standard rate (6%) and exempt categories
+   - Tax-Inclusive Pricing: Whether prices include SST
+   - Invoice Requirements: SST-compliant invoicing
+   - Reporting: SST reporting and filing
+   - Audit Trail: Transaction history for audits
+   ```
+
+#### SST Reporting
+
+1. Navigate to **Retail → Reports → SST**
+2. Generate SST reports:
+   ```markdown
+   SST Reports:
+   - SST Summary: Total SST collected
+   - SST by Category: SST by product category
+   - SST Transactions: Detailed SST transactions
+   - SST Filing: Ready-to-file SST reports
+   - Exempt Sales: Sales exempt from SST
+   ```
+
+### 2. Malaysian Payment Methods
+
+#### E-wallet Integration
+
+1. Navigate to **Retail → Settings → Payment Methods**
+2. Configure e-wallets:
+   ```markdown
+   E-wallet Setup:
+   - Touch 'n Go: Business account setup
+   - GrabPay: Merchant configuration
+   - Boost: Merchant setup
+   - ShopeePay: Business account setup
+   - Transaction Fees: Configure fee structure
+   - Settlement: Bank settlement details
+   ```
+
+#### Online Banking
+
+1. Navigate to **Retail → Settings → Online Banking**
+2. Configure bank integrations:
+   ```markdown
+   Bank Integration:
+   - Maybank2U: Business banking setup
+   - CIMB Clicks: Merchant services
+   - RHB Now: Banking integration
+   - Hong Leong Connect: Payment processing
+   - Payment Gateway: Gateway configuration
+   ```
+
+### 3. Local Business Features
+
+#### Malaysian Address Format
+
+1. Navigate to **Retail → Settings → Address Format**
+2. Configure address format:
+   ```markdown
+   Malaysian Address Format:
+   - Street Address: Street number and name
+   - Taman/Area: Residential or commercial area
+   - Postcode: Malaysian postcode
+   - City: City or town
+   - State: Malaysian state
+   - Country: Malaysia (default)
+   ```
+
+#### Public Holidays
+
+1. Navigate to **Retail → Settings → Holidays**
+2. Configure holidays:
+   ```markdown
+   Malaysian Holidays:
+   - Federal Holidays: National holidays
+   - State Holidays: State-specific holidays
+   - Religious Holidays: Religious observances
+   - Special Events: Special business events
+   - Operating Hours: Holiday operating hours
+   ```
+
+## Reporting and Analytics
+
+### 1. Sales Analytics
+
+#### Sales Performance
+
+1. Navigate to **Retail → Analytics → Sales Performance**
+2. View sales metrics:
+   ```markdown
+   Sales Metrics:
+   - Revenue Trends: Sales over time
+   - Product Performance: Best-selling products
+   - Category Performance: Sales by category
+   - Time Analysis: Sales by time/day
+   - Staff Performance: Sales by staff member
+   - Location Performance: Sales by store location
+   ```
+
+#### Customer Analytics
+
+1. Navigate to **Retail → Analytics → Customer Insights**
+2. Analyze customer data:
+   ```markdown
+   Customer Metrics:
+   - Customer Acquisition: New customers over time
+   - Customer Retention: Repeat customer rate
+   - Customer Lifetime Value: CLV calculations
+   - Purchase Patterns: Buying behavior analysis
+   - Demographics: Customer demographic data
+   - Loyalty Program: Loyalty participation rates
+   ```
+
+### 2. Inventory Analytics
+
+#### Stock Analysis
+
+1. Navigate to **Retail → Analytics → Inventory**
+2. Analyze inventory:
+   ```markdown
+   Inventory Metrics:
+   - Stock Turnover: How quickly inventory sells
+   - Stock Levels: Current inventory status
+   - Aging Inventory: Old stock analysis
+   - Reorder Points: Optimal reorder quantities
+   - Supplier Performance: Supplier delivery times
+   - Lost Sales: Out-of-stock impact
+   ```
+
+#### Demand Forecasting
+
+1. Navigate to **Retail → Analytics → Forecasting**
+2. View forecasts:
+   ```markdown
+   Forecasting Features:
+   - Sales Forecasting: Predict future sales
+   - Demand Planning: Plan inventory needs
+   - Seasonal Trends: Seasonal demand patterns
+   - Trend Analysis: Market trend identification
+   - Alerts: Low stock and overstock alerts
+   ```
+
+## Mobile Features
+
+### 1. Mobile POS
+
+#### Mobile Sales Processing
+
+1. Open mobile app
+2. Navigate to **Retail → POS**
+3. Process sales on mobile:
+   ```markdown
+   Mobile POS Features:
+   - Product Search: Quick product lookup
+   - Barcode Scanning: Camera-based scanning
+   - Mobile Payments: Process payments on device
+   - Receipt Printing: Bluetooth printer support
+   - Offline Mode: Process sales without internet
+   - Sync: Automatic data synchronization
+   ```
+
+#### Inventory Management
+
+1. Navigate to **Retail → Inventory** on mobile
+2. Manage inventory:
+   ```markdown
+   Mobile Inventory Features:
+   - Stock Count: Mobile stock counting
+   - Receiving: Receive shipments on mobile
+   - Transfers: Transfer stock between locations
+   - Adjustments: Make stock adjustments
+   - Barcode Scanning: Scan barcodes with camera
+   - Photos: Add product photos
+   ```
+
+### 2. Customer Management
+
+#### Mobile Customer Lookup
+
+1. Navigate to **Retail → Customers** on mobile
+2. Access customer information:
+   ```markdown
+   Mobile Customer Features:
+   - Customer Search: Find customers quickly
+   - Purchase History: View customer purchases
+   - Loyalty Points: Check point balance
+   - Contact Info: Access contact details
+   - Notes: Add customer notes
+   - Communication: Call or email customers
+   ```
+
+## Troubleshooting
+
+### 1. Common Issues
+
+#### POS Issues
+
+**Transaction Failures**
+- Check internet connection
+- Verify payment gateway status
+- Confirm customer payment method
+- Restart POS application
+- Contact technical support if needed
+
+**Barcode Scanning Issues**
+- Clean camera lens
+- Ensure good lighting
+- Check barcode condition
+- Update mobile app
+- Try manual entry
+
+#### Inventory Issues
+
+**Stock Discrepancies**
+- Perform stock count
+- Check recent transactions
+- Review transfer records
+- Examine return processing
+- Investigate potential theft
+
+**Sync Issues**
+- Check internet connection
+- Verify cloud sync settings
+- Restart mobile application
+- Update application
+- Contact technical support
+
+### 2. Performance Issues
+
+**Slow System Response**
+- Check internet speed
+- Close unused applications
+- Clear browser cache
+- Update mobile app
+- Check system status page
+
+**Mobile App Issues**
+- Ensure latest version
+- Check device compatibility
+- Restart mobile device
+- Clear app data
+- Reinstall if needed
+
+## Best Practices
+
+### 1. Inventory Management
+
+**Stock Control**
+- Perform regular stock counts
+- Set appropriate reorder points
+- Monitor slow-moving items
+- Track expiration dates
+- Implement FIFO rotation
+
+**Supplier Management**
+- Maintain good supplier relationships
+- Negotiate better pricing
+- Monitor supplier performance
+- Diversify supplier base
+- Maintain accurate records
+
+### 2. Sales Processing
+
+**Customer Service**
+- Train staff on product knowledge
+- Implement upselling techniques
+- Handle returns professionally
+- Maintain customer records
+- Personalize customer experience
+
+**Payment Processing**
+- Offer multiple payment options
+- Ensure secure payment processing
+- Reconcile payments daily
+- Handle payment issues promptly
+- Maintain transaction records
+
+### 3. Malaysian Business Practices
+
+**SST Compliance**
+- Keep accurate SST records
+- Issue proper invoices
+- File SST returns on time
+- Stay updated on SST changes
+- Maintain proper documentation
+
+**Cultural Considerations**
+- Respect Malaysian business hours
+- Consider religious holidays
+- Use appropriate language
+- Maintain professional relationships
+- Understand local customs
+
+## Conclusion
+
+The Retail Module provides comprehensive solutions for Malaysian retail businesses. By following this guide, you can effectively manage your retail operations, maintain compliance with Malaysian regulations, and provide excellent customer service.
+
+Remember to:
+1. **Stay Compliant**: Keep up with SST and other regulations
+2. **Use Mobile Features**: Take advantage of mobile capabilities
+3. **Monitor Performance**: Regularly review sales and inventory metrics
+4. **Train Staff**: Ensure staff are properly trained
+5. **Provide Good Service**: Focus on customer satisfaction
+
+For additional support:
+- **Help Center**: Comprehensive knowledge base
+- **Video Tutorials**: Step-by-step video guides
+- **Community Forum**: Connect with other users
+- **Technical Support**: support@yourplatform.com
+- **Training Resources**: training@yourplatform.com
+
+Success with the Retail Module comes from understanding your customers, managing your inventory efficiently, and staying compliant with Malaysian business regulations. Use this guide as your reference for maximizing the value of your retail operations.