HOCO B2B
SRS

Scope

Purpose, audiences, what each surface contains, the V1/V2 boundary per area, explicit exclusions, numbered assumptions and the constraints of the Algerian context.

Purpose

HOCO distributes phone accessories of three brands — HOCO, ACEFAST and BOROFONE — to shops across Algeria. Orders, field work and follow-up run on phone calls, WhatsApp and spreadsheets; the ecosystem replaces them with one platform and one source of truth (cahier §1.1). The cahier sets eight business objectives (§1.3) and six success indicators (§1.4):

Objective (cahier §1.3)Measured by (cahier §1.4, ANA-04)
Centralise reseller and prospect data · grow the number of active points of saleReseller adoption: share of accounts activated, sign-in frequency
Speed up order taking and validation · reduce manual-order errorsOrder digitalisation: share of orders placed through the apps · Operational quality: fewer errors, cancellations and delays
Follow delegates, tours, visits and conversionsField conversion: prospects → accounts → first orders · Tour performance: visits done / planned
Visibility on stock, sales, payments and zone performance · reliable indicatorsDashboards and reports (ANA-01, ANA-03)
Retain resellers with promotions, packs and loyalty levelsLoyalty: order frequency and level progression (levels in V2, from qualified purchases)

Audiences

AudienceRole keyUsesMain jobsData scope
Super administratorSUPER_ADMINBOGlobal settings, roles and permissions, users, auditEverything
Commercial administratorCOMMERCIAL_ADMINBOCRM, account validation, delegates, zones, tours, promotions, order confirmation, after-sales, reportingAll commercial data, no purchase prices
Stock managerSTOCK_MANAGERBOProducts, attributes, stock, inventories, return receptionCatalog and stock
Finance managerFINANCE_MANAGERBOInvoices, payments and declarations, credit, credit notes, financial reportsFinance, purchase prices and margins
Delivery managerDELIVERY_MANAGERBOPreparation, shipping, carriers, proof of deliveryOrders to fulfil
DirectionDIRECTIONBODashboards, KPIs, consolidated reportsRead-only, all modules
Delegate (délégué commercial)DELEGATEDATours, visits, prospects, sign-ups, invitations, assisted first orders, reportsTheir zones, assigned resellers, own performance
Reseller (revendeur)RESELLERRA, RWCatalog, cart, orders and tracking, returns, after-sales claims, invoices and payments, supportTheir own data
Guest (visitor without account)—RA, RWBrowse the catalog, promotions and banners without prices; contact support on WhatsApp; sign upPublic catalog
HOCO, the client organisation——Validates the cahier, the SRS baseline, designs and acceptance (PV de recette); takes the decisions of the register; owns its data, store and provider accounts; is the data controller under Law 18-07—

Roles and their permissions: permissions matrix (cahier §3, ACL-01).

Delivery frame

V1 — design, development and deployment — takes three months from Sunday 18 October 2026 (team decision of 18 October). Production goes live at the start of January 2027 and a two-week pilot with a limited group of delegates and resellers follows (cahier §14 phase 9); generalisation and V2 come after the three months. The reseller web is part of V1: it is built in the V1 phase, goes through acceptance with the other interfaces and is deployed before the pilot. Dates come from the plan — see the timeline and the releases.

Phase (plan)Cahier §14 phasesDelivers
P0 — Foundations1 Cadrage · 2 UX/UI · 3 ArchitectureDecisions, the complete design, services, database, API contract, mobile foundations
P1 — V1 build & integration4 Back-office · 5 Reseller app · 6 Delegate app · 7 IntegrationServer, back-office, reseller web, both Flutter apps, staging integration, field test, store readiness
P2 — Acceptance, go-live & pilot8 Tests · 9 PilotEnd-to-end tests, client acceptance and PV, production go-live, training, two-week pilot
P3 — Generalisation (after the three months)10 GénéralisationPilot improvements, progressive opening by zone, public store release
P4 — V2§14.2The V2 evolutions below

