Phase 1b — Core Features: - Huawei ID Kit login (token exchange + user info) with guest mode - Quiz engine: randomized questions, distractor shuffling, answer verification - XP service with combo bonuses (3/5/10-hit streaks), daily reset - Streak service: >=3 correct/day, freeze, UTC date handling - Hearts service: 5/day, 30min auto-restore, Pro unlimited - 50 quiz questions across 3 categories (history/drama/crosstalk) - 13 skill tree chapters with linear progression - Idempotent seed import script (categories → skill tree → questions) - 7 admin CRUD services (questions, categories, knowledge cards, skill tree, users, stats, feedback) with Zod validation - All routes use Zod schema validation, /auth/me endpoint Phase 1c — Commercialization: - Leaderboard with live XP ranking, 10 tiers, weekly settlement - Achievement system with 15 seed achievements and condition checking - Huawei IAP receipt verification + subscription management - Differentiated rate limiting (auth 10/min, quiz 60/min) - Admin audit logging middleware Infrastructure: - Vitest test framework with DB mock utilities (19 tests passing) - 12 DB tables (5 new: question_ratings, user_feedback, achievements, user_achievements, leaderboard_snapshots, subscriptions, admin_audit_log) - TypeScript strict mode: zero errors
30 lines
1.3 KiB
TypeScript
30 lines
1.3 KiB
TypeScript
import { FastifyInstance } from 'fastify';
|
|
import { getLeaderboard, getUserRank } from '../services/gamification/leaderboard-service.js';
|
|
import { getAchievements, checkAchievements } from '../services/gamification/achievement-service.js';
|
|
|
|
export async function gamificationRoutes(app: FastifyInstance): Promise<void> {
|
|
app.get('/leaderboard', async (request) => {
|
|
const { tier, page = '1', limit = '20' } = request.query as Record<string, string>;
|
|
const data = await getLeaderboard(tier, Number(page), Number(limit));
|
|
return { success: true, data: data.items, pagination: data.pagination, error: null };
|
|
});
|
|
|
|
app.get('/leaderboard/me', async (request) => {
|
|
const userId = (request.user as { userId: string }).userId;
|
|
const data = await getUserRank(userId);
|
|
return { success: true, data, error: null };
|
|
});
|
|
|
|
app.get('/achievements', async (request) => {
|
|
const userId = (request.user as { userId: string }).userId;
|
|
const data = await getAchievements(userId);
|
|
return { success: true, data, error: null };
|
|
});
|
|
|
|
app.post('/achievements/check', async (request) => {
|
|
const userId = (request.user as { userId: string }).userId;
|
|
const newlyUnlocked = await checkAchievements(userId);
|
|
return { success: true, data: { newlyUnlocked }, error: null };
|
|
});
|
|
}
|