IS-115 Søknadssystem for vitenskapelige assistenter

Kjør prosjektet lokalt fra github

Forutsetninger:

• du xampp installert https://www.apachefriends.org/ (apache og mysql)
• du har composer dependency manager https://getcomposer.org/ (kun nødvending hvis du kloner fra github)

kommandoer

git clone https://github.com/SimonPortillo/soknadsystem_php.git

cd soknadsystem_php

composer install

composer start

Kjør fra zip

Uten Composer

• Unzip prosjektet.
• Alle avhengigheter er inkludert i vendor/ mappen.
• Start lokal server

  php -S localhost:8080 -t public
  

Med Composer

• Unzip prosjektet.
• kjør:

  composer install
  

• Start lokal server

  composer start
  
  

Mysql database snapshot:

database.sql (kan importeres eller kjøres direkte som sql-spørring i myphpadmin)

Config

du må endre din config fil til å bruke:

• dine mysql credentials
• smtp brukernavn og passord for PHPmailer (ikke kritisk for å kjøre siden)

se: config_sample.php

Important

Bruk config_sample som mal og lag en ny config.php i config mappen med dine credentials

Testbrukere

Det finnes tre testbrukere i databasen som representer de ulike rollene i systemet:

• student (passord: Tester123)
• ansatt (passord: Tester123)
• admin (passord: Tester123)

Funskjoner

Alle brukere

• Registrere bruker (nye brukere har rollen student)
• oppdatere valgfrie personopplysninger (fullt navn og telefonnummer)
• logge inn og ut
• tilbakestille passord

Studenter

• Søke på stillinger
• laste opp dokumenter (cv og søknadsbrev)
  • en student kan ha flere dokumenter
• slette dokumenter og søknader
• laste ned sine egne dokumenter

Ansatt

• Opprette, redigere og slette stillinger
• Se søkere
• laste ned søkers dokumenter
• oppdatere status på søknaden
• svare på søknaden gjennom plaintext grensesnitt
• svare ved å åpne epostklient med brukerens epost

Admin

• Administrere andre brukere
  • tilgang til adminpanel som viser alle brukere i systemet, alle søknadene og alle stillingene deres
  • se mer detaljerte brukeropplysninger
  • slette brukere
  • Endre rolle til andre brukere
  • administrere og slette søknader på vegne av eieren
  • redigere og slette stillinger på vegne av eieren

Prosjekt struktur

project-root/
│
├── app/                
│   ├── config/         # Konfigurasjonsfiler (database, mail, app settings, routes, services)
│   ├── controllers/    # Kontrollere (ruting + forretningslogikk)
│   ├── middlewares/    # Mellomvare (for CSP)
│   ├── models/         # Data modeller (datatilgangsklasse DAO)
│   ├── utils/          # Hjelpeklasser
│   ├── views/          # Presentasjonslogikk
│
├── cache/
│   ├── latte/          # Template cache
│   ├── application     # Api cache
│
├── public/
│   ├── images/         # Konfigurasjonsfiler (database, app settings, routes)
│   ├── js/             # Klientside funksjonalitet        
│
├── uploads/      
│   ├── users/          # Opplastningsti for bruker-dokumenter 
│
├── vendor/             # Composer avhengigheter
│
├── composer.json       # Composer config
│
├── database.sql        # Database dump
│
└── README.md

Database diagram