From 7e7c22d0bb078283ffc217fae28f91e8678c7740 Mon Sep 17 00:00:00 2001 From: abdulhade Date: Mon, 7 Apr 2025 14:40:19 +0300 Subject: [PATCH] =?UTF-8?q?ADDED=20EMOJIS=20TO=20THE=20DOCS,=20WOW=20?= =?UTF-8?q?=F0=9F=98=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 82 +++++++++++++++++++++++++++---------------------------- 1 file changed, 41 insertions(+), 41 deletions(-) diff --git a/README.md b/README.md index b22a181..6b2d4ec 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,11 @@ -# Capital Index Database Middleware +# ๐Ÿฆ Capital Index Database Middleware -## Overview +## ๐Ÿ“„ Overview -### About This Project +### ๐Ÿ’ก About This Project The **Capital Index Database Middleware** provides an abstraction layer for your database, enhancing query management and change monitoring. It streamlines database interactions while ensuring efficient performance and security. -### Repository Contents +### ๐Ÿ“ Repository Contents This repository includes: - **Middleware Source Code** โ€“ The core logic for database interaction. - **Dockerfile** โ€“ Configuration for containerized deployment. @@ -15,34 +15,34 @@ This repository includes: --- -### Table of Content: +### ๐Ÿงญ Table of Content: -- [Capital Index Database Middleware](#capital-index-database-middleware) - - [Overview](#overview) - - [About This Project](#about-this-project) - - [Repository Contents](#repository-contents) - - [Table of Content:](#table-of-content) - - [Getting Started](#getting-started) - - [Installation](#installation) - - [Step 1: Install Required Dependencies](#step-1-install-required-dependencies) - - [Step 2: Run the Setup Script](#step-2-run-the-setup-script) - - [Configuration](#configuration) - - [1. API\_PORT](#1-api_port) - - [2. CONTAINER\_NAME](#2-container_name) - - [3. HAS\_LOCAL\_DBS](#3-has_local_dbs) - - [Test your setup](#test-your-setup) - - [Using the `status` command:](#using-the-status-command) - - [Using the `test_setup` command:](#using-the-test_setup-command) - - [Create your first admin user](#create-your-first-admin-user) - - [Expose the API](#expose-the-api) - - [Using Nginx](#using-nginx) - - [Using Apache](#using-apache) +- [๐Ÿฆ Capital Index Database Middleware](#-capital-index-database-middleware) + - [๐Ÿ“„ Overview](#-overview) + - [๐Ÿ’ก About This Project](#-about-this-project) + - [๐Ÿ“ Repository Contents](#-repository-contents) + - [๐Ÿงญ Table of Content:](#-table-of-content) + - [๐Ÿš€ Getting Started](#-getting-started) + - [๐Ÿ› ๏ธ Installation](#๏ธ-installation) + - [๐Ÿ”ง Step 1: Install Required Dependencies](#-step-1-install-required-dependencies) + - [โ–ถ๏ธ Step 2: Run the Setup Script](#๏ธ-step-2-run-the-setup-script) + - [โš™๏ธ Configuration](#๏ธ-configuration) + - [๐Ÿ”ข API\_PORT](#-api_port) + - [๐Ÿ“ฆ CONTAINER\_NAME](#-container_name) + - [๐Ÿ’พ HAS\_LOCAL\_DBS](#-has_local_dbs) + - [โœ… Test your setup](#-test-your-setup) + - [๐Ÿ“Š Using the `status` command:](#-using-the-status-command) + - [๐Ÿงช Using the `test_setup` command:](#-using-the-test_setup-command) + - [๐Ÿ‘ค Create your first admin user](#-create-your-first-admin-user) + - [๐ŸŒ Expose the API](#-expose-the-api) + - [๐ŸŒ Using Nginx](#-using-nginx) + - [๐Ÿ…ฐ๏ธ Using Apache](#๏ธ-using-apache) - [๐Ÿš€ Available Commands](#-available-commands) - [๐Ÿ› ๏ธ Source Code Management](#๏ธ-source-code-management) - [๐Ÿšฆ App Running](#-app-running) - [๐Ÿ‘ฅ User Management](#-user-management) - - [โš™๏ธ Configuration](#๏ธ-configuration) + - [โš™๏ธ Configuration](#๏ธ-configuration-1) - [๐Ÿ“š Help](#-help) - [Legal \& Licensing](#legal--licensing) - [โš ๏ธ Important Legal Notice](#๏ธ-important-legal-notice) @@ -50,11 +50,11 @@ This repository includes: -## Getting Started +## ๐Ÿš€ Getting Started -### Installation +### ๐Ÿ› ๏ธ Installation -#### Step 1: Install Required Dependencies +#### ๐Ÿ”ง Step 1: Install Required Dependencies Before installing, ensure you have the necessary dependencies to download and build the Docker container.
@@ -115,7 +115,7 @@ sudo apk add --no-cache docker-cli-buildx ```
-#### Step 2: Run the Setup Script +#### โ–ถ๏ธ Step 2: Run the Setup Script After installing dependencies, configure Docker permissions and run the setup script: 1. Add your user to the Docker group and re-login: @@ -143,28 +143,28 @@ After installing dependencies, configure Docker permissions and run the setup sc --- -## Configuration +## โš™๏ธ Configuration During installation, you will be prompted to configure the following variables: -### 1. API_PORT +### ๐Ÿ”ข API_PORT - Defines the port the middleware listens on. - **Default:** `8080` - Access within your machine: `http://localhost:8080` - Ensure this port is forwarded if external access is required. -### 2. CONTAINER_NAME +### ๐Ÿ“ฆ CONTAINER_NAME - Specifies the name of the Docker container running the middleware. -### 3. HAS_LOCAL_DBS +### ๐Ÿ’พ HAS_LOCAL_DBS Determines how the middleware connects to databases: - **Enter `0`** โ€“ If all the databases are hosted on a remote server. - **Enter `1`** โ€“ If one or more of the database runs on the same machine. > **Note:** By default, Docker containers operate on an isolated network. If your database is local, the middleware must be configured to run on the same network to ensure connectivity. -## Test your setup +## โœ… Test your setup -### Using the `status` command: +### ๐Ÿ“Š Using the `status` command: Check the status of the container @@ -218,7 +218,7 @@ Config file loaded successfully. -### Using the `test_setup` command: +### ๐Ÿงช Using the `test_setup` command: If the container is created and running, use the test setup command: @@ -237,7 +237,7 @@ Config file loaded successfully. ``` -## Create your first admin user +## ๐Ÿ‘ค Create your first admin user First make sure it is running by calling the `db-middleware start` command. @@ -263,7 +263,7 @@ Enter role (admin/user): admin You don't need passwords for this, just the username and role. -## Expose the API +## ๐ŸŒ Expose the API This app currently runs on your local network only, we need to expose it so the data consumer on the Data Analysis product can access it and consume the data it provides. @@ -273,7 +273,7 @@ You can use a dedicated domain, or a sub-domain of yours. You can use any reverse proxy you prefer, we will guide you through Nginx and Apache. -### Using Nginx +### ๐ŸŒ Using Nginx Nginx is a great reverse-proxy that supports connection polling and real-time connections like Webhook and Server Site Events. @@ -363,7 +363,7 @@ sudo systemctl restart nginx > Notice the **s** in http**s** -### Using Apache +### ๐Ÿ…ฐ๏ธ Using Apache 1. Make sure apache is installed and upgraded