Pflichtenheft für die Datenbank Ferienangebote

und Umsetzung der Programmierung

Programmversion 1.0

Stand: 04.01.2007

1. Allgemeine Information

Ursprünglich war geplant, ab den Pfingstferien 2006 die verbindlichen Ferienangebote des Stadtjugendamtes Münchens und der freien Träger in einer zentralen Datenbank zu sammeln.

Dazu sollte eine Datenbank erstellt werden, in der die Träger ihre eigenen Angebote selbst eingeben und verwalten können.

Diese Datenbank soll von den Kunden (Eltern und Teilnehmer) von verschiedenen Eingangsseiten aus (z.B. www.jiz-online; www.muenchen.de; www.pomki.de) aufgerufen werden können.

2. Eigene Homepage

Neben der Möglichkeit diese Datenbank über andere Webseiten aufzurufen, soll es jedoch auch eine eigene Adresse für die Datenbank geben.

Dazu wurde angedacht, entweder die Adresse http://www.ferienprogramm-muenchen.de oder http://www.ferien-muenchen.de zu erwerben.

Die Homepage wird in zwei Ausgabegrössen angeboten werden:
600/800 Pixel zur eigenständigen Darstellung
und in
300/400 Pixel zur Einbindung für andere Homepages.

In der aktuellen Version sind diese beiden Ausgabegrössen leider noch nicht realisiert, die zweite Ausgabegrösse wird aber schnellstmöglichst erstellt.

3. Ursprüngliches Pflichtenheft

Element Ferienprogramm Anbieter Was	Zeichenumfang/ Art	Anmerkung	Status
Name des Anbieters			Pflichtfeld
Art des Anbieters	Städtischer Anbieter Freier Träger nach § 75 KJGH oder Wohlfahrtsverband Jugendverband nach § 14 KJHG	Auswahlliste nur eine Option möglich	Pflichtfeld
Ansprechpartner			Optional
Selbstdarstellung des Anbieters	500 Zeichen		Pflichtfeld
Straße			Pflichtfeld
PLZ / Ort			Pflichtfeld
Tel:			Pflichtfeld
FAX			Optional
Email			Optional
Homepage			Optional
Logo			Optional

Element Ferienprogramm Tagesangebot Was	Zeichenumfang/ Art	Anmerkung	Status
Titel des Angebots	Max 200 Zeichen		Pflichtfeld
Beschreibung des Angebots	Max 750 Zeichen		Pflichtfeld
Typ des Angebotes	-Sport und Bewegung -Kreativität und Gestaltung -Umwelt und Naturschutz -Spiel und Spaß -Politik und Gesellschaft -Erforschen und Lernen	Auswahlliste; nur zwei Option möglich	Pflichtfeld
Ort des Angebots	Max 200 Zeichen		Optional
Ferien	Auswahlliste		Pflichtfeld
Datum	Datum kalendarisch		Pflichtfeld
Uhrzeit			Optional
Teilnehmeralter	Von bis	Angebot auffindbar bei Nennung des Alters bei Suche innerhalb des Definitionsrahmens	Pflichtfeld
Behindertengerecht	-Ja -Nein -Nach Rücksprache mit dem Anbieter	Auswahlliste	Pflichtfeld
Teilnehmerzahl	Zahl		Pflichtfeld
Kosten	Max 150 Zeichen		Pflichtfeld
Anmeldemodalitäten	Max 500 Zeichen		Pflichtfeld
Leistungsumfang	Max 150 Zeichen		Optional
Verknüpfung zum Anbieter	Name des Anbieters	Automatisch durch Eingabe	Automatisch
Buchungsstatus	Frei oder ausgebucht	Warteliste???	Pflichtfeld
Anlagen zum Download	Maximal 5 Dokumente	In allen üblichen Dateiformaten	Optional

