wiki:UseCaseImplementations

ID: 1

  1. Корисникот пишува во полето за пребарување состојки, што активира AJAX повик до /Recipes/getSuggestions акцијата по 300ms задоцнување за да ги добие соодветните состојки од базата на податоци.
  2. searchIngredients() прави fetch(/Recipes/getSuggestions?query=${encodeURIComponent(query)}) со GET метод. Одговорот се парсира со response.json() и се прикажува преку displaySuggestions().
  3. displaySuggestions() користи document.createElement("div") за секој резултат, сетира innerHTML со regex name.replace(regex, "<strong>$1</strong>") за highlighting, и поставува addEventListener("click") за селекција.
  4. Избраните состојки се чуваат во selectedIngredients[] низа со структура {Id, Name, Quantity, Unit}. addIngredient() прави selectedIngredients.push(newIngredient) и повикува updateIngredientsDisplay() и updateIngredientsInput()
  5. updateIngredientsInput() користи JSON.stringify(selectedIngredients) за да ја конвертира низата во string и ги сетира во hiddenIngredientsInput.value за испраќање преку формата
  6. initializeFileUpload() поставува addEventListener("dragover"), addEventListener("drop"), и FileReader() API за preview на сликата со reader.readAsDataURL(file)
  7. showAddIngredientModal() го прикажува модалниот прозорец за додавање на нова состојка што ја нема во базата. handleAddNewIngredient() прави POST до /Recipes/AddIngredient каде состојката се додава во базата но со "Pending" статус
  8. При испраќање, контролерот:
  • Ја зачувува прикачената слика во /wwwroot/images/ со уникатно име
  • Креира запис за рецептот со ID на корисникот и основни информации
  • Ја изминува низата од состојките за да креира записи во RecipeIngredient
  • Пресметува вкупни нутритривни вредности користејќи ConvertType() метод
  • Генерира тагови за типот на рецептот користејќи GenerateRecipeTags()

ID: 2

  1. Корисникот го клика рецептот што сака да го избрише од "My Recipes" секцијата
  2. Корисникот клика на копчето за бришење со што се прави повик до /Recipes/Delete акцијата која го враќа "_RecipeDeletePartial"
  3. Корисникот го потврдува бришењето на рецептот со што се прави повик до /Recipes/DeleteConfirmed акцијата која го брише записот за избраниот рецепт

ID: 3

  1. /Recipes/Index акцијата користи .Where(r => r.RecipeStatus == "Accepted") за да ги филтрира одобрените рецепти, потоа .Skip((page - 1) * pageSize).Take(pageSize) за пагинација.
  2. initializeInfiniteScroll() поставува event listener кој проверува scrollTop + windowHeight >= documentHeight - 600 за да открие кога корисникот е близу крајот. loadMoreRecipes() испраќа GET барање до /Recipes/Index акцијата.
  3. createRecipeCard() динамички креира div елементи со data-calories, data-protein, data-carbs, data-fat атрибути кои се користат за филтрирање.
  4. updateSlider() чита parseInt(minSlider.value) и parseInt(maxSlider.value), ги споредува вредностите со if (minVal > maxVal), и сетира CSS left и width на .range-fill елементот за визуелниот приказ на самите слајдери.
  5. filterRecipes() користи document.querySelectorAll(".recipe-card") за да ги добие сите картички, потоа за секоја прави:
  • parseInt(card.dataset.calories) за филтрирање според макро вредности
  • .textContent.toLowerCase() за текстуално пребарување
  • .getAttribute("data-favorited") === "true" за приказ на омилени

ID: 4

  1. currentFilters објектот ги чува вредностите од слајдерите, додека initializeFilters() поставува event listeners на сите 8 slider inputs со addEventListener("input").
  2. updateSlider() синхронизира min/max вредности со if (minVal > maxVal) validation, ажурира CSS, и повикува applyFilters() за да ги зачува вредностите во currentFilters објектот.
  3. openMenu(restaurantId) се активира на click, конструира query parameters објект од current filter state, и прави new URLSearchParams(f).toString() за URL encoding на филтрите.
  4. fetch(/Restaurants/GetRestaurantMeals/${restaurantId}?${query}) испраќа GET барање со филтер параметри како query string до контролерот.
  5. Контролерот прима nullable integers int? minCalories, int? maxCalories... што ASP.NET ги bind-ува од query string автоматски.
