1. Overview

Franchise Network Management turns Dolibarr into a complete Franchise Management System (FMS). It provides a vertical ERP/CRM solution dedicated to franchisors that own or steer a network of franchises, brands, store chains and multi-outlet groups. From a single interface, the franchisor manages the entire operational, commercial, financial, contractual and strategic lifecycle of the network.

The module covers the following business domains:

·       The franchisor, the network and its brand identity

·       Franchisees and their commercial lifecycle (from prospect to active partner)

·       The stores of the network (multi-store management)

·       Franchise contracts, exclusive territories and operating rights

·       Entry fees and royalties (automatic calculation and invoicing)

·       The brand product catalogue and central purchasing

·       Multi-store stock, sales and revenue

·       Network, region and store objectives

·       Franchise audits, quality management and corrective actions

·       Franchisee training, network communication and a document library

·       Consolidated dashboards and a full reporting suite

2. Module identity

3. Technical architecture

The module follows the native Dolibarr module architecture and lives in htdocs/custom/franchise/. It is built on a robust, homogeneous engine (generic list and card pages, an object registry, a shared helper library) that guarantees a consistent user experience across all 15 business objects.

·       admin/ — configuration and about pages

·       class/ — 15 CommonObject business classes + the demonstration-data generator

·       core/modules/ — the module descriptor (menus, permissions, activation)

·       core/triggers/ — business triggers that keep objects consistent with native events

·       css/ & js/ — the corporate blue/orange charter and front-end behaviours

·       langs/ — 5 language files (fr_FR, en_US, es_ES, it_IT, de_DE)

·       sql/ — table definitions and indexes (self-healing schema on upgrade)

·       lib/ — shared helpers, the object registry and the in-page navigation

·       dashboard.php, reporting.php — the consolidated cockpit and the reporting hub

Standards respected: native Dolibarr classes and permissions, hooks and triggers, menu system, multi-language, multi-entity (multi-company), PDF generation and CSV/Excel export, and optimisation for large databases (indexed foreign keys, paginated lists, full-scan-safe queries).

4. Consolidated dashboard

The modern dashboard (corporate blue / dynamic orange charter) provides a strategic, network-wide view built around four KPI zones and a set of interactive charts.

Network

·       Number of franchisees and stores

·       Active stores and newly opened stores

·       Total network surface and headcount

Franchisor finance

·       Network revenue

·       Royalties generated

·       Franchisor revenue (royalties + entry fees)

·       Unpaid royalties

Store performance

·       Top store

·       Objectives achieved

·       Average quality (audit) score

·       Underperforming stores

Operations & charts

·       Audits done, expiring contracts, planned trainings

·       Charts: revenue evolution, store ranking, royalty evolution, stores by status, objectives vs actuals

5. Functional modules

Network & brand

Describe the brand: name, sector, country, region, network manager, currency, default royalty rate and creation year. Each network groups its franchisees and stores.

Franchisees

Manage partner franchisees with company, manager, contact details, geographic zone, join date and commercial status (Prospect, Under review, Contract signed, Active, Suspended, Terminated). Each franchisee is linked to a native Dolibarr third party.

Stores

Multi-store management: code, name, address, surface, manager, headcount, opening date and status (In preparation, Open, Temporarily closed, Permanently closed). Optional link to a Dolibarr warehouse.

Contracts

Franchise contracts with start/end dates, duration, entry fee, royalty type and rate, monthly flat fee, exclusive zone and conditions. Automatic alert for expiring contracts.

Royalties

Royalty management per store and period, automatically computed from revenue and the contract rate, with payment tracking and invoice reference. Connected to Dolibarr invoicing.

Network products

Brand catalogue distinguishing mandatory, exclusive and recommended products, with brand reference, purchase price, suggested retail price, margin rate and supplier. Linked to native Dolibarr products.

Central purchasing

Group purchasing orders with supplier, date, amount, number of stores served and negotiated conditions.

Multi-store stock

Stock tracked per store and product, with alert threshold, stock value and movement type (normal, transfer, dormant). Critical-stock alerts.

Sales & revenue

Commercial tracking consolidating revenue per store and period, with number of sales, average basket and margin.

Objectives

Objectives at network, region or store level (revenue, sales, margin, customer acquisition) with actuals and achievement rate.

Audits

Quality, commercial, financial and compliance audits with auditor, score, findings and corrective actions.

Quality

Quality management tracking brand standards, claims and customer satisfaction, building a quality index per store.

Training

Training sessions with date, trainer, store, participants, material, certification and results.

Communication

Network communication space for news, internal notes, marketing campaigns and commercial documents.

Document library

Franchise ECM gathering contracts, procedures, manuals, logos, marketing material and audit reports.

6. Reporting & exports

The reporting hub delivers decision-making reports: network situation, financial & royalties, stores, ranking, franchisees, sales, objectives, audits, quality, training and network development. Every report can be exported to CSV and Excel, printed, or generated as a PDF.

7. Native Dolibarr integration

·       Third parties: franchisees, suppliers and customers

·       Products: brand catalogue and stock

·       Invoices: royalties and franchisor billing

·       Quotes, orders and suppliers: central purchasing

·       Agenda & projects: audits, trainings and new store openings

·       ECM: the document library

·       Multi-company (multi-entity) and the REST API

8. Configuration & demonstration data

The configuration page gathers the franchisor information (name, currency, default royalty rate, contract duration) and notification settings (contract-expiry alert). Two one-click buttons manage a complete, realistic demonstration dataset:

·       Install demonstration data — generates networks, franchisees, stores, contracts, royalties, products, purchases, stock, sales, objectives, audits, quality records, trainings, communications and documents.

·       Remove demonstration data — safely deletes only the data created by the module (matched by import key), leaving the rest of your Dolibarr untouched.

9. Security & quality

·       Granular permissions per domain (read / write / delete) plus an administration right

·       CSRF token protection on all state-changing actions

·       SQL escaping and parameter filtering on every input

·       Indexed foreign keys and paginated, full-scan-safe lists for large databases

·       Responsive, accessible interface aligned with the Dolibarr theme

·       Tested end-to-end: installation, activation, permissions, multi-language, demo install/remove, PDF generation and native module integration

 

Franchise Network Management — © 2026 DoliResources — www.doliresources.com