minio-cms v0.12.2

Minio

Minio is an easy to use minimalistic sandbox project providing

• auth
• token
• model
• security

services with support for customize the special requirements. It's not just another CMS system. It's only a minimalistic bootstrapper providng possibility for customizations.

The main purpose is to providing convenient services in order to automate following features:

• auth management
• token management
• providing model mapping
• security management
• service connections

Getting Started

Installation

git clone https://github.com/AhmetCavus/Minio.git

or

git clone git@github.com:AhmetCavus/Minio.git

cd .\Minio

or

cd Minio

npm i

Configuration

You have to provide an env file '.env' in your project root folder. For securing the api and the socket connection, minio uses the JWT approach. To get more detail about JWT, you can dive into this link https://jwt.io/introduction. This file should contain following keys:

DB_URI=mongodb://user:pass@host:port/collection?authSource=admin
JWT_SECRET=do.not.read.it.is.jwt.secret
VERIFY_SIGNATURE=i.can.open.doors
CLIENT_ID=alone.i.am.useless
SECRET_ID=do.not.read.it.is.client.secret
SSL_KEY=e.g. /etc/domain-name/privkey.pem
SSL_CERT=e.g. /etc/domain-name/fullchain.pem
IS_HTTPS=true/false

Be aware of commiting this file in your repo!!!

Usage

const Minio = require("minio-cms")

const minio = new Minio.App()

minio.start().then(() => {
console.log("Minio is up and running")
})

minio.setting((app, express) => {
app.get("/", (req, res) => {
res.sendFile(\_\_dirname + "/public/index.html")
})
app.use("/todo", require("./routes/todo.route"))
})

For more information check the unit test project folder.

Options

In order to configurate the server and ports, you can specify following values on startup:

minio.start(options)

Accessing to collections

In order to access the collection provided in the models, you can simply call the code below

const device = minio.collection("device")
// device.model is the mongoose schema

After that, minio provides you convenient methods to notify observers

For every model schema in your models path, a collection will be created in the database. In addition, it will be supplied with bi-directional communication through sockets. You can get further detail in the API calls section.

Socket events

The table below lists all necessary events that are subscribable for getting or sending notifications.

You can also register more events regarding those from Socket.IO by invoking the method

minio.subscribeOn(event, channel, callback)

event = The name of the event as String
channel = The channel name as String
callback = The callback for retrieving data if exists

API calls

The OpenAPI Spec of Minio is provided here Minio.Spec

Creating models

For instructions of creating models, you can check the profile model

In order to create nested list, check following sample file: TodoModel

Starting the application

npm start

Playground

You can enter the playground by calling localhost:[Port] in your browser.

Tests

npm test

Requirements

Node:

• NodeJS >= 10.16 <=14
• NPM >= 6.x

Database:

• MongoDB >= 3.6

We recommend always using the latest version of minio to start your new projects.

Clients

• Dart / Flutter Minio.ClientDart
• Javascript In progress
• .Net C# In progress

Features

• Auth service
• Token service
• Auto db connection
• Model service
• Web socket support

License

See the LICENSE file for licensing information.