📚 Добавлены обучающие комментарии в код + 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';

app/page.tsx

@@ -1,4 +1,8 @@
-'use client';
+// Главная страница приложения (Home Page)
+// Показывает статус подписки пользователя и кнопки действий
+// URL: https://app.umbrix.net/
+
+'use client'; // Next.js 13: это клиентский компонент (с useState, useEffect)
 
 import { useState, useEffect } from 'react';
 import { useRouter } from 'next/navigation';