Changes between Initial Version and Version 1 of UseCaseImplementationsFinal

Timestamp:

01/20/26 16:57:03 (5 days ago)

Author:

231104

Comment:

--

UseCaseImplementationsFinal

@@ +1 @@
+= Финална имплементација на случаи на употреба
+
+== Трансфер на средства со email известување
+
+**User-to-User трансфер**
+
+Најавен корисник се навигира кон страницата за трансфер на средства и внесува email адреса на примачот.
+
+**Backend имплементација - views.py**
+
+При испраќање на трансфер преку POST барање, најпрво се валидира изворната сметка и балансот. Потоа се проверува дали примачот постои во системот.
+
+
+{{{
+
+@api_view(['POST'])
+@permission_classes([IsAuthenticated])
+def transfer_funds(request):
+    data = request.data
+    source_account_id = data.get('source_account_id')
+    recipient_email = data.get('recipient_email')
+    amount = Decimal(str(data.get('amount', 0)))
+    note = data.get('note', '')
+
+    # Validate source account
+    source_account = Account.objects.get(id=source_account_id, user=request.user)
+
+    # Check balance
+    if source_account.balance < amount:
+        return Response({'error': 'Insufficient balance'})
+
+}}}
+
+По успешна валидација, се креираат две трансакции - една за испраќачот (debit) и една за примачот (credit):
+
+
+{{{
+
+    with transaction.atomic():
+        Transaction.objects.create(
+            account=source_account,
+            transaction_type='debit',
+            amount=amount,
+            description=f'Sent to {recipient_user.first_name}'
+        )
+
+        Transaction.objects.create(
+            account=recipient_account,
+            transaction_type='credit',
+            amount=amount,
+            description=f'Received from {request.user.first_name}'
+        )
+
+}}}
+
+**Email известување
+**
+
+По завршување на трансферот, се праќаат два email-и преку функцијата send_transfer_email:
+
+
+{{{
+def send_transfer_email(user, transfer_type, amount, recipient_name,
+                        reference_number, new_balance, is_sender=True, note=None):
+    if is_sender:
+        subject = f'Banker - Transfer Sent: ${amount}'
+    else:
+        subject = f'Banker - Payment Received: ${amount}'
+
+    send_mail(
+        subject=subject,
+        message=message,
+        from_email=settings.DEFAULT_FROM_EMAIL,
+        recipient_list=[user.email],
+        html_message=html_message
+    )
+
+}}}
+
+Email-от содржи: сума, име на примач/испраќач, референтен број, датум и време, нов баланс, и опционална порака (note) доколку е внесена при трансферот.
+
+**Internal трансфер (меѓу свои сметки)**
+
+Корисникот може да пренесе средства меѓу своите сметки.
+
+
+При интерен трансфер, корисникот добива email со детали за двете сметки:
+
+{{{
+def send_internal_transfer_email(user, amount, from_account, to_account,
+                                  reference_number, from_balance, to_balance):
+    subject = f'Banker - Internal Transfer Completed: ${amount}'
+
+    # HTML email содржи табела со:
+    # - Amount
+    # - From Account (име на изворна сметка)
+    # - To Account (име на дестинациска сметка)
+    # - Updated Balances за двете сметки
+}}}
+
+== Најава преку Google OAuth
+
+**Ненајавен корисник**
+
+Ненајавениот корисник се навигира кон страницата за најава.
+
+
+Корисникот го кликнува копчето за најава преку Google профил и го селектира посакуваниот профил.
+
+
+По успешна најава, корисникот е пренасочен кон главната страница.
+
+**Frontend имплементација - OAuthButtons.tsx**
+
+Во frontend делот се иницијализира Google Sign-In SDK и се рендерира официјалното Google копче:
+
+{{{
+useEffect(() => {
+  if (googleLoaded && window.google) {
+    window.google.accounts.id.initialize({
+      client_id: GOOGLE_CLIENT_ID,
+      callback: handleGoogleCallback,
+      ux_mode: 'popup',
+    });
+
+    window.google.accounts.id.renderButton(
+      googleButtonRef.current,
+      { theme: 'outline', size: 'large', text: 'signin_with' }
+    );
+  }
+}, [googleLoaded]);
+}}}
+
+По успешна автентикација, credential-от се праќа до backend-от:
+
+{{{
+const handleGoogleCallback = async (response) => {
+  const backendResponse = await fetch(
+    'http://localhost:8000/api/auth/google/',
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ credential: response.credential })
+    }
+  );
+
+  const data = await backendResponse.json();
+  localStorage.setItem('access_token', data.access);
+  localStorage.setItem('user', JSON.stringify(data.user));
+};
+}}}
+
+**Backend имплементација - oauth_views.py**
+
+Во backend-от се верифицира Google credential преку Google tokeninfo endpoint:
+
+{{{
+@api_view(['POST'])
+@permission_classes([AllowAny])
+def google_login(request):
+    credential = request.data.get('credential')
+
+    # Verify token with Google
+    google_url = f'https://oauth2.googleapis.com/tokeninfo?id_token={credential}'
+    response = requests.get(google_url)
+    google_data = response.json()
+
+    # Verify audience matches our app
+    if google_data.get('aud') != settings.GOOGLE_CLIENT_ID:
+        return Response({'error': 'Token not for this app'})
+
+    email = google_data.get('email')
+    first_name = google_data.get('given_name', '')
+    last_name = google_data.get('family_name', '')
+}}}
+
+Доколку корисникот не постои, се креира нов:
+
+{{{
+    user, created = User.objects.get_or_create(
+        email=email,
+        defaults={
+            'username': email,
+            'first_name': first_name,
+            'last_name': last_name,
+        }
+    )
+
+    # Generate JWT tokens
+    refresh = RefreshToken.for_user(user)
+
+    # Send login notification email
+    send_login_notification(user, 'Google Sign-in')
+}}}
+
+**Email известување при најава**
+
+При секоја успешна најава преку Google, корисникот добива security email:
+
+{{{
+def send_login_notification(user, login_method):
+    subject = 'Banker - New Sign-in to Your Account'
+
+    # Email содржи:
+    # - Account email
+    # - Sign-in Method (Google Sign-in)
+    # - Date & Time
+    # - Security warning доколку не е корисникот
+}}}
+
+== Support страница со email известување
+
+**Корисник испраќа support барање**
+
+Најавениот корисник се навигира кон Support страницата.
+
+Корисникот пополнува форма со категорија, приоритет, предмет и порака.
+
+По испраќање, корисникот добива потврда со ticket ID.
+
+**Frontend имплементација - support/page.tsx**
+
+Support формата содржи селекција за категорија и приоритет, како и полиња за предмет и порака:
+
+{{{
+const categories = [
+  { value: 'general', label: 'General Inquiry', icon: HelpCircle },
+  { value: 'bug', label: 'Bug Report', icon: Bug },
+  { value: 'feature', label: 'Feature Request', icon: Lightbulb },
+  { value: 'billing', label: 'Billing Issue', icon: CreditCard },
+];
+
+const priorities = [
+  { value: 'low', label: 'Low', color: 'bg-gray-100' },
+  { value: 'normal', label: 'Normal', color: 'bg-blue-100' },
+  { value: 'high', label: 'High', color: 'bg-orange-100' },
+  { value: 'urgent', label: 'Urgent', color: 'bg-red-100' },
+];
+}}}
+
+При submit, се праќа POST барање до backend-от:
+
+{{{
+const handleSubmit = async (e) => {
+  const response = await fetch('http://localhost:8000/api/banking/support/', {
+    method: 'POST',
+    headers: {
+      'Authorization': `Bearer ${accessToken}`,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({ subject, message, category, priority }),
+  });
+};
+}}}
+
+**Backend имплементација - contact_views.py**
+
+Backend-от го обработува support барањето и праќа два email-и:
+
+{{{
+@api_view(['POST'])
+@permission_classes([IsAuthenticated])
+def send_support_message(request):
+    data = request.data
+    user = request.user
+
+    subject = data.get('subject', 'Support Request')
+    message = data.get('message')
+    category = data.get('category', 'general')
+    priority = data.get('priority', 'normal')
+
+    # Generate unique ticket ID
+    ticket_id = f'TKT-{user.id}-{int(time.time())}'
+}}}
+
+
+{{{
+Се праќаат два email-и:
+
+    # Email 1: To support team
+    send_mail(
+        subject=f'[Banker Support - {priority.upper()}] {subject}',
+        message=support_email_body,
+        from_email=settings.DEFAULT_FROM_EMAIL,
+        recipient_list=[settings.SUPPORT_EMAIL],
+    )
+
+    # Email 2: Confirmation to user
+    send_mail(
+        subject=f'[Banker] Support Request Received - {ticket_id}',
+        message=user_confirmation,
+        from_email=settings.DEFAULT_FROM_EMAIL,
+        recipient_list=[user.email],
+    )
+}}}
+
+== Бришење на банкарска сметка
+
+**Корисник брише сметка**
+
+Најавениот корисник се навигира кон My Banks страницата.
+
+Корисникот кликнува на копчето за бришење на сметка.
+
+Системот прво проверува дали сметката има баланс - доколку има, не дозволува бришење.
+
+**Backend имплементација - views.py**
+
+{{{
+@api_view(['DELETE'])
+@permission_classes([IsAuthenticated])
+def delete_account(request, account_id):
+    account = Account.objects.get(id=account_id, user=request.user)
+
+    # Check if account has balance
+    if account.balance > 0:
+        return Response({
+            'error': f'Cannot delete account with balance. Current: ${account.balance}'
+        }, status=status.HTTP_400_BAD_REQUEST)
+
+    # Delete all transactions for this account
+    Transaction.objects.filter(account=account).delete()
+
+    # Delete the account
+    account_name = f'{account.bank.name} {account.account_type.title()}'
+    account.delete()
+
+    return Response({
+        'message': f'Account "{account_name}" deleted successfully'
+    })
+}}}
+
+**URL конфигурација - urls.py**
+
+{{{
+path('accounts/<uuid:account_id>/', views.delete_account, name='delete_account'),
+}}}
+
+== Филтрирање на аналитика по категорија
+
+**Корисник филтрира аналитика**
+
+Најавениот корисник се навигира кон Analytics страницата.
+
+Корисникот може да филтрира по временски период и по категорија.
+
+**Backend имплементација - views.py**
+
+Analytics endpoint-от прима query параметри за филтрирање:
+
+{{{
+@api_view(['GET'])
+@permission_classes([IsAuthenticated])
+def analytics_view(request):
+    # Get query parameters
+    date_range = request.GET.get('range', 'all')
+    category_filter = request.GET.get('category', 'all')
+
+    # Filter transactions by date
+    transactions = Transaction.objects.filter(account__in=user_accounts)
+    if start_date:
+        transactions = transactions.filter(created_at__gte=start_date)
+
+    # Filter by category if specified
+    if category_filter and category_filter != 'all':
+        transactions = transactions.filter(category__iexact=category_filter)
+}}}
+
+
+Филтрирањето се применува на сите калкулации - category breakdown, monthly trends и income vs expenses.
+
+Исто така се враќа листа на достапни категории за dropdown менито:
+
+
+{{{
+# Get all available categories for filter dropdown
+    all_categories = list(Transaction.objects.filter(
+        account__in=user_accounts
+    ).values_list('category', flat=True).distinct())
+
+    return Response({
+        'categoryBreakdown': category_breakdown,
+        'monthlyTrends': monthly_trends,
+        'incomeVsExpenses': income_vs_expenses,
+        'availableCategories': all_categories
+    })
+}}}
+
+
+== Конфигурација на системот
+
+**Django Settings - settings.py**
+
+Email конфигурација за Gmail SMTP:
+
+{{{
+EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
+EMAIL_HOST = 'smtp.gmail.com'
+EMAIL_PORT = 587
+EMAIL_USE_TLS = True
+EMAIL_HOST_USER = 'your-email@gmail.com'
+EMAIL_HOST_PASSWORD = 'your-app-password'
+DEFAULT_FROM_EMAIL = 'Banker App <your-email@gmail.com>'
+SUPPORT_EMAIL = 'your-email@gmail.com'
+}}}
+
+Google OAuth конфигурација:
+
+{{{
+GOOGLE_CLIENT_ID = 'your-google-client-id.apps.googleusercontent.com'
+GOOGLE_CLIENT_SECRET = 'your-google-client-secret'
+}}}
+
+**URL Routing - urls.py**
+
+Authentication endpoints:
+
+{{{
+# authentication/urls.py
+urlpatterns = [
+    path('google/', google_login, name='google_login'),
+    path('login/', login_view, name='login'),
+    path('register/', register_view, name='register'),
+]
+}}}
+
+Banking endpoints:
+
+{{{
+# banking/urls.py
+urlpatterns = [
+    path('transfer/', transfer_funds, name='transfer_funds'),
+    path('support/', send_support_message, name='support'),
+    path('analytics/', analytics_view, name='analytics'),
+    path('accounts/<uuid:account_id>/', delete_account, name='delete_account'),
+]
+}}}
+
+
+
+
+