Add overdue dues management system with notifications and status updates

- Create DuesOverdueBanner component for displaying overdue member counts
- Add API endpoints for overdue count retrieval and status updates
- Integrate overdue dues banner into admin and member list dashboards
- Implement handlers for viewing overdue members and updating statuses
- Add dues management section to admin dashboard

components/DuesOverdueBanner.vue

@@ -0,0 +1,170 @@
+<template>
+  <v-alert
+    v-if="overdueCount > 0"
+    type="warning"
+    variant="elevated"
+    class="dues-overdue-banner mb-6"
+    prominent
+    border="start"
+  >
+    <template #prepend>
+      <v-icon size="32">mdi-alert-circle</v-icon>
+    </template>
+    
+    <template #title>
+      <span class="text-h6 font-weight-bold">
+        {{ overdueCount }} Member{{ overdueCount > 1 ? 's' : '' }} with Overdue Dues
+      </span>
+    </template>
+    
+    <div class="mt-2">
+      <p class="mb-3">
+        {{ overdueCount }} member{{ overdueCount > 1 ? 's have' : ' has' }} dues that are more than 1 year overdue. 
+        These accounts have been automatically marked as inactive.
+      </p>
+      
+      <div class="d-flex flex-wrap gap-2 align-center">
+        <v-btn
+          color="warning"
+          variant="elevated"
+          size="small"
+          @click="$emit('view-overdue')"
+        >
+          <v-icon start>mdi-eye</v-icon>
+          View Overdue Members
+        </v-btn>
+        
+        <v-btn
+          v-if="canUpdateStatuses"
+          color="primary"
+          variant="outlined"
+          size="small"
+          :loading="updatingStatuses"
+          @click="updateOverdueStatuses"
+        >
+          <v-icon start>mdi-refresh</v-icon>
+          Update Member Statuses
+        </v-btn>
+        
+        <v-btn
+          v-if="canSendReminders"
+          color="secondary"
+          variant="outlined"
+          size="small"
+          @click="$emit('send-reminders')"
+        >
+          <v-icon start>mdi-email-multiple</v-icon>
+          Send Reminders
+        </v-btn>
+        
+        <v-spacer />
+        
+        <v-btn
+          icon
+          size="small"
+          variant="text"
+          @click="dismissed = true"
+        >
+          <v-icon>mdi-close</v-icon>
+        </v-btn>
+      </div>
+    </div>
+  </v-alert>
+</template>
+
+<script setup lang="ts">
+interface Props {
+  overdueCount: number;
+  canUpdateStatuses?: boolean;
+  canSendReminders?: boolean;
+  refreshTrigger?: number;
+}
+
+interface Emits {
+  (e: 'view-overdue'): void;
+  (e: 'send-reminders'): void;
+  (e: 'statuses-updated', count: number): void;
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  canUpdateStatuses: false,
+  canSendReminders: false,
+  refreshTrigger: 0
+});
+
+const emit = defineEmits<Emits>();
+
+// State
+const dismissed = ref(false);
+const updatingStatuses = ref(false);
+
+// Update overdue member statuses
+const updateOverdueStatuses = async () => {
+  updatingStatuses.value = true;
+  
+  try {
+    const response = await $fetch<{
+      success: boolean;
+      data: { updatedCount: number };
+      message?: string;
+    }>('/api/members/update-overdue-statuses', {
+      method: 'POST'
+    });
+
+    if (response.success) {
+      emit('statuses-updated', response.data.updatedCount);
+      console.log(`Updated ${response.data.updatedCount} overdue member statuses`);
+    } else {
+      throw new Error(response.message || 'Failed to update statuses');
+    }
+  } catch (error: any) {
+    console.error('Error updating overdue statuses:', error);
+    // Show error notification if needed
+  } finally {
+    updatingStatuses.value = false;
+  }
+};
+
+// Reset dismissed state when refresh trigger changes
+watch(() => props.refreshTrigger, () => {
+  dismissed.value = false;
+});
+
+// Watch for overdueCount changes and reset dismissed
+watch(() => props.overdueCount, (newCount, oldCount) => {
+  if (newCount > oldCount) {
+    dismissed.value = false;
+  }
+});
+</script>
+
+<style scoped>
+.dues-overdue-banner {
+  border-radius: 12px !important;
+  box-shadow: 0 4px 12px rgba(255, 152, 0, 0.2) !important;
+}
+
+.dues-overdue-banner :deep(.v-alert__content) {
+  width: 100%;
+}
+
+.gap-2 {
+  gap: 8px;
+}
+
+/* Mobile responsive */
+@media (max-width: 600px) {
+  .d-flex.flex-wrap {
+    flex-direction: column;
+    align-items: stretch !important;
+  }
+  
+  .d-flex.flex-wrap .v-btn {
+    margin-bottom: 8px;
+  }
+  
+  .v-spacer {
+    display: none;
+  }
+}
+</style>

