Configurable Values

Overview

Configurable values allow you to customize dropdown options, system classifications, and reference data throughout MartialFlow. This guide covers managing system values, creating custom options, and maintaining data consistency across your school's system.

Prerequisites

• Administrative access to system configuration
• Understanding of your school's classification needs
• Knowledge of data consistency requirements
• Familiarity with system-wide impact of value changes

Understanding Configurable Values

Value Types

System Value Categories

• Belt Rankings - Complete belt hierarchy and progression
• Class Categories - Program types and classifications
• Age Groups - Student age category definitions
• Skill Levels - Proficiency classifications
• Achievement Types - Awards and recognition categories

Reference Data Types

• Location Lists - School locations and training areas
• Instructor Qualifications - Teaching certifications and ranks
• Equipment Categories - Gear and supply classifications
• Event Types - Competition and demonstration categories
• Payment Categories - Billing and expense classifications

Value Applications

Student Management Values

1. Classification Values

   • Student status types (Active, Trial, Inactive, Graduated)
   • Enrollment types (Regular, Trial, Private, Competition Team)
   • Student categories (Child, Teen, Adult, Senior)
   • Special needs classifications

2. Progress Tracking Values

   • Belt colors and names
   • Stripe designations
   • Achievement levels
   • Competition categories

Business Operation Values

1. Class Management Values

   • Class types and categories
   • Skill level requirements
   • Class status options
   • Session types

2. Financial Values

   • Payment methods
   • Billing frequencies
   • Discount types
   • Fee categories

Accessing Value Configuration

Navigation to Value Management

Value Configuration Interface

1. Access Configurable Values

   • Navigate to Settings → Configuration → System Values
   • Select value category
   • View existing values and options
   • Access value management tools

2. Value Management Features

   • Value Lists - View all values in category
   • Value Editor - Create and modify values
   • Usage Reports - See where values are used
   • Impact Analysis - Understand change implications

Value Category Management

Category Organization

1. System Categories

   • Student Information - Student-related classifications
   • Class Management - Class and program values
   • Financial - Billing and payment options
   • Operational - Day-to-day operation values

2. Custom Categories

   • School-Specific - Unique classification needs
   • Regional - Location-specific requirements
   • Cultural - Martial arts style-specific values
   • Integration - Third-party system values

Managing Belt Rankings

Belt Hierarchy Setup

Creating Belt System

1. Belt Rank Configuration

   • Belt Name - Full belt designation (e.g., "1st Degree Black Belt")
   • Belt Color - Visual color representation
   • Belt Order - Progression sequence number
   • Belt Abbreviation - Short form (e.g., "1BB")

2. Belt System Examples

   Order | Name | Color | Abbreviation
   1 | White Belt | White | WB
   2 | Yellow Belt | Yellow | YB
   3 | Orange Belt | Orange | OB
   4 | Green Belt | Green | GB
   5 | Blue Belt | Blue | BB
   6 | Brown Belt | Brown | BrB
   7 | 1st Degree Black Belt | Black | 1BB
   8 | 2nd Degree Black Belt | Black | 2BB

Belt Progression Rules

1. Advancement Requirements

   • Minimum Time - Required time at current rank
   • Age Requirements - Minimum age for rank
   • Testing Requirements - Skills and knowledge needed
   • Prerequisites - Required previous ranks

2. Special Considerations

   • Youth Rankings - Modified belt system for children
   • Adult Accelerated - Faster progression for adults
   • Transfer Students - Rank recognition from other schools
   • Honorary Ranks - Special recognition belts

Stripe and Progress Systems

Intermediate Progress Markers

1. Stripe System Configuration

   • Stripe Colors - Visual progress indicators
   • Stripe Meanings - What each stripe represents
   • Stripe Requirements - Criteria for earning stripes
   • Maximum Stripes - Stripes allowed per belt

2. Progress Tracking Options

   Stripe System Example:
   1 Stripe = Basic techniques mastered
   2 Stripes = Intermediate techniques mastered
   3 Stripes = Advanced techniques mastered
   4 Stripes = Ready for belt testing

Alternative Progress Systems

1. Point-Based Systems

   • Achievement Points - Points for various accomplishments
   • Behavior Points - Recognition for good behavior
   • Skill Points - Technical proficiency tracking
   • Leadership Points - Leadership development

2. Badge Systems

   • Skill Badges - Specific technique mastery
   • Character Badges - Personal development
   • Service Badges - Community contribution
   • Special Achievement Badges - Unique accomplishments

Class and Program Values

Class Category Management

Program Classifications

1. Age-Based Programs

   • Little Ninjas - Ages 3-5
   • Kids Karate - Ages 6-12
   • Teen Programs - Ages 13-17
   • Adult Classes - Ages 18+
   • Senior Programs - Ages 55+

2. Skill-Based Programs

   • Beginner Classes - No experience required
   • Intermediate Classes - Basic skills developed
   • Advanced Classes - Significant experience
   • Black Belt Classes - Black belt ranks only
   • Competition Team - Tournament preparation

