📚 Добавлены обучающие комментарии в код + PROJECT-STRUCTURE.md

app/api/create-user/route.ts

@@ -1,5 +1,10 @@
+// API endpoint для создания нового пользователя VPN
+// POST /api/create-user
+// Принимает: { planType, telegramId, telegramUsername, firstName, lastName }
+// Возвращает: { success: true, token, username, subscriptionUrl }
+
 import { NextRequest, NextResponse } from 'next/server';
-import { randomUUID } from 'crypto';
+import { randomUUID } from 'crypto'; // Криптографически безопасная генерация UUID
 import { MARZBAN_PANEL_URL, getSubscriptionUrl } from '@/lib/constants';
 import { logger } from '@/lib/logger';
 import type { PlanType, CreateUserRequest, CreateUserResponse } from '@/types/marzban';