pages/dashboard/admin.vue

@@ -112,6 +112,29 @@
         </v-col>
       </v-row>
 
+      <!-- Overdue Dues Banner -->
+      <DuesOverdueBanner
+        :overdue-count="overdueCount"
+        :can-update-statuses="true"
+        :can-send-reminders="true"
+        :refresh-trigger="overdueRefreshTrigger"
+        @view-overdue="viewOverdueMembers"
+        @send-reminders="sendDuesReminders"
+        @statuses-updated="handleStatusesUpdated"
+      />
+
+      <!-- Dues Management -->
+      <v-row class="mb-6">
+        <v-col cols="12">
+          <BoardDuesManagement
+            :refresh-trigger="duesRefreshTrigger"
+            @view-member="handleViewMember"
+            @view-all-members="navigateToMembers"
+            @member-updated="handleMemberUpdated"
+          />
+        </v-col>
+      </v-row>
+
       <!-- Portal Configuration -->
       <v-row class="mb-6">
         <v-col cols="12">
@@ -390,6 +413,11 @@ const showRecaptchaConfig = ref(false);
 const showMembershipConfig = ref(false);
 const showEmailConfig = ref(false);
 
+// Dues management
+const overdueCount = ref(0);
+const overdueRefreshTrigger = ref(0);
+const duesRefreshTrigger = ref(0);
+
 // Create user dialog data
 const createUserValid = ref(false);
 const creatingUser = ref(false);
@@ -622,9 +650,60 @@ const systemMaintenance = () => {
   // TODO: Implement maintenance mode
 };
 
-// Load stats on component mount
+// Dues management handlers
+const loadOverdueCount = async () => {
+  try {
+    const response = await $fetch<{ success: boolean; data: { count: number } }>('/api/members/overdue-count');
+    if (response.success) {
+      overdueCount.value = response.data.count;
+    }
+  } catch (error: any) {
+    console.error('Error loading overdue count:', error);
+  }
+};
+
+const viewOverdueMembers = () => {
+  // Navigate to member list with overdue filter applied
+  navigateTo('/dashboard/member-list');
+};
+
+const sendDuesReminders = () => {
+  // Placeholder for dues reminder functionality
+  console.log('Send dues reminders - feature to be implemented');
+};
+
+const handleStatusesUpdated = async (updatedCount: number) => {
+  console.log(`Successfully updated ${updatedCount} member${updatedCount !== 1 ? 's' : ''} to inactive status`);
+  
+  // Refresh overdue count
+  await loadOverdueCount();
+  
+  // Trigger banner refresh
+  overdueRefreshTrigger.value += 1;
+};
+
+const handleViewMember = (member: any) => {
+  // Navigate to member details or open modal
+  console.log('View member:', member.FullName || `${member.first_name} ${member.last_name}`);
+  navigateTo('/dashboard/member-list');
+};
+
+const navigateToMembers = () => {
+  // Navigate to member list page
+  navigateTo('/dashboard/member-list');
+};
+
+const handleMemberUpdated = (member: any) => {
+  console.log('Member updated:', member.FullName || `${member.first_name} ${member.last_name}`);
+  
+  // Trigger dues refresh
+  duesRefreshTrigger.value += 1;
+};
+
+// Load stats and overdue count on component mount
 onMounted(async () => {
   await loadStats();
+  await loadOverdueCount();
 });
 </script>
 

