Options
All
  • Public
  • Public/Protected
  • All
Menu

Développement de l'API de Camino

github.com/MTES-MCT/camino-api

Technologies


Guide de démarrage

Environnement

  • Node.js (v.10 ou plus) et npm
  • PostgreSQL (v.10 ou plus)

Configuration et imports des données

  • Cloner ce repo : git clone https://github.com/MTES-MCT/camino-api.git.
  • Renommer le fichier .env-example en .env et le compléter.
  • Créer une base de données PostgreSQL correspondant au fichier .env.
  • Copier le fichier Camino database dans le répertoire /backups.

Installation

# installe les dépendances
npm install

# importe les données depuis /backups/camino-public.sql
npm run db:public-import

# crée un utilisateur admin selon les paramètres ADMIN_EMAIL et ADMIN_PASSWORD du fichier .env
npm run db:user

Développement

# démarre le serveur avec nodemon
npm run dev

Production

# compile l'application avec typescript
npm run build

# démarre le serveur
npm run start

Structure des fichiers

.

├── docs-sources         # `source de la documentation générée avec typeDoc`

└── src                  # `fichiers sources. Transformés avec npm run build.`
    ├── index            # `point d'entrée`

    ├── api              # `APIs`
    │   ├── graphql      # `API Graphql`
    │   └── rest         # `API Rest`

    ├── config           #
    │   ├── index        # `variables globales`
    │   └── knex         # `connexion à la base de données`

    ├── dev               # `scripts de développement`

    ├── database         # `base de données PostgreSQL`
    │   ├── models       # `modèles de la base de données (knex.js / objection.js)`
    │   └── queries      # `requêtes à la base de données (knex.js / objection.js)`

    ├── business         # `logique métier`
    │   ├── processes    # `scripts de traitement`
    │   ├── rules        # `lois et procédures administratives`
    │   ├── utils        # `utilitaires de filtrage et de classement`
    │   ├── daily        # `scripts de mise à jour quotidiens (npm run daily)`
    │   ├── etape-update # `script effectués lors de la mise à jour d'une étape`
    │   └── monthly      # `scripts de mise à jour mensuels (npm run monthly)`

    ├── knex                 # `scripts de migration et d'import de la base de données
    │   ├── migrations       # `migration de la base de données`
    │   └── seeds            # `import depuis les fichier /sources vers la base de données`

    └── tools            # `outils`
        ├── export       # `exportation de la base de données vers des spreadsheets (npm run export)`
        ├── import       # `import de spreadsheets vers des fichiers json dans /sources (npm run import)`
        ├── api-...      # `connexion aux api externes`
        └── emails-send  # `envoi d'email`


Contribution

Voir contributing.md (en anglais) pour plus d'infos.

Generated using TypeDoc