Merge pull request #359 from DevLoversTeam/develop

Release v1.0.2

Author: ViktorSvertoka

.github/workflows/telegram-pr-opened.yml

@@ -9,7 +9,7 @@ jobs:
         runs-on: ubuntu-latest
         steps:
             - name: Send Telegram message
-              uses: appleboy/telegram-action@v1.0.1
+              uses: appleboy/telegram-action@221e6b684967abe813051ee4a37dd61770a83ad3
               with:
                   token: ${{ secrets.TELEGRAM_BOT_TOKEN }}
                   to: ${{ secrets.TELEGRAM_CHAT_ID }}

CHANGELOG.md

@@ -624,3 +624,63 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 - Improved Redis cache reliability for Q&A
 - Extended automated tests for caching and payment flows
+
+## [1.0.2] - 2026-02-23
+
+### Added
+
+- Dashboard engagement system:
+  - Activity Heatmap with daily streak tracking and tooltips
+  - Expanded Achievements system (24 badges across multiple categories)
+  - Score distribution visualization and improved analytics
+- Profile & account management:
+  - User name update with validation
+  - Secure password change (bcrypt hashing)
+  - Localized system notifications with Notification Center
+- Admin platform expansion:
+  - Unified admin panel under `/admin` with collapsible sidebar
+  - Quiz Admin: full create workflow via JSON upload
+  - Draft → Ready → Activate publishing flow with translation validation
+  - Edit existing quizzes with locale-aware editor and Redis invalidation
+- Content & learning:
+  - Added SQL, PostgreSQL, MongoDB category to Q&A
+- User engagement:
+  - In-app feedback form with multiple attachments
+  - Sponsor recognition and GitHub star achievements
+- Shop UX:
+  - “My Orders” summary card on Cart page
+
+### Changed
+
+- Dashboard UX:
+  - Unified glassmorphism visual language across cards
+  - Clickable stats sections with smooth navigation
+- Leaderboard:
+  - Top 15 users with contextual ranking around current user
+  - Improved sponsor styling and visual consistency
+- Header & navigation:
+  - Unified dropdown styles (Notifications / Profile / Language)
+- Dependencies:
+  - Upgraded Next.js to **16.1.6**
+- Codebase:
+  - Large-scale formatting and structural refactoring
+
+### Fixed
+
+- Dashboard profile logic and statistics inconsistencies
+- Notification rendering and layout issues
+- Quiz editor Save button now disabled when no changes made
+- Admin quiz cache invalidation when status changes
+- Improved mobile menu scroll locking
+- Fixed Vercel build issues and migration conflicts
+
+### Performance & Reliability
+
+- Improved Redis cache invalidation for quizzes
+- Optimized dashboard data fetching
+- Safer database migration handling
+
+### Security
+
+- Stronger password validation and confirmation flow
+- Improved server-side validation and error reporting

frontend/.env.example

@@ -61,6 +61,11 @@ JANITOR_URL=
 # --- Quiz
 QUIZ_ENCRYPTION_KEY=
 
+# --- Web3Forms (feedback form)
+NEXT_PUBLIC_WEB3FORMS_KEY=
+
+GITHUB_SPONSORS_TOKEN=
+
 # --- Telegram
 TELEGRAM_BOT_TOKEN=
 TELEGRAM_CHAT_ID=
@@ -102,4 +107,6 @@ TRUST_FORWARDED_HEADERS=0
 # emergency switch
 RATE_LIMIT_DISABLED=0
 
-GROQ_API_KEY=
+GROQ_API_KEY=
+
+NEXT_PUBLIC_WEB3FORMS_KEY=

frontend/actions/notifications.ts

@@ -0,0 +1,96 @@
+'use server';
+
+import { desc, eq, and } from 'drizzle-orm';
+import { revalidatePath } from 'next/cache';
+
+import { db } from '@/db';
+import { notifications } from '@/db/schema/notifications';
+
+import { getCurrentUser } from '@/lib/auth';
+
+export async function getNotifications() {
+  const session = await getCurrentUser();
+  if (!session) return [];
+  
+  try {
+    const data = await db.query.notifications.findMany({
+      where: eq(notifications.userId, session.id),
+      orderBy: [desc(notifications.createdAt)],
+      limit: 20,
+    });
+    return data;
+  } catch (error) {
+    console.error('Failed to fetch notifications:', error);
+    return [];
+  }
+}
+
+export async function markAsRead(notificationId: string) {
+  const session = await getCurrentUser();
+  if (!session || !notificationId) return { success: false };
+
+  try {
+    await db
+      .update(notifications)
+      .set({ isRead: true })
+      .where(
+        and(
+          eq(notifications.id, notificationId),
+          eq(notifications.userId, session.id)
+        )
+      );
+
+    revalidatePath('/', 'layout');
+    return { success: true };
+  } catch (error) {
+    console.error('Failed to mark notification as read:', error);
+    return { success: false };
+  }
+}
+
+export async function markAllAsRead() {
+  const session = await getCurrentUser();
+  if (!session) return { success: false };
+
+  try {
+    await db
+      .update(notifications)
+      .set({ isRead: true })
+      .where(and(eq(notifications.userId, session.id), eq(notifications.isRead, false)));
+
+    revalidatePath('/', 'layout');
+    return { success: true };
+  } catch (error) {
+    console.error('Failed to mark all notifications as read:', error);
+    return { success: false };
+  }
+}
+
+export async function createNotification(data: {
+  userId: string;
+  type: string;
+  title: string;
+  message: string;
+  metadata?: any;
+}) {
+  if (!data.userId) return null;
+
+  try {
+    const [result] = await db
+      .insert(notifications)
+      .values({
+        userId: data.userId,
+        type: data.type,
+        title: data.title,
+        message: data.message,
+        metadata: data.metadata || null,
+      })
+      .returning();
+
+    revalidatePath('/', 'layout');
+    return result;
+  } catch (error) {
+    console.error('Failed to create notification:', error);
+    return null;
+  }
+}

frontend/actions/profile.ts

@@ -0,0 +1,96 @@
+'use server';
+
+import bcrypt from 'bcryptjs';
+import { getTranslations } from 'next-intl/server';
+import { revalidatePath } from 'next/cache';
+
+import { getUserProfile, updateUser } from '@/db/queries/users';
+import { getCurrentUser } from '@/lib/auth';
+
+import { createNotification } from './notifications';
+
+export async function updateName(formData: FormData) {
+  const session = await getCurrentUser();
+  if (!session) {
+    return { error: 'Unauthorized' };
+  }
+
+  const name = formData.get('name') as string;
+  if (!name || name.trim().length === 0) {
+    return { error: 'Name is required' };
+  }
+
+  try {
+    await updateUser(session.id, { name: name.trim() });
+    
+    // Create notification
+    const tNotify = await getTranslations('notifications.account');
+    await createNotification({
+      userId: session.id,
+      type: 'SYSTEM',
+      title: tNotify('nameChanged.title'),
+      message: tNotify('nameChanged.message', { name: name.trim() }),
+    });
+
+    revalidatePath('/[locale]/dashboard', 'page');
+    return { success: true };
+  } catch (error) {
+    console.error('Failed to update name:', error);
+    return { error: 'Failed to update name' };
+  }
+}
+
+export async function updatePassword(formData: FormData) {
+  const session = await getCurrentUser();
+  if (!session) {
+    return { error: 'Unauthorized' };
+  }
+
+  const currentPassword = formData.get('currentPassword') as string;
+  const newPassword = formData.get('newPassword') as string;
+
+  if (!currentPassword || !newPassword) {
+    return { error: 'Both current and new passwords are required' };
+  }
+
+  if (newPassword.length < 8) {
+    return { error: 'New password must be at least 8 characters long' };
+  }
+
+  try {
+    // Better to fetch specifically for verification
+    const { db } = await import('@/db');
+    const { users } = await import('@/db/schema/users');
+    const { eq } = await import('drizzle-orm');
+    
+    const dbUser = await db.query.users.findFirst({
+      where: eq(users.id, session.id),
+    });
+
+    if (!dbUser || !dbUser.passwordHash) {
+      return { error: 'Password not set for this account (Social Login?)' };
+    }
+
+    const isValid = await bcrypt.compare(currentPassword, dbUser.passwordHash);
+    if (!isValid) {
+      return { error: 'Invalid current password' };
+    }
+
+    const newPasswordHash = await bcrypt.hash(newPassword, 10);
+    await updateUser(session.id, { passwordHash: newPasswordHash });
+
+    // Create notification
+    const tNotify = await getTranslations('notifications.account');
+    await createNotification({
+      userId: session.id,
+      type: 'SYSTEM',
+      title: tNotify('passwordChanged.title'),
+      message: tNotify('passwordChanged.message'),
+    });
+
+    return { success: true };
+  } catch (error) {
+    console.error('Failed to update password:', error);
+    return { error: 'Failed to update password' };
+  }
+}