Element Ferienprogramm Workshop / Kurse Was	Zeichenumfang/ Art	Anmerkung	Status
Titel des Angebots	Max 200 Zeichen		Pflichtfeld
Beschreibung des Angebots	Max 750 Zeichen		Pflichtfeld
Typ des Angebotes	-Sport und Bewegung -Kreativität und Gestaltung -Umwelt und Naturschutz -Spiel und Spaß -Politik und Gesellschaft -Erforschen und Lernen	Auswahlliste; nur zwei Option möglich	Pflichtfeld
Ort des Angebots	Max 200 Zeichen		Optional
Ferien	Auswahlliste		Pflichtfeld
Datum	Datum kalendarisch		Pflichtfeld
Uhrzeit			Optional
Teilnehmeralter	Von bis	Angebot auffindbar bei Nennung des Alters bei Suche innerhalb des Definitionsrahmens	Pflichtfeld
Behindertengerecht	-Ja -Nein -Nach Rücksprache mit dem Anbieter	Auswahlliste	Pflichtfeld
Teilnehmerzahl	Zahl		Pflichtfeld
Kosten	Max 150 Zeichen		Pflichtfeld
Anmeldemodalitäten	Max 500 Zeichen		Pflichtfeld
Leistungsumfang	Max 150 Zeichen		Optional
Verknüpfung zum Anbieter	Name des Anbieters	Automatisch durch Eingabe	Automatisch
Buchungsstatus	Frei oder ausgebucht	Warteliste???	Pflichtfeld
Anlagen zum Download	Maximal 5 Dokumente	In allen üblichen Dateiformaten	Optional

Element Ferienprogramm Ferienfahrten mehrtägig Was	Zeichenumfang/ Art	Anmerkung	Status
Titel des Angebots	Max 200 Zeichen		Pflichtfeld
Beschreibung des Angebots	Max 750 Zeichen		Pflichtfeld
Typ des Angebotes	-Sport und Bewegung -Kreativität und Gestaltung -Umwelt und Naturschutz -Spiel und Spaß -Politik und Gesellschaft -Erforschen und Lernen	Auswahlliste; nur zwei Option möglich	Pflichtfeld
Ort des Angebots	Max 200 Zeichen		Optional
Ferien	Auswahlliste		Pflichtfeld
Datum	Datum kalendarisch		Pflichtfeld
Uhrzeit			Optional
Teilnehmeralter	Von bis	Angebot auffindbar bei Nennung des Alters bei Suche innerhalb des Definitionsrahmens	Pflichtfeld
Behindertengerecht	-Ja -Nein -Nach Rücksprache mit dem Anbieter	Auswahlliste	Pflichtfeld
Teilnehmerzahl	Zahl		Pflichtfeld
Kosten	Max 150 Zeichen		Pflichtfeld
Anmeldemodalitäten	Max 500 Zeichen		Pflichtfeld
Leistungsumfang	Max 150 Zeichen		Optional
Verknüpfung zum Anbieter	Name des Anbieters	Automatisch durch Eingabe	Automatisch
Buchungsstatus	Frei oder ausgebucht	Warteliste???	Pflichtfeld
Anlagen zum Download	Maximal 5 Dokumente	In allen üblichen Dateiformaten	Optional

Element Ferienprogramm Stadtranderholung Was	Zeichenumfang/ Art	Anmerkung	Status
Titel des Angebots	Max 200 Zeichen		Pflichtfeld
Beschreibung des Angebots	Max 750 Zeichen		Pflichtfeld
Ort des Angebots	Max 200 Zeichen		Optional
Datum Anfang	Datum kalendarisch bis		Pflichtfeld
Datum Ende	Datum kalendarisch		Pflichtfeld
Uhrzeit			Optional
Teilnehmeralter	Von bis	Angebot auffindbar bei Nennung des Alters bei Suche innerhalb des Definitionsrahmens	Pflichtfeld
Behindertengerecht	-Ja -Nein -Nach Rücksprache mit dem Anbieter	Auswahlliste	Pflichtfeld
Kosten	Max 150 Zeichen		Pflichtfeld
Anmeldemodalitäten	Max 500 Zeichen		Pflichtfeld
Leistungsumfang	Max 150 Zeichen		Optional
Haltepunkte der Zubringerbusse	Max 500 Zeichen		Optional
Verknüpfung zum Anbieter	Name des Anbieters	Automatisch durch Eingabe	Automatisch
Buchungsstatus	Frei oder ausgebucht	Warteliste???	Pflichtfeld
Anlagen zum Download	Maximal 5 Dokumente	In allen üblichen Dateiformaten	Optional