If the build slips, dates hold and scope moves after go-live in the order of decision D-38, unless HOCO decides otherwise.

In scope per surface

SurfaceV1 content (cahier §14.1 plus the decisions of 17–18 October 2026)
Back-office (web, desktop, tablet and large screens)Dashboards by role; CRM with list, map, reseller 360°, validation queue with customer-type review, follow-ups, segments; delegates, zones, objectives, tour planning, live map, visits; catalog with brands, categories and sub-categories, filterable attributes, three prices per variant, visibility, import; stock, movements, inventories; orders with the « Commandes à confirmer » queue, controls, modification, assisted orders, delivery board, carriers; returns and after-sales claims; invoices, payments and declarations, credit control, credit notes; promotions, daily offers and banners; support tickets, announcements, notification templates; reports and exports; users, roles, audit, settings, reference lists, support regions, app versions, imports
Reseller app (Android first) and reseller web (responsive, same account, same cart)Guest browsing without prices; sign-up with OTP and declared customer type, account claim, pending-validation state; home, search, barcode scanner (app), catalog with advanced filters and facets; product detail; favorites; server-side cart, checkout, addresses; order tracking updated live, documents, cancellation before confirmation, assisted-order confirmation, reorder; returns and after-sales claims; balance, credit, invoices, payment declarations; promotions and daily offers; notifications; support tickets and the regional WhatsApp button; profile, store documents, settings
Delegate app (Android, offline-first)Sign-in, location consent; home with today's tour and objectives; tour programme, map and navigation, GPS check-in, visit with checklist, note and photos, not-done reasons, visit report and follow-ups; prospects list and map, field sign-up offline, invitation with QR and share, first-order assistance, orders of their resellers; tour closing and performance; messages, sync centre
Central API and workerAuthentication and sessions, permissions and scopes, every business rule, audit, numbering, files, notifications (push, SMS, email, inbox), real-time streams for the back-office and the reseller apps, offline sync, scheduled jobs, imports and exports
OperationsDevelopment, pre-production (acceptance) and production environments; deployment, domains, certificates, backups and restore tests; store publication; monitoring; training and documentation (cahier §13)

V1 / V2 boundary

V2 follows cahier §14.2 (« Fidélité avancée, packs rentables, crédit détaillé … intégration livraison, WhatsApp Business et comptabilité … optimisation automatique des tournées et analyses avancées »). Returns and after-sales, which the cahier lists in V2, were moved into V1 by the team on 17 October 2026.

AreaIn V1In V2
Authentication, access, audit, geographyEverything (AUTH-01 to AUTH-11, ACL, AUD, GEO)—
CRMRecords, lifecycle, assignment, segments, timeline, follow-ups, validation, documentsMerge tool for historical duplicates (CRM-13)
CatalogEverything, including advanced filters and attributes (CAT-12, CAT-13)—
PricingThree prices per variant by customer type, VAT, history, re-validationPer-reseller agreements and level prices (PRC-03); quantity tiers dropped (D-37)
StockLevels, reservation and deduction, automatic restock, ledger, alerts, inventories, override, availability-only displayAPI sync with HOCO's stock system (STK-09; V1 uses imports)
OrdersCart, checkout, 11-status lifecycle, explicit confirmation, live status, assisted orders, first order, cancellation, phone orders, documents, returns (ORD-13)—
DeliveryPreparation, shipping, proof, carriers managed by hand, delivery-fee policyCarrier API (DLV-05)
FinanceInvoices, payment methods, declarations, allocations, basic credit control, reseller finance view, credit notes (FIN-08)Detailed credit with terms and automatic blocking (FIN-06), automatic reminders (FIN-07), accounting exports (FIN-09)
PromotionsDaily offers, scheduled promotions, targeting, stacking, caps, banners, flash sales and the promotion tabs (PRM-07, change request 03)Profitable packs (PRM-06), exclusive offers by level (PRM-08)
Loyalty—The whole programme (LOY-01 to LOY-05), missions and challenges (LOY-06), the monthly ranking (LOY-07); the full programme of change request 04 (LOY-08 to LOY-26), not yet accepted or priced; split to confirm (D-16, D-57)
Field operationsEverything, including the recommended visit order (nearest neighbour)Routing-engine optimisation (FLD-18)
InvitationsEverything—
SupportTickets, after-sales claims with resolutions (SUP-04), regional WhatsApp (SUP-05), contacts and FAQ—
NotificationsInbox, push, SMS, email, WhatsApp share links, matrix, preferences, announcements; smart notifications — groups, Notification Centre, action buttons, rule-based commercial triggers, anti-fatigue rules (NOT-09 to NOT-17, change request 03)WhatsApp Business API messages (NOT-08); loyalty-driven notifications (NOT-18)
AnalyticsDashboards, essential reports, success KPIs, exportsAdvanced analytics (ANA-06)
Administration, sync, reseller web, non-functional, security, operationsEverything—
IntegrationsMaps, FCM, SMS, email, file storage, provider costsERP and accounting API (INT-06)

