Initial commit

src/PowderCoating.Web/Controllers/DashboardTipsController.cs

@@ -0,0 +1,172 @@
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.EntityFrameworkCore;
+using PowderCoating.Core.Entities;
+using PowderCoating.Infrastructure.Data;
+using PowderCoating.Shared.Constants;
+
+namespace PowderCoating.Web.Controllers;
+
+/// <summary>
+/// SuperAdmin-only CRUD interface for managing the rotating tip-of-the-day entries
+/// displayed on the tenant dashboard.  The system ships with 40 seed tips loaded by
+/// <c>SeedDataService.SeedSystemDataAsync()</c>; this controller allows platform
+/// operators to add, edit, deactivate, or remove tips without a code deployment.
+/// The tip shown each day is selected by the dashboard controller using
+/// <c>DayOfYear % activeCount</c> so it rotates predictably.
+/// </summary>
+[Authorize(Policy = AppConstants.Policies.SuperAdminOnly)]
+public class DashboardTipsController : Controller
+{
+    private readonly ApplicationDbContext _db;
+
+    public DashboardTipsController(ApplicationDbContext db)
+    {
+        _db = db;
+    }
+
+    /// <summary>
+    /// Returns a paginated, optionally filtered list of all dashboard tips.
+    /// Active tips are sorted first (then by newest Id) to make the currently
+    /// live pool easy to review at a glance.  ViewBag includes both the filtered
+    /// count and the global active/total counts for the header summary cards.
+    /// </summary>
+    // GET: /DashboardTips
+    public async Task<IActionResult> Index(string? search, bool? activeOnly, int page = 1)
+    {
+        const int pageSize = 25;
+
+        var query = _db.DashboardTips.AsQueryable();
+
+        if (!string.IsNullOrWhiteSpace(search))
+            query = query.Where(t => t.TipText.Contains(search));
+
+        if (activeOnly == true)
+            query = query.Where(t => t.IsActive);
+
+        var total = await query.CountAsync();
+        var tips = await query
+            .OrderByDescending(t => t.IsActive)
+            .ThenByDescending(t => t.Id)
+            .Skip((page - 1) * pageSize)
+            .Take(pageSize)
+            .ToListAsync();
+
+        ViewBag.Search = search;
+        ViewBag.ActiveOnly = activeOnly ?? false;
+        ViewBag.Page = page;
+        ViewBag.PageSize = pageSize;
+        ViewBag.Total = total;
+        ViewBag.TotalPages = (int)Math.Ceiling(total / (double)pageSize);
+        ViewBag.ActiveCount = await _db.DashboardTips.CountAsync(t => t.IsActive);
+        ViewBag.TotalCount = await _db.DashboardTips.CountAsync();
+
+        return View(tips);
+    }
+
+    /// <summary>Returns the Create form with an empty <see cref="DashboardTip"/> model.</summary>
+    // GET: /DashboardTips/Create
+    public IActionResult Create() => View(new DashboardTip());
+
+    /// <summary>
+    /// Persists a new dashboard tip.  Text is trimmed before saving to prevent
+    /// whitespace-only entries from appearing as blank tiles on the dashboard.
+    /// Model validation is done manually (rather than relying solely on
+    /// <c>[Required]</c> attributes) to ensure a meaningful error message is shown.
+    /// </summary>
+    // POST: /DashboardTips/Create
+    [HttpPost, ValidateAntiForgeryToken]
+    public async Task<IActionResult> Create(DashboardTip model)
+    {
+        if (string.IsNullOrWhiteSpace(model.TipText))
+        {
+            ModelState.AddModelError(nameof(model.TipText), "Tip text is required.");
+            return View(model);
+        }
+
+        _db.DashboardTips.Add(new DashboardTip
+        {
+            TipText = model.TipText.Trim(),
+            IsActive = model.IsActive,
+            CreatedAt = DateTime.UtcNow
+        });
+        await _db.SaveChangesAsync();
+
+        TempData["Success"] = "Tip added successfully.";
+        return RedirectToAction(nameof(Index));
+    }
+
+    /// <summary>Returns the Edit form for an existing tip, or 404 if not found.</summary>
+    // GET: /DashboardTips/Edit/5
+    public async Task<IActionResult> Edit(int id)
+    {
+        var tip = await _db.DashboardTips.FindAsync(id);
+        if (tip == null) return NotFound();
+        return View(tip);
+    }
+
+    /// <summary>
+    /// Updates text and active flag for an existing tip.  Returns the tracked entity
+    /// (not the posted model) to the view on validation failure so the form shows
+    /// the database version rather than potentially mangled posted data.
+    /// </summary>
+    // POST: /DashboardTips/Edit/5
+    [HttpPost, ValidateAntiForgeryToken]
+    public async Task<IActionResult> Edit(int id, DashboardTip model)
+    {
+        var tip = await _db.DashboardTips.FindAsync(id);
+        if (tip == null) return NotFound();
+
+        if (string.IsNullOrWhiteSpace(model.TipText))
+        {
+            ModelState.AddModelError(nameof(model.TipText), "Tip text is required.");
+            return View(tip);
+        }
+
+        tip.TipText = model.TipText.Trim();
+        tip.IsActive = model.IsActive;
+        await _db.SaveChangesAsync();
+
+        TempData["Success"] = "Tip updated.";
+        return RedirectToAction(nameof(Index));
+    }
+
+    /// <summary>
+    /// Permanently (hard) deletes a dashboard tip.  Tips are platform metadata so
+    /// they do not use soft delete — they have no foreign-key relationships to
+    /// tenant data and nothing references a deleted tip's Id.  A missing Id is
+    /// silently ignored to keep the action idempotent.
+    /// </summary>
+    // POST: /DashboardTips/Delete/5
+    [HttpPost, ValidateAntiForgeryToken]
+    public async Task<IActionResult> Delete(int id)
+    {
+        var tip = await _db.DashboardTips.FindAsync(id);
+        if (tip != null)
+        {
+            _db.DashboardTips.Remove(tip);
+            await _db.SaveChangesAsync();
+            TempData["Success"] = "Tip deleted.";
+        }
+        return RedirectToAction(nameof(Index));
+    }
+
+    /// <summary>
+    /// Flips the <c>IsActive</c> flag on a tip without a full edit round-trip.
+    /// This lets operators quickly remove a tip from the rotation (deactivate)
+    /// without deleting it, preserving the ability to reactivate it later.
+    /// A missing Id is silently ignored to keep the action idempotent.
+    /// </summary>
+    // POST: /DashboardTips/ToggleActive/5
+    [HttpPost, ValidateAntiForgeryToken]
+    public async Task<IActionResult> ToggleActive(int id)
+    {
+        var tip = await _db.DashboardTips.FindAsync(id);
+        if (tip != null)
+        {
+            tip.IsActive = !tip.IsActive;
+            await _db.SaveChangesAsync();
+        }
+        return RedirectToAction(nameof(Index));
+    }
+}