.Where() применува range filtering со логика (minCalories == null
r.Calories >= minCalories) за секој макронутриент.
  1. Контролерот враќа PartialView("_RestaurantMealsPartial", filteredMeals), кој fetch го зема како .text() response.
  2. JavaScript го вметнува HTML од филтрираните оброци во модалот преку menuContainer.innerHTML = html, прикажувајќи само оброци што ги исполнуваат критериумите поставени на клиентската страна.

ID: 5

  1. [BindProperty] InputModel Input автоматски ги bind-ува HTML form полињата со C# својствата. Data annotations [Required], [EmailAddress], [StringLength(100, MinimumLength = 6)] обезбедуваат client и server-side validation.
  2. OnPostAsync() прво проверува ModelState.IsValid за server-side validation, потоа повикува CreateUser() за да креира нова User instance користејќи Activator.CreateInstance<User>() reflection.
  3. _userStore.SetUserNameAsync() и _emailStore.SetEmailAsync() ги сетираат username-от и еmail-от, додека _userManager.CreateAsync(user, Input.Password) го креира записот во базата со хаширан пасворд преку Identity framework-от.
  4. _signInManager.SignInAsync(user, isPersistent: false) автоматски го логира и го пренасочува кон returnUrl.

ID: 6

  1. [BindProperty] InputModel Input автоматски ги bind-ува email и password полињата преку ASP.NET model binding. Data annotations [Required], [EmailAddress], [DataType(DataType.Password)] обезбедуваат валидација.
  2. OnPostAsync() прави ModelState.IsValid проверка, потоа повикува _signInManager.PasswordSignInAsync(Input.Email, Input.Password, Input.RememberMe, lockoutOnFailure: false) за автентикација според базата.
  3. result.Succeeded е проверка за успешна најава и прави LocalRedirect(returnUrl).
  4. Успешната најава креира authentication cookie преку Identity framework што се користи при наредни requests.

ID: 7

  1. showRecipeDetails(recipeId) се активира при клик, додава loading класа на картичката, и конструира query parameters со new URLSearchParams() за да прати isOwner и recipeDetailsDisplayContorol параметри.
  2. fetch(/Recipes/Details/${recipeId}?${params}) прави GET request и го зема response како .text() бидејќи се враќа HTML partial view.
  3. GetRatingDataAsync() во контролерот ги пресметува averageRating, totalRatings, userRating, и hasUserRated од database, додека _context.FavoriteRecipes.AnyAsync() проверува favorite статус.
  4. Контролерот ги поставува ViewBag вредности (IsOwner, AverageRating, IsFavorited) што се користат во partial view за условен приказ на елементите.
  5. JavaScript го вметнува partial view-то во modalContainer.innerHTML = html, потоа динамички извршува <script> тагови со document.createElement("script") и document.body.appendChild().

ID: 8

  1. rateRecipe(rating, recipeId) се активира со click на ѕвездичка, поставува isRatingInProgress = true за да спречи multiple concurrent requests, и веднаш го ажурира UI со updateUserRatingDisplay(rating).
  2. fetch('/Recipes/Rate') испраќа POST request со JSON body {recipeId, rating}.
  3. /Recipes/Rate акцијата користи [FromBody] JsonElement body за JSON deserialization, валидира rating >= 1 && rating <= 5, и проверува authentication со User.FindFirstValue(ClaimTypes.NameIdentifier).
  4. _context.RecipeRatings.FirstOrDefaultAsync() проверува за постоечки rating. Ако постои, прави existingRating.Rating = rating update, инаку креира new RecipeRating entity и го додава со _context.Add().
  5. По SaveChangesAsync(), контролерот прави _context.RecipeRatings.Where().Select(r => r.Rating).ToListAsync() и пресметува ratings.Average() и ratings.Count за ажурирани податоци.
  6. На клиентска страна .then(response => response.json()) го парсира JSON response, повикува updateAverageRatingDisplay(data.averageRating, data.totalRatings) за да ги ажурира ѕвездичките, и прикажува showRemoveRatingButton().
  7. removeRating() прави POST до /Recipes/RemoveRating, контролерот го бара постоечкиот запис со FirstOrDefaultAsync() и го брише со _context.Remove(), потоа рекалкулира податоци.
  8. clearUserRatingDisplay() ги ресетира ѕвездичките, hideRemoveRatingButton() го сокрива remove копчето, и document.querySelector('.rate-label').textContent се менува од "Your rating:" во "Rate this recipe:".

