KTUSA-PS/SISTEMA.md

KTUSA Problemų Sistema (KTUSA-PS)

Apžvalga

KTUSA-PS yra KTU SA (Kauno technologijos universiteto Studentų atstovybės) problemų sprendimo sistema – internetinė platforma, skirta studentų problemų registravimui, tvarkymui ir sprendimui.

Technologijų rinkinys

Backend (.NET)

• Framework: ASP.NET Core (C#)
• Duomenų bazė: MySQL su Entity Framework Core
• Autentifikacija: Microsoft Azure Active Directory (MSAL) su JWT Bearer autentifikacija
• API: RESTful API su Swagger dokumentacija
• Architektūra: MVC pattern su atskirtu duomenų sluoksniu

Frontend (Vue.js)

• Framework: Vue.js 3 su Composition API
• Maršrutizacija: Vue Router 4
• Būsenos valdymas: Vuex 4
• UI Framework: Bootstrap 5 su Bootstrap Icons
• Build Tool: Vite
• HTTP klientas: Axios
• Autentifikacija: Azure MSAL Browser

Pagrindinės funkcijos

Studentams

1. Problemų registravimas – studentai gali pateikti problemas sistemoje
2. Problemų tipų pasirinkimas – galimybė klasifikuoti problemas pagal tipus
3. Atsiliepimų teikimas – galimybė komentuoti ir vertinti sprendimus

Administratoriams

1. Problemų valdymas – peržiūrėti, redaguoti ir spręsti pateiktas problemas
2. Problemų tipų administravimas – kurti ir tvarkyti problemų kategorijas
3. Publikavimo kontrolė – spręsti, kurios problemos ir sprendimai bus viešai matomi
4. Atsiliepimų moderavimas – tvarkyti naudotojų atsiliepimus

Duomenų modelis

Pagrindinės esybės

• Issue – problemų registravimas su aprašymu, tipu ir sprendimo būsena
• IssueType – problemų kategorijos (dvikalbės: LT/EN)
• PublishedProblem – viešai publikuojamos problemos
• PublishedFeedback – viešai publikuojami atsiliepimai
• Admin – administratorių vaidmenys
• Vote – balsavimo / vertinimo sistema

Saugumo funkcijos

1. Azure AD integracija – autentifikacija per Microsoft Active Directory
2. Vaidmenų sistema – atskirtos administratorių ir paprastų naudotojų teisės
3. JWT tokenų validacija – saugus API prieigos kontrolės mechanizmas
4. HTTPS privalomumas – saugus duomenų perdavimas
5. Lokalizuoti saugumo perspėjimai – naudotojų informavimas apie nesaugius ryšius

Architektūros ypatybės

• SPA (Single Page Application) – Vue.js kliento dalis su ASP.NET Core serverio dalimi
• RESTful API – aiškiai struktūrizuotas API dizainas
• Mikroservisų elementai – atskirtas duomenų sluoksnis (KTUSAPS.Data)
• Lokalizacija – dvi kalbos (lietuvių ir anglų)
• Prisitaikantis dizainas – sukurtas su Bootstrap, pritaikytas mobiliesiems įrenginiams

Projekto struktūra

KTUSA PS.sln                          # Visual Studio solution failas
├── KTUSAPS/                          # Pagrindinis web aplikacijos projektas
│   ├── Controllers/                  # API kontroleriai
│   │   ├── IssuesController.cs       # Problemų valdymo API
│   │   ├── IssueTypesController.cs   # Problemų tipų API
│   │   └── ...
│   ├── ClientApp/                    # Vue.js frontend aplikacija
│   │   ├── src/
│   │   │   ├── components/           # Vue komponentai
│   │   │   ├── pages/                # Puslapių komponentai
│   │   │   ├── router/               # Maršrutizacijos konfigūracija
│   │   │   └── store/                # Vuex būsenos valdymas
│   │   ├── package.json
│   │   └── vite.config.js
│   ├── Auth/                         # Autentifikacijos logika
│   ├── Services/                     # Verslo logikos servisai
│   └── Program.cs                    # Aplikacijos entry point
└── KTUSAPS.Data/                     # Duomenų sluoksnis
    ├── Model/                        # Entity Framework modeliai
    ├── Migrations/                   # Duomenų bazės migracijos
    └── SAPSDataContext.cs            # DbContext

Diegimas ir konfigūracija

• Konfigūracijos failai – appsettings.json (taip pat appsettings.Development.json vystymui)
• Parengta naudoti su Docker – tiek Vite, tiek .NET Core dalims
• Duomenų bazės migracijos – valdomos per Entity Framework Core migracijas
• Swagger dokumentacija – automatiškai generuojama API dokumentacija

Paleidimo instrukcijos

Reikalavimai

• .NET 6.0 arba naujesnis
• Node.js 16+ ir npm
• MySQL serveris

Serverio dalies paleidimas

cd KTUSAPS
dotnet restore
dotnet run

Kliento dalies paleidimas

cd KTUSAPS/ClientApp
npm install
npm run dev

Duomenų bazės konfigūracija

1. Sukurkite MySQL duomenų bazę
2. Atnaujinkite prisijungimo eilutę (connection string) faile appsettings.json
3. Paleiskite migracijas:

dotnet ef database update

Pagrindinės sistemos dalys

Autentifikacija

Sistema naudoja Microsoft Azure Active Directory autentifikaciją. Vartotojai prisijungia per savo institucijos paskyrą, o sistema automatiškai nustato jų teises.

Problemų valdymas

• Studentai gali registruoti problemas per intuityvią formą
• Administratoriai gali peržiūrėti visas problemas ir jas administruoti
• Problemos gali būti skirstomos į tipus ir kategorijas

Publikavimo sistema

• Administratoriai sprendžia, kurios problemos ir sprendimai bus viešai matomi
• Publikuotos problemos tampa matomos visiems sistemos naudotojams
• Atsiliepimų sistema leidžia vertinti sprendimų kokybę

Saugumas ir privatumas

• Visi duomenys perduodami per HTTPS
• Vartotojų duomenys saugomi pagal GDPR reikalavimus
• Prieiga prie administratoriaus funkcijų griežtai kontroliuojama
• Sistema perspėja apie nesaugius ryšius ar lokalų paleidimą

---

Sistema sukurta siekiant pagerinti KTU studentų problemų sprendimo procesus, užtikrinant skaidrumą, efektyvumą ir saugumą visame problemų valdymo cikle.