1. Overview

Fish Production Management turns Dolibarr ERP/CRM into a complete, production-ready solution for a fish production, processing and distribution plant. It manages the entire halieutic value chain — from the catch and reception of raw fish, through the cold chain and industrial transformation (filleting, cutting, freezing, packaging), to full lot traceability, HACCP quality control, cold storage, logistics and distribution — without depending on any external software.

·       26 interconnected business objects covering the whole value chain.

·       Premium real-time maritime dashboard with KPIs and charts.

·       Kanban production pipeline and a production planning board.

·       Reporting hub with 20 business reports and PDF / Excel / CSV export.

·       Native invoicing bridge, a daily automation engine and a one-click demo dataset.

·       Deep native Dolibarr integration with no data redundancy.

2. Raw Material Management (raw fish)

2.1 Fish species (reference catalogue)

·       Common name and scientific (Latin) name.

·       Biological family and category (white fish, oily fish, crustacean, cephalopod).

·       Origin type: sea, farming or import.

·       Average weight (kg) and average size (cm).

·       FAO species code and fishing season.

·       Conservation notes (recommended storage conditions).

2.2 Fish lots (traceability backbone)

·       Reference, label and linked species.

·       Fishing zone, supplier / fisherman and originating reception.

·       Origin type (sea / farming / import) and FAO fishing zone.

·       Catch date and expiry date (DLC).

·       Quality grade (A / B / C) and freshness rating (Extra / A / B).

·       Conservation state (fresh / frozen) and reception temperature (°C).

·       Gross and net weight (kg) and number of pieces.

·       Calibre, storage location, barcode and QR code.

·       Purchase price and lot status (in stock / in production / shipped / rejected).

·       Each lot card shows a KPI cockpit and every linked record.

3. Reception & Traceability

The reception module registers every arrival of fresh, frozen or live fish and generates the traceable lots that enter production or cold storage.

·       Reception type (fresh / frozen), supplier and fishing zone.

·       Number of lots and total weight (kg).

·       Reception temperature and truck temperature (°C), checked against the cold-chain requirement.

·       Total value and reception status (expected / received / controlled / refused).

·       Optional link to a native Dolibarr supplier order and reception.

4. Production & Transformation

4.1 Processing orders (OT)

·       Source lot and target finished product.

·       Workshop, client and native Dolibarr customer order / project.

·       Product type (filet, darne, whole fish, frozen, canned, smoked, minced).

·       Quantity to make, quantity produced and losses.

·       Input and output weight (kg) and material yield (%).

·       Priority, production phase and progress (%).

·       Industrial costs — material, labour, machine, overhead, total.

·       Sale price and margin (computed automatically).

·       Planned and real start / end dates.

4.2 Production pipeline (Kanban)

·       Drag-and-drop board with phase columns: to launch → planned → filleting → cutting → freezing → packaging → control → done.

·       Dragging a card moves the order to that phase; reaching 'done' closes it.

·       Each column shows its order count and total production cost.

4.3 Production steps

·       Operations: reception, sorting, heading, gutting, filleting, cutting, freezing, packaging, labelling, control.

·       Assigned machine and operator per step.

·       Sequence, duration (h), processing temperature (°C).

·       Input / output / scrap quantities and step yield (%).

·       Machine cost and status.

4.4 Production planning

·       Forward view of upcoming orders, maintenance, shipments and receptions by date.

·       Colour-coded workshop load overview (green / amber / red).

5. Packaging & Finished Products

Finished products (filets, darnes, whole fish, frozen, canned, smoked) with full packaging and conservation data.

·       Conservation mode (fresh / frozen / canned / smoked).

·       Packaging (tray, vacuum, polystyrene box, carton, can).

·       Unit weight (kg) and calibre.

·       Shelf life (days) and storage temperature (°C).

·       Unit cost, sale price and stock quantity.

·       Link to a native Dolibarr product for pricing and stock.

