Checking Super Admin access…

Authentication and profile verification are required.

Architecture technique & fonctionnelle

Document interne de référence pour comprendre les composants, flux métier, sécurité, données, documents et responsabilités de JenyMel Ship Chandler.

Overview Frontend Backend Data model Workflow Security Documents Operations Optimisations

1. Vue d'ensemble

Public webCatalogue, services, contact et création de commande publique.

Admin webCockpit commercial et opérationnel : Dashboard, Orders, Customers, Documents, Operations, Settings.

StockWorkspace séparé stock.html pour articles, stock, images et imports.

UsersWorkspace users.html pour la gestion des profils administratifs.

2. Frontend

Application web HTML/CSS/JavaScript, responsive mobile/desktop.
Supabase JS v2 côté navigateur.
UI JenyMel : palette verte, cartes, pills, timelines, queues, Modern Motion UI.
Pagination standardisée à 20 lignes sur les listes/queues à croissance potentielle.
Recherche globale Admin pour Orders, Customers, Articles et Documents.

admin.html ├─ Dashboard / Command Center ├─ Orders + workflow + financials ├─ Customers / Customer Master / CRM / Vessel intelligence ├─ Documents / Proforma / Invoice / Payments ├─ Operations └─ Settings stock.html users.html help.html architecture.html (Super Admin)

3. Backend & services

Supabase AuthAuthentification des administrateurs et session utilisateur.

PostgreSQLDonnées métier, relations, historique et règles d'intégrité.

RPC / SECURITY DEFINEROpérations sensibles : création de commandes publiques, identité client, paiements, facturation et actions protégées.

Edge FunctionsFonctions d'administration et envoi documentaire/email selon la configuration Resend.

StorageBucket produit pour les images catalogue/articles.

PDF / EmailDocuments commerciaux générés depuis les données de commande et paramètres commerciaux.

4. Architecture fonctionnelle des données

Customer Master └─ Customer versions / historique └─ Orders ├─ Order items → Products / Categories ├─ Workflow status / Order history ├─ Financials (discount / charges / VAT) └─ Documents ├─ Proforma + items └─ Invoice + items + payments Products / Categories └─ Stock & article management Company settings ├─ identity / logo / currency ├─ VAT ├─ payment terms └─ delivery terms Admin profiles └─ Super Admin / Admin / Read Only

La règle d'identité client est particulièrement importante : les commandes historiques conservent leur contexte, tandis que le Customer Master peut être corrigé sans réécrire les snapshots historiques.

5. Workflow métier

pending → under_review → proforma_issued → confirmed → in_preparation → delivered → completed

cancelled constitue une sortie fermée.

Under reviewPoint de décision commercial : prix, remise, charges, TVA, informations client/vessel et conditions.

Proforma issuedPoint de verrou financier : les montants commerciaux doivent être considérés comme figés.

ConfirmedAutorise le passage vers la préparation.

Delivered / CompletedFin opérationnelle puis finalisation documentaire/comptable.

6. Sécurité & permissions

AuthenticationUn compte doit être authentifié et actif.

Profile rolessuper_admin admin read_only

Read OnlyLes actions de modification sont bloquées dans l'interface et les protections backend existantes doivent rester la source d'autorité.

Financial lockLes montants deviennent verrouillés après émission de Proforma afin de protéger l'intégrité commerciale.

Accès à ce documentCette page vérifie la session, le statut administrateur actif et le rôle super_admin avant d'afficher le document.

7. Documents & finances

Currency : USD.
VAT par défaut configurée à 15% dans les paramètres actuels.
Discount : pourcentage ou montant fixe, pas les deux.
Additional charges : montant + libellé explicite.
Invoice : suivi des paiements, montant payé et balance due.
Payment terms et delivery terms proviennent de Company Settings et sont injectés dans les documents.

8. Operations & CRM

CRMCustomer Master, qualité des données, segmentation, activité, valeur commerciale et historique vessel.

OperationsETA Port Louis, readiness, disponibilité, priorités et suivi de livraison.

DashboardPriority Queue, Workflow Queue, Unified Timeline, analytics et signaux commerciaux.

AuditOrder history, customer versions et verrouillage financier assurent la traçabilité des changements importants.

9. Optimisations recommandées

Conserver la pagination 20 et envisager un chargement par pages côté backend lorsque les volumes deviennent importants.
Ajouter progressivement une vraie journalisation d'administration structurée pour les actions sensibles : qui, quoi, avant/après, date.
Renforcer l'accès du document technique par une ressource backend protégée par RLS si le document doit être considéré comme confidentiel au niveau sécurité, et pas seulement au niveau interface.
Ajouter une stratégie de sauvegarde/restauration documentée Supabase avant la mise en production complète.
Centraliser les constantes métier et les labels de workflow afin de réduire la duplication JavaScript entre workspaces.
Conserver les contrôles de données au niveau RPC/RLS plutôt que de compter uniquement sur les contrôles UI.

