Heel en Schoon is een project van de Gemeente Amsterdam. Meer informatie over dit project is te vinden op de website van het Datalab van de Gemeente Amsterdam
Meer informatie datapunt.ois@amsterdam.nl
Het FIXXX-team van de Gemeente Amsterdam ontwikkelt software voor de gemeente. Veel van deze software wordt vervolgens als open source gepubliceerd zodat andere gemeentes, organisaties en burgers de software als basis en inspiratie kunnen gebruiken om zelf vergelijkbare software te ontwikkelen. De Gemeente Amsterdam vindt het belangrijk dat software die met publiek geld wordt ontwikkeld ook publiek beschikbaar is.
Deze repository bevat een "as-is" kopie van het project op moment van publiceren. Deze kopie wordt niet actief onderhouden.
De Gemeente Amsterdam heeft deze code gepubliceerd onder de Mozilla Public License v2. Een kopie van de volledige licentie tekst is opgenomen in het bestand LICENSE.
Het FIXXX-team heeft de verdere doorontwikkeling van deze software overgedragen aan de probleemeigenaar. De code in deze repository zal dan ook niet actief worden bijgehouden door het FIXXX-team.
Dit project maakt gebruik van diverse andere Open Source software componenten. O.a.
Symfony,
Doctrine,
Composer,
Monolog,
Twig,
Swiftmailer,
LiipImagine,
NelmioAPI Doc,
JSOR/Doctrine PostGIS,
Leaflet
Om deze software te draaien moet je beschikking hebben over een webserver met PHP (Apache, Nginx of IIS) en een PostgreSQL databaseserver met PostGIS. Om afbeeldingen te beschermen wordt gebruik gemaakt van de secure link module van Nginx, er is een voorbeeld gegeven voor de configuratie hiervan. Voor andere webservers is een andere configuratie vereist en is het mogelijk noodzakelijk om de code aan te passen.
Maak een nieuwe PostgreSQL database aan voor dit project.
CREATE DATABASE xx;
CREATE USER yy WITH PASSWORD 'zz';
GRANT ALL PRIVILEGES ON DATABASE xx TO yy;
Voer met een superuser onderstaand statement uit om de UUID en PostGIS functies beschikbaar te maken.
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
CREATE EXTENSION postgis;
CREATE EXTENSION postgis_topology;
Clone de codebase
git clone git@github.com:amsterdam/heelenschoon.git
cd heelenschoon
Maak een aantal mappen aan om data op te kunnen slaan
mkdir var
mkdir var/data
mkdir web/media
Afhankelijk van je systeem en de rechtenstructuur moet je sommige directories beschrijfbaar maken. Zie ook Setting up Permissions in de handleiding van Symfony 3.0. De volgende directories moeten schrijfbaar zijn voor Symfony
HTTPDUSER=`ps axo user,comm | grep -E '[a]pache|[h]ttpd|[_]www|[w]ww-data|[n]ginx' | grep -v root | head -1 | cut -d\ -f1`
sudo setfacl -R -m u:"$HTTPDUSER":rwX -m u:`whoami`:rwX var web/media
sudo setfacl -dR -m u:"$HTTPDUSER":rwX -m u:`whoami`:rwX var web/media
Installeer composer (https://getcomposer.org) en voer een composer install uit
composer install
Voer Doctrine Migrations uit om de database te initialiseren
php bin/console doctrine:migrations:migrate
Configueer tenslote een vhost van de webserver. Zie ook de specifieke handleiding per webserver in de Symfony 3.0 handleiding
Voor productie moet gebruik gemaakt worden van app_prod.php
i.p.v. app.php
zoals vermeld in de Symfony 3 handleiding.