@mostajs/aop-response 0.1.0

package/README.md

@@ -0,0 +1,5 @@
+# @mostajs/aop-response
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+
+Dossier de **candidature** aux appels d offres (ORM-first) : **3 pièces** (administratif / mémoire technique / offre financière, §8.4) + **FSM gardée** (draft→preparing→ready→submitted→won/lost) compatible `@mostajs/workflow`. Stack `mosta-aop-stack`.

package/llms.txt

@@ -0,0 +1,7 @@
+# @mostajs/aop-response — fiche LLM
+> Dossier de candidature AO (ORM-first) : pièces (administratif/technique/financier §8.4) + FSM gardée.
+
+## EXPORTS
+ResponseSchema · REQUIRED_PIECES · emptyPieces() · checklist(pieces)->{complete,missing} · responseWorkflowDef · RESPONSE_STATES · createResponses({repositories:{responses},now}) · createMemoryRepositories()
+API: create({tenderId,clientId,ref}) · setPiece(id,section,key,present) · transition(id,transId)->{ok,dossier|reason,missing?} · checklist(id) · availableTransitions(id) · byTender/byClient.
+FSM: draft→preparing→ready(garde: dossier complet)→submitted→won|lost ; abandon. responseWorkflowDef = compatible @mostajs/workflow defineWorkflow. Stack mosta-aop-stack.

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@mostajs/aop-response",
+  "version": "0.1.0",
+  "description": "Dossier de candidature aux appels d'offres (ORM-first) : pièces (administratif/technique/financier §8.4), FSM gardée compatible @mostajs/workflow.",
+  "author": "Dr Hamid MADANI <drmdh@msn.com>",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "llms.txt"
+  ],
+  "peerDependencies": {
+    "@mostajs/workflow": "*"
+  },
+  "peerDependenciesMeta": {
+    "@mostajs/workflow": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@mostajs/mjs-unit": "^0.3.0"
+  },
+  "scripts": {
+    "test": "node test-scripts/unit/aop-response.test.mjs && node examples/run.mjs"
+  }
+}

package/src/aop-response.js

@@ -0,0 +1,37 @@
+// @mostajs/aop-response — dossier de candidature (ORM-first) + transitions gardées (FSM §8.4).
+// Compatible @mostajs/workflow (responseWorkflowDef) ; transition interne si workflow non câblé. @author Dr Hamid MADANI <drmdh@msn.com>
+import { emptyPieces, checklist } from './pieces.js';
+import { responseWorkflowDef } from './workflow-def.js';
+export function createResponses({ repositories, now = () => new Date() } = {}) {
+  if (!repositories?.responses) throw new Error('aop-response: repositories.responses requis');
+  const repo = repositories.responses;
+  const trans = responseWorkflowDef.transitions;
+  async function create({ tenderId, clientId = null, ref = null } = {}) {
+    if (!tenderId) throw new Error('aop-response: tenderId requis');
+    return repo.create({ tenderId, clientId, ref, status: 'draft', pieces: emptyPieces() });
+  }
+  /** Coche/décoche une pièce. */
+  async function setPiece(id, section, key, present = true) {
+    const d = await repo.get(id); if (!d) return null;
+    const pieces = { ...d.pieces, [section]: { ...(d.pieces?.[section] || {}), [key]: !!present } };
+    return repo.update(id, { pieces });
+  }
+  /** Applique une transition par id, en vérifiant la garde (`when`). */
+  async function transition(id, transitionId) {
+    const d = await repo.get(id); if (!d) return { ok: false, reason: 'introuvable' };
+    const t = trans.find((x) => x.id === transitionId && x.from === d.status);
+    if (!t) return { ok: false, reason: `transition '${transitionId}' impossible depuis '${d.status}'` };
+    if (t.when && !t.when(d)) return { ok: false, reason: 'garde non satisfaite (dossier incomplet)', missing: checklist(d.pieces).missing };
+    const patch = { status: t.to };
+    if (t.to === 'submitted') patch.submittedAt = now().toISOString();
+    return { ok: true, dossier: await repo.update(id, patch) };
+  }
+  return {
+    create, setPiece, transition,
+    get: (id) => repo.get(id), list: () => repo.list(),
+    byTender: (tenderId) => repo.find((d) => d.tenderId === tenderId),
+    byClient: (clientId) => repo.find((d) => d.clientId === clientId),
+    checklist: async (id) => checklist((await repo.get(id))?.pieces),
+    availableTransitions: async (id) => { const d = await repo.get(id); return d ? trans.filter((t) => t.from === d.status).map((t) => t.id) : []; },
+  };
+}

