added comments for understanding

Author: Aerospace-prog

components/haptic-tab.tsx

@@ -2,7 +2,6 @@
  * Haptic Tab Component
  * 
  * Tab bar button with haptic feedback for both iOS and Android.
- * Requirements: 10.4, 10.5
  */
 
 import { BottomTabBarButtonProps } from '@react-navigation/bottom-tabs';

contexts/theme.context.tsx

@@ -2,7 +2,6 @@
  * Theme Context and Provider
  * 
  * Provides centralized theme management with light/dark mode support.
- * Requirements: 10.4, 10.5
  */
 
 import {

hooks/use-auth.ts

@@ -1,4 +1 @@
-/**
- * Re-export useAuth hook from auth context for convenience
- */
 export { useAuth } from '../contexts/auth.context';

hooks/use-events.ts

@@ -1,4 +1 @@
-/**
- * Re-export useEvents hook from contexts for convenience
- */
 export { useEvents } from '@/contexts/events.context';

hooks/use-role.ts

@@ -21,21 +21,6 @@ interface UseRoleResult {
 
 /**
  * useRole hook - Check current user's role and permissions
- * 
- * @returns Role information and helper functions
- * 
- * @example
- * ```tsx
- * const { isAdmin, hasRole } = useRole();
- * 
- * if (isAdmin) {
- *   // Show admin features
- * }
- * 
- * if (hasRole('admin')) {
- *   // Alternative way to check
- * }
- * ```
  */
 export function useRole(): UseRoleResult {
   const { user, loading } = useAuth();

hooks/use-theme.ts

@@ -2,7 +2,6 @@
  * useTheme Hook
  * 
  * Re-exports theme hooks from the theme context for convenient access.
- * Requirements: 10.4, 10.5
  */
 
 export {

services/checkin.service.ts

@@ -17,11 +17,7 @@ export class CheckInService {
   private static readonly EVENTS_COLLECTION = 'events';
   private static readonly USERS_COLLECTION = 'users';
 
-  /**
-   * Validate QR code data using the decodeQRData utility
-   * @param qrString - Raw QR code string data
-   * @returns Validation result with decoded data or error
-   */
+ 
   static validateQRData(qrString: string): QRValidationResult {
     return decodeQRData(qrString);
   }
@@ -30,11 +26,6 @@ export class CheckInService {
    * Check in a user to an event
    * Verifies RSVP status and adds user to checkedIn array
    * Uses arrayUnion for idempotent operations (no duplicates)
-   * 
-   * @param userId - User ID from QR code
-   * @param eventId - Event ID from QR code
-   * @returns Check-in result with success status and message
-   *
    */
   static async checkInUser(userId: string, eventId: string): Promise<CheckInResult> {
     try {
@@ -110,9 +101,6 @@ export class CheckInService {
 
   /**
    * Get check-in status for a user at an event
-   * @param userId - User ID to check
-   * @param eventId - Event ID to check
-   * @returns True if user is checked in, false otherwise
    */
   static async getCheckInStatus(userId: string, eventId: string): Promise<boolean> {
     try {
@@ -140,8 +128,8 @@ export class CheckInService {
 
   /**
    * Get attendance data for an event
-   * @param eventId - Event ID to get attendance for
-   * @returns Attendance data including RSVP and check-in counts
+   * eventId - Event ID to get attendance for
+   * Attendance data including RSVP and check-in counts
    */
   static async getEventAttendance(eventId: string): Promise<AttendanceData | null> {
     try {
@@ -181,8 +169,8 @@ export class CheckInService {
 
   /**
    * Helper method to get user name from Firestore
-   * @param userId - User ID to look up
-   * @returns User name or null if not found
+   * userId - User ID to look up
+   * User name or null if not found
    */
   private static async getUserName(userId: string): Promise<string | null> {
     try {
@@ -208,8 +196,8 @@ export class CheckInService {
    * Validate and check in a user from QR code data
    * Combines validation and check-in into a single operation
    * 
-   * @param qrString - Raw QR code string data
-   * @returns Check-in result with success status and message
+   * qrString - Raw QR code string data
+   * Check-in result with success status and message
    */
   static async validateAndCheckIn(qrString: string): Promise<CheckInResult> {
     // First validate the QR data

services/event.service.ts

@@ -186,8 +186,8 @@ export class EventService {
    * Subscribe to real-time updates for all upcoming events
    * Returns an unsubscribe function
    * 
-   * @param callback - Called with events array when data changes
-   * @param onError - Optional error callback for handling subscription errors
+   * callback - Called with events array when data changes
+   *  onError - Optional error callback for handling subscription errors
    */
   static subscribeToEvents(
     callback: (events: Event[]) => void,

services/index.ts

@@ -1,6 +1,3 @@
-/**
- * Export all services
- */
 export { AuthService } from './auth.service';
 export { CheckInService } from './checkin.service';
 export { EventService } from './event.service';

services/notification.service.ts

@@ -80,7 +80,7 @@ export class NotificationService {
       const tokenData = await Notifications.getExpoPushTokenAsync({ projectId });
       console.log('Expo Push Token:', tokenData.data);
 
-      // Also get the native device token (FCM for Android, APNs for iOS)
+      // Also get the native device token (FCM for Android)
       // This can be used as a fallback or for direct FCM integration
       try {
         const deviceToken = await Notifications.getDevicePushTokenAsync();
@@ -332,7 +332,6 @@ export class NotificationService {
 
   /**
    * Set up notification listeners for foreground notifications and tap handling
-   * Requirements: 6.3, 6.4
    */
   static setupNotificationListeners(): () => void {
     // Listener for notifications received while app is in foreground
@@ -366,7 +365,6 @@ export class NotificationService {
 
   /**
    * Handle notification received in foreground
-   * Requirements: 6.3
    */
   private static handleNotificationReceived(
     notification: Notifications.Notification
@@ -378,7 +376,6 @@ export class NotificationService {
 
   /**
    * Handle notification tap - deep link to event detail
-   * Requirements: 6.4
    */
   private static handleNotificationTap(
     response: Notifications.NotificationResponse