Suchmaske:

1. Einfache Suche:

Die einfache Suche erfolgt nach folgenden Kriterien:

• Ferien (Auswahlliste nur eine Option möglich)
• Alter des Kindes: 6 bis 26 Jahre
• Art des Angebotes durch Auswahlliste: alle Angebote; Tagesangebote; Kurse und Workshops; Ferienfahrten; Stadtranderholung (nur eine Option möglich)

2. Erweiterte Suche:

Die erweiterte Suche erfolgt nach folgenden Kriterien:

• Ferien (Auswahlliste nur eine Option möglich)
• Alter des Kindes: 6 bis 26 Jahre
• Art des Angebots:

Art des Angebots Erste Ebene	Zweite verknüpfte Ebene Typ 1
Tagesangebote	-Sport und Bewegung -Kreativität und Gestaltung -Umwelt und Naturschutz -Spiel und Spaß -Politik und Gesellschaft -Erforschen und Lernen
Kurse und Workshops	-Sport und Bewegung -Kreativität und Gestaltung -Umwelt und Naturschutz -Spiel und Spaß -Politik und Gesellschaft -Erforschen und Lernen
Ferienfahrten	-Zeltlager -Skifreizeit -Wanderfreizeit -Internationale Jugendbegegnung -Abenteuerfreizeit -Reitferien
Stadtranderholung

• Integratives Angebot ja oder nein
• Datum (es werden alle Angebote gesucht die das genannte Datum beinhalten oder nicht mehr als 7 tage danach stattfinden oder beginnen)
• Auswahl nach Anbietern (Auswahlliste aller angelegten Anbieter)

Art des Angebots Erste Ebene	Zweite verknüpfte Ebene
Angebote der Stadt
Angebote freier Träger	Auswahlliste aller angelegten Anbieter freier Träger
Angebote der Jugendverbände	Auswahlliste aller angelegten Anbieter Jugendverbände

• Volltextsuche in den Bereichen Titel des Angebots und Beschreibung des Angebots

Ergebnisausgabe:

Erste Ebene - Liste:

