@cyberskill/shared 1.169.0 → 1.170.0

package/public/wiki/convention.md

@@ -1,185 +0,0 @@
-# Hướng Dẫn Sử Dụng Dự Án
-
-![Build Status](https://img.shields.io/badge/build-passing-brightgreen)
-![License](https://img.shields.io/badge/license-MIT-blue)
-
-<!-- Mục lục -->
-
-- [Yêu Cầu](#yêu-cầu)
-- [Cài Đặt](#cài-đặt)
-- [Chạy Dự Án](#chạy-dự-án)
-    - [Chạy ở môi trường development với Docker](#chạy-ở-môi-trường-development-với-docker)
-    - [Chạy ở môi trường development (Local)](#chạy-ở-môi-trường-development-local)
-- [Các Script & Ý Nghĩa](#các-script--ý-nghĩa)
-- [Quy Ước Viết Code & Đặt Tên](#quy-ước-viết-code--đặt-tên)
-    - [Quy Ước Đặt Tên](#quy-ước-đặt-tên)
-    - [Quy Ước Đặt Tên Chung](#quy-ước-đặt-tên-chung)
-    - [Quy Ước Tiền Tố Trong TypeScript](#quy-ước-tiền-tố-trong-typescript)
-    - [Quy Ước Đặt Tên Type Trong GraphQL](#quy-ước-đặt-tên-type-trong-graphql)
-    - [Quy Ước Đặt Tên Biến Môi Trường](#quy-ước-đặt-tên-biến-môi-trường)
-    - [Quy Ước Khi Import](#quy-ước-khi-import)
-    - [Quy Ước Viết Code](#quy-ước-viết-code)
-    - [Quy Ước Đặt Commit Message](#quy-ước-đặt-commit-message)
-- [Quy Trình Làm Việc Với Git](#quy-trình-làm-việc-với-git)
-
----
-
-## Yêu Cầu
-
-- **nvm (Node Version Manager):**
-    - MacOS: [nvm-sh/nvm](https://github.com/nvm-sh/nvm)
-    - Windows: [coreybutler/nvm-windows](https://github.com/coreybutler/nvm-windows)
-- **Node.js:** 22.15.0
-  _(nvm sẽ tự động cài đặt phiên bản này nếu chưa có)_
-    - MacOS: [node-v22.15.0.pkg](https://nodejs.org/dist/v22.15.0/node-v22.15.0.pkg)
-    - Windows: [node-v22.15.0-x64.msi](https://nodejs.org/dist/v22.15.0/node-v22.15.0-x64.msi)
-- **Docker:** [Docker Desktop](https://www.docker.com/products/docker-desktop)
-- **Ghi chú:** Dùng **pnpm** để tránh xung đột với các công cụ khác.
-
----
-
-## Cài Đặt
-
-1. **Tạo file cấu hình môi trường:**
-   Sao chép file `.env.example` thành `.env`.
-2. **Chỉnh sửa file `.env`:**
-   Cập nhật các trường cần thiết phù hợp với môi trường máy.
-
----
-
-## Chạy Dự Án
-
-### Chạy ở môi trường development với Docker
-
-_(Lưu ý: Hãy bật Docker trước khi chạy)_
-
-```bash
-make build-development
-make start-development
-```
-
-### Chạy ở môi trường development (Local)
-
-```bash
-pnpm i
-pnpm run dev
-```
-
----
-
-## Các Script & Ý Nghĩa
-
-| Script           | Ý nghĩa                                 |
-| ---------------- | --------------------------------------- |
-| **lint**         | Kiểm tra lỗi lint và typescript         |
-| **lint:fix**     | Tự động sửa các lỗi có thể sửa          |
-| **lint:inspect** | Xem chi tiết các lint rule đang dùng    |
-| **reset**        | Cài đặt lại dependencies                |
-| **prepare**      | Tự động nâng cấp @cyberskill/shared     |
-| **inspect**      | Xem chi tiết các dependencies đang dùng |
-
----
-
-## Quy Ước Viết Code & Đặt Tên
-
-### Quy Ước Đặt Tên
-
-| Loại          | Quy Ước      | Ví Dụ               |
-| ------------- | ------------ | ------------------- |
-| **Biến**      | `camelCase`  | `userName`          |
-| **Hàm**       | `camelCase`  | `getUserInfo()`     |
-| **Parameter** | `camelCase`  | `id, userData`      |
-| **Argument**  | `camelCase`  | `fetchData(userId)` |
-| **Private**   | `_camelCase` | `_isHidden`         |
-| **Class**     | `PascalCase` | `UserProfile`       |
-| **Hằng số**   | `UPPER_CASE` | `MAX_RETRY_COUNT`   |
-| **File**      | `kebab-case` | `user-service.ts`   |
-| **Thư mục**   | `kebab-case` | `services/`         |
-
-### Quy Ước Đặt Tên Chung
-
-| Loại                     | Tiền Tố       | Quy Tắc                       | Ví Dụ                       |
-| ------------------------ | ------------- | ----------------------------- | --------------------------- |
-| **Biến đại diện input**  | `I_Input_`    | Tiền tố + loại + kiểu dữ liệu | `interface I_Input_User`    |
-| **Biến đại diện output** | `I_Response_` | Tiền tố + loại + kiểu dữ liệu | `interface I_Response_User` |
-
-### Quy Ước Tiền Tố Trong TypeScript
-
-| Loại          | Tiền Tố | Ví Dụ              |
-| ------------- | ------- | ------------------ |
-| **Interface** | `I_`    | `interface I_User` |
-| **Type**      | `T_`    | `type T_User`      |
-| **Enum**      | `E_`    | `enum E_User`      |
-| **Constant**  | `C_`    | `enum C_User`      |
-
-### Quy Ước Đặt Tên Type Trong GraphQL
-
-| Loại          | Tiền Tố  | Ví Dụ                    |
-| ------------- | -------- | ------------------------ |
-| **Type**      | `T_`     | `type T_User`            |
-| **Input**     | `Input_` | `input Input_CreateUser` |
-| **Interface** | `I_`     | `input I_User`           |
-| **Union**     | `U_`     | `input U_SearchResult`   |
-
-### Quy Ước Đặt Tên Biến Môi Trường
-
-| Loại        | Tiền Tố        | Ví Dụ                 |
-| ----------- | -------------- | --------------------- |
-| **Vite**    | `VITE_`        | `VITE_API_SECRET`     |
-| **Next.js** | `NEXT_PUBLIC_` | `NEXT_PUBLIC_API_KEY` |
-| **Node.js** | `NODE_`        | `NODE_ENV`            |
-
-### Quy Ước Khi Import
-
-1. Các thư viện bên ngoài **ở trên cùng**.
-2. Các module/hàm tiện ích **ở dưới**, cách một dòng trắng với phần trên.
-3. Định cấu hình đường dẫn để **import nhanh** trong `tsconfig.json`.
-
-```ts
-import React from 'react'; // Thư viện bên ngoài
-
-import { formatDate } from '#shared/util'; // Module nội bộ
-```
-
-### Quy Ước Viết Code
-
-✅ **Làm**
-
-- Dùng `let` và `const` thay vì `var`.
-- Dùng `===` thay vì `==`.
-- Xóa `console.log`, `alert` và `debugger` trước khi commit.
-
-❌ **Không làm**
-
-- Không dùng `any`, `unknown`, `never`.
-- Không dùng `@ts-ignore`, `@ts-nocheck`.
-
-### Quy Ước Đặt Commit Message
-
-| Loại Commit       | Cú Pháp                  | Ví Dụ                                      |
-| ----------------- | ------------------------ | ------------------------------------------ |
-| **Tính năng mới** | `feat(module): message`  | `feat(user): add user login form`          |
-| **Sửa lỗi**       | `fix(module): message`   | `fix(auth): incorrect password validation` |
-| **Dọn dẹp**       | `chore(module): message` | `chore(product): refactor product filter`  |
-
-## Quy Trình Làm Việc Với Git
-
-1. **Tạo nhánh mới từ `develop`**:
-
-```bash
-git checkout develop
-git pull origin develop
-git checkout -b feature/new-feature
-```
-
-2. **Commit theo chuẩn**:
-
-```bash
-git commit -m "feat(module): mô tả ngắn gọn"
-```
-
-3. **Tạo Pull Request (PR)** và đợi review trước khi merge vào `develop`.
-
----
-
-> **Ghi chú:** Nếu có bất kỳ thắc mắc nào, vui lòng liên hệ team phát triển!

package/public/wiki/setup-mongo.md

@@ -1,29 +0,0 @@
-## ✅ Bước 1: Cài đặt mongo 8.0 (Ubuntu 24.04)
-
-```
-sudo apt-get install gnupg curl
-```
-
-```
-curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | \
-   sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \
-   --dearmor
-```
-
-```
-echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
-```
-
-```
-sudo apt-get update
-```
-
-```
-sudo apt-get install -y mongodb-org
-```
-
-## ✅ Bước 2: Chạy mongo
-
-```
-sudo systemctl start mongod
-```

package/public/wiki/setup-nginx.md

@@ -1,50 +0,0 @@
-## ✅ Bước 1: Cài đặt nginx
-
-```
-sudo apt update
-sudo apt install nginx
-```
-
-## ✅ Bước 2: Cấu hình nginx
-
-```
-cd /etc/nginx/sites-enabled
-```
-
-```
-sudo nano default
-```
-
-Thiết lập cấu hình
-
-```
-    server {
-        listen       port-sẽ-chạy;
-        server_name  địa-chỉ-ip;
-
-        location / {
-            proxy_pass http://localhost:port-sẽ-chạy;
-            proxy_http_version 1.1;
-            proxy_set_header Upgrade $http_upgrade;
-            proxy_set_header Connection 'upgrade';
-            proxy_set_header Host $host;
-            proxy_cache_bypass $http_upgrade;
-        }
-    }
-```
-
-## ✅ Bước 3: Kiểm tra cấu hình
-
-```
-sudo nginx -t
-```
-
-Nếu hiện như sau là cấu hình ok
-`nginx: the configuration file /etc/nginx/nginx.conf syntax is ok`
-`nginx: configuration file /etc/nginx/nginx.conf test is successful`
-
-## ✅ Bước 4: Khởi động lại nginx với cấu hình mới
-
-```
-sudo nginx -s reload
-```

package/public/wiki/setup-node.md

@@ -1,29 +0,0 @@
-## ✅ Bước 1: Cài đặt homebrew (nếu chưa cài)
-
-```
-/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
-```
-
-## ✅ Bước 2: Cài đặt nvm
-
-```
-brew install nvm
-```
-
-Thêm đoạn script dưới đây vào `~/.profile` hoặc `~/.zshrc`
-
-```
-export NVM_DIR="$HOME/.nvm"
-[ -s "/home/linuxbrew/.linuxbrew/opt/nvm/nvm.sh" ] && \. "/home/linuxbrew/.linuxbrew/opt/nvm/nvm.sh"  # This loads nvm
-[ -s "/home/linuxbrew/.linuxbrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/home/linuxbrew/.linuxbrew/opt/nvm/etc/bash_completion.d/nvm"  # This loads nvm bash_completion
-```
-
-Tắt mở lại terminal hoặc chạy lệnh `source ~/.profile` hoặc `source  ~/.zshrc`
-
-## ✅ Bước 3: Cài đặt phiên bản node tương ứng
-
-```
-nvm install phiên-bản-node
-```
-
-> ⚠️ Lưu ý: ví dụ `nvm install 22.15.0`

package/public/wiki/setup-pm2.md

@@ -1,27 +0,0 @@
-## ✅ Bước 1: Cài đặt node (nếu chưa cài)
-
-[Xem tại đây](./setup-node.md)
-
-## ✅ Bước 2: Cài đặt pm2
-
-```
-npm install pm2 -g
-```
-
-## ✅ Bước 3: Chạy pm2
-
-Chạy bằng node mặc định
-
-```
-pm2 start tên-file.js --name tên-app
-```
-
-> ⚠️ Lưu ý: ví dụ `pm2 start index.js --name cyberskill-example`
-
-Đối với dự án có script chạy từ package.json
-
-```
-pm2 start pnpm --name tên-app -- run tên-script-chạy
-```
-
-> ⚠️ Lưu ý: ví dụ `pm2 start pnpm --name cyberskill-example -- run start`

package/public/wiki/setup-redis.md

@@ -1,17 +0,0 @@
-## ✅ Bước 1: Cài đặt homebrew (nếu chưa cài)
-
-```
-/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
-```
-
-## ✅ Bước 2: Cài đặt redis
-
-```
-brew install redis
-```
-
-## ✅ Bước 3: Chạy redis
-
-```
-brew services start redis
-```

package/public/wiki/setup-ssl.md

@@ -1,102 +0,0 @@
-## ✅ Bước 1: Cài đặt certbot
-
-```
-sudo apt update
-```
-
-```
-sudo apt install certbot python3-certbot-nginx
-```
-
-## ✅ Bước 2: Chạy certbot
-
-```
-sudo certbot --nginx -d tên-miền
-```
-
-> ⚠️ Lưu ý: nếu có nhiều tên miền có thể ghi liên tục, ví dụ `sudo certbot --nginx -d cyberskill.example -d api.cyberskill.example -d www.cyberskill.example`
-
-Nếu hiện như sau là cấu hình ok
-`Successfully received certificate.`
-`Certificate is saved at: đường-dẫn/fullchain.pem`
-`Key is saved at:         đường-dẫn/privkey.pem`
-`This certificate expires on năm-tháng-ngày.`
-`These files will be updated when the certificate renews.`
-`Certbot has set up a scheduled task to automatically renew this certificate in the background.`
-
-## ✅ Bước 3: Cập nhật cấu hình nginx
-
-Ví dụ cho cấu hình Backend và Frontend
-
-```
-server {
-    listen 80 default_server;
-    listen [::]:80 default_server;
-
-    server_name cyberskill.example www.cyberskill.example api.cyberskill.example;
-
-    return 301 https://$host$request_uri;
-}
-
-server {
-    listen 443 ssl;
-    listen [::]:443 ssl;
-
-    server_name cyberskill.example www.cyberskill.example;
-
-    ssl_certificate /etc/letsencrypt/live/cyberskill.example/fullchain.pem;
-    ssl_certificate_key /etc/letsencrypt/live/cyberskill.example/privkey.pem;
-    include /etc/letsencrypt/options-ssl-nginx.conf;
-    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
-
-    location / {
-        proxy_pass http://localhost:port-frontend;
-        proxy_http_version 1.1;
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection 'upgrade';
-        proxy_set_header Host $host;
-        proxy_cache_bypass $http_upgrade;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-    }
-}
-
-server {
-    listen 443 ssl;
-    listen [::]:443 ssl;
-
-    server_name api.cyberskill.example;
-
-    ssl_certificate /etc/letsencrypt/live/cyberskill.example/fullchain.pem;
-    ssl_certificate_key /etc/letsencrypt/live/cyberskill.example/privkey.pem;
-    include /etc/letsencrypt/options-ssl-nginx.conf;
-    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
-
-    location / {
-        proxy_pass http://localhost:port-backend;
-        proxy_http_version 1.1;
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection 'upgrade';
-        proxy_set_header Host $host;
-        proxy_cache_bypass $http_upgrade;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-    }
-}
-```
-
-## ✅ Bước 4: Kiểm tra cấu hình
-
-```
-sudo nginx -t
-```
-
-Nếu hiện như sau là cấu hình ok
-`nginx: the configuration file /etc/nginx/nginx.conf syntax is ok`
-`nginx: configuration file /etc/nginx/nginx.conf test is successful`
-
-## ✅ Bước 5: Khởi động lại nginx với cấu hình mới
-
-```
-sudo nginx -s reload
-```