zysktomasz / votingapp

App for creating custom polls. ASP.NET Core 2.0 with EF Core + Identity

Aplikacja do głosowania, tworzenia ankiet, sprawdzania ich statystyk(todo) oraz generowania raportów(todo). Korzystanie z usług wymaga rejestracji, zaimplementowanej z wykorzystaniem ASP.NET Core Identity.

---

Wykorzystane technologie i rozwiązania

• ASP .NET Core 2.0 (wzorzec projektowy MVC)
• Razor Views + Bootstrap (prosty front aplikacji)
• npm (manager pakietów jquery,bootstrap)
• Entity Framework Core (Code First, obsługa baz danych MSSQL)
• ASP .NET Core Identity (autoryzacja/autentykacja)
• DbInitializer.cs do utworzenia startowych kont i ankiet
• LoginStatusViewComponent do prezentacji belki logowania/zarządzania ankietami dla zalogowanych, zgodnie z tym artykułem
• wykorzystanie nuget pakietu OdeToCode.AddFeatureFolders od K. Scott Allena (opisane tutaj) do organizacji controllerów i views wewnątrz nowego folderu Features

---

---

Struktura solucji projektu

Struktura reprezentuje moją pierwszą próbę zastosowania się do Clean Architecture bazując na wskazówkach opisanych w Architecting Modern Web Apps with ASP.NET Core 2 and Azure

• VotingApp.Core zawiera klasy POCO modeli (Answer, Poll, Vote, ApplicationUser) oraz interfejsy (IPoll, IVote)
• VotingApp.Infrastructure zawiera DbContext i migracje z EF Core oraz implementacje interfejsów (/Services)
• VotingApp.Web - warstwa prezentacyjna z views i controllers pogrupowanymi w dodatkowym folderze Features

---

---

Dodawanie ankiety

Każdy zalogowany użytkownik może dodać ankietę. Pola formularza: pytanie, odpowiedzi, status (public/private).

Private - ankieta niewidoczna na liście ankiet, dostępna jedynie z adresu

Przycisk "Add new answer field" dodaje, z użyciem javascriptu, kolejne pole na odpowiedź. "Remove" zaś usuwa powiązane do siebie pole. Poniżej kod zawarty w AddPoll.cshtml

    $(document).ready(function () {
        $('.answers_wrapper').on("click", ".remove_button", function (e) { //user click on remove text
            e.preventDefault(); $(this).parent('div').parent('div').remove();
        })

        var answerHTML = '<div class="input-group col-8 mb-3"><input class="form-control" type="text" data-val="true" data-val-required="The Answers field is required." id="Answers" name="Answers" /><div class="input-group-append"> <button class="btn btn-outline-secondary remove_button" type="button">Remove</button></div></div>';
        $(".add_button").click(function () {
            $(".answers_wrapper").append(answerHTML);
        });

    });

W ViewModelu PollAddViewModel.cs został również dopisany customowy atrybut, zapewniający że lista odpowiedzi w formularzu nie będzie pusta oraz nie będzie zawierała pustych elementów.

public class PollAddViewModel
    {
        [Required]
        public string Question { get; set; }
        [EnsureICollectionElementNotNull(ErrorMessage = "Answer cannot be empty.")]
        public ICollection<string> Answers { get; set; }
        public PollStatus Status { get; set; }
    }

    public class EnsureICollectionElementNotNullAttribute : ValidationAttribute
    {
        public override bool IsValid(object value)
        {
            var list = value as ICollection<string>;
            if (list == null) return false;

            if (list.Any(answer => answer == null))
            {
                return false;
            }
            return true;
        }
    }

Poniżej metoda HttpPostAddPoll() w controllerze odpowiadająca za dodawanie ankiety.

        [HttpPost, ValidateAntiForgeryToken]
        public async Task<IActionResult> AddPoll([Bind("Question,Answers,Status")] PollAddViewModel model)
        {
            if (ModelState.IsValid)
            {
                Poll newPoll = new Poll
                {
                    Question = model.Question,
                    Answers = model.Answers.Select(s => new Answer
                    {
                        Description = s,
                    }).ToList(),
                    Status = model.Status,
                    User = await _userManager.GetUserAsync(User)
                };

                _polls.Add(newPoll);
                return RedirectToAction(nameof(MyPollsItem), new { pollId = newPoll.PollId });
            }

            return View(model);
        }

---

---

Głosowanie

Głosowanie wymaga bycia zalogowanym, głos można oddać raz, ostatecznie (bez możliwości zmiany).

Wyniki ankiety

Widok po zagłosowaniu, wyświetla ilość głosów oraz Pie Chart z Google Charts

Metoda zwracająca dane json z wynikami ankiety

[AllowAnonymous]
        [HttpGet]
        [Route("[controller]/[action]/{pollId}")]
        public JsonResult ResultsPieChart(int pollId)
        {
            var answers = _polls.GetPollById(pollId).Answers;

            var resultsData = answers.Select(a => new {
                    description = a.Description,
                    votes = a.Votes
                }).ToList();
            return Json(resultsData);
        }

---

---

Zarządzanie ankietami

Lista własnych ankiet, z przyciskiem usuwającym

Panel zarządzający ankiety

"Get summary in .PDF" - TODO