SRS
Glossary
French ↔ English glossary of the business, administrative, project and technical terms used in the cahier and across the HOCO docs.
The product speaks French (cahier, interface, documents); the docs are written in English. Terms are listed alphabetically within each section, French first where the term is French. Where used points to the page that defines the behaviour. Status labels are not repeated here: each enum and its French labels are on lifecycles and statuses.
Business and CRM
| Term | English | Definition | Where used |
|---|---|---|---|
| Client invité | Guest | Visitor of the reseller app or web without an account: sees catalog, promotions and banners, never prices; cannot add to cart. | BR-61, AUTH-10 |
| Compte | Account | The login of a user (User), with its status (AccountStatus); distinct from the reseller record. | AccountStatus |
| Délégué commercial | Delegate, field sales representative | HOCO employee who visits points of sale, signs up prospects, invites them to the app and assists first orders; uses the delegate app. | Field operations |
| Demi-gros | Semi-wholesale | Intermediate customer type; selects the variant's demi-gros price. | BR-07 |
| Détail | Retail | Customer type of small shops; selects the highest of the three prices. | BR-07 |
| Fiche (magasin, point de vente, revendeur) | Record, sheet (store record, point-of-sale sheet) | The data of one point of sale: store, owner, phones, address, GPS, type, potential, delegate, photos, documents, status (cahier §15.5). | CRM-01, DA-09 |
| Inscription | Sign-up, registration | Creation of a reseller account (self sign-up with OTP) or of a prospect record in the field. | AUTH-03, FLD-11 |
| Interaction | Interaction | An entry of the reseller timeline: call, visit, note, order, payment, claim, status change. | CRM-07 |
| Niveau | Level | V2 loyalty tier: Bronze, Silver, Gold, VIP. | BR-43 |
| Point de vente (PDV) | Point of sale | A shop that buys from HOCO; one reseller record. | Scope |
| Potentiel | Potential | Commercial potential of a point of sale: low, medium, high. | CRM-06 |
| Prospect | Prospect | Point of sale recorded but not yet buying; statuses Nouveau prospect to À relancer. | ResellerStatus |
| Relance | Follow-up | A planned next contact (call, visit, WhatsApp, catalog) stored as a task with a due date. | TaskStatus |
| Responsable (du magasin) | Store owner or manager | The person in charge of a point of sale. | CRM-01 |
| Revendeur | Reseller | Shop owner who buys HOCO products for resale; uses the reseller app or web. | CRM |
| Revendeur actif | Active reseller | A reseller whose order was delivered and who keeps ordering within the activity window. | ResellerStatus |
| Secteur | Sector, territory | Informal word for a delegate's territory; the system uses zone. | BR-46 |
| Segment | Segment | Group of resellers used for targeting and visibility (not for prices in V1). | CRM-06 |
| Super-gros | Large wholesale | Customer type of the largest buyers; selects the lowest price. | BR-07 |
| Type de client | Customer type | SUPER_GROS, DEMI_GROS or DETAIL; declared at sign-up, reviewed at validation, changed only by the back-office. | CustomerType |
| Type de commerce | Business type | Kind of shop (phone shop, electronics, multi-service…), from a reference list. | ADM-05 |
| Validation du compte | Account validation | Back-office approval or rejection of a sign-up or a new point of sale. | ValidationStatus |
| Zone | Zone | Set of wilayas and communes assigned to delegates. | GEO-02 |
Catalog, orders, delivery and finance
| Term | English | Definition | Where used |
|---|---|---|---|
| Attribut (de produit) | Product attribute | Filterable characteristic defined per category (power, connector, length, colour, capacity…) and valued per variant. | CAT-13 |
| Avoir | Credit note | Document that reduces what a reseller owes: accepted return, after-sales resolution, cancelled invoice. V1. | BR-39 |
| Bon de livraison (BL) | Delivery note | Document generated when an order is ready, listing what is delivered (BL-YYYY-NNNNNN). | BR-29 |
| Bon de préparation, liste de préparation | Picking list | Printable list used to pick an order in the warehouse. | DLV-01 |
| Commande assistée | Assisted order | Order prepared by a delegate for a reseller, confirmed by the reseller or by the administration, then confirmed by the back-office. | AssistedConfirmation |
| Commandes à confirmer | Orders to confirm | Back-office queue of every order waiting for an explicit confirmation. | BR-24, BO-41 |
| Crédit disponible | Available credit | Credit limit minus exposure. | BR-33 |
| Déclaration de paiement | Payment declaration | A reseller's statement of a transfer, CCP or BaridiMob payment with proof, verified by finance. | BR-37 |
| Dérogation | Override | Recorded authorisation to confirm beyond available stock or credit. | BR-15 |
| Échéance | Due date | Date by which an invoice must be paid. | BR-36 |
| Encours | Exposure, outstanding | What a reseller owes plus credit orders not yet invoiced. | BR-33 |
| En rupture | Out of stock | Availability shown when available stock is 0; the only stock information besides En stock. | BR-16 |
| Facture | Invoice | Legal document issued from an order (FAC-YYYY-NNNNNN). | InvoiceStatus |
| Frais de livraison | Delivery fee | Fee added to an order according to the delivery settings; « Offerts » when free. | BR-28 |
| Impayé | Unpaid (invoice or amount) | Invoice with a balance; en retard once past due. | InvoiceStatus |
| Livreur | Driver | HOCO's own delivery person (mode OWN_FLEET). | DeliveryStatus |
| Montant minimum | Minimum order amount | Cart total below which checkout is refused. | BR-20 |
| Panier | Cart | The reseller's server-side cart, shared by app and web. | BR-22 |
| Paiement à la livraison | Cash on delivery (COD) | Payment collected by the driver at delivery. | BR-38 |
| Plafond de crédit | Credit limit | Maximum exposure allowed for a reseller paying on credit. | BR-32 |
| Première commande | First order | A reseller's first order that is not refused or cancelled; attributed to a delegate. | BR-27 |
| Preuve de livraison | Proof of delivery | Photo and/or recipient name recorded at delivery. | DLV-03 |
| Prix conseillé (PVC) | Recommended retail price | Price HOCO recommends to the end customer, shown to resellers. | BR-06 |
| Prix d'achat | Purchase price, cost | What HOCO pays; visible only to finance.view holders. | BR-11 |
| Rapprochement, lettrage | Reconciliation, allocation | Matching payments to invoices. | FIN-04 |
| Reçu | Receipt | Proof of a payment given to a reseller. | FIN-08 |
| Remise par quantité | Quantity discount, tier | Price by quantity bracket; dropped from V1. | D-37 |
| Retour | Return | Goods sent back after delivery: request, approval, transit, reception with automatic restock, credit note. V1. | ReturnStatus |
| Retrait au dépôt | Pickup at the depot | Delivery mode where the reseller collects the order. | DeliveryStatus |
| Société de livraison, transporteur | Carrier | External delivery company. | DLV-04 |
| Solde | Balance | Amount a reseller still owes. | FIN-10 |
| Stock disponible | Available stock | Physical stock minus reserved stock. | BR-12 |
| Stock réservé | Reserved stock | Quantities held for confirmed orders not yet shipped. | BR-13 |
| Variante | Variant | A sellable version of a product (colour, length…) with its SKU, barcode and three prices. | CAT-03 |
| Virement | Bank transfer | Payment by bank transfer, declared with proof. | BR-37 |
Field operations
| Term | English | Definition | Where used |
|---|---|---|---|
| Arrivé, check-in | Check-in, arrival | The delegate's arrival at a point of sale, recorded with time and GPS position within tolerance. | BR-51 |
| Bilan (de la journée) | Day summary | Visits, sign-ups, installs, first orders, revenue and kilometres of a tour. | FLD-12 |
| Checklist (commerciale) | Checklist | Actions to perform during a visit, from a template per visit type. | FLD-16 |
| Clôture (de tournée) | Tour closing | End of the day: blocking checks, comment, final report. | TourStatus |
| Consentement (géolocalisation) | Location consent | The delegate's informed agreement to location collection during tours. | BR-53 |
| Invitation, code de parrainage | Invitation, referral code | Link, QR code and 8-character code that attribute a reseller's install and sign-up to a delegate. | BR-03 |
| Motif | Reason | Mandatory reason from a reference list (visit not done, refusal, cancellation, suspension…). | Lifecycles |
| Objectif | Objective | Target per delegate and period: visits, sign-ups, installs, first orders, orders, revenue. | FLD-02 |
| Ordre imposé, ordre recommandé | Imposed order, recommended order | Whether the delegate may reorder the stops of a tour. | FLD-03 |
| Rapport de visite | Visit report | Structured account of a visit: person met, interest, products presented, issues, next action. | FLD-10 |
| Taux de conversion | Conversion rate | Share of prospects that become accounts or first orders. | ANA-04 |
| Tolérance GPS | GPS tolerance | Maximum distance between the delegate and the point of sale at check-in (150 m by default). | BR-51 |
| Tournée | Tour | A delegate's planned route for one day. | TourStatus |
| Visite | Visit | A stop of a tour at a point of sale. | VisitStatus |
Promotions, loyalty and support
| Term | English | Definition | Where used |
|---|---|---|---|
| Bannière | Banner | Home image linked to a promotion, product or category; visible to guests without prices. | BR-68 |
| Bon d'achat | Voucher | V2 loyalty reward usable at checkout. | BR-44 |
| Ciblage | Targeting | Audience of a promotion: wilaya, segment, customer type, level, volume. | BR-64 |
| Cumul | Stacking | Whether several promotions combine on one line. | BR-66 |
| Fidélité | Loyalty | V2 points programme with levels and rewards. | Loyalty |
| Offre du jour | Daily offer | Promotion valid for one day with a countdown. | BR-68 |
| Pack rentable | Profitable pack, bundle | V2 bundle of references at a pack price. | PRM-06 |
| Réclamation | Claim, complaint | A reseller's complaint; an after-sales claim when it concerns delivered items. | SUP-01 |
| Récompense | Reward | V2 benefit redeemed with points. | BR-44 |
| Région de support | Support region | Group of wilayas served by one WhatsApp support number and hours. | BR-83 |
| SAV (service après-vente) | After-sales service | Handling of claims on delivered items: diagnosis, then replacement, return, credit note, repair or rejection. V1. | TicketStatus |
| Ticket, demande d'assistance | Support ticket | A reseller's request with its conversation and status. | TicketStatus |
Project and acceptance
| Term | English | Definition | Where used |
|---|---|---|---|
| Anomalie bloquante | Blocking defect | Defect that prevents acceptance until fixed. | Bugs |
| Atelier | Workshop | Working session with HOCO (cadrage, design reviews). | PRJ-03 |
| Cadrage | Scoping, framing | First phase: rules, roles, data and integrations validated with HOCO (cahier §14 phase 1). | Scope |
| Cahier des charges | Specification document, requirements brief | HOCO's 40-page document, v1.0 July 2026 — the source of this SRS. | Source traceability |
| Chiffrage | Estimate, costing | Effort and price of a piece of work, for example a change request. | Change requests |
| Clause de périmètre | Scope clause | Page 2 rule: anything not described is analysed, priced or planned separately. | Change control |
| Évolution | Enhancement | Change to the product after a version is accepted. | Change requests |
| Fiche de validation | Validation sheet | Page 2 of the cahier, signed by HOCO and the provider before development. | Source traceability |
| Garantie corrective | Corrective warranty | Period after go-live during which defects are fixed under warranty (cahier §13.4). | OPS-04 |
| Généralisation | Roll-out, generalisation | Progressive opening to all zones after the pilot. | Scope |
| Maquette | Mock-up | Design of a screen in Claude Design. | Design |
| Pilote | Pilot | Two weeks in production with a limited group of delegates and resellers. | OPS-06 |
| Préproduction | Pre-production | Environment where HOCO performs acceptance. | OPS-01 |
| Prestataire | Provider, contractor | The team delivering the project. | Overview |
| PV de recette | Acceptance report | Signed minutes stating that acceptance passed (cahier §12). | Acceptance scenarios |
| Recette | Acceptance testing | HOCO's execution of the priority scenarios before go-live. | OPS-05 |
Algerian and administrative terms
| Term | English | Definition | Where used |
|---|---|---|---|
| AI (article d'imposition) | Tax article number | Tax identifier of a business, printed on invoices. | BR-29 |
| Algérie Poste | Algerian postal operator | Runs CCP accounts and BaridiMob. | Scope |
| ANPDP | National personal-data protection authority | Authority set up by Law 18-07. | Scope |
| BaridiMob | BaridiMob | Algérie Poste mobile app for transfers between CCP accounts; payments declared with proof. | BR-37 |
| CCP (compte courant postal) | Postal current account | Account at Algérie Poste; a common way to pay suppliers. | BR-37 |
| Commune | Municipality | Administrative subdivision of a wilaya; used in addresses and zones. | GEO-01 |
| DA, DZD | Algerian dinar | Currency; amounts stored in centimes (125000 = 1 250,00 DA). | Business rules |
| Droit de timbre, timbre fiscal | Stamp duty | Duty on invoices paid in cash, per the finance law in force. | D-21 |
| HT (hors taxes) | Excluding VAT | Price or amount before VAT; prices are stored HT. | BR-08 |
| Loi 18-07 | Law 18-07 | Algerian law of 10 June 2018 on the protection of personal data. | Scope |
| NIF | Tax identification number | Tax identifier of a business. | BR-29 |
| NIS | Statistical identification number | ONS identifier of a business. | BR-29 |
| RC (registre de commerce) | Trade register | Registration number of a trader; a store document. | CRM-10 |
| RIB, RIP | Bank account details, postal account details | Account references shown to resellers for transfers. | BR-37 |
| TTC (toutes taxes comprises) | Including VAT | Price including VAT; reseller screens show TTC by default. | BR-08 |
| TVA | VAT | Value-added tax: 19 % standard, 9 % reduced. | BR-06 |
| Wilaya | Province | First-level administrative division of Algeria. | GEO-01 |
Technical terms
| Term | Meaning | Where used |
|---|---|---|
| ADR | Architecture decision record — a numbered technical decision with its reasons. | Architecture |
| API | Application programming interface; here the central REST API under /v1. | API reference |
| BullMQ | Redis-based job queue used by the worker for jobs, notifications and the scheduler. | Jobs and scheduler |
| Cursor pagination | Lists returned page by page with an opaque nextCursor. | API reference |
| Deep link, app link | Link that opens a screen of the app (https://app.hoco.dz/i/…). | IVT-04 |
| drift | SQLite library used by the delegate app for its offline database. | Offline sync design |
| E.164 | International phone format (+213555123456). | BR-04 |
| ETag | HTTP validator that lets clients cache reference data and get 304 Not Modified. | API reference |
| FCM | Firebase Cloud Messaging — the push-notification service. | INT-02 |
| Haversine | Formula for the distance between two GPS points. | BR-50 |
| Idempotency key | Client-chosen UUID sent in Idempotency-Key so a retried request runs only once. | API reference |
| Install referrer | Google Play data passed to an app on first open, used to attribute installs to invitations. | IVT-04 |
| MDX | Markdown with components — the format of these docs pages. | Overview |
| OpenAPI | Standard description of a REST API (3.1 here), generated from the contract. | API reference |
| oRPC | Contract-first TypeScript library declaring each route with Zod schemas and serving it as REST with OpenAPI. | Architecture |
| OTP | One-time password — 6-digit code sent by SMS. | AUTH-07 |
| Outbox (transactional) | Table where events are written in the same transaction as the change, then dispatched by the worker; the delegate app has its own outbox of offline actions. | Architecture and data |
| RBAC | Role-based access control — permissions attached to roles. | Permissions matrix |
| RTL | Right-to-left layout, needed for Arabic. | NFR-06 |
| Scope (data scope) | Row filter added by the server: self for resellers, delegate for delegates. | Permissions matrix |
| Signed URL | Short-lived URL to upload or read a private file. | SEC-04 |
| SSE | Server-Sent Events — one-way live stream from the server (back-office events, reseller order status). | SYN-07 |
| UUIDv7 | Time-ordered unique identifier used for every record. | BR-01 |
| Webhook | HTTP call from a provider to the API (V2 carrier tracking). | Integrations |
| Zod | TypeScript schema library validating every request and response. | API reference |
Scope
Purpose, audiences, what each surface contains, the V1/V2 boundary per area, explicit exclusions, numbered assumptions and the constraints of the Algerian context.
Source traceability
Every section of the cahier des charges mapped to requirement ids, screens and the pages that cover it, the list of team additions with their rationale, and how traceability is kept when the cahier is revised.