Aller au contenu principal
    Open source

    Open source. Littéralement.

    Chaque ligne de code est disponible : à lire, copier, modifier et auto-héberger. Sous licence AGPL-3.0. Pour toujours.

    github.com/ghhamza/maqraa
    0
    étoiles
    0
    forks
    1
    contributeurs
    Rust 60% · TypeScript 30% · Autres 10%
    Dernière mise à jour : il y a 2 jours

    Licence : AGPL-3.0

    Ce que cette licence signifie pour vous

    ✓ Autorisé

    • Utiliser la plateforme gratuitement, à toute fin
    • Copier et modifier le code
    • Auto-héberger la plateforme sur vos serveurs
    • Construire des produits sur la base du code
    • Usage commercial (dans les termes de la licence)

    ◯ Conditions de la licence

    • Les contributions et modifications restent sous AGPL-3.0
    • Si vous publiez une version modifiée hébergée, vous devez publier les changements
    • Les auteurs originaux doivent être crédités
    • Une copie de la licence doit être incluse
    Ce résumé est uniquement éducatif. Pour les détails juridiques complets, consultez le texte de la licence GNU AGPL-3.0. GNU AGPL-3.0

    Pourquoi AGPL et pas MIT ou Apache ?

    Nous avons choisi AGPL-3.0 plutôt que des licences plus permissives (comme MIT ou Apache) pour une raison simple : nous voulons que les améliorations restent ouvertes, même en hébergement cloud.

    Les licences permissives permettent à de grandes entreprises de prendre le code, d'en construire une version fermée et de la proposer comme service cloud payant sans partager les améliorations avec la communauté. Cela s'est produit à plusieurs reprises dans d'autres projets open source.

    AGPL ferme cette porte : quiconque héberge une version modifiée de Maqraa comme service doit publier ses modifications. Cela garantit que la communauté bénéficie de chaque amélioration, pas seulement les entreprises.

    Pour l'enseignant qui utilise app.maqraa.org ou s'auto-héberge — la licence n'a aucun impact pratique. AGPL ne concerne que ceux qui construisent une version modifiée et la proposent à d'autres.

    Auto-hébergez sur votre serveur

    Un guide rapide d'auto-hébergement — pour les instituts, les développeurs, ou pour qui veut une confidentialité totale

    Un serveur modeste

    Serveur Linux (Ubuntu 22+ recommandé), au moins 2 Go de RAM, 20 Go de disque. PostgreSQL 16+. Node.js et Rust pour la compilation.

    Cloner le dépôt et installer les prérequis

    Un git clone, configurer .env avec les valeurs de base, lancer la base de données.

    Lancer la plateforme

    Avec docker compose up ou manuellement. Nginx + Let's Encrypt pour le domaine. Guide complet sur GitHub.

    # Auto-hébergement en 3 commandes
    git clone https://github.com/ghhamza/maqraa
    cd maqraa && cp .env.example .env  # edit values
    docker compose up -d

    Contribuer au projet

    Il y a plus d'une façon de contribuer — même si vous n'êtes pas développeur

    Contributions de code

    Ouvrez une Pull Request sur GitHub. Nous examinons toutes les contributions et accueillons le code à tous les niveaux.

    Guide de contribution →

    Rapports de bugs

    Trouvé un bug ? Ouvrez une Issue sur GitHub avec des détails clairs. Nous traitons les rapports régulièrement.

    Signaler un bug →

    Suggestions de fonctionnalités

    Une idée ? Partagez-la avec nous. Les meilleures fonctionnalités viennent des enseignants eux-mêmes.

    Suggérer une fonctionnalité →

    Traduction

    Aidez-nous à traduire la plateforme dans votre langue. Nous avons besoin de relectures pour l'arabe, l'anglais, le français, et plus à venir.

    Aider à traduire →

    Feuille de route

    Nous gérons la feuille de route publiquement sur GitHub Projects. Chaque fonctionnalité prévue, chaque modification en cours, chaque priorité — visible par tous.

    Rejoignez la communauté

    Maqraa est utilisé et construit par des individus et des institutions du monde entier. Faites-en partie.

    GitHub →