1KA_F2F/readme.md

# 1KA-F2F

1KA (https://www.1ka.si) je spletno orodje za spletno in deloma telefonsko anketiranje.  
  
**1KA-F2F** (delovno ime 2KA) je odvejitev (fork) orodja 1KA, ki je prirejena za **profesionalno agencijsko rabo**.  

Odvejitev je bila izpeljana v letu 2017:
- v letu 2019, 2021 in 2023 je so bile novosti iz 1KA prenešene v 1KA-F2F
- z letom 2023 (januar) sta zaradi novih 1KA-F2F dodelav postali veji tako različni, da bo z zagotavljanjem združljivosti preveč dela.

## Zakaj 1KA-F2F

Na delu na Centru za merjenje javnega mnenja in množičnih komunikacij (CJMMK, del FDV) redno izvajamo terenske (F2F), spletne in poštne ankete. Ker so komercialna orodja draga in toga, smo začeli iskati alternativne rešitve in se odločili za 1KA, ki je v dobršni meri pokrila potrebe profesionalnega anketarskega dela.  

Pri prvi resnejši uporabi 1KAe za "push2web" se je izkazala vrsta pomanjkljivosti v zvezi z email obveščanjem in sinhronizacijo podatkov med spletom in papirjem. Od leta 2015 tako, predvsem v prostem času, dopolnjujem orodje 1KA z "obliži" (patches), ki omogočajo delo na terenu. Vseh sprememb ni bilo možno integrirati v izvorno 1KO, saj bi v negativnem smislu vplivale na delovanje obstoječih anket (različno obnašanje piškotov, izvažanje datotek, ipd.).

Leta 2017 sem razvil tudi funkcionalnosti terenskega anketiranja, ki sem jih leta 2019 temeljito dodelal v skupek orodij, ki so omogočala sočasno anketiranje prek vseh štirih (telefon, splet, poštno, osebno) načinov in sinhronizacijo v skupno podatkovno datoteko.  

V letu 2019 so postale razlike med vejama tako velike, da je bilo nesmiselno vztrajati pri ročnem lepljenju obližev (angl. patchanju) na 1KAo. Tako sem oddvojil vejo 1KA-F2F, ki za razliko od izvirne različice 1KA nudi nekaj dodatnih funkcionalnosti ter deluje predvidljivo glede na predhodne različice; ne vključuje pa več zadnjih lepotnih popravkov. 


## Ključne razlike od osnovne veje

- dodane funkcionalnosti za F2F anketiranje znotraj orodja:
  - spremenjeno obnašanje piškotov
  - spremenjeno obnašanje naknadnega urejanja
  - dodelano izvažanje podatkov (možnost sinhronizacije na centralni strežnik)
- dopolnjeno pošiljanje obvestilnih pisem (primerno za anketiranje tisočev respondentov)
- izdelane dodatne skripte za sinhronizacijo in združevanje podatkov na strežnik- spremembe v obnašanju piškotov: 
- na strežniku samodejna izdelava .SAV datotek iz izvoznh paketov posameznih anketarskih terminalov
- odstranjen Drupal
- temeljito očiščena in varnostno dodelana koda (sonarCube ocena kode in varnosti: A/A/A/A. 1KA ima E/E/E/A in 2700 dni programerskega "dolga")
- vse spremembe ohranjajo združljivost za nazaj

## Ali lahko uporabljam 1KA-F2F?

Programska oprema je izdana pod licenco GNU GPL V2, zato jo lahko uporabljate in dodelujete pod pogoji GNU GPL V2 licence (gl. spodaj).  

Omeniti velja, da je bila 1KA-F2F je bila razvita kot hobi projekt.  
Podpore tako ne morem nuditi; prav tako ne nudim gostovanja.



## Avtor

May Doušak; may.dousak@fdv.uni-lj.si

## Licenca 

Programska oprema je prosto na voljo komurkoli pod pogoji licence GNU GPL V2.


Copyright (C) May Doušak

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.


## Navodila composer

### Dodajanje novega razreda
V kolikor se doda nov razred v main/survey/app, aplikacija 1ka sama naloži omenej razred zaradi PSR-4 standarda. Pri definiranju novega razreda uporabiti namespace "App\Controller" in deklarirati razred (use ime razreda), katere se uporablja v omenjenem novem razredu.

Pri dodajanju razredov v admin/survey ali kamorkoli drugam pa je potrebno v datoteki composer.json ime datoteko oz. točno določen
razred. Ko je razred dodan se mora izvesti:

```
composer dump-autoload
```

### Posodobitev dodatnih knjižnic razvojno okolje ali commit na pridukcijo
Pri posodobitvi knjižnic in osveževanju autoloaderja za produkcijo se uporabi ukaz:

```
composer produkcija
```

### Development (lokalno/strežnik)
Pri razvoju se lahko uporablja orodja, ki so primerna za razvoj in se dodatne knjižnice namesti z
```
composer dev
```