ID: 9 и ID: 11

  1. тoggleFavorite(recipeId) поставува isFavoriteInProgress = true, зачувува wasFavorited состојба, и веднаш ја ажурира UI со favoriteBtn.classList.toggle('favorited') и favoriteBtn.title пред да испрати request.
  2. fetch('/Recipes/ToggleFavorite') испраќа POST request со JSON body {recipeId}.
  3. /Recipes/ToggleFavorite акцијата користи [ValidateAntiForgeryToken] attribute, проверува authentication со User.FindFirstValue(ClaimTypes.NameIdentifier), и валидира дека рецептот постои со _context.Recipes.FindAsync().
  4. _context.FavoriteRecipes.FirstOrDefaultAsync() проверува за постоечки запис. Ако постои, го брише со _context.Remove(), инаку креира нов FavoriteRecipe запис и го додава со _context.Add().
  5. Контролерот враќа isFavorited boolean flag што укажува на финалната состојба, дозволувајќи кодот на клиентска страна да се синхронизира со серверската состојба независно од почетната вредност.
  6. showToast() прикажува success/error пораки базирани на data.message од server response, давајќи визуелен feedback за акцијата ("Added to favorites" / "Removed from favorites").

ID: 10

  1. toggleFavoritesFilter() се повикува кога корисникот кликнува на копчето Show Favorites Only.
  2. Се итерираат сите .recipe-card елементи и се проверува нивниот data-favorited атрибут - ако е "true" се прикажуваат, инаку се сокриваат.
  3. visibleCount се пресметува и ажурира, а текстот на копчето се менува од "Show Favorites Only" во "Show All Recipes".
  4. При повторно кликање, сите recipe cards повторно се прикажуваат и состојбата се враќа на почетната.

ID: 12

  1. User.FindFirstValue(ClaimTypes.NameIdentifier) се користи за да се земе тековниот корисник, а _context.Recipes.Where(r => r.UserId == userId) ги филтрира само рецептите на тој корисник.
  2. recipe.Ratings.Average(r => r.Rating) пресметува просечен рејтинг за секој рецепт, а ако нема рејтинзи се поставува на 0.
  3. _context.RecipeRatings.Where().GroupBy() ги групира рејтинзите по рецепт, а Math.Round(averageRating / ratings.Count(), 1) го пресметува вкупниот просек на корисникот.
  4. Razor логиката @if (recipe.RecipeStatus == "Pending/Accepted/Declined") рендерира соодветен badge со Bootstrap класи и FontAwesome икони за тоа дали рецептот е во исчекување, прифатен или одбиен.

ID: 13

  1. _context.Recipes.Where(r => r.RecipeStatus == "Pending") ги филтрира само рецептите со статус "Pending".
  2. Razor кодот @Model.Count Pending го прикажува бројот на непотврдени рецепти, а секој recipe card добива checkbox за bulk операции.
  3. setupBulkActions() во DOMContentLoaded поставува event listeners на selectAll checkbox и сите .recipe-checkbox елементи за групно селектирање.
  4. setupSearchFunctionality() и setupSortingFunctionality() овозможуваат филтрирање по наслов/автор и сортирање по датум, автор или калории преку DOM манипулација.
  5. showRecipeDetails(recipeId, true, 'Buttons') праќа isOwner=true и recipeControl='Buttons' параметри за да се прикажат approve/decline копчиња во modal-от.
  6. removeRecipeCard() ја отстранува одобрената/одбиената recipe card од DOM-от, updateDisplayCount() го ажурира бројачот.