Class Type Values

1. Regular Class Types

   Type: Regular Training
   Description: Standard curriculum classes
   Duration: 45-60 minutes
   Capacity: 15-20 students
   
   Type: Intensive Training
   Description: Extended skill development
   Duration: 90 minutes
   Capacity: 10-12 students

2. Special Class Types

   Type: Private Lesson
   Description: One-on-one instruction
   Duration: 30-60 minutes
   Capacity: 1 student
   
   Type: Make-up Class
   Description: Replacement for missed class
   Duration: Variable
   Capacity: Variable

Instructor Qualification Values

Instructor Ranks and Certifications

1. Instructor Levels

   • Assistant Instructor - Basic teaching certification
   • Certified Instructor - Full teaching qualification
   • Senior Instructor - Advanced teaching experience
   • Master Instructor - Highest teaching level

2. Specialization Areas

   • Youth Instruction - Specialized in teaching children
   • Adult Education - Focus on adult learners
   • Competition Coaching - Tournament preparation
   • Self-Defense - Personal protection emphasis
   • Weapons Training - Traditional weapons instruction

Student Classification Values

Student Status Options

Enrollment Status Values

1. Active Status Types

   Status: Active
   Description: Currently enrolled and attending
   Billing: Active billing
   Access: Full system access
   
   Status: Trial
   Description: Trying classes before enrollment
   Billing: Trial pricing
   Access: Limited system access

2. Inactive Status Types

   Status: Hold
   Description: Temporarily suspended enrollment
   Billing: No billing charges
   Access: Limited access
   
   Status: Graduated
   Description: Completed program goals
   Billing: No billing charges
   Access: Alumni access

Student Categories

1. Age-Based Categories

   • Preschool - Ages 3-5
   • Elementary - Ages 6-10
   • Middle School - Ages 11-13
   • High School - Ages 14-17
   • College - Ages 18-22
   • Adult - Ages 23+

2. Special Categories

   • Special Needs - Students requiring accommodations
   • Homeschool - Homeschooled students
   • Military Family - Military-connected families
   • Scholarship - Scholarship recipients

Achievement and Award Types

Recognition Categories

1. Academic Achievements

   • Technique Mastery - Specific skill accomplishments
   • Form Excellence - Kata/form performance
   • Sparring Awards - Sparring skill recognition
   • Knowledge Awards - Martial arts history and philosophy

2. Character Achievements

   • Leadership Awards - Leadership development
   • Citizenship Awards - Community contribution
   • Perseverance Awards - Overcoming challenges
   • Respect Awards - Respectful behavior

Competition Categories

1. Tournament Classifications

   Category: Forms Competition
   Age Groups: 6-9, 10-13, 14-17, 18+
   Skill Levels: Beginner, Intermediate, Advanced
   Divisions: Traditional, Contemporary, Weapons
   
   Category: Sparring Competition
   Age Groups: 8-11, 12-15, 16+
   Weight Classes: Multiple weight divisions
   Skill Levels: Novice, Intermediate, Advanced

Financial and Billing Values

Payment Method Options

Standard Payment Methods

1. Electronic Payments

   Method: Credit Card
   Types: Visa, MasterCard, American Express, Discover
   Processing: Automated
   Fees: Processor fees apply
   
   Method: Bank Transfer
   Types: ACH, Direct Debit
   Processing: 2-3 business days
   Fees: Lower processing costs

2. Traditional Payment Methods

   Method: Cash
   Processing: Manual recording required
   Fees: No processing fees
   Tracking: Receipt required
   
   Method: Check
   Processing: Manual deposit
   Fees: Potential NSF charges
   Tracking: Check number recording

Payment Frequency Options

1. Billing Cycles
   • Monthly - Most common option
   • Quarterly - Every 3 months
   • Semi-Annual - Every 6 months
   • Annual - Yearly payment
   • Custom - Flexible arrangements

Fee and Discount Categories

Fee Types

1. Standard Fees

   Fee Type: Monthly Tuition
   Description: Regular class fees
   Frequency: Monthly
   Application: All active students
   
   Fee Type: Registration Fee
   Description: One-time enrollment fee
   Frequency: Once per enrollment
   Application: New students only

2. Additional Fees

   Fee Type: Testing Fee
   Description: Belt rank examination
   Frequency: Per test
   Application: Testing students only
   
   Fee Type: Equipment Fee
   Description: Required gear and uniforms
   Frequency: As needed
   Application: All students

Discount Categories

1. Family Discounts

   • Second Student - Discount for second family member
   • Third Student - Additional discount for third member
   • Family Maximum - Cap on total family charges

2. Special Discounts

   • Military Discount - Active military families
   • First Responder - Police, fire, EMS families
   • Senior Citizen - Age-based discount
   • Student Discount - Full-time students

Location and Facility Values

Location Classifications

Physical Locations

