@amsom-habitat/cresol 0.1.0

package/README.md

@@ -0,0 +1,508 @@
+# Cresol
+
+Assistant de **création de sollicitation**, extrait de Cally2 et réutilisable par les outils
+AMSOM Habitat.
+
+L'assistant est **autonome** : il charge lui-même la nomenclature, l'arbre patrimonial et les
+collaborateurs, puis poste la création et les documents joints. Il ne connaît rien de l'outil
+qui l'héberge. Celui-ci lui donne :
+
+- les **réclamants** possibles (le dossier consulté) ;
+- éventuellement un **brouillon pré-alimenté** et des **champs figés** ;
+- le contenu des **volets latéraux** (sollicitations similaires, évènements), qui restent les
+  siens.
+
+En retour, il reçoit des **événements** à chaque moment clé : avant et après la création, et
+aux changements de réclamant, de motif et d'étape.
+
+```text
+┌──────────────── outil hôte ────────────────┐
+│  props : reclamants, modelValue, readonly… │
+│  slots : volets similaires / évènements    │
+└───────────────┬────────────────▲───────────┘
+                │                │ événements : beforeCreate, created,
+                ▼                │ createError, motifChange…
+        ┌──────────────── Cresol ────────────────┐
+        │ [Réclamant] › Catégorisation › Cible › │
+        │ Détails  →  POST création + documents  │
+        └────────────────────────────────────────┘
+```
+
+## Sommaire
+
+- [Installation](#installation)
+- [Configuration](#configuration)
+- [Démarrage rapide](#démarrage-rapide)
+- [Props](#props)
+- [Événements](#événements)
+- [Slots](#slots)
+- [Le choix du réclamant](#le-choix-du-réclamant)
+- [Champs figés (`readonly`)](#champs-figés-readonly)
+- [Restreindre la nomenclature](#restreindre-la-nomenclature)
+- [Le brouillon (`v-model`)](#le-brouillon-v-model)
+- [La création](#la-création)
+- [Exports](#exports)
+- [Endpoints consommés](#endpoints-consommés)
+- [Développement](#développement)
+
+## Installation
+
+```bash
+npm i @amsom-habitat/cresol
+```
+
+Pas de feuille de style à importer : le CSS est injecté par le JS du paquet. L'outil fournit, lui,
+Bootstrap (`@amsom-habitat/bootstrap-5`) et le composant global `font-awesome-icon`. Les icônes
+portées par les données (motifs, catégories…) sont enregistrées à la volée par le paquet.
+
+## Configuration
+
+À poser **une fois** au démarrage de l'outil :
+
+```javascript
+import { configureCresol } from '@amsom-habitat/cresol'
+
+configureCresol({ baseUrl: import.meta.env.VITE_API_URL })
+```
+
+| Option          | Défaut (`@amsom-habitat/user-manager`) | Rôle                                |
+| --------------- | -------------------------------------- | ----------------------------------- |
+| `baseUrl`       | — (**obligatoire**)                    | Racine de l'API métier              |
+| `getToken`      | cookie partagé du domaine              | Jeton envoyé à chaque appel         |
+| `setToken`      | écrit le cookie                        | Jeton renouvelé (refresh 449)       |
+| `logout`        | déconnexion du domaine                 | Refresh impossible                  |
+| `goToLoginPage` | page de login du domaine               | 401 / 498 sur un appel qui redirige |
+
+Un outil du domaine ne pose que `baseUrl` : le jeton suit le SSO. Les autres options servent à un
+outil qui gère son authentification lui-même.
+
+Deux props surchargent la configuration **pour une instance** : `baseUrl` et `token`. Ordre de
+priorité : **prop › `configureCresol` › défaut**. Elles servent aux cas de bord : storybook, démo,
+seconde API, outil hors du domaine. Sans `baseUrl` nulle part, l'appel échoue avec une erreur
+explicite plutôt que de partir en relatif sur l'origine de la page.
+
+## Démarrage rapide
+
+```vue
+<template>
+  <creer-sollicitation-modal
+    v-if="open"
+    :reclamants="[{ type: 'L', id: 2200523, libelle: 'Contrat' }]"
+    :model-value="{ provenance: 'T' }"
+    :readonly="['reclamant']"
+    @created="onCreated"
+    @error="$toast.error($event)"
+    @close="open = false"
+  >
+    <template #aside-similaires="{ idMotif, codeProgramme, idCible }">
+      <mes-similaires :id-motif="idMotif" :code-programme="codeProgramme" :id-cible="idCible" />
+    </template>
+    <template #aside-evenements>
+      <mes-evenements-de-patrimoine />
+    </template>
+  </creer-sollicitation-modal>
+</template>
+
+<script>
+import { CreerSollicitationModal } from '@amsom-habitat/cresol'
+
+export default {
+  components: { CreerSollicitationModal },
+  data: () => ({ open: true }),
+  methods: {
+    onCreated(sollicitations) {
+      this.$toast.success(`${sollicitations.length} sollicitation(s) créée(s)`)
+      // … recharger le listing de l'outil
+    }
+  }
+}
+</script>
+```
+
+Deux composants, **même contrat** (props, événements, slots, définis une seule fois dans
+`src/props.js`) :
+
+- **`CreerSollicitationForm`** : l'assistant seul, à placer dans une page ou dans sa propre modale ;
+- **`CreerSollicitationModal`** : le même, dans une `AmsomModal`. Il ajoute les props `titre`
+  (défaut `'Nouvelle sollicitation'`) et `closeOnCreated` (défaut `true` : émet `close` juste
+  après `created`), et l'événement `close` (croix, ou création réussie). Ses attributs non
+  déclarés (`reducible`, `title`…) descendent sur `AmsomModal`.
+
+## Props
+
+| Prop                 | Type             | Défaut     | Rôle                                                                                   |
+| -------------------- | ---------------- | ---------- | -------------------------------------------------------------------------------------- |
+| `reclamants`         | Array            | `[]`       | Réclamants proposables : `[{ type, id, libelle }]` ([détail](#le-choix-du-réclamant))  |
+| `reclamantMode`      | String           | `'select'` | Présentation du choix : `select`, `switch`, `autocomplete`, `step`                     |
+| `modelValue`         | Object           | `null`     | Brouillon pré-alimenté, partiel ; suivi en `v-model` ([détail](#le-brouillon-v-model)) |
+| `readonly`           | Boolean \| Array | `false`    | Champs figés : `true`, `false` ou une liste ([détail](#champs-figés-readonly))         |
+| `modules`            | Array            | `null`     | Modules du réclamant ; laissés `null`, chargés pour un réclamant contrat               |
+| `idModule`           | String \| Number | `null`     | Module à préférer comme cible par défaut parmi ceux du réclamant                       |
+| `nomenclatureFilter` | Function         | `null`     | Prédicat : quels motifs sont proposables ([détail](#restreindre-la-nomenclature))      |
+| `aside`              | Boolean          | `true`     | Affiche le volet latéral (ses onglets viennent des slots)                              |
+| `nbSimilaires`       | Number           | `0`        | Badge de l'onglet « Similarité »                                                       |
+| `baseUrl`            | String           | `null`     | API de cette instance (sinon `configureCresol`)                                        |
+| `token`              | String           | `null`     | Jeton de cette instance (sinon `configureCresol`)                                      |
+
+Chaque prop porte **une seule responsabilité**. Les valeurs de la saisie passent par
+`modelValue`, les choix possibles par `reclamants`, ce qui est modifiable par `readonly`, et la
+présentation du réclamant par `reclamantMode`. Il n'y a donc pas de prop `provenance` : on la
+passe dans `modelValue` (`{ provenance: 'M' }`).
+
+`modelValue` n'est lu qu'**à l'ouverture** : le modifier ensuite ne réinitialise pas l'assistant.
+Pour repartir d'un autre brouillon, on remonte le composant (`v-if` ou `:key`).
+
+## Événements
+
+| Événement           | Quand                                     | Charge utile                                                 |
+| ------------------- | ----------------------------------------- | ------------------------------------------------------------ |
+| `update:modelValue` | à chaque modification du brouillon        | le brouillon                                                 |
+| `reclamantChange`   | l'utilisateur change de réclamant         | l'entrée de `reclamants` choisie                             |
+| `motifChange`       | le motif ou les motifs associés changent  | `{ idCategorie, idType, idNature, idMotif, motifsAssocies }` |
+| `stepChange`        | changement d'étape                        | `{ step, key, previous: { step, key } }`                     |
+| `beforeCreate`      | clic sur « Créer », **avant** l'appel API | `{ payload, cancel, waitUntil }`                             |
+| `created`           | création réussie (documents compris)      | `(sollicitations, { payload, fichiers })`                    |
+| `createError`       | l'API a refusé la création                | `{ error, message, payload }`                                |
+| `error`             | **toute** erreur affichable               | `message` (chaîne)                                           |
+| `close`             | (modale) fermeture demandée               | —                                                            |
+
+`reclamantChange`, `motifChange` et `stepChange` ne sont **pas émis pour l'état initial** : l'outil
+le connaît déjà, puisque c'est lui qui l'a fourni. Ils rendent compte de ce que fait l'utilisateur.
+
+### Le cycle de la création
+
+```text
+clic « Créer »
+   │
+   ├─ beforeCreate ── cancel() / waitUntil(false | rejet) ──▶ rien n'est envoyé, l'assistant reste ouvert
+   │
+   ├─ POST creer_sollicitation ── échec ──▶ createError + error, l'assistant reste ouvert
+   │
+   ├─ POST upload_sollicitation_ged (un par document, en parallèle)
+   │      échec d'un document ──▶ error (la création, elle, est acquise)
+   │
+   └─ created(sollicitations, { payload, fichiers })   (modale : puis close)
+```
+
+Pendant tout le cycle, l'assistant est sous overlay et un second clic est ignoré.
+
+**Succès et échec sont séparés** (`created` / `createError`) : l'outil n'y fait pas la même
+chose (fermer et recharger d'un côté, garder la saisie et expliquer de l'autre), et chacun
+porte une charge utile différente. `error` reste le **canal unique des messages** pour qui ne
+veut que toaster : il reçoit aussi les échecs de création, ceux des documents et ceux des
+chargements. Règle simple :
+
+- pour **afficher** une erreur, écouter `error` ;
+- pour **réagir** à l'échec de la création (journaliser, proposer autre chose…), écouter
+  `createError`.
+
+### `beforeCreate` : intervenir avant l'envoi
+
+L'événement porte un objet :
+
+| Clé                  | Rôle                                                                           |
+| -------------------- | ------------------------------------------------------------------------------ |
+| `payload`            | le corps qui va partir ([forme](#la-création)) ; **modifiable en place**       |
+| `cancel()`           | annule la création                                                             |
+| `waitUntil(promise)` | fait attendre l'envoi ; résolue à `false`, ou rejetée, elle annule la création |
+
+```javascript
+// Confirmation
+onBeforeCreate({ payload, waitUntil }) {
+  waitUntil(this.$confirm(`Créer ${payload.lignes.length} sollicitation(s) ?`))
+}
+
+// Veto synchrone
+onBeforeCreate({ payload, cancel }) {
+  if (!this.peutCreer(payload)) cancel()
+}
+
+// Enrichir le payload
+onBeforeCreate({ payload }) {
+  payload.lignes.forEach((ligne) => (ligne.description += `\n[${this.origine}]`))
+}
+```
+
+Une annulation est **silencieuse** : rien n'est émis ensuite. C'est l'outil qui l'a décidée, il
+sait déjà pourquoi.
+
+### `created` : le compte rendu
+
+```javascript
+onCreated(sollicitations, { payload, fichiers }) {
+  // sollicitations : une par ligne, sérialisées par l'API ([{ id, idMotif, … }])
+  // fichiers       : un compte rendu par document joint
+  //   [{ idMotif, nom, idSollicitation, ok: true | false, message }]
+  const enEchec = fichiers.filter((f) => !f.ok)
+}
+```
+
+Un document en échec **n'annule pas** la création : il est signalé par `error` et marqué
+`ok: false`, et l'utilisateur pourra le joindre depuis le détail de la sollicitation.
+
+### Les autres événements
+
+```javascript
+// Recharger ce qui dépend du réclamant (sollicitations similaires, évènements…)
+onReclamantChange(reclamant) {}
+
+// Suggestions, alertes métier propres à l'outil sur un motif
+onMotifChange({ idMotif, motifsAssocies }) {}
+
+// Suivi d'usage, aide contextuelle par étape
+onStepChange({ key, previous }) {}   // key : 'reclamant' | 'categorie' | 'cible' | 'details'
+```
+
+## Slots
+
+| Slot               | Contenu                                         | Absent ⇒        |
+| ------------------ | ----------------------------------------------- | --------------- |
+| `aside-similaires` | onglet « Similarité » ; scopé (voir ci-dessous) | pas d'onglet    |
+| `aside-evenements` | onglet « Événements »                           | pas d'onglet    |
+| `aside`            | remplace tout le volet latéral                  | volet à onglets |
+
+Les deux volets appartiennent à l'**outil** : c'est lui qui interroge son API et rend ses cartes.
+Le paquet ne lui fournit que le **scope** de la saisie en cours :
+
+| Clé du scope    | Valeur                                                                  |
+| --------------- | ----------------------------------------------------------------------- |
+| `idMotif`       | motif de la ligne principale                                            |
+| `codeProgramme` | programme de la localisation ciblée (nul quand la cible est la demande) |
+| `idCible`       | id de la demande ciblée (nul sinon)                                     |
+| `reclamant`     | le réclamant sélectionné                                                |
+
+Le badge de l'onglet revient par la prop `nbSimilaires`.
+
+## Le choix du réclamant
+
+`reclamants` est une **liste ordonnée** d'entrées `{ type, id, libelle }` :
+
+- `type` est le code `KRCLENT.RCLT` : `D` = demande, `U` = individu « Autre », `T` = tiers, tout
+  autre code = **contrat** (`L`, `P`…) ;
+- `libelle` est ce qui est affiché (côté Cally : « Contrat », « Demande », « Partie externe ») ;
+- il n'y a pas de clé technique : un réclamant s'identifie par son couple `type` + `id`.
+
+Le premier de la liste est sélectionné, sauf si `modelValue.reclamant` (`{ type, id }`) en
+désigne un autre. Le type choisi pilote la suite :
+
+| Réclamant                 | Cible proposée                                                                 |
+| ------------------------- | ------------------------------------------------------------------------------ |
+| contrat                   | le contrat lui-même, sur l'un de ses modules (chargés si `modules` est `null`) |
+| demande (`D`)             | toujours la demande, sans localisation                                         |
+| partie externe (`U`, `T`) | une localisation du patrimoine (pas de contrat propre)                         |
+
+Présentation, selon `reclamantMode` :
+
+| `reclamantMode` | Rendu                                                                 |
+| --------------- | --------------------------------------------------------------------- |
+| `select`        | liste déroulante (défaut)                                             |
+| `switch`        | boutons côte à côte                                                   |
+| `autocomplete`  | `AmsomAutocomplete`, pour une liste longue (recherche sur le libellé) |
+| `step`          | une **étape dédiée**, avant la catégorisation                         |
+
+Avec un seul réclamant, ou `'reclamant'` dans `readonly`, il est seulement affiché, quel que soit
+le mode. En mode `step`, le stepper compte une étape de plus et `stepChange` émet
+`key: 'reclamant'`.
+
+## Champs figés (`readonly`)
+
+Une seule prop, trois formes :
+
+```vue
+<!-- tout se saisit (défaut) -->
+<creer-sollicitation-form :readonly="false" />
+
+<!-- partiel : l'outil impose le réclamant et le canal -->
+<creer-sollicitation-form :readonly="['reclamant', 'provenance']" />
+
+<!-- tout est figé : l'utilisateur relit et valide -->
+<creer-sollicitation-form readonly />
+```
+
+| Champ         | Figé, il affiche…                                                    | … et l'assistant ne fait plus                   |
+| ------------- | -------------------------------------------------------------------- | ----------------------------------------------- |
+| `reclamant`   | son libellé                                                          | —                                               |
+| `provenance`  | le canal (icône + libellé)                                           | —                                               |
+| `motif`       | la chaîne catégorie › type › nature › motif ; motifs associés grisés | —                                               |
+| `cible`       | un résumé par ligne                                                  | déduire la cible du réclamant ou de ses modules |
+| `description` | le texte                                                             | —                                               |
+| `dateFaits`   | la date                                                              | —                                               |
+| `responsable` | son nom, ou « Déterminé automatiquement »                            | suggérer un responsable d'après le paramétrage  |
+| `fichier`     | le document, sans ajout ni suppression                               | —                                               |
+
+La liste est exportée (`READONLY_FIELDS`) et une valeur inconnue est signalée par Vue.
+
+Un champ figé affiche **ce qu'on lui fournit**, par `reclamants` et `modelValue`. Les champs
+obligatoires restent exigés pour avancer : figer `provenance`, `motif`, `cible` ou `description`
+engage l'outil à les fournir, sans quoi l'utilisateur reste bloqué à l'étape. Un responsable figé
+et vide est déterminé côté serveur.
+
+## Restreindre la nomenclature
+
+`nomenclatureFilter` est un **prédicat** qui reçoit le motif entier : on filtre sur n'importe
+quel champ, pas seulement sur les identifiants.
+
+```javascript
+// Sur une demande, seuls certains motifs sont proposables (règle d'office de Cally).
+(motif, { reclamant }) => reclamant?.type !== 'D' || MOTIFS_DEMANDE.includes(motif.id)
+
+// N'importe quel champ du référentiel fait l'affaire.
+(motif) => !motif.libelle.startsWith('[INTERNE]')
+```
+
+Il s'applique à la recherche **et** à la sélection guidée, et il est rejoué quand le réclamant
+change. Absent, toute la nomenclature active est proposée.
+
+## Le brouillon (`v-model`)
+
+```javascript
+{
+  reclamant: { type, id },
+  provenance: 'T',                          // PROVENANCES_CONTACT
+  lignes: [ lignePrincipale, ...motifsAssociés ],
+}
+```
+
+Un brouillon **partiel** suffit : il est fusionné avec le squelette (`getDefaultDraft`,
+`getDefaultLigne`, `getDefaultPatrimoine`, exportés), l'appelant n'a pas à connaître toutes les
+clés.
+
+Une ligne :
+
+| Clé                                            | Rôle                                                                |
+| ---------------------------------------------- | ------------------------------------------------------------------- |
+| `idCategorie`, `idType`, `idNature`, `idMotif` | nomenclature (hiérarchique : changer un niveau efface les suivants) |
+| `cibleMode`                                    | `contrat`, `patrimoine` ou `demande` (voir ci-dessous)              |
+| `patrimoine`                                   | localisation : commune, adresse, étage, module…                     |
+| `contratReclamant`, `contratCible`             | contrat ciblé en mode `contrat`                                     |
+| `reprendreLocataireActuel`                     | viser l'occupant actuel du module plutôt que le contrat ciblé       |
+| `description`, `dateFaits`                     | détail (`dateFaits` en timestamp Unix)                              |
+| `responsable`                                  | collaborateur, ou son id ; `null` = déterminé côté serveur          |
+| `fichier`                                      | document joint (`AmsomUploadFile`), envoyé après la création        |
+
+- **Cible** (`cibleMode`) :
+  - `contrat` : un contrat et l'un de ses modules. C'est celui du réclamant si
+    `contratReclamant`, sinon le `contratCible` trouvé par la recherche. Quand ce contrat n'occupe
+    plus le module, `reprendreLocataireActuel` bascule sur son occupant actuel ;
+  - `patrimoine` : une adresse (partie commune) et, facultativement, un module (le logement) ;
+  - `demande` : la demande elle-même, pour un réclamant demande.
+- **Héritage des motifs associés** : `lignes[0]` porte toujours sa cible et son détail. Sur une
+  ligne associée :
+  - `description: null` = **hérite** de la principale, une valeur la surcharge ;
+  - la cible se surcharge par `cibleOverride` ;
+  - la date se surcharge par `dateFaitsOverride`, parce que `null` est une date valide
+    (« pas de date ») et ne peut pas marquer l'héritage ;
+  - le **responsable n'hérite jamais**.
+
+## La création
+
+`beforeCreate` expose le corps envoyé à `POST /cally2/creer_sollicitation`. L'héritage y est
+**déjà résolu** : chaque ligne est autonome et porte les mêmes clés.
+
+```javascript
+{
+  typeReclamant: 'L',
+  reclamant: 2200523,
+  provenance: 'T',
+  lignes: [
+    {
+      categorie, type, nature, motif,
+      description, dateFaits, responsable,   // responsable : id ou null
+      patrimoine,                             // absent quand la cible est la demande
+      codeTypeCible, idCible,                 // cible contractuelle explicite…
+      deduireCible                            // …ou à déduire du module par le serveur
+    }
+  ]
+}
+```
+
+L'API renvoie les sollicitations créées (une par ligne). Chaque document joint part ensuite par
+`POST /cally2/upload_sollicitation_ged`, apparié à la sollicitation **du même motif**. Le fichier
+ne figure jamais dans le corps de création.
+
+## Exports
+
+```javascript
+import {
+  CreerSollicitationForm,
+  CreerSollicitationModal,
+  configureCresol, // configuration du transport
+  resetCresolCache, // vide le cache des référentiels
+  getDefaultDraft, // squelettes du brouillon
+  getDefaultLigne,
+  getDefaultPatrimoine,
+  READONLY_FIELDS, // champs acceptés par `readonly`
+  PROVENANCES_CONTACT, // [{ id, libelle, icon }]
+  DEFAULT_PROVENANCE_CONTACT
+} from '@amsom-habitat/cresol'
+```
+
+Les référentiels et l'arbre patrimonial sont mis en **cache au niveau du module**, par API : deux
+ouvertures de l'assistant ne rechargent rien. `resetCresolCache()` le vide (changement
+d'utilisateur, tests).
+
+## Endpoints consommés
+
+| Méthode | Chemin                                                      | Usage                            |
+| ------- | ----------------------------------------------------------- | -------------------------------- |
+| GET     | `/v2/sollicitation/{motifs,categories,types,natures,etats}` | Nomenclature (sans jeton)        |
+| GET     | `/v2/sollicitation/responsables`                            | Paramétrage des responsables     |
+| GET     | `/collaborateurs?actif=true`                                | Responsables proposables         |
+| GET     | `/cally2/patrimoine_communes` · `_entrees` · `_modules`     | Arbre patrimonial (cible)        |
+| GET     | `/cally2/contrat_modules`                                   | Modules d'un contrat             |
+| GET     | `/cockpit/circuit_achat/contrats`                           | Recherche de contrat (n° ou nom) |
+| POST    | `/cally2/creer_sollicitation`                               | Création (1 à n lignes)          |
+| POST    | `/cally2/upload_sollicitation_ged`                          | Document joint à une ligne       |
+
+## Développement
+
+```bash
+npm i
+cp .env.example .env   # VITE_API_URL=http://…
+npm run storybook      # http://localhost:6006
+npm run lint
+npm run build
+```
+
+Les stories parlent à une **vraie API** : la nomenclature, le patrimoine et les collaborateurs
+viennent du serveur désigné par `.env`. Les props `baseUrl` et `token` restent disponibles en
+contrôle de story pour surcharger ponctuellement. Le journal sous chaque story liste les
+événements émis, avec leur charge utile.
+
+| Story                                                          | Montre                         |
+| -------------------------------------------------------------- | ------------------------------ |
+| `Contrat` / `Demande`                                          | un réclamant de chaque sorte   |
+| `ReclamantSwitch` / `ReclamantAutocomplete` / `ReclamantEtape` | les présentations du réclamant |
+| `ReclamantEtProvenanceFiges`                                   | `readonly` partiel             |
+| `ConfirmationAvantCreation`                                    | `beforeCreate` + `waitUntil`   |
+| `BrouillonPrealimente`                                         | `modelValue` partiel           |
+| `SansVolet`                                                    | `aside: false`                 |
+
+### Organisation du code
+
+```text
+src/
+  CreerSollicitationForm.vue    racine : fournit brouillon, données et options ; porte la création
+  CreerSollicitationModal.vue   coquille modale (props et événements relayés)
+  props.js                      contrat public unique (props + événements)
+  components/                   étapes et blocs de saisie (lisent le brouillon injecté)
+  composables/
+    useSollicitationDraft.js    le brouillon : état, validation, champs figés, payload
+    useCresolData.js            référentiels et patrimoine (cache module, par API)
+    useCresolContext.js         options de l'outil (injectées, sans prop-drilling)
+  api/                          un fichier par domaine ; transport/ = axios-overlay + jeton
+  utils/                        fonctions pures (texte, dates, erreurs, icônes)
+```
+
+Toute la logique de saisie (héritage, validation, champs figés, payload) vit dans
+`useSollicitationDraft` : les composants ne font qu'afficher et appeler ses setters.
+
+### Publier
+
+Le numéro de `package.json` doit avoir son entrée `## VX.Y.…` dans `changelog.md`
+(`check-version.sh`).
+
+```bash
+make publish         # main : lint, build, tag, npm publish
+make alpha_publish   # dev : version prerelease beta
+```