pages/dashboard/member-list.vue

@@ -13,6 +13,17 @@
       </v-col>
     </v-row>
 
+    <!-- Overdue Dues Banner -->
+    <DuesOverdueBanner
+      :overdue-count="overdueCount"
+      :can-update-statuses="isAdmin"
+      :can-send-reminders="isAdmin || isBoard"
+      :refresh-trigger="overdueRefreshTrigger"
+      @view-overdue="viewOverdueMembers"
+      @send-reminders="sendDuesReminders"
+      @statuses-updated="handleStatusesUpdated"
+    />
+
     <!-- Search and Filter Controls -->
     <v-row class="mb-4">
       <v-col cols="12" md="2">
@@ -290,6 +301,10 @@ const successMessage = ref('');
 // Portal account creation
 const creatingPortalAccountIds = ref<string[]>([]);
 
+// Overdue dues management
+const overdueCount = ref(0);
+const overdueRefreshTrigger = ref(0);
+
 // Filter options
 const activeFilterOptions = [
   { title: 'Active Members', value: 'active' },
@@ -554,9 +569,50 @@ const createPortalAccount = async (member: Member) => {
   }
 };
 
-// Load members on mount
-onMounted(() => {
-  loadMembers();
+// Overdue dues handlers
+const loadOverdueCount = async () => {
+  try {
+    const response = await $fetch<{ success: boolean; data: { count: number } }>('/api/members/overdue-count');
+    if (response.success) {
+      overdueCount.value = response.data.count;
+    }
+  } catch (error: any) {
+    console.error('Error loading overdue count:', error);
+  }
+};
+
+const viewOverdueMembers = () => {
+  // Filter to show only inactive members (who were marked inactive due to overdue dues)
+  activeFilter.value = 'inactive';
+  duesFilter.value = 'unpaid';
+  
+  showSuccess.value = true;
+  successMessage.value = 'Showing members with overdue dues (marked as inactive)';
+};
+
+const sendDuesReminders = () => {
+  // Placeholder for dues reminder functionality
+  console.log('Send dues reminders - feature to be implemented');
+  showSuccess.value = true;
+  successMessage.value = 'Dues reminder feature coming soon!';
+};
+
+const handleStatusesUpdated = async (updatedCount: number) => {
+  showSuccess.value = true;
+  successMessage.value = `Successfully updated ${updatedCount} member${updatedCount !== 1 ? 's' : ''} to inactive status`;
+  
+  // Refresh members list and overdue count
+  await loadMembers();
+  await loadOverdueCount();
+  
+  // Trigger banner refresh
+  overdueRefreshTrigger.value += 1;
+};
+
+// Load members and overdue count on mount
+onMounted(async () => {
+  await loadMembers();
+  await loadOverdueCount();
 });
 </script>
 

server/api/members/dues-status.get.ts

@@ -22,9 +22,51 @@ export default defineEventHandler(async (event) => {
 
     const overdueMembers: any[] = [];
     const upcomingMembers: any[] = [];
+    const severelyOverdueMembers: any[] = [];
 
     for (const member of allMembers.list) {
-      // Skip if dues are already paid
+      // Check for severely overdue members (more than 1 year past due date)
+      let isSeverelyOverdue = false;
+      
+      if (member.current_year_dues_paid === 'true' && member.membership_date_paid) {
+        // If dues are marked as paid, check if it's been more than 1 year since payment
+        const lastPaidDate = new Date(member.membership_date_paid);
+        const oneYearFromPayment = new Date(lastPaidDate);
+        oneYearFromPayment.setFullYear(oneYearFromPayment.getFullYear() + 1);
+        
+        if (today > oneYearFromPayment) {
+          isSeverelyOverdue = true;
+        }
+      } else if (member.current_year_dues_paid !== 'true') {
+        // If dues are not paid, check payment due date or member since date
+        let dueDate: Date;
+        
+        if (member.payment_due_date) {
+          dueDate = new Date(member.payment_due_date);
+        } else if (member.member_since) {
+          // Fallback: 1 year from member since date
+          dueDate = new Date(member.member_since);
+          dueDate.setFullYear(dueDate.getFullYear() + 1);
+        } else {
+          // Skip if we can't determine due date
+          continue;
+        }
+        
+        // Check if more than 1 year overdue
+        const oneYearOverdue = new Date(dueDate);
+        oneYearOverdue.setFullYear(oneYearOverdue.getFullYear() + 1);
+        
+        if (today > oneYearOverdue) {
+          isSeverelyOverdue = true;
+        }
+      }
+
+      if (isSeverelyOverdue) {
+        severelyOverdueMembers.push(member);
+        continue; // Don't add to other lists
+      }
+
+      // Skip if dues are already paid (and not severely overdue)
       if (member.current_year_dues_paid === 'true') {
         continue;
       }
@@ -34,7 +76,7 @@ export default defineEventHandler(async (event) => {
         const dueDate = new Date(member.payment_due_date);
         
         if (dueDate < today) {
-          // Overdue
+          // Overdue (but not severely overdue)
           overdueMembers.push(member);
         } else if (dueDate <= thirtyDaysFromNow) {
           // Due within 30 days

server/api/members/overdue-count.get.ts

@@ -0,0 +1,74 @@
+// server/api/members/overdue-count.get.ts
+export default defineEventHandler(async (event) => {
+  try {
+    const { getMembers } = await import('~/server/utils/nocodb');
+
+    // Get all members
+    const allMembers = await getMembers();
+    
+    if (!allMembers?.list) {
+      return {
+        success: true,
+        data: { count: 0 }
+      };
+    }
+
+    const today = new Date();
+    let severelyOverdueCount = 0;
+
+    for (const member of allMembers.list) {
+      // Check for severely overdue members (more than 1 year past due date)
+      let isSeverelyOverdue = false;
+      
+      if (member.current_year_dues_paid === 'true' && member.membership_date_paid) {
+        // If dues are marked as paid, check if it's been more than 1 year since payment
+        const lastPaidDate = new Date(member.membership_date_paid);
+        const oneYearFromPayment = new Date(lastPaidDate);
+        oneYearFromPayment.setFullYear(oneYearFromPayment.getFullYear() + 1);
+        
+        if (today > oneYearFromPayment) {
+          isSeverelyOverdue = true;
+        }
+      } else if (member.current_year_dues_paid !== 'true') {
+        // If dues are not paid, check payment due date or member since date
+        let dueDate: Date;
+        
+        if (member.payment_due_date) {
+          dueDate = new Date(member.payment_due_date);
+        } else if (member.member_since) {
+          // Fallback: 1 year from member since date
+          dueDate = new Date(member.member_since);
+          dueDate.setFullYear(dueDate.getFullYear() + 1);
+        } else {
+          // Skip if we can't determine due date
+          continue;
+        }
+        
+        // Check if more than 1 year overdue
+        const oneYearOverdue = new Date(dueDate);
+        oneYearOverdue.setFullYear(oneYearOverdue.getFullYear() + 1);
+        
+        if (today > oneYearOverdue) {
+          isSeverelyOverdue = true;
+        }
+      }
+
+      if (isSeverelyOverdue) {
+        severelyOverdueCount++;
+      }
+    }
+
+    return {
+      success: true,
+      data: { count: severelyOverdueCount }
+    };
+
+  } catch (error: any) {
+    console.error('[API] Error fetching overdue count:', error);
+    
+    throw createError({
+      statusCode: error.statusCode || 500,
+      statusMessage: error.message || 'Failed to fetch overdue count'
+    });
+  }
+});

server/api/members/update-overdue-statuses.post.ts

@@ -0,0 +1,108 @@
+// server/api/members/update-overdue-statuses.post.ts
+export default defineEventHandler(async (event) => {
+  try {
+    const { getMembers, updateMember } = await import('~/server/utils/nocodb');
+
+    // Get all members
+    const allMembers = await getMembers();
+    
+    if (!allMembers?.list) {
+      return {
+        success: true,
+        data: { updatedCount: 0 },
+        message: 'No members found'
+      };
+    }
+
+    const today = new Date();
+    const membersToUpdate: any[] = [];
+
+    for (const member of allMembers.list) {
+      // Skip if already inactive
+      if (member.membership_status === 'Inactive') {
+        continue;
+      }
+
+      // Check if member has overdue dues (more than 1 year)
+      let isOverdue = false;
+      
+      if (member.current_year_dues_paid === 'true' && member.membership_date_paid) {
+        // If dues are marked as paid, check if it's been more than 1 year since payment
+        const lastPaidDate = new Date(member.membership_date_paid);
+        const oneYearFromPayment = new Date(lastPaidDate);
+        oneYearFromPayment.setFullYear(oneYearFromPayment.getFullYear() + 1);
+        
+        if (today > oneYearFromPayment) {
+          isOverdue = true;
+        }
+      } else if (member.current_year_dues_paid !== 'true') {
+        // If dues are not paid, check payment due date or member since date
+        let dueDate: Date;
+        
+        if (member.payment_due_date) {
+          dueDate = new Date(member.payment_due_date);
+        } else if (member.member_since) {
+          // Fallback: 1 year from member since date
+          dueDate = new Date(member.member_since);
+          dueDate.setFullYear(dueDate.getFullYear() + 1);
+        } else {
+          // Skip if we can't determine due date
+          continue;
+        }
+        
+        // Check if more than 1 year overdue
+        const oneYearOverdue = new Date(dueDate);
+        oneYearOverdue.setFullYear(oneYearOverdue.getFullYear() + 1);
+        
+        if (today > oneYearOverdue) {
+          isOverdue = true;
+        }
+      }
+
+      if (isOverdue) {
+        membersToUpdate.push({
+          id: member.Id,
+          name: member.FullName || `${member.first_name} ${member.last_name}`,
+          currentStatus: member.membership_status
+        });
+      }
+    }
+
+    // Update all overdue members to inactive
+    let updatedCount = 0;
+    const errors: string[] = [];
+
+    for (const memberInfo of membersToUpdate) {
+      try {
+        await updateMember(memberInfo.id, {
+          membership_status: 'Inactive'
+        });
+        updatedCount++;
+        console.log(`[API] Marked member ${memberInfo.name} (${memberInfo.id}) as inactive due to overdue dues`);
+      } catch (error: any) {
+        console.error(`[API] Failed to update member ${memberInfo.name} (${memberInfo.id}):`, error);
+        errors.push(`Failed to update ${memberInfo.name}: ${error.message}`);
+      }
+    }
+
+    console.log(`[API] Updated ${updatedCount} of ${membersToUpdate.length} overdue members to inactive status`);
+
+    return {
+      success: true,
+      data: { 
+        updatedCount,
+        totalOverdue: membersToUpdate.length,
+        errors: errors.length > 0 ? errors : undefined
+      },
+      message: `Successfully updated ${updatedCount} overdue member${updatedCount !== 1 ? 's' : ''} to inactive status`
+    };
+
+  } catch (error: any) {
+    console.error('[API] Error updating overdue member statuses:', error);
+    
+    throw createError({
+      statusCode: error.statusCode || 500,
+      statusMessage: error.message || 'Failed to update overdue member statuses'
+    });
+  }
+});