# Open source
Source: https://docs.lomi.africa/resources/open-source

lomi. publie des outils d’intégration et la documentation en open source. Le traitement des paiements passe par notre plateforme hébergée, pas en auto-hébergement aujourd’hui.

***

title: 'Open source'
description: 'lomi. publie des outils d’intégration et la documentation en open source. Le traitement des paiements passe par notre plateforme hébergée, pas en auto-hébergement aujourd’hui.'
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

import { Callout } from '@/components/docs/docs-callout';

lomi. suit un modèle **hébergé d’abord**. Les marchands s’intègrent via notre API cloud, le tableau de bord et le checkout. Nous **ne proposons pas** l’auto-hébergement du traitement des paiements à ce stade.

Notre **direction à long terme** est d’ouvrir progressivement le monorepo, davantage d’apps, davantage de code source, et à terme un chemin supporté pour les opérateurs qui s’auto-hébergent avec leurs propres accords prestataires et leur conformité. Ce n’est pas disponible aujourd’hui ; voir la [feuille de route](#feuille-de-route) pour ce qui est public maintenant.

Nous publions tout de même du code source pour la transparence et les outils d’intégration (SDK, CLI, plugins, docs). Dans cette logique, nous appliquons une **double licence**.

Le projet est principalement sous **GNU Affero General Public License (AGPL)** : la communauté peut utiliser, modifier et redistribuer le logiciel librement. L’AGPL impose toutefois que toute utilisation en service (SaaS notamment) **publie également le code source**. Si vous souhaitez utiliser **lomi.** sans publier vos modifications (intégration à un produit propriétaire) ou l’exploiter commercialement pour des offres similaires, **une licence commerciale est requise**.

Certains composants relèvent exclusivement de notre **licence commerciale**, pour les entreprises ayant besoin de fonctionnalités additionnelles ou d’une plus grande flexibilité. Ce **double modèle** nous permet de servir à la fois la communauté open source et les partenaires enterprise.

<Callout type="info">
  Voir le fichier [LICENSE](https://github.com/lomiafrica/lomi.?tab=License-1-ov-file) du monorepo pour les textes complets des deux licences.
</Callout>

## Qu’est-ce qui est open source aujourd’hui ?

| Domaine                                                          | Disponibilité                                                  |
| :--------------------------------------------------------------- | :------------------------------------------------------------- |
| Plateforme hébergée (API, tableau de bord, checkout, conformité) | ✅ Production, [créer un compte](https://dashboard.lomi.africa) |
| API et webhooks                                                  | ✅ Hébergé uniquement                                           |
| SDK, CLI, MCP, plugins                                           | ✅ Outils d’intégration (code + packages)                       |
| Site de documentation                                            | ✅ Open source (`apps/docs`)                                    |
| Tableau de bord marchand, checkout, storefront                   | 🔒 Produit hébergé (ouverture progressive du code)             |
| Admin                                                            | 🔒 Propriétaire                                                |

<Callout type="warn">
  **Pas d’auto-hébergement aujourd’hui.** Le traitement des paiements repose sur l’infrastructure hébergée de lomi., les accords avec les partenaires de paiement, la couverture de conformité et la stack opérationnelle. Un clone local sert au **développement et à la contribution**, pas à exploiter votre propre processeur de paiement.
</Callout>

## Plateforme hébergée

Pour les paiements en production, utilisez la plateforme sur [dashboard.lomi.africa](https://dashboard.lomi.africa) : canaux de paiement intégrés, accords partenaires et couverture de conformité, mises à jour automatiques et support dédié.

### Comparaison rapide

| Fonctionnalité                     |            Outils open source            | Plateforme hébergée |
| :--------------------------------- | :--------------------------------------: | :-----------------: |
| API et webhooks                    |      Intégration sur l’API hébergée      |          ✅          |
| Canaux de paiement intégrés        |                     -                    |          ✅          |
| Tableau de bord et checkout        |                     -                    |          ✅          |
| SDK, CLI, MCP, plugins             | ✅ Outils d’intégration (code + packages) |          ✅          |
| Auto-hébergement du stack paiement |           À la feuille de route          |          -          |
| Mises à jour automatiques          |                     -                    |          ✅          |
| Support dédié                      |                Communauté                |          ✅          |

### Options de support

La plateforme hébergée inclut notamment :

* support technique 24/7
* traitement prioritaire des incidents
* aide à la mise en œuvre

### Ressources

* [Monorepo sur GitHub](https://github.com/lomiafrica/lomi.)
* [Contribuer](/resources/contributing)
* [Manifeste](/resources/manifesto)
* [Communauté](/resources/community)
* [Page de statut](https://status.lomi.africa)

## Feuille de route

Nous ouvrons progressivement le monorepo. **L’auto-hébergement du stack paiement complet est un objectif à long terme**, pas une offre supportée en production aujourd’hui. La trajectoire : publier plus de code → documenter les prérequis opérateur (prestataires, accords partenaires, conformité) → proposer une option auto-hébergée supportée quand le stack sera complet et sûr sans les services hébergés de lomi.

Ce qui est ouvert aujourd’hui :

* **Déjà en open source** :
  * Site de documentation : **`apps/docs`** (ce site)
  * CLI (**`apps/cli`**), outil d’intégration ; s’appuyer sur l’API hébergée, pas sur l’exploitation plateforme
  * Service API : **`apps/api`**
  * SDK : **`apps/sdks`**
  * Plugins e-commerce : dépôts séparés sous `apps/plugins/`, [woo](https://github.com/lomiafrica/woo), [magento](https://github.com/lomiafrica/magento), [prestashop](https://github.com/lomiafrica/prestashop), [shopify](https://github.com/lomiafrica/shopify), [bubble](https://github.com/lomiafrica/bubble)
  * Serveur MCP (**`apps/mcp`**), outil d’intégration ; API marchande dans l’IDE, pas l’exploitation plateforme
  * Plugin agent (**`apps/tools/agent-plugin`**), packaging marketplace pour le MCP hébergé ; [lomiafrica/agent-plugin](https://github.com/lomiafrica/agent-plugin)
  * Boilerplate événements (dépôt séparé) : **[lomiafrica/events](https://github.com/lomiafrica/events/)**

* **Bientôt** :
  * Tableau de bord marchand : **`apps/dashboard`**

* **Propriétaire** :
  * Tableau de bord admin : **`apps/admin`**

* **Produit hébergé (code pas entièrement public)** :
  * Checkout : **`apps/checkout`**
  * Storefront : **`apps/storefront`**
  * Portail client : **`apps/customers`**
  * Site marketing : **`apps/website`**

De nombreux fichiers, surtout les migrations et la logique paiement cœur, portent la mention `/* @proprietary license */` même dans des apps sous AGPL.

## Organisation du monorepo

```text filename="Structure du projet"
└── lomi./
    ├── README.md
    ├── CONTRIBUTING.md
    ├── LICENSE
    ├── pnpm-workspace.yaml
    ├── tooling/          # eslint, knip, tsconfig, postcss, scripts partagés (pas un package)
    ├── packages/
    │   ├── ui/           # @lomi./ui — primitives React partagés (interne workspace)
    │   ├── shared/       # @lomi./shared — formatage, json-value, types Database générés
    │   ├── queries/      # @lomi./queries — wrappers RPC injectés
    │   ├── pay/          # @lomi./pay — chrome formulaire checkout/storefront (React 19)
    │   └── receipt-pdf/  # @lomi./receipt-pdf — PDF de reçu (interne au workspace)
    └── apps/
        ├── admin/        # Admin interne (propriétaire)
        ├── api/          # API paiement NestJS (open source)
        ├── checkout/     # Checkout hébergé (produit hébergé)
        ├── cli/          # CLI Rust (outil intégrateur ; open source)
        ├── customers/    # Portail client (produit hébergé)
        ├── dashboard/    # Tableau de bord marchand (ouverture prochaine)
        ├── design/       # Assets design partagés
        ├── docs/         # Documentation développeur (open source, cette app)
        ├── jumbo/        # Application marchande lomi. Pos (téléphone)
        ├── mcp/          # Serveur MCP (outil intégrateur ; open source)
        ├── plugins/      # WooCommerce, Magento, PrestaShop, Shopify, Bubble, références
        ├── sdks/         # SDK TypeScript, Python, PHP, Go (open source)
        ├── storefront/   # Storefront marchand (produit hébergé)
        ├── tools/        # Outils indépendants (agent-plugin, doctool, gsc-mcp, …)
        └── website/      # Site marketing (produit hébergé)
```

## Tableau de bord marchand (`apps/dashboard`)

Le tableau de bord est le back-office marchand (transactions, liens de paiement, paramètres, analytics). C’est un **produit hébergé** aujourd’hui ; le code s’ouvre progressivement.

Structure simplifiée :

```text filename="Tableau de bord (apps/dashboard)"
└── apps/dashboard/
    ├── package.json
    ├── .env.example
    ├── src/              # Application React (Vite)
    ├── supabase/         # Migrations DB et edge functions (référence)
    │   └── migrations/
    └── public/           # Assets statiques
```

Les migrations sous `supabase/migrations/` font foi pour le schéma plateforme. Ce n’est pas une recette pour exploiter votre propre stack paiement sans les services hébergés de lomi. et les accords prestataires.

## Contribuer

Les contributions sur les zones open source et la documentation sont les bienvenues. Ouvrez une issue ou une pull request sur le [monorepo lomi.](https://github.com/lomiafrica/lomi.).

Avant de contribuer :

1. Lisez notre [code de conduite](https://github.com/lomiafrica/lomi.?tab=coc-ov-file)
2. Consultez la [politique de sécurité](https://github.com/lomiafrica/lomi.?tab=security-ov-file)
3. N’altérez pas les fichiers marqués `/* @proprietary license */`

Voir [Contribuer](/resources/contributing) et [CONTRIBUTING.md](https://github.com/lomiafrica/lomi./blob/master/CONTRIBUTING.md) du monorepo.

## Besoin d’aide pour choisir ?

Pour toute question sur l’open source et la plateforme hébergée : [hello@lomi.africa](mailto:hello@lomi.africa).

Pour notre vision : [blog](https://lomi.africa/blog) ou [outil de tarification](https://lomi.africa/pricing).

## Liens utiles

* **Discord** : [communauté Discord](https://discord.gg/yb4FnBmh)
* **X** : [@lomiafrica](https://twitter.com/lomiafrica)
* **GitHub** : [issues](https://github.com/lomiafrica/lomi./issues) et [pull requests](https://github.com/lomiafrica/lomi./blob/master/CONTRIBUTING.md)
* **Email** : [hello@lomi.africa](mailto:hello@lomi.africa)