DEV Community: Naster Blue

Install and run Asgard CMS by docker stack

Naster Blue — Sat, 22 Feb 2020 13:04:28 +0000

Introduction

We will install and run Asgard CMS by docker stack :

NGINX web server
MYSQL database
REDIS cache

System Requirements

docker
docker-compose

Directory Structure

+ asgardcms-docker <root directory>
  + laradock <docker stack>

1.Build Docker stack

1.0.Working directory : /laradock <docker stack>

➜  asgardcms-docker cd laradock 
➜  laradock git:(master) ✗

1.1.Create .env

➜  laradock git:(master) ✗ cp env-example  .env

1.2.Then update mysql/nginx/redis configuration in .env

# Define the prefix of container names.
COMPOSE_PROJECT_NAME=asgardcms-laradock

# PHP version of the Workspace and PHP-FPM containers
# Accepted values: 7.4 - 7.3 - 7.2 - 7.1 - 7.0 - 5.6
PHP_VERSION=7.3

### MYSQL #####
MYSQL_VERSION=latest
MYSQL_DATABASE=asgardcms
MYSQL_USER=asgardcms
MYSQL_PASSWORD=asgardcms
MYSQL_PORT=3306
MYSQL_ROOT_PASSWORD=asgardcms

### REDIS #####
REDIS_PORT=6379

### NGINX #####
NGINX_HOST_HTTP_PORT=80
NGINX_HOST_HTTPS_PORT=443
NGINX_HOST_LOG_PATH=./logs/nginx/
NGINX_SITES_PATH=./nginx/sites/
NGINX_PHP_UPSTREAM_CONTAINER=php-fpm
NGINX_PHP_UPSTREAM_PORT=9000
NGINX_SSL_PATH=./nginx/ssl/

1.3.Run docker-compose

➜  laradock git:(master) ✗ docker-compose up -d nginx mysql redis laravel-horizon

1.4.Verify all done

➜  laradock git:(master) ✗ docker ps
CONTAINER ID        IMAGE                                COMMAND                  CREATED             STATUS              PORTS                                 NAMES
acfe204292b1        asgardcms-laradock_nginx             "/bin/bash /opt/star…"   28 minutes ago      Up 28 minutes       81/tcp, 0.0.0.0:80->80/tcp, 443/tcp   asgardcms-laradock_nginx_1
6bbdcadef86b        asgardcms-laradock_php-fpm           "docker-php-entrypoi…"   28 minutes ago      Up 28 minutes       9000/tcp                              asgardcms-laradock_php-fpm_1
6848c2af2394        asgardcms-laradock_laravel-horizon   "/usr/bin/supervisor…"   28 minutes ago      Up 28 minutes                                             asgardcms-laradock_laravel-horizon_1
e2cdbc9b3784        asgardcms-laradock_workspace         "/sbin/my_init"          28 minutes ago      Up 28 minutes                                             asgardcms-laradock_workspace_1
f8373d74d46a        asgardcms-laradock_mysql             "docker-entrypoint.s…"   28 minutes ago      Up 28 minutes       0.0.0.0:3306->3306/tcp, 33060/tcp     asgardcms-laradock_mysql_1
ab08ba38616f        asgardcms-laradock_redis             "docker-entrypoint.s…"   28 minutes ago      Up 28 minutes       0.0.0.0:6379->6379/tcp                asgardcms-laradock_redis_1
23868938380e        docker:19.03-dind                    "dockerd-entrypoint.…"   28 minutes ago      Up 28 minutes       2375-2376/tcp                         asgardcms-laradock_docker-in-docker_1

2.Install and run Asgard CMS

2.0.Working directory : asgardcms-docker <root directory>

➜  asgardcms-docker docker ps
CONTAINER ID        IMAGE                                COMMAND                  CREATED             STATUS              PORTS                                 NAMES
acfe204292b1        asgardcms-laradock_nginx             "/bin/bash /opt/star…"   28 minutes ago      Up 28 minutes       81/tcp, 0.0.0.0:80->80/tcp, 443/tcp   asgardcms-laradock_nginx_1
6bbdcadef86b        asgardcms-laradock_php-fpm           "docker-php-entrypoi…"   28 minutes ago      Up 28 minutes       9000/tcp                              asgardcms-laradock_php-fpm_1
6848c2af2394        asgardcms-laradock_laravel-horizon   "/usr/bin/supervisor…"   28 minutes ago      Up 28 minutes                                             asgardcms-laradock_laravel-horizon_1
e2cdbc9b3784        asgardcms-laradock_workspace         "/sbin/my_init"          28 minutes ago      Up 28 minutes                                             asgardcms-laradock_workspace_1
f8373d74d46a        asgardcms-laradock_mysql             "docker-entrypoint.s…"   28 minutes ago      Up 28 minutes       0.0.0.0:3306->3306/tcp, 33060/tcp     asgardcms-laradock_mysql_1
ab08ba38616f        asgardcms-laradock_redis             "docker-entrypoint.s…"   28 minutes ago      Up 28 minutes       0.0.0.0:6379->6379/tcp                asgardcms-laradock_redis_1
23868938380e        docker:19.03-dind                    "dockerd-entrypoint.…"   28 minutes ago      Up 28 minutes       2375-2376/tcp                         asgardcms-laradock_docker-in-docker_1

2.1.Enter the Workspace container, to execute commands

➜  asgardcms-docker docker exec  -it e2cdbc9b3784 bash
root@e2cdbc9b3784:/var/www#

2.2.Install the Asgard CMS

➜  asgardcms-docker docker exec  -it e2cdbc9b3784 bash
root@e2cdbc9b3784:/var/www# php artisan asgard:install

  Welcome!                              
  Starting the installation process...  

Successfully created .env file

 Enter your database driver (e.g. mysql, pgsql) [mysql]:
 > mysql

 Enter your database host [127.0.0.1]:
 > mysql

 Enter your database port [3306]:
 > 3306

 Enter your database name [homestead]:
 > asgardcms

 Enter your database username [homestead]:
 > asgardcms

 Enter your database password (leave <none> for no password) [secret]:
 > asgardcms