The V2 requirements, live from requirements.json:

IDRequirementReleasePrioritySourceApps
CRM-13Merge tool for historical duplicatesV2COULD§4.2BO
PRC-03Per-reseller price agreements and level-based prices on top of the three customer-type pricesV2SHOULD§8API · BO
STK-09Synchronisation with the client's existing stock system (V1 import, V2 API)V2SHOULD§11API
DLV-05Carrier API integration (shipment creation, tracking webhooks)V2SHOULD§11, §14.2API
FIN-06Detailed credit: payment terms, due dates, automatic blocking or approval when exceededV2SHOULD§4.7, §14.2API · BO
FIN-07Automatic reminders and unpaid alertsV2SHOULD§4.7API · BO
FIN-09Accounting exports and financial reportsV2SHOULD§4.7, §11API · BO
PRM-06Profitable packs: bundles of references at a pack price, added to cart as a unitV2SHOULD§4.6, §5.5, §14.2API · BO · RA · RW
PRM-08Exclusive offers by loyalty level and their tabV2COULDClient doc 03 (18 Oct 2026)API · BO · RA · RW
LOY-01Points earned per order line, credited after delivery or payment (setting), bonusesV2SHOULD§4.4, §4.6, §14.2; Client loyalty document + letter of 6 Nov 2026API
LOY-02Points expiry, adjustments, reversal and regularisation on cancellation or returnV2SHOULD§4.6; Client loyalty document + letter of 6 Nov 2026API · BO
LOY-03Configurable levels: Standard at sign-up, then levels from qualified purchases over a configurable periodV2SHOULD§4.6; Client loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-04Rewards catalogue (voucher, free delivery, discount, gift, early access, commercial advantage) and redemptionV2SHOULD§4.6, §5.5; Client loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-05Traceable points history for the reseller and the back-officeV2SHOULD§5.5, §12API · BO · RA · RW
LOY-06Missions and challenges: daily, weekly, monthly, seasonal; commercial, interaction, surprise and personalisedV2SHOULDClient doc 03 (18 Oct 2026); Client loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-07Monthly ranking: configurable criterion and Top N, reviewed results, prizes and home highlightV2COULDClient doc 03 (18 Oct 2026); Client loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-08Earning rules: barème by product, category, brand, quantity or amount, set in the back-officeV2SHOULDClient loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-09Order-value bonuses and bonuses on selected productsV2SHOULDClient loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-10Occasion campaigns and Happy Days with Algiers time windowsV2SHOULDClient loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-11Campaign stacking and the calculation orderV2SHOULDClient loyalty document + letter of 6 Nov 2026API · BO
LOY-12First-order bonus and bonus on accepted reviewsV2SHOULDClient loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-13New-product campaign for the first N buyersV2SHOULDClient loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-14Cashback balance, earning and use at checkoutV2SHOULDClient loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-15Referral of new resellers with fraud controlsV2SHOULDClient loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-16Birthday bonus on a verified dateV2COULDClient loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-17Badges: conditions, display, permanent or temporaryV2COULDClient loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-18Gift chest with configured prizes, odds and budgetV2COULDClient loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-19Wheel of fortune, optional, one spin per entitlementV2COULDClient loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-20Level upkeep and drop with noticeV2SHOULDClient loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-21Personal objective: progress to the next level on the homeV2SHOULDClient loyalty document + letter of 6 Nov 2026API · RA · RW
LOY-22Full history: separate ledgers, one combined viewV2SHOULDClient loyalty document + letter of 6 Nov 2026API · BO · RA · RW
LOY-23Back-office administration: every rule without a developer, reseller view, manual adjustmentsV2SHOULDClient loyalty document + letter of 6 Nov 2026API · BO
LOY-24Programme dashboardV2SHOULDClient loyalty document + letter of 6 Nov 2026API · BO
LOY-25Rule versioning: new operations only, or recalculationV2SHOULDClient loyalty document + letter of 6 Nov 2026API · BO
LOY-26Mandatory tests before the programme is deliveredV2SHOULDClient loyalty document + letter of 6 Nov 2026API · BO · RA · RW
FLD-18Automatic tour optimisation (routing engine)V2COULD§14.2API · BO
NOT-08WhatsApp Business API automated messagesV2COULD§11, §14.2API
NOT-18Loyalty-driven notifications: double points, new level, missions, gifts, anniversary, objective almost reached, challenge of the monthV2SHOULDClient doc 03 (18 Oct 2026)API · RA · RW
ANA-06Advanced analytics (cohorts, forecasting, delegate benchmarking)V2COULD§14.2BO · API
INT-06ERP / accounting import-export (files in V1, API in V2)V2SHOULD§11API