1. Main Facilities

   Location: Main Dojo
   Address: Primary school location
   Capacity: Maximum student capacity
   Features: Available equipment and facilities

2. Satellite Locations

   Location: Community Center
   Type: Rented space
   Schedule: Limited availability
   Capacity: Reduced capacity

Training Areas

1. Area Designations
   • Main Mat - Primary training area
   • Weapons Area - Specialized weapons training
   • Private Lesson Room - Individual instruction
   • Meditation Area - Quiet reflection space

Equipment and Resource Values

Equipment Categories

1. Training Equipment

   • Protective Gear - Helmets, guards, padding
   • Training Tools - Boards, bags, targets
   • Weapons - Traditional martial arts weapons
   • Exercise Equipment - Fitness and conditioning

2. Facility Resources

   • Audio/Visual - Sound systems, displays
   • Storage - Equipment storage solutions
   • Seating - Spectator and waiting areas
   • Safety - First aid and emergency equipment

Value Maintenance and Management

Data Consistency

Value Standardization

1. Naming Conventions

   • Use consistent naming patterns
   • Avoid abbreviations when possible
   • Include descriptive information
   • Maintain professional language

2. Value Relationships

   • Ensure logical value hierarchies
   • Maintain parent-child relationships
   • Check for circular dependencies
   • Validate value combinations

Change Management

1. Value Updates

   • Document reasons for changes
   • Notify affected users
   • Update related documentation
   • Test system functionality

2. Legacy Value Handling

   • Archive discontinued values
   • Provide migration paths
   • Maintain historical data integrity
   • Update reports and analytics

Quality Assurance

Value Validation

1. Data Quality Checks

   • Remove duplicate values
   • Standardize value formats
   • Verify value accuracy
   • Check for orphaned values

2. Usage Monitoring

   • Track value utilization
   • Identify unused values
   • Monitor value performance
   • Analyze user behavior

Regular Maintenance

1. Periodic Reviews

   • Quarterly value audits
   • Annual system cleanup
   • User feedback integration
   • Performance optimization

2. Maintenance Tasks

   • Update outdated values
   • Add new required values
   • Remove obsolete options
   • Optimize value organization

Best Practices

Value Design

1. User-Friendly Names - Use clear, descriptive value names
2. Logical Organization - Group related values together
3. Future-Proofing - Design for growth and change
4. Consistency - Maintain consistent naming and formatting
5. Documentation - Document value purposes and usage

Change Management

1. Impact Assessment - Understand change implications
2. User Communication - Notify users of value changes
3. Gradual Implementation - Phase in major changes
4. Backup Plans - Maintain rollback capabilities
5. Testing - Thoroughly test value changes

Data Integrity

1. Validation Rules - Implement proper validation
2. Referential Integrity - Maintain data relationships
3. Regular Audits - Check data consistency regularly
4. Error Handling - Gracefully handle invalid values
5. Recovery Procedures - Plan for data recovery needs

Common Value Configurations

Belt System Example

Traditional Karate Belt System:
1. White Belt (Beginner)
2. Yellow Belt (10th Kyu)
3. Orange Belt (9th Kyu)
4. Green Belt (8th Kyu)
5. Blue Belt (7th Kyu)
6. Purple Belt (6th Kyu)
7. Brown Belt 3rd (5th Kyu)
8. Brown Belt 2nd (4th Kyu)
9. Brown Belt 1st (3rd Kyu)
10. Black Belt 1st Dan
11. Black Belt 2nd Dan
12. Black Belt 3rd Dan

Class Category Example

Age-Based Program Structure:
- Little Dragons (Ages 4-6)
- Kids Karate (Ages 7-12)
- Teen Martial Arts (Ages 13-17)
- Adult Karate (Ages 18+)
- Senior Programs (Ages 55+)

Skill-Based Structure:
- Foundation (Beginners)
- Development (Intermediate)
- Mastery (Advanced)
- Leadership (Black Belts)

Troubleshooting Common Issues

Value Configuration Issues

Issue: Values not appearing in dropdown lists
Solution: Check value activation status, verify category assignment, refresh cache

Issue: Unable to delete values
Solution: Check for existing data dependencies, archive instead of delete, migrate data first

Issue: Inconsistent value display
Solution: Standardize value names, check for duplicates, verify display settings

Issue: Values appearing in wrong order
Solution: Review sort order settings, update sequence numbers, check alphabetical sorting

Next Steps

After configuring system values:

1. Data Import & Export - Include values in data management
2. System Settings & Configuration - Additional system setup
3. Security Settings - Secure value configuration
4. Student Management - Use values in student management

Getting Help

For configurable values assistance:

• Plan value structures before implementation
• Document value purposes and relationships
• Test value changes thoroughly
• Train staff on new values and their usage
• Contact support for complex value configuration

Properly configured values ensure data consistency, improve user experience, and support your school's specific operational needs. Regular maintenance and thoughtful organization keep your value system efficient and effective.