Database successfully configured

 Enter you application url (e.g. http://localhost, http://dev.example.com) [http://localhost]:
 > http://localhost


  User Module                        
  Starting the User Module setup...  


 Enter your first name:
 > naster

 Enter your last name:
 > blue

 Enter your email address:
 > taipv.uit@gmail.com

 Enter a password:
 > 

 Please confirm your password:
 > 

Please wait while the admin account is configured...
The application is now installed
Platform ready! You can now login with your username and password at /backend

2.3 Configuration file .env need to be update too
From

REDIS_HOST=127.0.0.1

REDIS_HOST=redis

2.3 Open your browser and visit your localhost address. Happy hacking!

Implement Repository Design Pattern in Laravel

Naster Blue — Wed, 04 Dec 2019 18:39:39 +0000

# The Repository Pattern

Use case

We have Post resource
Need to implement controller to support APIs for these features :

Get all posts
Paginate posts
Find posts with condition
Find post by id
Caching APIs to improve performance

Preparation

Post model (database driver can be MySQL/ PostgreSQL/ SQLite/ SQL Server)

<?php  

namespace App;  

use Illuminate\Database\Eloquent\Model;  

class Post extends Model  
{  
  protected $table = 'posts';  
}

Contract

<?php

namespace App\Http\Contracts;

interface RepositoryInterface
{
    /**
     * Retrieve all data of repository
     *
     * @param array $columns
     *
     * @return mixed
     */
    public function all($columns = ['*']);

    /**
     * Retrieve all data of repository, paginated
     *
     * @param null $limit
     * @param array $columns
     *
     * @return mixed
     */
    public function paginate($limit = null, $columns = ['*']);

    /**
     * Find data by multiple fields
     *
     * @param array $where
     * @param array $columns
     *
     * @return mixed
     */
    public function findWhere(array $where, $columns = ['*']);

    /**
     * Find data by id
     *
     * @param       $id
     * @param array $columns
     *
     * @return mixed
     */
    public function find($id, $columns = ['*']);

}

Implementation Details

Newbie/Beginner/Fresher/Intern level

<?php

namespace App\Http\Controllers;

use App\Http\Contracts\RepositoryInterface;
use App\Post;

class PostController extends Controller  implements RepositoryInterface
{
    protected $post;

    public function __construct(Post $post)
    {
        $this->post = $post;
    }

    public function all($columns = ['*'])
    {
        return $this->post->all($columns);
    }

    public function paginate($limit = null, $columns = ['*'])
    {
        return $this->post->paginate($limit, $columns);
    }

    public function find($id, $columns = ['*'])
    {
        return $this->post->find($id, $columns);
    }

    public function findWhere(array $where, $columns = ['*'])
    {
        foreach ($where as $field => $value) {
            if (is_array($value)) {
                list($field, $condition, $val) = $value;
                $this->post = $this->post->where($field, $condition, $val);
            } else {
                $this->post = $this->post->where($field, '=', $value);
            }
        }
        return $this->post->get($columns);
    }
}

Database Repository/ Junior Level

<?php

namespace App\Http\Controllers;

use App\Http\Contracts\RepositoryInterface;
use App\Post;

class DbPostRepository implements RepositoryInterface
{
    private $post;

    public function __construct(Post $post)
    {
        $this->post = $post;
    }

    public function all($columns = ['*'])
    {
        return $this->post->all($columns);
    }

    public function paginate($limit = null, $columns = ['*'])
    {
        return $this->post->paginate($limit, $columns);
    }

    public function findWhere(array $where, $columns = ['*'])
    {
        foreach ($where as $field => $value) {
            if (is_array($value)) {
                list($field, $condition, $val) = $value;
                $this->model = $this->post->where($field, $condition, $val);
            } else {
                $this->model = $this->post->where($field, '=', $value);
            }
        }
        return $this->post->get($columns);
    }

    public function find($id, $columns = ['*'])
    {
        return $this->post->find($id, $columns);
    }
}

class DbPostController extends Controller
{
    private $dbPostRepository;

    public function __construct(DbPostRepository $dbPostRepository)
    {
        $this->dbPostRepository = $dbPostRepository;
    }

    public function all($columns = ['*'])
    {
        return $this->dbPostRepository->all($columns);
    }

    public function paginate($limit = null, $columns = ['*'])
    {
        return $this->dbPostRepository->paginate($limit, $columns);
    }

    public function findWhere(array $where, $columns = ['*'])
    {
        return $this->dbPostRepository->findWhere($where, $columns);
    }

    public function find($id, $columns = ['*'])
    {
        return $this->dbPostRepository->find($id, $columns);
    }
}

Caching Repository/ Senior Level

<?php

namespace App\Http\Controllers;

use App\Http\Contracts\RepositoryInterface;
use Illuminate\Contracts\Cache\Repository as CacheRepository;

class CachePostRepository implements RepositoryInterface
{
    private $dbPostRepository;
    private $cacheRepository;

    public function __construct(DbPostRepository $dbPostRepository, CacheRepository $cacheRepository)
    {
        $this->dbPostRepository = $dbPostRepository;
        $this->cacheRepository = $cacheRepository;
    }

    public function getCacheMinutes()
    {
        return config('repository.cache.minutes', 30);
    }

    public function getCacheKey($method, $args = null)
    {
        $request = app('Illuminate\Http\Request');
        $args = serialize($args);
        $criteria = $this->serializeCriteria();
        $key = sprintf('%s@%s-%s', get_called_class(), $method, md5($args . $criteria . $request->fullUrl()));
        return $key;
    }

    public function all($columns = ['*'])
    {
        $key = $this->getCacheKey('all', func_get_args());
        $minutes = $this->getCacheMinutes();
        return $this->cacheRepository->remember($key, $minutes, function () use ($columns) {
            return $this->dbPostRepository->all($columns);
        });
    }

    public function paginate($limit = null, $columns = ['*'])
    {
        $key = $this->getCacheKey('paginate', func_get_args());
        $minutes = $this->getCacheMinutes();
        return $this->cacheRepository->remember($key, $minutes, function () use ($limit, $columns) {
            return $this->dbPostRepository->paginate($limit, $columns);
        });
    }


    public function findWhere(array $where, $columns = ['*'])
    {
        $key = $this->getCacheKey('findWhere', func_get_args());
        $minutes = $this->getCacheMinutes();
        return $this->cacheRepository->remember($key, $minutes, function () use ($where, $columns) {
            return $this->dbPostRepository->findWhere($where, $columns);
        });
    }

    public function find($id, $columns = ['*'])
    {
        $key = $this->getCacheKey('find', func_get_args());
        $minutes = $this->getCacheMinutes();
        return $this->cacheRepository->remember($key, $minutes, function () use ($columns) {
            return $this->dbPostRepository->all($columns);
        });
    }
}

class CachePostController extends Controller
{
    private $cachePostRepository;

    public function __construct(CachePostRepository $cachePostRepository)
    {
        $this->cachePostRepository = $cachePostRepository;
    }

    public function all($columns = ['*'])
    {
        return $this->cachePostRepository->all($columns);
    }

    public function paginate($limit = null, $columns = ['*'])
    {
        return $this->cachePostRepository->paginate($limit, $columns);
    }

    public function findWhere(array $where, $columns = ['*'])
    {
        return $this->cachePostRepository->findWhere($where, $columns);
    }

    public function find($id, $columns = ['*'])
    {
        return $this->cachePostRepository->find($id, $columns);
    }
}

Nhân Sinh Như Mộng

Naster Blue — Tue, 03 Dec 2019 16:05:48 +0000

Một nhà doanh nghiệp rất nổi tiếng, cứ cách một đoạn thời gian, ông lại dẫn theo vợ con đến nơi hỏa táng để xem. Có người không hiểu, hỏi ông nguyên do. Ông nói rằng, chỉ cần đến nơi hỏa táng, cái tâm nóng nảy sẽ rất mau chóng an tĩnh lại, thấy danh lợi tiền tài thật nhẹ nhàng. Ở nơi hỏa táng này, không kể bạn là quan to quý tộc quyền cao chức trọng, uy danh hiển hách hay là một người dân bình thường, nghèo rớt mồng tơi, không ai biết đến, cuối cùng đều sẽ phải đến đây, chung một tư thế, lặng yên nằm xuống, sau đó bị đưa vào bên trong lò hỏa táng đang bốc cháy ngùn ngụt, khi trở ra lần nữa, thì chỉ là một chiếc hộp vuông nho nhỏ được bọc trong tấm vải đỏ.

Khi đến chẳng mang theo thứ gì, khi đi chỉ như một làn khói. Đời người chính là đơn giản như vậy! Vinh hoa phú quý phút chốc thoáng qua, ân ái tình thù cũng chỉ như cát bụi. Hôm nay sống trong một thế giới vật chất dục vọng tràn lan, bên cạnh chúng ta là đầy những cám dỗ mê hoặc: quyền lực, địa vị, tiền bạc, mỹ sắc.., hễ không cẩn thận, thì trong tâm sẽ dậy sóng. Nội tâm chúng ta vốn dĩ trong sáng, thuần tịnh, bình lặng sẽ trở nên ngông cuồng, ngạo mạn và tư lợi.

Khi bạn cảm thấy hiện thực và lý tưởng có sự chênh lệch,
Khi bạn cảm thấy uất ức thương tâm, không có người hiểu bạn,
Khi bạn vì ân oán tình thù mà canh cánh trong lòng,
Khi bạn vì lợi ích được mất mà so đo tính toán,
Khi bạn khom lưng chau mày đối với quyền thế,
Khi bạn vì địa vị cao thấp mà mưu tính hại nhau…

Sao bạn không đi đến nơi hỏa táng xem thử, đối diện với một nắm tro bụi, bạn còn có gì không buông xuống được đây?
Đời người tựa như một giấc mộng! Tuyệt đối đừng nói rằng bạn có tiền..!!??

Đã biết chốn ni là quán trọ
Hơn, thua, hờn oán.. để mà chi!
Thử ra ngồi xuống bên phần mộ
Hỏi họ mang theo được những gì..

Chốn ấy trăm năm ngỡ tít mờ
Đâu ngờ ập đến tựa cơn mơ.
Sống Thương và Hiểu từng giây phút
Ngay kiếp mong manh gặp bến bờ..
Như Nhiên

Sống Với Nhau

Lần nọ một người hỏi đất
Đất sống với nhau thế nào?
Chúng tôi bao hàm, chấp nhận
Tô bồi, xây đắp cho nhau.

Lần kia người hỏi rừng cây
Cây sống làm sao với bạn?
Chúng tôi vui mọc sum vầy
Chở che nhau, cùng hoạn nạn...

Người hỏi mây trời phiêu lãng
Thế nào bay lượn cùng nhau?
Chúng tôi lòng không giới hạn
Tan vào nhau thuở ban đầu!

Rồi người hỏi thầm lá cỏ
Chung sống bạn bè ra sao?
Mặt đất đan xen, nương tựa
Chia từng sương nắng... gửi, trao.

Hỏi dòng sông xuôi năm tháng
Thế nào nước nhịp nhàng trôi?
Chúng tôi quyện hòa nhau chảy
Dù khi sóng dập gió dồi…

Rồi người gạn hỏi từng người
Với nhau, thế nào ta sống?
Không ai một tiếng trả lời
Những pho tượng cười… di động.

Đời còn dẫm nhau mà sống
Người còn nặng những niềm riêng…
Vì ngỡ kiếp đời miên viễn
Tình Người, đạo đức xô nghiêng…

Người về thương người nhỏ lệ
Cúi mình lạy khắp thiên nhiên…

Như Nhiên - Thích Tánh Tuệ
(phóng tác)

Materialized View trong DBMS là gì ?

Naster Blue — Wed, 06 Nov 2019 17:13:40 +0000

Phong, một developer tại công ty BSS. Nhân, là nhân viên kế toán cùng công ty.

Một ngày nọ thấy Nhân đang rảnh rỗi không có chuyện gì làm, Phong lấy hết can đảm của mình tới nhờ Nhân hỗ trợ tìm những giấy tờ có liên quan tới Phong bao gồm : bảng lương, bảo hiểm y tế & xã hội, sở hưu cơ sở vật chất được công ty cấp cho nhu cầu công việc MacBook Pro 2019, nhu cầu đi lại xe Mercedes S450, hoá đơn tiền xăng dầu,...

Nhân trên danh nghĩa là người tiếp nhận cũng như tạo ra những loại giấy tờ kể trên để tổng hợp và cất giữ vào kho hồ sơ ở nhiều nơi. Đồng thời cũng là người sẽ phải tính toán và phân tích số liệu để đưa ra dự báo về tình hình phát triển của công ty. Nhân phải mất thời gian trung bình khoảng 5 ngày để giải quyết yêu cầu của Phong.

Vấn đề làm sao để cải thiện hiệu năng làm việc và đáp ứng yêu cầu trả lời nhanh hơn hiện tại mà Nhân đang làm?

Hệ quản trị cơ sở dữ liệu (DBMS)

Database Table

Là nơi lưu trữ data từ nhiều nguồn.
Data lưu trữ dạng vật lý.
Khi có nhu cầu tra cứu thông tin đã từng lưu trữ thì thông tin cũng được trích xuất ra từ những table này.

Database View (DV)

Đây là cách mà Nhân kế toán của BSS đang làm, Nhân phải lục lại tủ hồ sơ ở nhiều nơi để phân loại và tìm kiếm hồ sơ của Phong.
DV là 1 use case hỗ trợ cho việc tra cứu trích xuất thông tin đơn giản hơn table .
DV được định nghĩa bởi 1 câu lệnh base SQL những logic structure của những tables sẽ trả về data (tuỳ vào số lượng tables được join và số lượng các điều kiện tham gia vào mà câu lệnh SQL này trở thành đơn giản hoặc phức tạp)
Tạo 1 DV :

   CREATE VIEW documents_of_employee_phong_dv AS
    SELECT documents.*, document_histories.*, 
    FROM documents, document_histories, employees
    WHERE documents.userId = employees.id AND documents.id = document_histories.documentId AND employees.id = 1; // 1 là id của Phong

Sử dụng DV:

   SELECT * FROM documents_of_employee_phong_dv

Thực ra câu lệnh SQL thực hiện bên dưới DBMS là :

   SELECT * FROM (
     SELECT documents.*, document_histories.*, 
     FROM documents, document_histories, employees
     WHERE documents.userId = employees.id AND documents.id = document_histories.documentId AND employees.id = 1;
   )

DV không lưu trữ data, DV là 1 table ảo, chỉ cần quan tâm đến câu lệnh SQL. Nên khi trích xuất thông tin từ DV thực chất ra là đang chạy lại những câu lệnh base SQL ở trên.
Câu lệnh base SQL đơn giản (join 1 table) thì DV đơn giản và ngược lại câu lệnh base SQL phức tạp (join nhiều table, nhiều điều kiện tham gia) thì DV phức tạp.

Materialized View (MV)

Giống với DV là MV được định nghĩa bằng 1 câu lệnh base SQL
Nhưng khác với cách lưu data của DV. MV lưu data dạng vật lý. Data được lưu là kết quả trả về từ câu lệnh base SQL.
Tạo 1 DV :

   CREATE MATERIALIZED  VIEW documents_of_employee_phong_mv AS
    SELECT documents.*, document_histories.*, 
    FROM documents, document_histories, employees
    WHERE documents.userId = employees.id AND documents.id = document_histories.documentId AND employees.id = 1; // 1 là id của Phong

Tốc độ trích xuất thông tin từ MV nhanh hơn gấp nhiều lần so với DV vì data đang được lưu tương tự như database table đồng thời không tốn thời gian chạy lại câu lệnh base SQL . Trích xuất data trực tiếp vào table không thông qua câu lệnh base SQL.
Nhân có thể tăng hiệu năng làm việc và cung cấp các giấy tờ cho Phong nhanh hơn từ 5 ngày xuống còn 1/2 ngày bằng cách mỗi lần khi nhận giấy tờ từ Phong thì Nhân nên đặt tất cả giấy tờ đó vào 1 túi hồ sơ dán tên Phong. Giờ đây khi có bất cứ khi nào Phong nhờ vã cung cấp hồ sơ giấy tờ thì Nhân đều có thể tự tin hỗ trợ Phong ngay lập tức. Còn nhờ vã những chuyện ngoài khả năng như đi chơi, ăn uống thì khó quá nên bỏ qua.
MV mang lại hiệu năng cao như vậy nhưng gặp phải vấn đề là vấn đề đồng bộ data mới nhất. Một lần nọ, Nhân đang bận đầu tắt mặt tối cả ngày thì Phong đưa hoá đơn tiền xăng xe cho Nhân nhưng sau đó Nhân để đâu quên mất và không cất vào túi hồ sơ của Phong. Nên hoá đơn này chắc chắn sau này sẽ không bao giờ đến được tay của Phong. Tốt nhất nếu Nhân quá bận rộn công việc thì nên cài đặt nhắc nhở trên điện thoại bổ sung túi hồ sơ của Phong sau đó.
MV cũng có cơ chế tương tự để đồng bộ hoá data mới nhất như vậy nhưng cách tiếp cận theo 2 hướng:
- BASIC REFRESH
  - DBMS cần thực hiện câu lệnh REFRESH MV để update data mới nhất (ví dụ như sau khi có data mới, data bị xoá hoặc có chỉnh sửa data sẽ ảnh hưởng với kết quả sai khác trả về trước đó). BASIC REFRESH sẽ READ LOCKING tất cả truy xuất tới MV khi đang trong quá trình thực hiện update data (để ngăn ngừa truy xuất ra thông tin cũ rích, sai khác dẫn đến ảnh hưởng gây ra hậu quả nghiêm trọng cho người dùng lẫn hệ thống).
```
  REFRESH MATERIALIZE VIEW documents_of_employee_phong_mv;
```
- CONCURRENTLY REFRESH
  - Trong một số trường hợp data không bị quá đòi hỏi khắc khe phải trả về kết quả cập nhật mới nhất, nên có thể trả về data đang trong quá trình tiền xử lý, data trong suốt với người dùng ví dụ như thông tin về tên/thông số sản phẩm trên ecommerce không nên để client ngồi chờ cả vài phút để chờ thực hiện xong lệnh update mới coi được. CONCURRENTLY REFRESH dùng để giải quyết READ LOCKING.
```
  CREATE UNIQUE INDEX documents_employee_ix ON documents_of_employee_phong_mv (document_id);
  REFRESH MATERIALIZED VIEW CONCURRENTLY documents_of_employee_phong_mv;
```

JSON Web Tokens (JWT) là gì ?

Naster Blue — Thu, 31 Oct 2019 19:11:05 +0000

Chúng ta đều biết thủ tục chung để xác thực user trong ứng dụng của mình. Đó là phương pháp đăng ký user với thông tin cơ bản như email, password. Tại thời điểm user đăng nhập ứng dụng, hệ thống sẽ kiểm tra trùng khớp email, password đã cho với dữ liệu được lưu trước đó. Nếu phù hợp thì cho user truy cập, nếu không thì chặn user lại.

Chúng ta cũng biết thủ tục phân quyền user trong một ứng dụng. Đó là user bình thường chỉ được truy cập tính năng cơ bản (user xài free), những chức năng nâng cao chỉ giành cho những premium user (user chấp nhận thực hiện thanh toán tiền), admin user có quyền truy cập quản lý dashboard, sale admin có thể truy cập để xem thống kê và xuất ra file excel report theo tháng/ năm, ...

Luồng cơ bản của xác thực dựa trên token (Stateful Token):

User nhập email/password trong form đăng nhập và gởi lên server.
Server xác minh email/password này là chính xác sẽ tạo ra 1 unique token đồng thời lưu vào database. Sau đó server sẽ trả về cho user 1 token có chứa một số thông tin dưới dạng json như user_id, role, permission.
Token này sẽ được lưu trữ phía user (cookie).
Các request APIs tiếp theo đến server sẽ phải đính kèm token này vào header hoặc body của request.Server sẽ query database để kiểm tra nếu token này hợp lệ sẽ tiếp tục xử lý request.

Client side :

$.ajax({
    type: 'POST',
    url: url,
    headers: {
        "Authorization":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"
    }

}).done(function(data) { 
    //
});

Server side

use Closure;

class CheckUserRolePermissions
{
    /**
     * Handle the incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @param  string  $role
     * @return mixed
     */
    public function handle($request, Closure $next, $role, $permission)
    {
        $token = $request>headers['Authorization'];
        $currentUser = User::findByToken($token);
        if($currentUser){
          // query database lấy ra những role của user này 
          if (! $currentUser->hasRole($role)) {
            // Redirect...
          }
          // query database lấy ra những permissions của user này 
          if (! $currentUser->hasPermissions($permission)) {
            // Redirect...
          }
          return $next($request);
        }
         // Redirect...

    }

}

Khi user logout, token bị hủy ở phía user và server sẽ xoá token này ra khỏi database.

Nhưng thời gian luôn trôi qua nhanh cùng với rất phương thức xác thực và phân quyền khác cũng được ra đời. Ứng dụng liên tục mở rộng thêm chức năng mới và ngày càng phình to trở thành siêu ứng dụng. Đồng thời số lượng user cũng tăng lên đột biến. Để đảm bảo trải nghiệm tốt cho user thì hệ thống buộc phải scale up theo chiều ngang (horizontal scale) hết cỡ có thể. Từ một hệ thống duy nhất có kiến trúc đơn khối (Monolithic) nên được chia ra thành những hệ thống con (vật lý) đơn nhiệm (chỉ thực hiện đúng 1 loại nhiệm vụ chức năng). Kiến trúc hệ thống cũ chuyển sang kiến trúc hướng dịch vụ (Microservices):

Mỗi service (đơn nhiệm) phải tự xác thực và phân quyền cho chính mình. Nếu clone source code xác thực và phân quyền từ hệ thống cũ sang từng service để tái sử dụng lại sẽ khiến việc maintain khi có bất cứ thay đổi gì trở nên tốn thời gian và phức tạp.
Mỗi service (đơn nhiệm) nên chỉ thực hiện đúng 1 loại nhiệm vụ chức năng của cuộc đời nó, không nên làm mất tập trung sang những việc không phải nhiệm vụ chức năng của nó là xác thực và phân quyền.
Kiến trúc Microservices khiến các service cần phải communicate với nhau, các request tới các service cũng tăng lên để lấy đủ dữ liệu từ nhiều service (ví dụ : sau khi add product vào cart thì khi tạo order sẽ cần request sang customer service lấy thông tin credit của customer có còn đủ để place order hay không, có thể request sang inventory service để kiểm tra còn hàng hay không, ... ). Nếu tiếp tục sử dụng cách xác thực, phân quyền theo Stateful Token sẽ làm performance thấp đi đáng kể, low latency (do query database để kiểm tra token quá nhiều lần).

JSON Web Tokens (JWT) là 1 loại Stateless token, có những ưu điểm vượt trội hơn Stateful token và thích hợp hơn khi áp dụng cho xác thực và phân quyền kiến trúc Microserives :

Token không lưu vào database.
Không cần query database kiểm tra chi đỡ tốn thời gian và resource.
JWT đảm bảo xác thực, phân quyền tốt cho cả users-to-services, services-to-services.

JWT được bảo vệ và đảm bảo tính toàn vẹn dữ liệu bằng chữ ký số (Digitally Signed). Chữ ký số (Digitally Signed) được mã hoá bằng hệ mã hoá đối xứng HMAC hoặc bất đối xứng RSA.

HMAC là hệ mã hoá đối xứng (Symmetric cryptography) : ví dụ 1 ổ khoá luôn có ít nhất 2 chìa khoá để backup lại phòng khi mất. Sau khi khoá cửa căn nhà lại thì ai có chìa khoá đều có thể mở cửa căn nhà ra lại. Hệ mã hoá và giải mã dùng chung 1 private key. Private key bị share ra cả client/server nên dễ bị lộ dẫn đến kém bảo mật.
RSA là hệ mã hoá bất đối xứng (Asymmetric cryptography): ví dụ Nhân gởi 1 bức thư tay thông qua đường bưu điện tới nhà Phong. Nhân viên bưu điện sẽ mang bức thư tay tới tận địa chỉ nhà được ghi trên thư để xác nhận và giao cho đúng người nhận là Phong. Hệ mã hoá bất đối xứng cần public key (public cho mọi người đều biết) để mã hoá, người nhận cần private key (giữ bí mật không nên để lộ) để giải mã. Hệ mã hoá bất đối xứng dùng để kiểm tra tính toàn vẹn của dữ liệu không bị thay đổi/giả mạo. Địa chỉ Phong có thể được xem là public key, và để xác nhận là Phong thì giấy chứng minh nhân dân có thể được xem là private key. Private key được lưu trên server dùng để giải mã. Bảo mật cao hơn. RSA là hệ mã hoá thích hợp dùng cho chữ ký số (Digitally Signed) do vấn đề tính bảo mật tốt hơn.

Chữ ký số (Digitally Signed): vai trò private key và public key trong RSA bị đảo ngược. Để tạo chữ ký số thì sẽ dùng private key, người nhận sẽ dùng public key để giải mã chữ ký số đó và xác thực xem chữ ký số có toàn vẹn không bị thay đổi/ giả mạo. Làm bằng cách nào ?

Trong chữ chữ ký số đã mã hoá có chuỗi hash đính kèm (encrypted hash)
Người nhận dùng public key để giải mã, sau khi có thông tin đã giải mã thì người nhận tiến hành dùng hàm hash để tính toán lại chuỗi hash gốc (original hash), sau đó so sánh chuỗi với (encrypted hash) xem có trùng khớp nhau không để biết là dữ liệu vẫn đảm bảo tính toàn vẹn hoặc đã bị thay đổi/ giả mạo.

3 thành phần của JWT:

JWT có format : xxxxx.yyyyy.zzzzz
Header : các thông tin về thuật toán signing, type của payload (JWT).
Payload : các dữ liệu thực tế trong JSON format (user info, roles, permissions)
Signature : chữ kí

Xem thêm về [3 thành phần của JWT ][https://jwt.io/introduction/]

Luồng cơ bản của xác thực dựa trên JWT (Stateless Token):

User nhập email/password trong form đăng nhập và gởi lên server.
Server xác minh email/password này là chính xác sẽ tạo ra 1 JWT không lưu lại vào bất cứ đâu. Trong Payload của JWT có chưa JSON format (user info, roles, permissions). Server trả JWT này về cho user.
Token này sẽ được lưu trữ phía user (cookie).
Các request APIs tiếp theo đến các services sẽ phải đính kèm token này vào header hoặc body của request. Services tiếp nhận request sẽ dùng public key (khoá công khai ) để giải mã token , kiểm tra token này hợp lệ sẽ tiếp tục xử lý request.

Client side :

$.ajax({
    type: 'POST',
    url: url,
    headers: {
        "Authorization":"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJ5b3VyLWFwaS1rZXkiLCJqdGkiOiIwLjQ3MzYyOTQ0NjIzNDU1NDA1IiwiaWF0IjoxNDQ3MjczMDk2LCJleHAiOjE0NDcyNzMxNTZ9.fQGPSV85QPhbNmuu86CIgZiluKBvZKd-NmzM6vo11DM"
    }

}).done(function(data) { 
    //
});

Server side

use Closure;

class CheckUserRolePermissions
{
    /**
     * Handle the incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @param  string  $role
     * @return mixed
     */
    public function handle($request, Closure $next, $role, $permission)
    {
        $token = $request>headers['Authorization'];
        $userRolePermission = JWT::decode($token); 
        // kiểm tra tính toàn vẹn dữ liệu bằng cách dùng khoá công khai giả mã, dùng hàm hash tạo ra chuổi hash từ JWT vừa nhận đồng thời kiểm tra chuổi hash sau khi giải mã có giống với chuổi hash trong JWT vừa nhận.
        // $userRolePermission : {user : object, userRoles: object[], userPermissions: object[]}
        $currentUser =  $userRolePermission->user;
        $userRoles =  $userRolePermission->userRoles;
        $userPermissions =  $userRolePermission->userPermissions;
        if($currentUser){
          // check user roles và permissions
          return $next($request);
        }
         // Redirect...

    }

}

Khi user logout, token bị hủy ở phía user

CQRS - là gì

Naster Blue — Mon, 21 Oct 2019 18:08:24 +0000

Con người bắt đầu lưu trữ dữ liệu từ xưa bằng viết lên giấy đóng lại thành sách, sách có thể được viết lại cập nhật thêm và truyền từ đời này sang đời khác cho con cháu. Cùng với sự phát triển của công nghệ về sau thì dữ liệu được lưu trữ thành tệp, rồi bằng cơ sở dữ liệu bằng các hệ quản lý cơ sở dữ liệu như MySql, SqlServer, PostgreSQL, MongoDB, ...

Bốn chức năng cơ bản mà một hệ quản trị cơ sở dữ liệu cần phải đảm đảo là C(Create : tạo mới) - R(Retrieve : đọc) - U(Update : cập nhật) - D(Delete : xoá). Có thể nhóm 4 chức năng cơ bản này lại thành 2 nhóm chức năng chính :

Query Model - Nhóm chỉ thao tác đọc dữ liệu, cần có kết quả trả về.
Command Model - Nhóm chỉ thao tác làm thay đổi dữ liệu, không cần trả về kết quả.

Đối với các ứng dụng quản lý truyền thống thì 2 nhóm này thuộc cùng một tập hợp các model để thao tác đọc và làm thay đổi dữ liệu.

Ứng dụng quản lý sơ khai ban đầu do có ít người dùng nên dữ liệu lưu và truy cập rất ít nên hệ thống hoạt động không gặp vấn đề gì.
Qua một thời gian sản phẩm được công chúng biết đến, công ty quyết định đưa đưa ứng dụng này ra thế giới khiến lượng truy cập tăng lên đột biến server phải chịu tải cả triệu request đồng đời, cùng với khối lượng dữ liệu người dùng tăng lên chóng mặt cả vài trăm Terabyte data mỗi ngày khiến cho hệ thống hiện tại trở nên quá chậm chạp và không đáp ứng được lượng yêu cầu truy cập.

CQRS là viết tắt của Command Query Responsibility Segregation. Tách biệt hẳn 2 nhóm Query và Command Model về mặt vật lý.

Command
- Tối ưu hoá cho thao tác thay đổi dữ liệu.
- Chỉ xài các truy vấn đơn giản.
- Command model vẫn lưu trong DBMS cùng các khoá quan hệ giữa các bảng.
- Tính Consistency trong ACID (Atomicity, Consistency, Isolation, Durability) phải được hạ thấp và đánh đổi.
- Tập trung xử lý business logic trong Bounded Context.
Query
- Tối ưu hoá cho thao tác đọc dữ liệu.
- Xài cho các truy vấn cực kỳ phức tạp.
- Query model có thể lưu trong GraphQL, Cached (Redis), Materialized View (Oracle, PostgreSQL, SQL Server), MongoDB, Elastic, ... hỗ trợ query nhanh, tăng tốc độ đọc nhanh đến chóng mặt.
- Đồng bộ data cho Query Model sẽ có độ trễ hơn so với Command Model data (Eventual Consistency) thông qua message queue.

DDD - Bounded Context là gì ?

Naster Blue — Mon, 21 Oct 2019 12:47:26 +0000

Bounded Context (BC) là gì?

BC là một trong những nguyên tắc DDD khó giải thích nhất, nhưng có lẽ nó là quan trọng nhất, bởi vì sẽ không thể làm DDD mà không có BC. Vì vậy, phải hiểu cách xác định BC trước khi thực sự tìm hiểu đến với Aggregate Roots, Aggregates, Entities and Value Objects.

Một Context mang ý nghĩa là một phòng ban trong một công ty sẽ đảm nhận một trách nhiệm cụ thể.

Bộ phận kinh doanh sẽ hỗ trợ thương mại, tác nghiệp kinh doanh.
Bộ phận R&D sẽ chịu trách nhiệm nghiên cứu phát triển sản phẩm mới, nghiên cứu gia tăng tính năng, chất lượng sản phẩm hiện hữu, xây dựng và triển khai các dự án kinh doanh, công trình, sản xuất,...

Phong, một developer tại công ty BSS. Phong làm việc trong bộ phận CNTT.
Bộ phận CNTT là một BC . Nó có trách nhiệm xử lý mọi thứ liên quan đến CNTT trong công ty.
Nhân, một kế toán tại cùng công ty. Nhân làm việc trong phòng Kế toán. Bộ phận kế toán xử lý mọi thứ liên quan đến kế toán, bao gồm cả bảng lương.
Cả hai đều có trách nhiệm rất chính xác và ranh giới của họ là khá rõ ràng.

Về thực tế 2 người họ ở các văn phòng khác nhau. Họ có tổ chức nội bộ của riêng họ, quy tắc nội bộ của riêng họ, nhân viên, v.v.

Phong không vào văn phòng của Nhân để sửa đổi bảng lương tăng lên x2, thưởng x4.
Nhân không đến chỗ làm việc của Phong để sửa đổi code của Phong cho sai logic.

2 người họ có thể làm những điều trên nhưng đó sẽ gây ảnh hưởng và dẫn đến hậu quả nghiêm trọng. Nếu Nhân tìm thấy một lỗi trong phần mềm kế toán (được phát triển nội bộ), Nhân nên gọi cho bộ phận CNTT để xử lý nó. Phong muốn tăng lương nên thương lượng lại lương với giám đốc công ty.

Nhân không thể cài đặt PhpStorm và bắt đầu code Laravel (là một framework PHP hiện đại, design pattern xịn, code rất là đẹp). Đó không phải là trách nhiệm của Nhân và Nhân không biết làm thế nào để làm điều đó, ngay cả khi Nhân biết rằng PhpStorm (IDE rất tốt cho PHP developer) là chương trình được Phong hay sử dụng để viết code. Trên thực tế, PhpStorm sẽ là một phần mềm rất lạ trên máy tính của kế toán viên. Tương tự thì các tập tin về bảng lương, biên chế hoặc hóa đơn cũng không có trong bộ phận CNTT.
Nhưng tất nhiên, khi Phong gặp vấn đề liên quan đến bảng lương, Phong có thể yêu cầu Nhân xem xét nó. Cả hai đều tôn trọng ranh giới của nhau và hành động theo trách nhiệm của họ. Nhưng bộ phận CNTT tự tổ chức thành 2 nhóm: nhóm phát triển phần mềm và nhóm quản trị.
Nhóm đầu tiên thực hiện các tính năng và sửa lỗi (Developer: Đa số là sinh viên vừa ra trường, làm được vài dự án khủng khi bảo vệ luận văn, đa số không biết design principle, SOLID, DRY, KISS là gì, phận mãi làm cuder, lương đủ mua mì gói sống qua ngày ).
Nhóm thứ hai xử lý các máy chủ data(DBA : Database Administrator, mấy ông này làm việc ít, đa số thời gian là thảnh thơi trong công ty nhưng lương tháng lại cao ngất ngưỡng).

Mỗi nhóm là một Bounded Context. Họ có trách nhiệm riêng và ranh giới rõ ràng. DBA không viết code Laravel PHP và Phong không tự ý cài đặt lại cấu hình máy chủ. Mọi người hành động theo trách nhiệm của họ và trong ranh giới của họ.

Vì vậy, bộ phận CNTT là một BC. Phong là một phần của mô hình của nó. Trong thực tế thì mọi thứ có ý nghĩa như (developer, máy chủ, v.v.) là một phần của BC và nó phải nhất quán bên trong nó (developer nên viết phần mềm và không được đòi hỏi về quản lý hóa đơn).

Điều tương tự là Nhân không có vị trí trong bộ phận CNTT và Nhân không nên xử lý bất cứ điều gì liên quan đến bộ phận CNTT. Nhân là một phần của Kế toán BC. Nhân có thể đến bộ phận CNTT chơi nhưng sau đó Nhân chỉ là một người bạn đi ngang qua, Nhân không có ý nghĩa gì với bộ phận CNTT và không ai mong Nhân sẽ ở lại viết code Laravel PHP hay fix bugs hộ hoặc đóng vai trò là developer.

Phong có thể phải lòng Nhân và dành một chút thời gian trong văn phòng của Nhân, nhưng điều đó không khiến Phong trở thành một kế toán viên.

Có khá nhiều những BC độc lập và chúng không trùng nhau. Hơn nữa, nếu một đối tượng từ một BC (X) chuyển sang BC (Y) khác, điều đó không có nghĩa là bây giờ nó là một phần của sau này, nó được xem giống như một đối tượng đơn giản không có ý nghĩa đối với Y.

2 người làm việc gần như độc lập nhưng làm thế nào họ có thể làm việc cùng nhau không? Nghĩa là bộ phận CNTT và Kế toán phải làm việc cùng nhau theo thời gian. Họ làm điều đó bằng cách nói chuyện với đúng người (người thứ 3 :) ).

Khi Nhân cần một tính năng phần mềm mới, Nhân có thể nói với Phong, nhưng người quản lý của Phong (là Dự) cuối cùng sẽ quyết định xem những tính năng nào sẽ được thêm vào.
Dự là người tiếp nhận cuộc nói chuyện khi Nhân muốn các tính năng mới hoặc thậm chí để sửa một số lỗi. Dự là người quản lý bộ phận CNTT và giao tasks cho Phong (hoặc bất kỳ ai khác trong bộ phận CNTT) sẽ phải làm gì tiếp theo.
Nhân không thể bỏ qua Dự xem như người vô hình được vì đây là quy tắc trong bộ phận CNTT: Dự là người sẽ ra quyết định. Nhân phải trình bày ý tưởng của mình cho Dự nghe, nếu không thì yêu cầu sẽ bị từ chối.
Nếu các yêu cầu không có ý nghĩa đối với bộ phận CNTT như bao cafe Phúc Long hay bánh mì 7-eleven, yêu cầu sẽ bị từ chối. Dự là Anti Corruption Layer của CNTT BC. Không yêu cầu gì có thể tự ý thông qua nếu chưa được sự đồng ý của Dự và những yêu cầu gì nếu đã thông qua, nó sẽ được chấp nhận để phát triển thêm cho phù hợp với tổ chức nội bộ của bộ phận CNTT.

Low Coupling & High Cohesion là gì ?

Naster Blue — Mon, 21 Oct 2019 12:42:59 +0000

Mục đích của giai đoạn thiết kế trong vòng đời phát triển phần mềm là tạo ra giải pháp cho một vấn đề được đưa ra trong tài liệu SRS(Software Requirement Specification). Đầu ra của giai đoạn thiết kế là SDD (Sofware Design Document).
Về cơ bản, thiết kế là một quá trình lặp lại gồm hai phần:
- Phần đầu tiên là thiết kế ý tưởng cho khách hàng biết hệ thống sẽ làm gì.
- Thứ hai là thiết kế kỹ thuật cho phép người xây dựng hệ thống hiểu được phần cứng và phần mềm thực tế cần thiết để giải quyết vấn đề của khách hàng.

Thiết kế khái niệm hệ thống:

Viết bằng ngôn ngữ đơn giản tức là ngôn ngữ khách hàng dễ hiểu.
Giải thích chi tiết về đặc điểm hệ thống.
Mô tả chức năng của hệ thống.
Độc lập thực hiện.
Liên kết với tài liệu yêu cầu.

Thiết kế kỹ thuật hệ thống:

Thành phần phần cứng và thiết kế.
Chức năng và phân cấp của thành phần phần mềm.
Kiến trúc phần mềm.
Kiến trúc mạng.
Cấu trúc dữ liệu và luồng dữ liệu.
Thành phần I/O của hệ thống.
Giao diện hiển thị.

Modularization

Đề cập đến quá trình phân chia một hệ thống phần mềm thành nhiều module độc lập trong đó mỗi module hoạt động độc lập. Ví dụ : Những nhân viên làm việc về bảng lương, hóa đơn, hồ sơ giấy tờ nên được tách riêng ra thành một bộ phận trong công ty. Tương tự đối với những nhân viên làm việc liên quan tới coding website, android/iOS app thì cũng nên tách ra thành một bộ phận riêng.
Có nhiều lợi thế của Modularization trong công nghệ phần mềm. Một số trong số này được đưa ra dưới đây:

Dễ hiểu hệ thống.
Bảo trì hệ thống dễ dàng.
Một module có thể được sử dụng nhiều lần theo yêu cầu của họ. Không cần phải viết đi viết lại.

Coupling

Đề cập đến mức độ liên quan hoặc phụ thuộc của các class/module đối với nhau. Ví dụ : kế toán viên nên làm việc ở bộ phận kế toán. Web developer nên làm việc ở bộ phận CNTT. 2 bộ phận nên tách rời nhau, không phải xung đột hay phụ thuộc nhau trong quá trình làm việc.

Đối với High Coupling sẽ gây khó khăn cho việc thay đổi và duy trì code của bạn, vì các class/module được liên kết chặt chẽ với nhau, nên việc thay đổi có thể yêu cầu viết lại toàn bộ hệ thống.
Đối với Low Coupling, việc thay đổi thứ gì đó trong một class/module sẽ không ảnh hưởng đến class/module kia. (Dependency Inversion Principle : xem chữ D trong SOLID)

Cohesion

Đề cập đến những class/module có thể làm những chức năng nhiệm vụ gì. Ví dụ : bộ phận kế toán nên làm việc liên quan tới bảng lương, hóa đơn, hồ sơ,... bộ phận kết toán không nên tự ý sửa đổi sourcode của bộ phận phát triển web. Tương tự bộ phận CNTT không nên tự ý sửa đổi tăng lương lên x2.

Low Cohesion là class/module thực hiện rất nhiều hành động - phạm vi hoạt động rộng và dàn trãi không rõ ràng và chuyên biệt, không tập trung vào những gì nó nên làm (God Object).
High Cohesion là class/module tập trung vào những gì nó nên làm, tức là chỉ các phương thức liên quan đến ý định của Class (Single Repository Principle : xem chữ S trong SOLID).

SOLID là gì ?

Naster Blue — Mon, 21 Oct 2019 12:42:50 +0000

SOLID là 5 nguyên lý trong thiết kế phần mềm giúp code trở nên dễ hiểu, linh động và dễ bảo trì hơn. 5 nguyên lý trong SOLID bao gồm:

S: Single responsibility principle
O: Open/closed principle
L: Liskov substitution principle
I: Interface segregation principle
D: Dependency inversion principle

S — Single Responsibility Principle (SRP)

A class should have only a single responsibility.
Một class nên chỉ xử lý đơn nhiệm.

class Accountant
{
    codeJS() : void ;
}

=> correct it
Nhiệm vụ code JS nên được giao cho developer JS.

class JSDeveloper{
     codeJS() : void ;
}

Accountant chỉ nên làm việc liên quan tới kế toán như : về bảng lương, hóa đơn, hồ sơ giấy tờ.

class Accountant
{
    prepareAccountsAndTaxReturns() : void ;
    administerPayrolls() : void ;
    controllingIncomeAndExpenditure() : void ;
}

O — Open-Closed Principle

Software entities (classes, modules, functions, etc.) should be open for extension, but closed for modification.
Nên mở rộng/kế thừa các class đã tồn tại thay vì sửa đổi chúng.

class ReactJSDeveloper extends JSDeveloper
{
    codeReactJS() : void ;
}

Một JSDeveloper ngoài biết code JS thuần ra về lâu dài còn có khả năng học và code React JS với tư duy reactive.

L — Liskov Substitution Principle

Objects in a program should be replaceable with instances of their subtypes without altering the correctness of that program.
Các đối tượng của class cha có thể được thay thế bởi các đối tượng của các class con mà không làm thay đổi tính đúng đắn của chương trình.

class ReactJSDeveloper extends JSDeveloper
{
    codeJS(): void {
      //  override code logic
    }
}

ReactJS Developer ngoài biết code ReactJs mà còn phải biết code JS thuần.

I — Interface Segregation Principle

Many client-specific interfaces are better than one general-purpose interface.
Nên tách thành nhiều interface nhỏ cho các mục đích riêng, không nên để 1 interface phình quá to cho nhiều mục đích.

interface IAccountant {
    prepareAccountsAndTaxReturns(): void;
    administerPayrolls(): void;
    controllingIncomeAndExpenditure(): void;
}
interface IJSDeveloper{
   codeJS(): void;
}
interface IReactJsDeveloper extends IJSDeveloper
{
    codeReactJS(): void;
}

D — Dependency Inversion Principle

Depend on abstractions, not on concretions.
Các module cấp cao không nên phụ thuộc vào các module cấp thấp. Cả hai nên phụ thuộc vào abstraction.
Abstraction không nên phụ thuộc vào detail. Detail nên phụ thuộc vào abstraction.

class VueJSDeveloper  extends IJSDeveloper
{
    codeJS(): void {
        // override improve JS performance
    }
    codeVueJS(): void ;
}
class WebProject{
    private jsDeveloper : IJSDeveloper;
    constructor(jsDeveloper VueJSDeveloper){}
    kickOff(): void {
        jsDeveloper.codeJS();
    }
}

Khi lựa chọn developer cho Frontend dự án thì có thể chọn VueJS Developer làm đầu vào.
Dự án tiếp theo có thể chọn ReactJS Developer làm frontend.