·       Production and expiry dates, sanitary standards and barcodes / QR codes.

6. Cold Chain

6.1 Temperature readings

·       Reading type: positive cold room, negative cold room, freezing tunnel, truck, reception dock, display case.

·       Measured temperature, target / min / max temperature, humidity (%).

·       Alert level: normal / alert / break.

·       Linked site, cold room and workshop, timestamped reading date.

·       Break-of-cold-chain events feed the dashboard alert tiles and the automation engine.

6.2 Cold rooms (refrigerated warehouses)

·       Positive / negative rooms, freezing tunnels and reception docks.

·       Capacity (m³ and tonnes), target and current temperature, fill rate (%) and equipment state.

7. Stock & Warehouses

Stock movements track raw, finished and frozen goods with FIFO / FEFO discipline.

·       Movement type (in / out / transfer / loss).

·       Linked lot, product, consumable, cold room, warehouse and processing order.

·       Quantity (kg), value and storage temperature (°C).

·       Consumables (packaging, ice, salt, cartons, labels, vacuum film, gloves, brine) with stock quantity, minimum threshold, unit price, stock value and low-stock alerting.

8. Quality & Compliance (HACCP)

8.1 Sanitary controls

·       Control type (reception, HACCP, microbiological, organoleptic, temperature, finished product).

·       Linked order, lot and product.

·       Temperature (°C), pH, histamine (ppm) and quality score.

·       Critical Control Point (CCP) reference and checklist.

·       Number checked / OK / KO and a conforming / non-conforming result.

8.2 Non-conformities

·       Type (temperature, microbiological, foreign body, labelling, cold-chain break, calibre).

·       Severity (minor / major / critical).

·       Impacted quantity (kg) and cost impact.

·       Description, corrective action, responsible person.

·       Detection / close dates and status (open / in progress / closed).

·       Full sanitary audit history available through the reporting hub.

9. Logistics & Distribution

9.1 Shipments

·       Client, product, third party, transporter, truck plate and driver.

·       Transport temperature (°C), delivery note, destination and transport cost.

·       Status (prepared / shipped / delivered / invoiced) with optional native shipment link.

9.2 Weighing (weighbridge)

·       Tare, gross and net weight with temperature.

·       Linked to the lot and the shipment for outbound control and end-customer traceability.

10. Commercial Management

Full connection to native Dolibarr sales documents — quotes, customer orders, invoices and payments.

·       Pricing by species and by quality grade.

·       Client records (grossiste, mareyeur, restaurateur, GMS, exportateur) with market segment.

·       An invoicing hub that creates native quotes, orders and invoices from finished processing orders, with quick links to open orders and invoices.

11. Suppliers & Fishermen

Supplier / fisherman records (fisherman, wholesaler, aquaculturist, importer, consumable supplier).

·       Supplied species, contract reference and native third-party link.

·       Supports supply contracts, raw-fish purchasing, supplier quality tracking and supplier invoices.

12. Industrial Maintenance

Machine fleet

·       Filleting machines, slicers, freezing tunnels, vacuum packers, labellers, conveyors, ice machines.

·       Brand, model, serial number, power, capacity (kg/h), run/stop hours, availability and utilization (%), state and maintenance dates.

Maintenance interventions

·       Preventive / corrective, planned and done dates, technician, cost, downtime hours, next date and findings.

Operators

·       Qualification, shift, medical-check validity, productivity and hours worked.

13. Premium Maritime Dashboard

A brand-new real-time control center (not the native Dolibarr one), with an ocean-blue / turquoise maritime identity.

Hero band

·       Lots in stock, fish processed this month, material yield, average storage temperature.

Alerts zone

·       Late processing orders, cold-chain breaks, near-expiry lots, critical non-conformities, low consumables, stopped machines, open safety incidents.

KPI zones with charts

·       Production: lots in stock, raw tonnage, monthly / yearly output (t), orders in progress, order count, yield, loss rate, late orders.