Ergebnisse werden nur mit Titel und Anfangsdatum (Kurse; Fahrten; Stadtranderholung und Datum (Tagesangebote) gelistet. Sortierung erfolgt über Datum.

Zweite Ebene- Angebotsdetails:

Bei Auswahl eines Angebotes: Alle Inhalte des Datensatzes Angebot zusätzlich alle Inhalte Datenblatt Anbieter (Seitenstruktur noch nicht vorgegeben).

Zusätzlich Mailfunktion: Dieses Angebot weiterempfehlen.
Zusätzlich Druckversion: Diese Angebot (incl. Anbieter) drucken

Rechteverwaltung:

Erste Ebene - Anbieter:

Kann nach Zuteilung eines Accounts nur die eigenen Angebote und das Anbieterstammblatt verwalten.

Zweite Ebene - Chef einer Anbietergruppe (Jugendverbände; freie Träger; Stadt)

Teilt Accounts innerhalb seiner Gruppe zu. Kann alle Angebote und Anbieterstammblätter innerhalb der Benutzergruppe ändern.

Dritte Ebene - Admin

Kann alle Angebote und Anbieterstammblätter ändern. Hat Zugriff auf das Datenbankdesign.

4. Realisierte Rechteverwaltung

Es wurden vier Zugriffsebenen definiert

Steuerelemente:

0 Keine Rechte
1 Administration
2 Veranstalter editieren, Veranstaltungen und Mitarbeiter anlegen und editieren
3 Veranstaltungen anlegen und editieren

Um einen neuen Veranstalter anzulegen oder einen Veranstalter zu löschen benötigt man Administratorenrechte!

Das Anbieterstammblatt kann nur von jemand mit der Berechtigungsstufe 2 geändert werden kann.

User mit der Berechtigungsstufe 3 können nur die Angebote des Veranstalters ändern, nicht jedoch dessen Stammdaten.

5.MySQL-Datenbank

Die Datenbank wurde mit MySQL erstellt. Die Datenaufbereitung Abfrage für das Internet erfolgt auf PHP-Basis. Die gesamte Programmierung erfolgte mit PHP, wobei Wert darauf gelegt wurde, den Code und die Darstellung zu trennen. Allgemein sind die entsprechenden Masken im Verzeichnis /tpl abgelegt.

6. Verzeichnisstruktur

/

Hier befinden sich die meisten php-Source-Dateien sowie diese Datei.

add1.php
add2.php
addmitarbeiter1.php
addmitarbeiter2.php
addveranstalter1.php
addveranstalter2.php
addveranstaltung1.php
addveranstaltung2.php
db.php
index.php
menubar.inc.php
standard.inc.php
search.php
update1.php
update2.php
view.php

/conf

Hier werden die notwendigen Datenbankeinstellungen vorgenommen.

Sollte die Datenbank umgezogen werden müssen in der Datei die entsprechenden Einträge geändert werden.

Änderungen sind vorsichtig vorzunehmen, damit das Programm noch auf die Datenbank zugreifen kann.

/images

Hier werden die vom Programm verwendeten Grafiken und Schriftarten abgelegt.

Die Dateien können jederzeit ausgetauscht werden. Schlimmstenfalls gibt es optische Beeinträchtigung

/lib

Hier findet sich die fuer das Programm verwendete Datenbanklibrary.

Hier vorgenommene Änderungen greifen auf das ganze Programm zu. Sie müssen also getestet werden! Vorsicht!

/phpshell

Wird nicht zwingend für das Programm benötigt.

/pma

pma ist ein Tool zur Ansicht der Datenbank

/style

Hier finden sich die Stylesheets des Programmes.

Die einzelnen Bereiche sind dokumentiert.

/tpl

Hier finden sich die Template-Dateien. Über die Templatedateien wird die Anzeige und die Ausgabe der Daten über Variablen geregelt.

Die Startseite

header.tpl

footer.tpl

Hier wird die Grafik, die Überschrift und die Fußzeile inkl. der Grafiken und Links generiert.

Die allgemeinen Texte sind in den help_???.tpl Dateien abgelegt, das Impressum in der impressum.tpl.

Der Startseitentext verbirgt sich unter help_welcome.tpl.

7. Programmierung

7.1. Anlage von Veranstaltern

addveranstalter1.php

Hier wird die Session entsprechend eingestellt, die tpl.-Datei addveranstalter1.tpl ausgelesen und die entsprechenden Angaben aus der Datenbank geholt.

addveranstalter1a.php

Hier werden nach dem Drücken auf den Button die Daten ausgelesen und in die Datenbank geschrieben.

7.2. Anlage von Mitarbeitern

addmitarbeiter1.php

Hier wird die Session entsprechend eingestellt, die tpl.-Datei addmitarbeiter1.tpl ausgelesen und die entsprechenden Angaben aus der Datenbank geholt.

addmitarbeiter1a.php

Hier werden nach dem Drücken auf den Button die Daten ausgelesen und in die Datenbank geschrieben.

7.3. Veranstaltungen

Neuanlage

addveranstaltung1.php

Hier wird die Session entsprechend eingestellt, die tpl.-Datei addveranstaltung1.tpl ausgelesen und die entsprechenden Angaben aus der Datenbank geholt.

addveranstaltung1a.php

Hier werden nach dem Drücken auf den Button die Daten ausgelesen und in die Datenbank geschrieben.

Editieren

editveranstaltung1.php

Hier werden die eingegebenen Daten aus der Maske ausgelesen und die Datenbank aktualisiert.

Sonstige PhP-Dateien

index.php

Start des Programms

Hier werden die entsprechenden .tpl-Dateien ausgesucht, je nachdem ob man als Administrator oder als User angemeldet ist.

db.php

Hier wird die Konfiguration eingelesen und die Datenbank geöffnet.