DocumentUploadRequired

using System.ComponentModel.DataAnnotations;
using FMH.Komponente.Basis.Ui.Validation.DataAnnotation;
using FMH.Komponente.FileUpload.Models;
using FMH.Komponente.FileUpload.Ui.Validation.DataAnnotation;
using FMH.Komponente.Infrastruktur;

namespace FMH.Komponente.WebUI.Areas.FileUploadValidierung.Models
{
    public class DokumentListePflichtBeispielViewModel
    {
        /// <summary>
        /// DocumentUploadRequired sucht am ViewModel die erste Eigenschaft vom Typ
        /// DokumentListeViewModel und prüft deren DokumentIds. Die Liste startet in diesem Beispiel
        /// bewusst leer: Sind bereits Dokumente vorhanden, gilt die Bedingung als erfüllt und die
        /// Meldung wäre nie zu sehen.
        /// </summary>
        [UIHint(UiEditor.FileUpload.DokumentListe)]
        [Display(Name = "Nachweis (mindestens ein Dokument)")]
        [DocumentUploadRequired]
        [AdditionalMetadata(UiMetadata.FileUpload.UploadUrl, "/FileUploadValidierung/DokumentListePflichtBeispiel/Upload")]
        [AdditionalMetadata(UiMetadata.FileUpload.MaxFileSizeInMb, "1")]
        [AdditionalMetadata(UiMetadata.FileUpload.MaxFiles, "1")]
        [AdditionalMetadata(UiMetadata.FileUpload.DownloadActionName, "Download")]
        [AdditionalMetadata(UiMetadata.FileUpload.DownloadControllerName, "DokumentListePflichtBeispiel")]
        public DokumentListeViewModel Nachweise { get; set; } = new DokumentListeViewModel();
    }
}

using System.Collections.Concurrent;
using System.Linq;
using System.Text;
using System.Threading;
using FMH.Komponente.Basis.Erweiterungen;
using FMH.Komponente.Basis.Ui.Feedback.Alert;
using FMH.Komponente.WebUI.Areas.FileUploadValidierung.Models;
using Microsoft.AspNetCore.Mvc;

namespace FMH.Komponente.WebUI.Areas.FileUploadValidierung.Controllers.Beispiele
{
    /// <summary>
    /// Zeigt [DocumentUploadRequired]. Die angezeigte Dokumentliste bleibt hier bewusst immer leer:
    /// Sobald bereits Dokumente zugeordnet sind, gilt die Bedingung über das versteckte Feld
    /// «NachweiseExistingDocuments» als erfüllt, die Pflichtmeldung wäre dann nicht mehr auslösbar
    /// und das Beispiel nur einmal vorführbar.
    /// </summary>
    [Area("FileUploadValidierung")]
    public class DokumentListePflichtBeispielController : Controller
    {
        /// <summary>
        /// Nur die Zuordnung Id -&gt; Name für die Rückmeldung; die Einträge landen nicht in der Tabelle.
        /// </summary>
        private static readonly ConcurrentDictionary<int, string> Dokumente =
            new ConcurrentDictionary<int, string>();

        private static int letzteId;

        [HttpGet]
        public IActionResult Index()
        {
            return this.View(new DokumentListePflichtBeispielViewModel());
        }

        [HttpPost]
        [ValidateAntiForgeryToken]
        public IActionResult Index(DokumentListePflichtBeispielViewModel modell)
        {
            // Der ungültige Zweig ist hier der Lerninhalt: Ohne übertragenes Dokument ist
            // DokumentIds leer, DocumentUploadRequired meldet Document_Required und die View wird
            // mit dem Fehler erneut angezeigt. Die Prüfung läuft rein serverseitig, es gibt keinen
            // unaufdringlichen Client-Adapter dafür.
            if (this.ModelState.IsValid == false)
            {
                return this.View(modell);
            }

            var namen = modell.Nachweise.DokumentIds
                .Select(id => Dokumente.TryGetValue(id, out var name) ? name : $"Id {id}");

            this.AddAlert(
                $"Formular gültig – Nachweis vorhanden: {string.Join(", ", namen)}",
                AlertType.Success,
                autoHide: true);

            return this.RedirectToAction(nameof(this.Index));
        }

        /// <summary>
        /// Der Upload-Endpunkt dieses Beispiels. Antwort muss ein Json mit der Eigenschaft
        /// <c>id</c> sein, erst diese Id landet als verstecktes Feld <c>DokumentIds</c> im
        /// Formular und macht die Pflichtprüfung zufrieden.
        /// </summary>
        /// <returns>Json mit der vergebenen Id.</returns>
        [HttpPost]
        public IActionResult Upload()
        {
            if (this.Request.Headers.ContainsKey("IsDropzoneRequest") == false || this.Request.Form.Files.Count == 0)
            {
                return this.Json(new { id = 0 });
            }

            var datei = this.Request.Form.Files[0];
            var bezeichnung = this.Request.Form["DateiBezeichnung"].ToString();
            var name = string.IsNullOrWhiteSpace(bezeichnung) ? datei.FileName : bezeichnung;

            var id = Interlocked.Increment(ref letzteId);
            Dokumente[id] = name;

            return this.Json(new { id });
        }

        /// <summary>
        /// Der Download-Endpunkt. In diesem Beispiel bleibt die Tabelle leer, der Endpunkt ist
        /// dennoch konfiguriert, damit das ViewModel vollständig ist.
        /// </summary>
        /// <param name="id">Die Id des Dokuments.</param>
        /// <returns>Die Datei zum Herunterladen.</returns>
        [HttpGet]
        public IActionResult Download(int id)
        {
            if (Dokumente.TryGetValue(id, out var name) == false)
            {
                return this.NotFound();
            }

            var inhalt = Encoding.UTF8.GetBytes($"Platzhalter-Inhalt für «{name}» (Id {id}).");

            return this.File(inhalt, "text/plain", name);
        }
    }
}