Camino API

API GraphQL de Camino: api.camino.beta.gouv.fr

---

Technologies

• Node.js
• Express.js
• PostgreSQL
• Express-GraphQL
• Knex.js
• Objection.js
• Eslint
• Prettier
• Standardjs
• Docker

---

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.
• À l'intérieur du dossier /database, coller le fichier camino-public.sql disponible ici : Camino database.

Installation

# installe les dépendances 
npm install
 
# importe les données depuis /database/camino-public.sql 
npm run db:import-public
 
# crée un utilisateur admin 
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

Tests

# lance les tests en local 
npm run dev:test

---

Structure des fichiers

.
│
├── knex                 # `scripts de création et d'import de la base de données (npm run migrate) 
│   ├── migrations       # `création de la base de données` 
│   └── seeds            # `import depuis les fichier /sources vers la base de données` 
│
├── manual               # `source de la documentation générée avec esdoc` 
│
└── src                  # `fichiers sources. Transformés avec npm run build.` 
    ├── index            # `point d'entrée` 
    │
    ├── api              # `API graphql` 
    │   ├── resolvers    # `liens entre l'API et la base de données` 
    │   ├── schemas      # `description des nœuds de l'API` 
    │   └── types        # `types graphQl customs` 
    │
    ├── config           # 
    │   ├── index        # `variables globales` 
    │   └── knex         # `connexion à la base de données` 
    │
    ├── 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)` 
    │
    └── tools            # `outils` 
        ├── dev          # `outils de développement` 
        ├── 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` 
 

---

PostgreSQL

---

Contribution

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

---

Crédits

Production

• La Fabrique Numérique, Ministère de la transition écologique et solidaire

Équipe

• Guillaume Levieux, intrapreneur
• Joeffrey Arruyer, coach
• François Romain, développeur
• Adrien Risser, développeur

---

Licence

Camino API, le cadastre minier numérique ouvert

AGPL 3 ou plus récent