base on A comprehensive collection of Quran resources <p align="center"> <a href="https://qul.tarteel.ai"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://github.com/TarteelAI/quranic-universal-library/blob/main/.github/images/qul-og.png?raw=true"> <img src="https://github.com/TarteelAI/quranic-universal-library/blob/main/.github/images/qul-og.png?raw=true"> </picture> <h1 align="center">Quranic Universal Library (QUL)</h1> </a> </p> <p align="center"> <a aria-label="Tarteel logo" href="https://tarteel.ai"> <picture> <source height="24" media="(prefers-color-scheme: dark)" srcset="https://tarteel.ai/logo.svg"> <img height="24" src="https://tarteel.ai/logo.svg"> </picture> </a> <a aria-label="A project by Tarteel Shield" href="https://tarteel.ai"><img src='https://img.shields.io/badge/A%20PROJECT%20BY%20Tarteel-000000.svg?style=for-the-badge'></a> <a aria-label="Follow on X formerly Twitter" href="https://x.com/intent/follow?screen_name=tarteelai"><img alt="X (formerly Twitter) Follow" src="https://img.shields.io/twitter/follow/tarteelai?style=for-the-badge&logo=x"></a> <a aria-label="Join the community on Discord" href="https://t.zip/discord?utm_source=github&utm_medium=readme&utm_campaign=qul"><img alt="Discord" src="https://img.shields.io/discord/934719200222642186?style=for-the-badge&logo=discord&label=Join%20our%20discord"></a> </a> </p> Welcome to QUL! This project is a comprehensive Content Management System designed to manage Quranic data, including translations, tafsirs, Audio, Audio segments, Arabic scripts, Mushaf layouts, and much more. QUL is implemented using Ruby on Rails, and Active Admin for implementing the admin interface. ## Features - Translations and Tafsirs Management: Easily add, proofread, fix issues, and export different formats. - Audio Management: Easily add both ayah by ayah and gapless aduio, manage audio segments, and export segments data. - Arabic Scripts: Preview different Arabic scripts, both ayah by ayah and word by word. - Mushaf Layouts: Manage different Mushaf layouts, preview them, and export them. - User Management: Manage users, their roles, and permissions. - Mutashabihat ul Quran: Manage Mutashabihat ul Quran data. - Surah info: Manage Surah info data in multiple languages. - Content Versioning: Keep track of all changes made to the content. - Export Data: Export data in different formats. - Import Data: Import data from different sources. - Quranic grammar and morphology: Manage Quranic grammar and morphology data. ## Setup Guide This guide will help you set up the QUL project on your local machine. Follow the steps below to get started. ### Prerequisites - **Ruby**: Version 3.3.3 - **Rails**: Version 7.0.3 - **RVM or rbenv**: For managing Ruby versions - **PostgreSQL**: 14.3 or higher - **Redis**: 7.0.0 or higher #### 1. Clone the repository ```bash git clone [email protected]:TarteelAI/quranic-universal-library.git cd quranic-universal-library ``` #### 2. Install Ruby and setup environment ```bash rvm install 3.3.3 rvm use 3.3.3 rvm gemset create qul rvm gemset use qul ``` #### 3. Install PostgreSQL - **Ubuntu/Debian** ```bash sudo apt-get update sudo apt-get install postgresql postgresql-contrib libpq-dev ``` - **MacOS** ```bash brew install postgresql ``` - **Windows** Download and install the latest version of PostgreSQL from the [official website](https://www.postgresql.org/download/windows/). #### 4. Install Dependencies ```bash gem install bundler bundle install ``` #### 5. Database Configuration **The QUL project requires two databases:** 1. **`quran_dev`**: This database holds all Quranic data, including translations, tafsirs, audio etc. It's accessed through `quran_api_db_dev` for the development environment. 2. **`quran_community_tarteel`**: This database manages user accounts, permissions, and user changes. #### 6. Create Databases Create the **`quran_community_tarteel`** database for managing user content. ```bash rails db:create ``` For **`quran_dev`** you can create it manually or change the database name to `quran_dev` for `development` group in database.yml file and run `rails db:create` again. #### 7. Load the data for **`quran_dev`** database The `quran_dev` database dump is available in both SQL and binary formats. Follow the appropriate instructions below to restore the database. #### Restoring from SQL Dump 7.1 **Restore using SQL Dump:** Download the [SQL dump file](https://quran-assets.tarteel.ai/cms/qul-mini-dump/quran_dev.sql.zip) and restore it using ```bash psql quran_dev < "path to sql dump file" ``` If it didn't work try running the following command: ```bash psql -U postgres -d quran_dev -f path/to/quran_dev.sql ``` 7.2 **Restore using binary dump:** Download the [Binary dump file](https://quran-assets.tarteel.ai/cms/qul-mini-dump/quran_dev.dump.zip) and restore it using ```bash pg_restore --host localhost --port 5432 --no-owner --no-privileges --no-tablespaces --no-acl --dbname quran_dev -v "path to binary dump file" ``` ### 8. Run the migrations for **`quran_community_tarteel`** database ```ruby rails db:migrate rails db:migrate rails db:seed ``` #### 9. Run the Application ```bash bin/dev ``` 🌟Insha`Allah! Your application should be up and running at time point! 🌟 You can now visit [http://localhost:3000](http://localhost:3000) in your browser to explore the app. 🔐 Head over to the admin panel at [http://localhost:3000/admin](http://localhost:3000/admin) ### 10. Contributing to QUL We welcome contributions to enhance the QUL project! If you'd like to contribute, please follow these steps: 10.1 **Fork the Repository:** Click on the "Fork" button at the top right of this page to create your own copy of the repository. 10.2 **Clone Your Fork:** ```bash git clone https://github.com/your_username/quranic-universal-library.git ``` 10.3. **Create a new feature branch:** ```bash git checkout -b making-qul ``` 10.4 **Make Your Changes:** 10.5 **Push Your Changes:** ```bash git add . git commit -m "Add a brief description of your changes" git push origin your-feature-branch ``` 10.6 **Create a Pull Request:** May Allah reward your efforts and make them beneficial for the community! 🤲 ", Assign "at most 3 tags" to the expected json: {"id":"11792","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"