Change request 03 — Smart notifications

On 18 October 2026 HOCO sent DOCUMENT 03 : SMART NOTIFICATIONS: 24 commercial notification types, a Notification Centre on the home page, an action button on every notification, a monthly Top 3 of resellers and three promotion tabs. The document is not part of the cahier. It is treated as a change request and placed as follows (details and reasons on smart notifications):

ReleaseAdded to the scope
V1Notification groups and the Notification Centre on the reseller home (NOT-09); an action button on every notification (NOT-10); rule-based triggers: new arrival, new catalogue, trending product (NOT-11), targeted back in stock and limited quantity (NOT-12), promotion, flash sale, price drop (NOT-13), abandoned cart and reorder reminder (NOT-14), complementary products (NOT-15), commercial push (NOT-16); anti-fatigue rules (NOT-17); flash sales with countdown and the tabs Promotions / Ventes flash (PRM-07)
V2Loyalty-driven notifications (NOT-18); missions and challenges (LOY-06); the monthly ranking, Top 3 in document 03 and a configurable Top N since change request 04 (LOY-07); the Offres exclusives tab by level (PRM-08)
Later / to decideHOCO Academy videos and quizzes (D-40); AI bought together suggestions (D-41); the Daily / Weekly / Monthly mission cadence and the product-review mission were placed here, and change request 04 now specifies both in V2 (LOY-06, LOY-12)

Impact: six new tasks, about 6.5 working days in total: DES-23, SRV-39, SRV-40, DSH-14, WEB-06, MRA-11. Most of it lands on Anis's lane, which has no slack (D-38). The milestone dates are recomputed on the timeline. If go-live is threatened, NOT-15 (COULD) and then NOT-11 move first in the deferral order.

Change request 04 — Full loyalty programme

HOCO sent a detailed loyalty document (HOCO PRO DZ — Système de fidélité, in Darija and French). The letter of 6 November 2026, section 1.3, updates it: levels are configurable (Bronze, Silver, Gold, Diamond or others); points are earned by product, category, brand, quantity or amount; they convert into rewards, discounts, vouchers or commercial advantages; a programme dashboard; manual adjustments with justification and audit log; and every rule is created, changed, enabled or disabled by an administrator, with no developer.

