phpdoc.yaml

title: comhisto - référentiel de l'historique des communes (V2)
path: /yamldoc/pub/comhisto
doc: |
  A faire:
    - faire un site spécifique static.georef.eu pour les fichiers leaflet, ...
    - améliorer replaces/replacedBy sur le fondement de l'elit

  Construction et diffusion d'un référentiel historique des communes depuis le 1er janvier 1943.
  Réutilisation du code produit dans rpicom, renommage du projet.
  Plusieurs formes de mise à disposition:
    - documentation sur https://github.com/benoitdavidfr/comhisto
    - fichier Yaml de l'historique (4,9 Mo) -> https://georef.eu/yamldoc/pub/comhisto/elits2/histelitp.yaml
      - avec son schéma et sa doc
    - fichier GéoJSON (55 Mo) utilisable dans un SIG
      -> https://static.data.gouv.fr/resources/code-officiel-geographique-cog/20200920-175314/comhistog3.geojson
    - GéoJSON zippé (6 Mo) -> https://github.com/benoitdavidfr/comhisto/blob/master/export/(comhistog3|elit).7z
    - visualisation interactive Html de chaque version de code Insee avec carte Leaflet associée
      -> https://georef.eu/yamldoc/pub/comhisto/map/
    - URI/API d'accès à chaque entité -> https://comhisto.georef.eu/
      avec restitution en fonction du paramètre Http Accept:
        - soit en Html avec inclusion du JSON-LD dans l'en-tête (par défaut dans un navigateur),
        - soit en JSON-LD.
    - OGC API Features -> https://comhisto.geoapi.fr/
    - MD DCAT https://comhisto.georef.eu/ référencant plusieurs distributions
      - fichier GéoJSON -> https://static.data.gouv.fr/...
      - fichier GéoJSON zippé -> https://github.com/benoitdavidfr/comhisto/...
      - fichier Yaml/JSON -> https://comhisto.georef.eu/histelitp.yaml
      - URI/API d'accès en JSON-GéoJSON/html/JSON-LD -> https://comhisto.georef.eu/api/
        - la version html intègre la description JSON-LD dans l'en-tête de la page
      - OGC API Features -> https://comhisto.geoapi.fr/
  
  Urls:
    - http://localhost/yamldoc/pub/comhisto/ - en local
    - https://georef.eu/yamldoc/pub/comhisto/ - sur Alwaysdata
    - https://comhisto.georef.eu/ - URI API
    - https://comhisto.geoapi.fr/ - OGC API
  
  Terminologie:
    - version valide/périmée à une date
    - version courante/actuelle = valide à la date de validité du référentiel
    
  synchro: http://localhost/synchro.php?remote=http://georef.eu/&dir=yamldoc/pub/comhisto
journal: |
  20/3/2021:
    - ajout incr pour produire le réf. au 1/1/2021 à partir de celui au 1/1/2020
  18/12/2020:
    - création utilisateur comhisto/Comhisto123456 sur Ovh et transfert connexion base vers Ovh suite à problèmes sur Alwaysdata
  10/12/2020:
    - correction de polygones parasites dans comhistog3
    - réexport de comhistog3, copie sur github, data.gouv et Alwaysdata
  4/12/2020:
    - gestion de l'espace de noms https://comhisto.georef.eu/ns
  2/12/2020:
    - chargement en base des chefs-lieux définis par un point
  30/11-1/12/2020:
    - annonce sur GéoRézo
    - ajout du géocodeur
  25-29/11/2020:
    - ajout de l'API ogcapi
  13-21/11/2020:
    - ajout de l'API renommée ensuite uriapi
  11-12/11/2020:
    - ajout visu carto
  20/10-9/11/2020:
    - écriture d'une nlle version de insee améliorant notamment la doc des erreurs Insee
    - archivage v1 (targz -> archives)
    - évolution de croise2 pour traiter les écarts Insee/IGN sur 14114/14712 et 52224/52064
    - génération des nouvelles couches, maj sur data.gouv.fr
  23/9/2020:
    - correction erreur sur 78613/91613 (Thionville)
    - ajout St Barth et St Martin
  22/9/2020:
    - écriture du schéma JSON de comhistog3
  20/9/2020:
    - détection d'erreurs et corrections
    - publication sur data.gouv
  15/9/2020:
    - gestion du cas de Lyon
  12/9/2020:
    - recopie dans comhistog3 de propriétés issues de histelitp.yaml
    - génération des com. déléguées propres
    - reste erreur sur Lyon, StBarth et StMartin
  10/9/2020:
    - restructuration en cours de zones en elits
  9/9/2020:
    - export GeoJSON assez correct, commit et push
      - reste erreur sur Lyon non traitée
  29/8/2020:
    - réécriture => abandon V1
  8/7/2020:
    - création à la suite de rpicom pour réécrire le code
submodules:
  - /yamldoc/pub/comhisto/data
  - /yamldoc/pub/comhisto/data2
  # archivé - /yamldoc/pub/comhisto/insee
  - /yamldoc/pub/comhisto/insee2
  # archivé - /yamldoc/pub/comhisto/elits
  - /yamldoc/pub/comhisto/elits2
  - /yamldoc/pub/comhisto/ign
  - /yamldoc/pub/comhisto/stbarthmartin
  - /yamldoc/pub/comhisto/cheflieu
  # archivé - /yamldoc/pub/comhisto/croise
  - /yamldoc/pub/comhisto/croise2
  - /yamldoc/pub/comhisto/export
  - /yamldoc/pub/comhisto/lib
  - /yamldoc/pub/comhisto/map
  - /yamldoc/pub/comhisto/uriapi
  - /yamldoc/pub/comhisto/ogcapi
  - /yamldoc/pub/comhisto/geocodeur
  - /yamldoc/pub/comhisto/incr
sqlDBs:
  - name: comhistoPg
    title: comhisto - base PostGis comhisto
    doc: |
      Utilisée en production et en consultation pour stocker le référentiel comhistog3
      localhost: 'host=172.17.0.4 dbname=gis user=docker'
      else: 'host=postgresql-bdavid.alwaysdata.net dbname=bdavid_comhisto user=bdavid_comhisto password=motdepasse123$'
  - name: comhistoMysql
    title: comhisto - base MySql comhisto
    doc: |
      Utilisée pour le log
      localhost: 'mysql://root:***@172.17.0.3/comhisto'
      else: 'mysql://bdavid:***@mysql-bdavid.alwaysdata.net/bdavid_comhisto'
      
phpScripts:
  #- /yamldoc/pub/comhisto/index.php
phpIncludes:
htmlFiles: