adding readme and automatic builds

This commit is contained in:
Johannes Theiner 2021-11-23 10:59:00 +01:00
parent 7dbf4ae7ad
commit 18ae1ce4af
3 changed files with 43 additions and 2 deletions

3
.gitignore vendored
View File

@ -1,3 +1,4 @@
.idea .idea
config.ini.php config.ini.php
vendor vendor
*.lock

40
README.md Normal file
View File

@ -0,0 +1,40 @@
# Alumni
[![Build Status](https://teamcity.joethei.xyz/app/rest/builds/buildType:(id:Studium_Programming_DigiHelfer_Alumni)/statusIcon)](https://teamcity.joethei.xyz/viewType.html?buildTypeId=Studium_Programming_DigiHelfer_Alumni&guest=1)
---
## [Demo](https://test.joethei.de)
Login zum einsehen der Daten ist unter `login.php` mit den Zugangsdaten `test:test`
## Installation
- eine bereits fertig gebaute Version kann [hier](https://teamcity.joethei.xyz/repository/downloadAll/Studium_Programming_DigiHelfer_Alumni/.lastSuccessful/artifacts.zip) heruntergeladen werden, diese wird einmal wöchentlich automatisch aktualisiert.
- oder den Quellcode herunterladen und die Abhängigkeiten mit [Composer](https://getcomposer.org/) installieren.
Die dabei erhaltenen Dateien können dann auf einen Webserver hochgeladen werden.
## Konfiguration
Die Konfiguration muss vor der ersten Verwendung angepasst werden,
dazu die entsprechenden Werte in der `config.ini.php.sample` anpassen und in `config.ini.php` umbenennen.
### Datenbank
zur Speicherung der Daten wird eine MySQl Datenbank verwendet, die Zugangsdaten müssen
in Konfiguration angegeben werden.
Zusätzlich müssen die folgenden Tabellen erstellt werden:
```mysql
create table entries(id bigint auto_increment primary key, name varchar(255), mail varchar(255),
year int(4), birthday date, verify bool, vocation varchar(255), creation DATE,
location varchar(100), phone varchar(50)
);
create table verify(id bigint primary key, uuid VARCHAR(36),foreign key verify(id) REFERENCES entries(id));
CREATE TRIGGER before_insert_verify BEFORE INSERT ON verify FOR EACH ROW SET new.uuid = uuid();
```
### Mail Server
Der Mail Server wird verwendet um Bestätigungs E-Mails zu versenden und muss angegeben werden.
Der Konfigurationswert `url` wird dabei zu Generierung des Bestätigungslinks verwendet.

View File

@ -1,7 +1,7 @@
{ {
"require": { "require": {
"phpmailer/phpmailer": "^6.4.1", "phpmailer/phpmailer": "^6.4.1",
"rakit/validation": "v1.4.0", "rakit/validation": "^v1.4.0",
"ext-pdo": "*" "ext-pdo": "*"
}, },
"name": "digihelfer/alumni", "name": "digihelfer/alumni",