Status

Change request 04, not yet accepted or priced by HOCO. It is specified here so it can be priced and decided. The letter does not state a version, so it is placed in V2 and phase P4 as a working position, and the question stays open (D-57). Nothing below is agreed.

ThemeAdded to the V2 scopeRequirements
EarningBarème by product, category, brand, quantity or amount; order-value and selected-product bonuses; occasions and Happy Days; stacking and calculation order; first-order, review and new-product bonusesLOY-08 to LOY-13
LevelsStandard at sign-up, then levels as configured data, reached through qualified purchases, not points; upkeep and drop; personal objectiveLOY-03, LOY-20, LOY-21
BalancesPoints, cashback and qualified purchases kept separate; cashback at checkout; append-only ledgers; full historyLOY-14, LOY-22
EngagementMissions, monthly Top N, referral, birthday, badges, gift chest, wheel of fortuneLOY-06, LOY-07, LOY-15 to LOY-19
AdministrationEvery rule without a developer, reseller view, programme dashboard, rule versioning with new operations only or recalculation, mandatory testsLOY-23 to LOY-26

What changes in the existing text. LOY-03 moves from points to qualified purchases; the Top 3 of LOY-07 becomes a configurable Top N, with document 03's content as the default example; the birthday bonus uses a verified owner's or shop date, and document 03's account anniversary (SN-15) stays as one option; the mission cadence and the review reward, placed later in change request 03, enter V2.

What does not change. V1 and its dates. The delegate app. The exclusions, including bulk marketing SMS or WhatsApp (EX-07) and marketing automation. The decisions of 17 October: prices HT with availability only for resellers, so rewards, prizes and first-N campaigns show availability, never a number (STK-07, BR-99); no automatic order confirmation, so cashback is only held until the order is confirmed (ORD-14).

Blocked until reviewed. Cashback waits for an accountant's review of invoices and VAT (D-60). The chest and the wheel wait for a legal check of purchase-linked random prizes (D-61). The specification takes no position on either.

Impact. Sixteen new tasks, 39 person-days planned: SRV-43 to SRV-50, DSH-22 to DSH-24, WEB-21, MRA-21, DES-31, DQA-13, QA-04. Twenty-seven new screens (BO-72 to BO-83, RA-42 to RA-53, RW-16 to RW-18), 43 new operations, 22 new models. The V2 delivered milestone moves accordingly on the timeline. A migration of the V1 enum LoyaltyLevel is required when this is built (SRV-45). Open decisions: D-45 to D-63.

Exclusions

Not in V1 nor V2. Any of them is a change request (change control).

IdExcludedNote
EX-01Online card payment (CIB, Edahabia) and any payment gatewayTransfers, CCP and BaridiMob are declared with a proof and verified by finance
EX-02Sales to consumers (B2C), public price list or marketplaceGuests see the catalog without prices
EX-03Several companies, currencies or VAT regimes (multi-tenant)One company, DZD
EX-04Warehouse management beyond stock levels: locations, lots, serial numbers, scanning-based picking, supplier purchase ordersReceipts and adjustments are recorded; the picking list is printed
EX-05General ledger, payroll, delegates' commissionsAccounting exports are V2; commissions are not in the cahier
EX-06A driver app for HOCO's own fleetDelivery is confirmed in the back-office with proof
EX-07Chat between resellers, delegates and HOCO, and bulk marketing SMS or WhatsApp campaignsTickets, announcements and WhatsApp links cover the cahier
EX-08Historical data migration beyond the initial import of products, resellers, users and stock (cahier §13.2)No past orders, invoices or balances (D-31)
EX-09Content production: product photos, descriptions, translations, price gridsSupplied by HOCO in the import templates
EX-10Hardware (phones for delegates, printers), external provider fees and subscriptionsIdentified and validated by HOCO (cahier §11, INT-07)
EX-11Native tablet or desktop applications; iOS apps unless HOCO decides (D-10)iPhone users use the reseller web
EX-12Electronic invoicing to a tax-administration platformInvoices are PDF documents