package/src/index.js

@@ -0,0 +1,5 @@
+export { ResponseSchema } from './schemas.js';
+export { REQUIRED_PIECES, emptyPieces, checklist } from './pieces.js';
+export { responseWorkflowDef, RESPONSE_STATES } from './workflow-def.js';
+export { createResponses } from './aop-response.js';
+export { createMemoryRepositories } from './memory-repo.js';

package/src/memory-repo.js

@@ -0,0 +1,2 @@
+function coll(){const m=new Map();let s=0;return{create:async d=>{const id=String(++s),r={id,...d};m.set(id,r);return r;},get:async id=>m.get(id)||null,list:async()=>[...m.values()],find:async p=>[...m.values()].filter(p),update:async(id,patch)=>{const r=m.get(id);const u={...r,...patch};m.set(id,u);return u;}};}
+export function createMemoryRepositories(){return{responses:coll()};}

package/src/pieces.js

@@ -0,0 +1,18 @@
+// @mostajs/aop-response — pièces du dossier de candidature (DEVRULES §8.4 #4). @author Dr Hamid MADANI <drmdh@msn.com>
+export const REQUIRED_PIECES = {
+  administratif: ['declaration_candidature', 'declaration_probite', 'registre_commerce', 'nif_nis',
+    'attestation_fiscale', 'attestation_cnas', 'attestation_casnos', 'agrements', 'references', 'statuts_pouvoirs'],
+  technique: ['memoire_technique'],
+  financier: ['bpu', 'dqe'],
+};
+export const emptyPieces = () => ({
+  administratif: Object.fromEntries(REQUIRED_PIECES.administratif.map((k) => [k, false])),
+  technique: Object.fromEntries(REQUIRED_PIECES.technique.map((k) => [k, false])),
+  financier: Object.fromEntries(REQUIRED_PIECES.financier.map((k) => [k, false])),
+});
+/** Checklist : { complete, missing: [...] } sur l'ensemble des pièces requises. */
+export function checklist(pieces = {}) {
+  const missing = [];
+  for (const [section, keys] of Object.entries(REQUIRED_PIECES)) for (const k of keys) if (!pieces?.[section]?.[k]) missing.push(`${section}.${k}`);
+  return { complete: missing.length === 0, missing };
+}

package/src/schemas.js

@@ -0,0 +1,13 @@
+export const ResponseSchema = {
+  name: 'ResponseDossier', collection: 'aop_responses', timestamps: true,
+  fields: {
+    tenderId: { type: 'string', required: true }, clientId: { type: 'string', default: null },
+    ref: { type: 'string', default: null },
+    status: { type: 'string', enum: ['draft', 'preparing', 'ready', 'submitted', 'won', 'lost', 'abandoned'], default: 'draft' },
+    pieces: { type: 'json', default: {} },           // { administratif{}, technique{}, financier{} }
+    financialOffer: { type: 'json', default: {} },    // { bpu:[], dqe:[], total }
+    submittedAt: { type: 'date', default: null }, outcome: { type: 'json', default: {} },
+    notes: { type: 'text', default: '' },
+  },
+  indexes: [{ fields: { tenderId: 'asc' } }, { fields: { clientId: 'asc' } }, { fields: { status: 'asc' } }],
+};

package/src/workflow-def.js

@@ -0,0 +1,15 @@
+// FSM du dossier de réponse — compatible @mostajs/workflow (defineWorkflow). @author Dr Hamid MADANI <drmdh@msn.com>
+import { checklist } from './pieces.js';
+export const RESPONSE_STATES = ['draft', 'preparing', 'ready', 'submitted', 'won', 'lost', 'abandoned'];
+export const responseWorkflowDef = {
+  initial: 'draft',
+  states: RESPONSE_STATES,
+  transitions: [
+    { id: 'start', from: 'draft', to: 'preparing' },
+    { id: 'ready', from: 'preparing', to: 'ready', when: (ctx) => checklist(ctx?.pieces).complete },   // garde : dossier complet
+    { id: 'submit', from: 'ready', to: 'submitted' },
+    { id: 'win', from: 'submitted', to: 'won' },
+    { id: 'lose', from: 'submitted', to: 'lost' },
+    { id: 'abandon', from: 'preparing', to: 'abandoned' },
+  ],
+};