ID: 14

  1. approveRecipe(recipeId) испраќа POST request со JSON body {recipeId} до /Admin/ApproveRecipe акцијата.
  2. request.TryGetProperty("recipeId") го извлекува ID-то, а _context.Recipes.Include().FirstOrDefaultAsync() го наоѓа рецептот.
  3. recipe.RecipeStatus = "Accepted" го менува статусот, додека ingredient.Status = null ги одобрува pending состојките и recipe.HasPendingIngredients = false го ресетира flag-от.
  4. _context.SaveChangesAsync() ги зачувува промените, а контролерот враќа JSON response со {success: true, message}.
  5. removeRecipeCard(recipeId) ја отстранува recipe card од DOM-от со fade-out анимација, hideRecipeDetails() го затвора modal-от, и showSuccess() прикажува toast порака.

ID: 15

  1. declineRecipe(recipeId) повикува fetch(/Admin/DeclineReasonModel/${recipeId}) за да го вчита partial view-то _RecipeDeclineAdminPartial, го сокрива главниот recipe modal и го прикажува decline modal-от.
  2. fetch('/Admin/DeclineRecipe') испраќа POST request со JSON body содржејќи recipeId, reason и notes, користејќи RequestVerificationToken за безбедност.
  3. /Admin/DeclineRecipe акцијата ги извлекува параметрите со request.TryGetProperty(), ги поставува recipe.RecipeStatus = "Declined", recipe.DeclineReason и recipe.AdminComment полињата.
  4. При успешен одговор, bootstrap.Modal.getInstance().hide() го затвора modal-от, showSuccess() прикажува порака, и removeRecipeCard(recipeId) ја отстранува recipe card од DOM-то.

ID: 16

  1. JavaScript addEventListener('input') на DailyCalories полето автоматски ги пресметува протеини, јаглехидрати и масти со формулите proteinCals / 4, carbCals / 4, и fatCals / 9 базирано на 30-40-30% дистрибуција.
  2. GenerateWeeklyMealPlanAsync() креира нов WeeklyMealPlan објект со GeneratedAt = DateTime.UtcNow и иницијализира празна MealSlots листа.
  3. DistributeRestaurantMeals() создава HashSet<string> од достапни слотови во формат "ден_тип_оброк", а потоа рандом селектира Math.Min(totalRestaurantMeals, availableSlots.Count) слотови кои ќе бидат одвоени за оброци од ресторан.
  4. Надворешен foreach за days низата и внатрешен foreach за mealTypes, каде што секоја итерација креира нов MealSlot објект со соодветни Day и MealType вредности.
  5. CalculateMealMacros() користи _mealTypeDistribution Dictionary (breakfast: 25%, lunch: 35%, dinner: 35%, snack: 5%) за да ги распредели дневните макроси на поединечните оброци во денот.
  6. SelectRecipeAsync() користи _context.Recipes.Include(r => r.RecipeIngredients).Where(r => r.RecipeStatus == "Accepted") за да најде одобрени рецепти, со дополнителен .Where(r => r.Type.Contains(mealType)) филтер за да се обезбеди валидноста во однос на типот на оброк.
  7. CalculateMacroMatchScore() пресметува score базиран на Math.Abs(recipe.Calories - targetMacros.Calories) за секоја макро вредност, со тежински фактори (calories: 40%, protein/carbs/fat: 20%).
  8. .OrderByDescending(x => x.Score).Take(10) ги зема најдобрите 10 рецепти, а потоа _random.Next(Math.Min(10, scoredRecipes.Count)) селектира некој рандом од нив. SelectRestaurantMealAsync() работи аналогно како SelectRecipeAsync(), но операра врз _context.RestaurantMeals табелата и користи ист macro matching алгоритам.
  9. CalculateRemainingCalories() ги сумира калориите од сите оброци за денот, а ако остануваат повеќе од 100 калории, се додава ужина со пропорции 15% протеин, 50% јаглехидрати, 35% масти.
  10. CalculateDailyMacroTotals() итерира низ секој ден и ги сумира макросите од сите оброци користејќи тернарен оператор за проверка ms.IsRestaurantMeal ? ms.RestaurantMeal?.Calories : ms.Recipe?.Calories.
  11. При успех, TempDataSuccess ја поставува пораката за следниот request, а RedirectToAction("Details", new { id = result.WeeklyMealPlan.Id }) прави redirect кон детали страницата на генерираното мени.
Last modified 2 weeks ago Last modified on 09/23/25 22:24:38
Note: See TracWiki for help on using the wiki.