10. Référence de version

Base fonctionnelle : JenyMel finale validée.

Extension documentaire : Help & Technical Architecture.

Ce document décrit l'architecture telle qu'elle est connue à la date de génération et doit être mis à jour lors de toute modification Supabase, RPC, Edge Function, workflow ou structure de données.

Technical & Functional Architecture

Internal reference document covering the components, business flows, security, data, documents and responsibilities of JenyMel Ship Chandler.

Overview Frontend Backend Data model Workflow Security Documents Operations Optimisations

1. Overview

Public webCatalogue, services, contact and public order creation.

Admin webCommercial and operational cockpit: Dashboard, Orders, Customers, Documents, Operations, Settings.

StockSeparate stock.html workspace for articles, stock, images and imports.

Usersusers.html workspace for administrative profile management.

2. Frontend

HTML/CSS/JavaScript web application, responsive on mobile and desktop.
Supabase JS v2 in the browser.
JenyMel UI: green palette, cards, pills, timelines, queues, Modern Motion UI.
Standard pagination at 20 rows on lists/queues with potential growth.
Global Admin search for Orders, Customers, Articles and Documents.

3. Backend & services

Supabase AuthAdministrator authentication and user session.

PostgreSQLBusiness data, relations, history and integrity rules.

RPC / SECURITY DEFINERSensitive operations: public order creation, customer identity, payments, invoicing and protected actions.

Edge FunctionsAdministration functions and document/email delivery according to Resend configuration.

StorageProduct bucket for catalogue/article images.

PDF / EmailCommercial documents generated from order data and commercial settings.

4. Functional data architecture

Customer Master └─ Customer versions / history └─ Orders ├─ Order items → Products / Categories ├─ Workflow status / Order history ├─ Financials (discount / charges / VAT) └─ Documents ├─ Proforma + items └─ Invoice + items + payments Products / Categories └─ Stock & article management Company settings ├─ identity / logo / currency ├─ VAT ├─ payment terms └─ delivery terms Admin profiles └─ Super Admin / Admin / Read Only

Customer identity is particularly important: historical orders retain their context, while Customer Master can be corrected without rewriting historical snapshots.

5. Business workflow

pending → under_review → proforma_issued → confirmed → in_preparation → delivered → completed

cancelled is a closed exit.

Under reviewCommercial decision point: price, discount, charges, VAT, customer/vessel information and terms.

Proforma issuedFinancial lock point: commercial amounts should be treated as fixed.

ConfirmedAllows the order to move towards preparation.

Delivered / CompletedOperational completion followed by documentary/accounting finalisation.

6. Security & permissions

AuthenticationAn account must be authenticated and active.

Profile rolessuper_admin admin read_only

Read OnlyModification actions are blocked in the interface and existing backend protections must remain the authority.

Financial lockAmounts become locked after Proforma issue to protect commercial integrity.

Access to this documentThis page checks the session, active administrator status and super_admin role before displaying the document.

7. Documents & finances

Currency: USD.
VAT currently configured at 15% in the settings.
Discount: percentage or fixed amount, not both.
Additional charges: amount + explicit label.
Invoice: payment tracking, paid amount and balance due.
Payment and delivery terms come from Company Settings and are injected into documents.

8. Operations & CRM

CRMCustomer Master, data quality, segmentation, activity, commercial value and vessel history.

OperationsPort Louis ETA, readiness, availability, priorities and delivery follow-up.

DashboardPriority Queue, Workflow Queue, Unified Timeline, analytics and commercial signals.

AuditOrder history, customer versions and financial locking provide traceability for important changes.

9. Recommended optimisations

Keep 20-row pagination and consider backend page loading as volumes increase.
Progressively add structured administration logging for sensitive actions: who, what, before/after, date.
Strengthen access to the technical document through a backend RLS-protected resource if it must be confidential at the security level, not only the interface level.
Document a Supabase backup/restore strategy before full production deployment.
Centralise business constants and workflow labels to reduce JavaScript duplication across workspaces.
Keep data controls at RPC/RLS level rather than relying only on UI controls.

10. Version reference

Functional baseline: JenyMel final validated.

Documentation extension: Help & Technical Architecture.

This document describes the architecture known at generation time and should be updated whenever Supabase, RPC, Edge Function, workflow or data structures change.