Assumptions

Each assumption is what the team builds with; a different answer from HOCO is a change request unless it is an open decision.

IdAssumptionLinked
A-01Android first. The two Flutter apps target Android on mid-range phones; iOS only on HOCO's decision.NFR-04, D-10
A-02French interface in V1; Arabic (right-to-left) and English are prepared (keys, layouts, templates) and delivered when validated.NFR-06, D-09
A-03hoco.dz is a placeholder for the API, apps and links (api.hoco.dz, app.hoco.dz).D-12
A-04One company, one currency (DZD), one VAT regime; amounts stored as integer centimes; VAT 19 % by default.EX-03
A-05One active cart per reseller, server-side, shared by the app and the web.ORD-01, RWA-02
A-06One reseller record = one point of sale with one login (the main phone). Chains with several shops are several records.CRM-01
A-07Each reseller has one customer type — super-gros, demi-gros or détail — that selects one of the three prices of every variant.AUTH-11, D-01
A-08Every order is confirmed by a person in the back-office; staffing of the confirmation queue during working hours is HOCO's.ORD-14
A-09One warehouse at launch; the model supports several.D-02
A-10Payments are not processed online; COD is collected by the driver and confirmed by finance.EX-01, D-03
A-11Delivery is managed by hand in V1 (own fleet, carrier companies, pickup).D-08
A-12A tour is one delegate on one date; weekly or monthly planning creates daily tours.FLD-03
A-13Open reseller sign-up with back-office validation; invitations attribute sign-ups to delegates.D-28
A-14HOCO provides the data (products with three prices and attributes, resellers, users, stock) in the import templates before go-live.ADM-06, D-31
A-15HOCO owns the accounts — Play Console, Firebase, maps, SMS gateway, domain, hosting — and pays the providers.D-25
A-16Pilot: two weeks, two to three delegates and 20–40 resellers in one zone, right after go-live.OPS-06, D-32

Constraints

IdConstraintConsequence in the specification
C-01CCP and BaridiMob (Algérie Poste) offer no merchant confirmation APIPayments are declared with a proof and verified by hand (PENDING_VERIFICATION) — PaymentStatus
C-02Wilayas and communes are the administrative reference and change by law (the 2019 reform created new wilayas)Geography is versioned reference data loaded by seed, never hard-coded (GEO-01)
C-03Weak and intermittent mobile networks outside city centresDelegate app offline-first with idempotent replay; compressed photos; small payloads (cahier §7.3, offline sync design)
C-04Law 18-07 of 10 June 2018 on the protection of personal data (national authority ANPDP): purpose, consent, rights of access and rectification, security, prior formalities, limits on transfers abroadLocation consent and transparency, retention periods, deactivation and anonymisation (BR-53, BR-84); hosting location decided with HOCO (D-15); legal review by HOCO's counsel
C-05Google Play policies: prominent disclosure and consent for location, background-location declaration and foreground-service type, data-safety form, privacy-policy URL, account deletion in the app and on the web for apps that create accounts, recent target API levelConsent screen DA-04, foreground service during tours (D-24), deletion requests (BR-85), store readiness task MOB-14
C-06SMS encoding: accented French switches to UCS-2 (70 characters per segment)OTP and SMS templates written without accents (BR-59)
C-07Fiscal mentions on invoices (RC, NIF, NIS, AI, VAT) and stamp duty on cash payments under the current finance lawDocument templates and the stamp-duty setting confirmed by HOCO's accountant (D-21)
C-08Working week Sunday–Thursday, business days in Africa/Algiers; Ramadan starts shortly after the planned pilotDay boundaries, queue alerts and the plan use that calendar (timeline)
C-09Three-month frame for V1 with go-live at the start of JanuaryScope moves after go-live rather than dates (D-38)

On this page