·       Cold chain: average storage temperature, cold-chain alerts, 14-day temperature trend.

·       Machines: running / stopped machines, availability, upcoming maintenance, utilization chart.

·       Stock: finished products, stock value, monthly by-products.

·       Quality: HACCP conformity rate, open non-conformities, safety incidents.

·       Cost & commercial: revenue, production cost, gross margin, today's shipments, active clients, suppliers.

·       Charts: monthly production, species split, machine utilization, storage-temperature trend, cost breakdown and monthly revenue.

14. Reporting (20 business reports)

A complete reporting menu, each report printable and exportable to PDF, Excel and CSV:

·       Production by period · Production by workshop · Production by machine.

·       Material yield and losses.

·       Fish lot stock · Lot traceability.

·       Finished product stock · Consumables and stock.

·       Sanitary quality and HACCP controls · Non-conformities.

·       Waste and recovery.

·       Cold chain and temperatures.

·       Machines and availability · Maintenance and breakdowns.

·       Shipments and logistics.

·       Sales and revenue · Production costs.

·       Revenue by client · Purchases by supplier.

·       Health and safety (HSE).

·       All exports decode accented characters correctly (UTF-8) and labels are localized.

15. Module Configuration

An administration panel provides:

·       Default parameters (overhead %, VAT rate, currency).

·       Cold-chain alert threshold (°C).

·       One-click generation and removal of the demonstration dataset.

·       Configurable reference vocabularies: fish species, product types, quality standards, temperature thresholds, production parameters, lot types, logistics parameters and system alerts.

16. Demonstration Data

Two one-click actions from the configuration panel:

·       Generate demo data — a full realistic dataset: sites, workshops, cold rooms, species, fishing zones, consumables, finished products, machines, operators, maintenance, receptions, fish lots, processing orders, production steps, HACCP controls, non-conformities, by-products, stock moves, shipments, weighing, cold-chain readings, HSE incidents, activity journal and automation rules — plus native customers, suppliers, products, quotes, orders and invoices.

·       Remove demo data — deletes only the rows tagged FISHDEMO; real production data is never touched.

17. Automation Engine

A daily scheduled cron job (FishRunAutomations) evaluates the active automation rules and applies safe built-in actions.

·       Close finished processing orders and recompute progress.

·       Raise alerts for late orders, low stock, cold-chain breaks, critical non-conformities and near-expiry lots (DLC).

·       The engine never throws on a partial failure, so the scheduler stays green.

18. Native Dolibarr Integration

100% integrated with Dolibarr's native modules, with no redundancy:

·       Third parties (clients, suppliers, fishermen, distributors).

·       Products / Services · Stock / Warehouses.

·       Customer & Supplier Orders · Invoices · Quotes.

·       Projects · Agenda · Accounting · Bank · Contracts.

·       REST API · Notifications · GED (documents) · Multi-company.

19. User Experience

A modern agri-food industrial interface under a consistent maritime colour charter (deep navy, ocean blue, turquoise, white, steel grey, alert red).

·       Real-time dashboard, production cards and a production-chain view.

·       Lot timeline, quick search, advanced filters with a column selector.

·       Interactive tables and visual alerts.

20. Security

·       Prepared / escaped SQL everywhere (no injection).

·       CSRF token protection on every form.

·       XSS escaping of all output.

·       Full Dolibarr permission management — 14 right groups (production, product, machine, maintenance, operator, quality, waste, stock, logistics, cold chain, HSE, commercial, automation, reporting) with read / write / delete.

·       Audit logging and multi-entity (multi-company) isolation on every table.

21. Architecture

Strict Dolibarr module structure: /class, /admin, /core, /sql, /hooks, /triggers, /img, /css, /js, /langs, /tpl. Database prefix llx_fishproduction_.

·       Every table carries rowid, entity, <fields>, status, date_creation, tms, fk_user_creat, fk_user_modif, import_key.

·       A schema self-heal runs on activation so upgrades add any missing columns automatically.