feat: support daily pulse (#103)

## Summary by Sourcery

Add documentation for a flexible, backward-compatible reporting schema
that supports daily, weekly, ad-hoc, and custom submission periods

Documentation:
- Introduce a design doc outlining generalized submission_periods,
templates, template_questions, submission_period_users, and
reminder_logs
- Detail admin workflows for creating templates, assigning users, and
tracking submissions
- Provide a migration plan to coexist with the current weekly pulse
system
- Outline automation and scheduling strategies for recurring daily and
weekly reports

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- **New Features**
- Introduced flexible reporting supporting daily, ad-hoc, and custom
periods alongside weekly check-ins.
- Added admin UI for creating and managing follow-up templates,
participants, schedules, and reminders.
- Launched detailed analytics and response tracking dashboards for
follow-ups.
- Released "Daily Pulse" UI with daily check-in forms, calendar view,
and monthly history.
- Enhanced navigation with separate "My Weekly Pulse" and "My Daily
Pulse" menus and sidebar items.
- Added automated scheduling and assignment of recurring daily
submission periods via a new cron job.
- Added command palette and popover UI components for improved user
interaction.
- Improved dialog components with enhanced styling and accessibility
features.

- **Bug Fixes**
- Improved form validation and error handling in follow-up and daily
pulse workflows.

- **Chores**
- Updated dependencies and cron job configurations to support new
scheduling features.

- **Documentation**
- Provided comprehensive documentation on the new reporting schema and
admin workflows.

- **Tests**
- Added unit and integration tests for recurring schedule utilities and
API endpoints.

- **Style**
- Enhanced UI components for clarity, accessibility, and consistent
styling.

- **Refactor**
- Reorganized components and abstractions for improved maintainability
and extensibility.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: Minhchau0108

docs/daily-and-weekly-report-schema-refactor.md

@@ -31,6 +31,7 @@
     "@radix-ui/react-dialog": "^1.1.11",
     "@radix-ui/react-dropdown-menu": "^2.1.12",
     "@radix-ui/react-label": "^2.1.6",
+    "@radix-ui/react-popover": "^1.1.14",
     "@radix-ui/react-scroll-area": "^1.2.6",
     "@radix-ui/react-select": "^2.2.2",
     "@radix-ui/react-separator": "^1.1.6",
@@ -47,6 +48,7 @@
     "add": "^2.0.6",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
     "date-fns": "^4.1.0",
     "dompurify": "^3.2.6",
     "framer-motion": "^12.10.0",
@@ -62,7 +64,8 @@
     "recharts": "^2.15.3",
     "resend": "^4.4.1",
     "tailwind-merge": "^3.2.0",
-    "uuid": "^11.1.0"
+    "uuid": "^11.1.0",
+    "zod": "^3.25.57"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.1",

package.json

@@ -0,0 +1,147 @@
+import { createClient } from '@/utils/supabase/client';
+
+// Fetch all periods for today for a user
+export async function fetchTodayPeriods(userId: string, nowStr: string) {
+  const supabase = createClient();
+  return supabase
+    .from('submission_period_users')
+    .select('*, submission_periods!inner(*)')
+    .eq('user_id', userId)
+    .eq('submission_periods.period_type', 'daily')
+    .lte('submission_periods.start_date', nowStr)
+    .gte('submission_periods.end_date', nowStr);
+}
+
+// Fetch all questions for a set of template IDs
+export async function fetchQuestionsByTemplateIds(templateIds: string[]) {
+  if (!templateIds.length) return { data: [], error: null };
+  const supabase = createClient();
+  return supabase
+    .from('template_questions')
+    .select('template_id, questions(*)')
+    .in('template_id', templateIds)
+    .order('display_order', { ascending: true });
+}
+
+// Fetch a template by ID
+export async function fetchTemplateById(templateId: string) {
+  const supabase = createClient();
+  return supabase
+    .from('templates')
+    .select('id, name, description')
+    .eq('id', templateId)
+    .single();
+}
+
+// Fetch a submission for a user, period, and type
+export async function fetchSubmission(userId: string, periodId: string, type: string) {
+  const supabase = createClient();
+  return supabase
+    .from('submissions')
+    .select('*')
+    .eq('user_id', userId)
+    .eq('submission_period_id', periodId)
+    .eq('type', type)
+    .maybeSingle();
+}
+
+// Fetch all periods for the current month for a user
+export async function fetchMonthPeriods(userId: string, monthStartStr: string, monthEndStr: string) {
+  const supabase = createClient();
+  return supabase
+    .from('submission_period_users')
+    .select('*, submission_periods!inner(*)')
+    .eq('user_id', userId)
+    .eq('submission_periods.period_type', 'daily')
+    .gte('submission_periods.start_date', monthStartStr)
+    .lte('submission_periods.end_date', monthEndStr);
+}
+
+// Fetch all templates by IDs
+export async function fetchTemplatesByIds(templateIds: string[]) {
+  if (!templateIds.length) return { data: [], error: null };
+  const supabase = createClient();
+  return supabase
+    .from('templates')
+    .select('id, name, description')
+    .in('id', templateIds);
+}
+
+// Fetch all submissions for a user, type, and period IDs
+export async function fetchSubmissions(userId: string, type: string, periodIds: string[]) {
+  const supabase = createClient();
+  return supabase
+    .from('submissions')
+    .select('*')
+    .eq('user_id', userId)
+    .eq('type', type)
+    .in('submission_period_id', periodIds);
+}
+
+// Fetch answers for a submission
+export async function fetchSubmissionAnswers(submissionId: string) {
+  const supabase = createClient();
+  return supabase
+    .from('submission_answers')
+    .select('*')
+    .eq('submission_id', submissionId);
+}
+
+// Refetch all submissions for the month for a user
+export async function refetchMonthSubmissions(userId: string, periodIds: string[]) {
+  const supabase = createClient();
+  return supabase
+    .from('submissions')
+    .select('*')
+    .eq('user_id', userId)
+    .eq('type', 'daily')
+    .in('submission_period_id', periodIds);
+} 
+
+
+export async function submitDailyPulse({
+    userId,
+    periodId,
+    questions,
+    form,
+  }: {
+    userId: string;
+    periodId: string | number;
+    questions: { id: string }[];
+    form: Record<string, string | string[]>;
+  }) {
+    const supabase = createClient();
+    // 1. Insert submission
+    const { data: submission, error: submissionError } = await supabase
+      .from('submissions')
+      .insert({
+        user_id: userId,
+        submission_period_id: periodId,
+        submitted_at: new Date().toISOString(),
+        type: 'daily',
+      })
+      .select()
+      .single();
+    if (submissionError || !submission) {
+      return { error: 'Failed to submit check-in.' };
+    }
+    // 2. Insert answers
+    const answers = questions.map((q) => {
+      let answer = form[q.id];
+      if (Array.isArray(answer)) {
+        answer = JSON.stringify(answer);
+      }
+      return {
+        submission_id: submission.id,
+        question_id: q.id,
+        answer: answer || '',
+      };
+    });
+    const { error: answersError } = await supabase
+      .from('submission_answers')
+      .insert(answers);
+    if (answersError) {
+      return { error: 'Failed to save answers.' };
+    }
+    return { success: true };
+  } 

pnpm-lock.yaml

@@ -0,0 +1,92 @@
+import React from 'react';
+import type { SubmissionPeriod, Submission } from '@/types/followup';
+
+
+interface DailyPulseCalendarProps {
+  monthDays: Date[];
+  periodByDate: Record<string, SubmissionPeriod[]>;
+  monthSubmissions: Submission[];
+  todayUTC: string;
+}
+
+// Helper to determine the status for a given day with multiple periods
+function getDayStatus({ date, key, periods, monthSubmissions, todayUTC }: {
+  date: Date;
+  key: string;
+  periods: SubmissionPeriod[];
+  monthSubmissions: Submission[];
+  todayUTC: string;
+}): 'submitted' | 'missed' | 'not_assigned' | 'not_submitted' {
+  if (!periods || periods.length === 0) return 'not_assigned';
+  let hasMissed = false;
+  let hasNotSubmitted = false;
+  let allSubmitted = true;
+  for (const period of periods) {
+    const submission = monthSubmissions.find(
+      (s) => s.submission_period_id === period.id
+    );
+    const isToday = key === todayUTC;
+    if (submission) continue;
+    allSubmitted = false;
+    if (date < new Date(todayUTC)) hasMissed = true;
+    else if (isToday || date >= new Date(todayUTC)) hasNotSubmitted = true;
+  }
+  if (allSubmitted) return 'submitted';
+  if (hasMissed) return 'missed';
+  if (hasNotSubmitted) return 'not_submitted';
+  return 'not_assigned';
+}
+
+const DailyPulseCalendar: React.FC<DailyPulseCalendarProps> = ({ monthDays, periodByDate, monthSubmissions, todayUTC }) => {
+
+  console.log('periodByDate', periodByDate);
+  return (
+    <div className="mb-10">
+      <h2 className="font-bold mb-3 text-lg text-gray-800">This Month&apos;s Check-in Overview</h2>
+      <div className="bg-white rounded-xl shadow p-4">
+        <div className="grid grid-cols-7 gap-2 text-left text-xs font-semibold text-gray-500 mb-2 pl-2">
+          <div>Sun</div><div>Mon</div><div>Tue</div><div>Wed</div><div>Thu</div><div>Fri</div><div>Sat</div>
+        </div>
+        <div className="grid grid-cols-7 gap-2">
+          {/* Empty cells for first week */}
+          {Array.from({ length: monthDays[0].getDay() }).map((_, i) => (
+            <div key={i}></div>
+          ))}
+          {/* Days of month */}
+          {monthDays.map((date) => {
+            const day = date.getDate();
+            const key = date.toISOString().slice(0, 10);
+            const periods = periodByDate[key] || [];
+            const status = getDayStatus({ date, key, periods, monthSubmissions, todayUTC });
+            const isToday = key === todayUTC;
+            return (
+              <div
+                key={day}
+                className={`flex items-center justify-center w-9 h-9 rounded-full font-bold text-sm leading-none text-center cursor-pointer transition-all
+                  ${status === 'submitted' ? 'bg-green-500 text-white' : ''}
+                  ${status === 'missed' ? 'bg-red-500 text-white' : ''}
+                  ${status === 'not_assigned' ? 'bg-gray-300 text-gray-500' : ''}
+                  ${status === 'not_submitted' ? 'bg-yellow-400 text-white' : ''}
+                  ${isToday ? 'ring-2 ring-blue-400 border-2 border-blue-400' : ''}
+                  ${status === 'not_assigned' ? 'opacity-50' : 'hover:scale-110'}
+                `}
+                title={status.charAt(0).toUpperCase() + status.slice(1)}
+              >
+                {day}
+              </div>
+            );
+          })}
+        </div>
+        <div className="flex gap-4 mt-4 text-xs">
+          <div className="flex items-center gap-1"><span className="w-3 h-3 rounded-full bg-green-500 inline-block"></span> Submitted</div>
+          <div className="flex items-center gap-1"><span className="w-3 h-3 rounded-full bg-yellow-400 inline-block"></span> Not Submitted</div>
+          <div className="flex items-center gap-1"><span className="w-3 h-3 rounded-full bg-red-500 inline-block"></span> Missed</div>
+          <div className="flex items-center gap-1"><span className="w-3 h-3 rounded-full bg-gray-300 inline-block"></span> Not Assigned</div>
+          <div className="flex items-center gap-1"><span className="w-3 h-3 rounded-full border-2 border-blue-400 inline-block"></span> Today</div>
+        </div>
+      </div>
+    </div>
+  );
+};
+
+export default DailyPulseCalendar;