frontend/actions/quiz.ts

@@ -11,6 +11,9 @@ import {
   quizQuestions,
 } from '@/db/schema/quiz';
 import { getCurrentUser } from '@/lib/auth';
+import { ACHIEVEMENTS, computeAchievements } from '@/lib/achievements';
+import { getUserStatsForAchievements } from '@/lib/user-stats';
+import { createNotification } from './notifications';
 
 export interface UserAnswer {
   questionId: string;
@@ -49,7 +52,6 @@ function calculateIntegrityScore(violations: ViolationEvent[]): number {
   return Math.max(0, 100 - penalty);
 }
 
-
 async function getQuizQuestionIds(quizId: string): Promise<string[]> {
   const rows = await db
     .select({ id: quizQuestions.id })
@@ -88,6 +90,16 @@ export async function submitQuizAttempt(
       return { success: false, error: 'User mismatch' };
     }
 
+    // Capture user achievements state BEFORE saving this attempt
+    const statsBefore = await getUserStatsForAchievements(session.id);
+    const earnedBefore = new Set(
+      statsBefore
+        ? computeAchievements(statsBefore)
+            .filter(a => a.earned)
+            .map(a => a.id)
+        : []
+    );
+
     if (!quizId || !Array.isArray(answers) || answers.length === 0) {
       return {
         success: false,
@@ -213,6 +225,25 @@ export async function submitQuizAttempt(
       integrityScore,
     });
 
+    // Capture user achievements state AFTER saving this attempt
+    const statsAfter = await getUserStatsForAchievements(session.id);
+    if (statsAfter) {
+      const earnedAfter = computeAchievements(statsAfter).filter(a => a.earned);
+      const newlyEarned = earnedAfter.filter(a => !earnedBefore.has(a.id));
+
+      // Trigger notifications for any newly earned achievements
+      for (const achievement of newlyEarned) {
+        // Find full object to get the fancy translated string (if needed) or just generic name
+        await createNotification({
+          userId: session.id,
+          type: 'ACHIEVEMENT',
+          title: 'Achievement Unlocked!',
+          message: `You just earned the ${achievement.id} badge!`,
+          metadata: { badgeId: achievement.id, icon: achievement.icon },
+        });
+      }
+    }
+
     return {
       success: true,
       attemptId: attempt.id,
@@ -238,7 +269,8 @@ export async function initializeQuizCache(
     const { getOrCreateQuizAnswersCache, clearVerifiedQuestions } =
       await import('@/lib/quiz/quiz-answers-redis');
 
-    const { resolveRequestIdentifier } = await import('@/lib/quiz/resolve-identifier');
+    const { resolveRequestIdentifier } =
+      await import('@/lib/quiz/resolve-identifier');
     const { headers } = await import('next/headers');
     const headersList = await headers();
     const identifier = resolveRequestIdentifier(headersList);

frontend/app/[locale]/achievements-demo/page.tsx

@@ -0,0 +1,36 @@
+import { AchievementsSection } from '@/components/dashboard/AchievementsSection';
+import { DynamicGridBackground } from '@/components/shared/DynamicGridBackground';
+import { computeAchievements } from '@/lib/achievements';
+
+export default function AchievementsDemoPage() {
+  // Mix of earned and unearned for a realistic preview
+  const achievements = computeAchievements({
+    totalAttempts: 4,
+    averageScore: 78,
+    perfectScores: 1,
+    highScores: 2,
+    isSponsor: false,
+    uniqueQuizzes: 4,
+    totalPoints: 80,
+    topLeaderboard: false,
+    hasStarredRepo: true, // demo: show star_gazer as earned
+    sponsorCount: 0,
+    hasNightOwl: false,
+  });
+
+  return (
+    <DynamicGridBackground className="min-h-screen bg-gray-50 py-16 dark:bg-transparent">
+      <main className="mx-auto max-w-4xl px-4 sm:px-6 lg:px-8">
+        <div className="mb-10 text-center">
+          <h1 className="text-4xl font-black tracking-tight text-gray-900 dark:text-white">
+            🏅 Achievements Preview
+          </h1>
+          <p className="mt-2 text-gray-500 dark:text-gray-400">
+            Flip the badges to see details. Locked badges show your progress.
+          </p>
+        </div>
+        <AchievementsSection achievements={achievements} />
+      </main>
+    </DynamicGridBackground>
+  );
+}