Files
lettersoup-online/002_source/cms/src/components/dashboard/student/_GUIDELINES.md
louiscklaw 7105bc85e3 update,
2025-05-08 14:38:34 +08:00

1.4 KiB

STUDENT MANAGEMENT GUIDELINES

Core Components

  • _constants.ts - Contains essential constants for:
    • Default values (defaultValue)
    • Empty/placeholder values (emptyValue)
    • Student status options (active/inactive)
    • Grade level options

Student Data Table System

  • students-table.tsx - Main student listing table
  • confirm-delete-modal.tsx - Confirmation dialog for student deletion
  • students-selection-context.tsx - Context for selected student records

Table Features

  • students-filters.tsx - Filter controls for the student table
    • email-filter-popover.tsx - Email-specific filtering
    • phone-filter-popover.tsx - Phone number filtering
  • students-pagination.tsx - Pagination controls

Student Forms

  • student-create-form.tsx - Form for adding new students with:
    • Personal information fields
    • Contact details
    • Enrollment information
  • student-edit-form.tsx - Form for modifying existing student records

Supporting Components

  • type.d.tsx - Type definitions for student data
  • notifications.tsx - Student notification preferences
  • payments.tsx - Student payment records
  • shipping-address.tsx - Student address information

Best Practices

  1. Always validate student data before submission
  2. Use the provided constants for default/empty values
  3. Maintain consistent field naming across all components
  4. Follow accessibility guidelines for all form inputs