တင်သွင်းခြင်း

./install.sh ဖြင့် host ကို ပြင်ဆင်ပြီး၊ Docker Compose ဖြင့် Quan ERP base ကို လည်ပတ်ကာ၊ plugin များကို build → available → installed လမ်းကြောင်းဖြင့် တင်သွင်းပြီး၊ staging / production အတွက် ခိုင်မာအောင် ပြုလုပ်နည်း ဖြစ်ပါသည်။

အနှစ်ချုပ်

Quark ERP / Quan ERP သည် base stack (Postgres၊ Redis၊ backend၊ frontend) နှင့် ဗားရှင်းပါ plugin များဖြင့် deploy လုပ်ပါသည်။ Server အသစ်တွင် install script ဖြင့် Docker နှင့် Nginx ကို ပြင်ဆင်ပြီး compose ကို စတင်ပါ။ Plugin များကို plugins/ အောက်တွင် တည်ဆောက်ကာ available-plugins/ သို့ build လုပ်ပြီး၊ ERP UI မှ installed-plugins/ သို့ အသက်ဝင်စေပါသည်။ Base image များနှင့် @quan-erp/* package များသည် တူညီသော ဗားရှင်းလိုင်းတွင် ရှိရပါမည်။

installation/ — ./install.sh (သို့မဟုတ် installation.sh) ဖြင့် host bootstrap နှင့် compose start/stop
docker-compose.yaml — Postgres၊ Redis၊ backend၊ frontend
plugins/ — source; quan-erp CLI က available-plugins/ သို့ တည်ဆောက်ပါသည်
ERP UI install — installed-plugins/ သို့ ကူးယူ / အသက်ဝင်စေပါသည်
UAT သို့မဟုတ် production တွင် module ဇယားကို SQL seed မလုပ်ရပါ

1. Host bootstrap (./install.sh)

Server deploy များတွင် production docker-compose.yaml ဘေးရှိ installation/ အောက်တွင် helper script ပါရှိပါသည်။ သာမန် user အဖြစ် run ရပါမည် — sudo / root အဖြစ် မဟုတ်ပါ။ Script သည် Docker Engine၊ Compose plugin နှင့် Nginx ကို သွင်းပြီး၊ stack ကို စတင် သို့မဟုတ် ရပ်တန့်နိုင်ပါသည်။

Command များ — install | start | stop (./install.sh --help ကို ကြည့်ပါ)
root အဖြစ် မ run ရပါ — လိုအပ်သည့်နေရာတွင်သာ sudo အသုံးပြုပါသည်
install — Ubuntu/Debian သို့မဟုတ် RHEL-family ကို ရှာဖွေပြီး Docker + Compose + Nginx သွင်းကာ service များကို ဖွင့်ပေးပါသည်
start — installation/ ဘေးရှိ stack အတွက် docker compose up -d
stop — တူညီသော compose ဖိုင်အတွက် docker compose stop
ပံ့ပိုးသော OS — Ubuntu၊ Debian၊ RHEL၊ CentOS၊ Fedora၊ Rocky၊ AlmaLinux
install ပြီးနောက် docker group အကျိုးသက်ရောက်ရန် shell အသစ် သို့မဟုတ် re-login လိုအပ်နိုင်ပါသည်

SHTerminal

cd installation
chmod +x ./install.sh   # or ./installation.sh

# One-time host setup (Docker + Compose + Nginx)
./install.sh install

# Start compose services
./install.sh start

# Stop compose services
./install.sh stop

2. Base stack (Docker Compose)

ဒေသခံ template အလုပ်အတွက် base/ အောက်တွင် compose ကို တိုက်ရိုက် စတင်နိုင်ပါသည်။ ./install.sh ဖြင့် ပြင်ဆင်ထားသော server တွင် ./install.sh start ကို ဦးစားပေး အသုံးပြုပါ။ နမူနာ stack တွင် shared bridge network ပေါ်ရှိ ဝန်ဆောင်မှု လေးခု — db (Postgres)၊ redis၊ backend၊ frontend — ပါဝင်ပါသည်။ Backend သည် Postgres နှင့် Redis သို့ compose service အမည်ဖြင့် ချိတ်ဆက်ပါသည်။

Container အတွင်း host များသည် compose service အမည်များ (db၊ redis) ဖြစ်ပါသည် — ဝန်ဆောင်မှုအချင်းချင်းအတွက် localhost မသုံးရပါ
အသုံးများသော volume များ — ./data၊ ./available-plugins၊ ./backend/installed-plugins၊ ./backend/logs
BASE_VERSION / image tag များ (base-backend၊ base-frontend) ကို plugin @quan-erp/* ဗားရှင်းများနှင့် ကိုက်ညီအောင် ထားရှိရပါမည်
Template စကားဝှက်နှင့် token လျှို့ဝှက်ချက်များသည် local/dev သာ ဖြစ်ပါသည် — မျှဝေအသုံးပြုသော ပတ်ဝန်းကျင် မတိုင်မီ ပြောင်းလဲရပါမည်

SHLocal template

cd base
docker compose up -d
docker compose ps

SHServer (via install script)

cd installation
./install.sh start
./install.sh stop

2b. နမူနာ docker-compose.yaml

အောက်ပါ local/dev template ကို ကူးယူပြီး၊ change-me တန်ဖိုးအားလုံးကို ပြောင်းလဲကာ၊ VITE_BACKEND_API ကို browser ရောက်နိုင်သော URL ထားရှိပြီး၊ image tag / BASE_VERSION ကို သင့် release လိုင်းသို့ ညွှန်ပါ။ Backend သည် Postgres (db:5432) သို့ တိုက်ရိုက် ချိတ်ဆက်ပါသည်။

DATABASE_HOST / DB_HOST=db၊ DB_PORT=5432 — ဤ template တွင် pooler မပါဝင်ပါ
OPENAI_* / FIREBASE_CONFIG — လိုအပ်မှသာ ထည့်ပါ; private key များကို git မတင်ရပါ

YAMLdocker-compose.yaml

services:
  db:
    image: postgres:17
    container_name: postgres
    restart: always
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: change-me
      POSTGRES_DB: quan-erp
    ports:
      - "5432:5432"
    volumes:
      - ./data/db-data:/var/lib/postgresql/data
    networks:
      - app-network

  redis:
    image: redis:7
    container_name: quanerp-redis
    restart: unless-stopped
    ports:
      - "6379:6379"
    command: >
      redis-server
      --requirepass "change-me"
      --appendonly yes
    volumes:
      - ./data/redis:/data
    networks:
      - app-network
    healthcheck:
      test: ["CMD", "redis-cli", "ping", "-a", "change-me"]
      interval: 5s
      timeout: 2s
      retries: 5

  backend:
    build:
      context: ./backend
      dockerfile: Dockerfile
    image: theparadance/quan-erp-base-backend:1.0.0
    restart: unless-stopped
    platform: linux/amd64
    container_name: backend
    ports:
      - "8080:8080"
      - "8081:8081"
    environment:
      NODE_ENV: production
      MODE: dev
      BASE_VERSION: 1.0.0
      ORGANIZATION_ID: quan-erp

      FRONTEND_URL: http://localhost
      BACKEND_URL: http://localhost:8080
      DEV_TOOL_URL: http://localhost:8081
      PLUGIN_SERVER_URL: http://localhost:8082

      ACCESS_TOKEN_SECRET: change-me
      ACCESS_TOKEN_SECRET_EXPIRATION_TIME: 15m
      REFRESH_TOKEN_SECRET: change-me
      REFRESH_TOKEN_SECRET_EXPIRATION_TIME: 30d

      DATABASE_HOST: db
      DB_HOST: db
      DB_USERNAME: postgres
      DB_PASSWORD: change-me
      DB_PORT: 5432
      DB_SCHEMA: quan-erp
      DB_SYNC: true

      REDIS_HOST: redis
      REDIS_PORT: 6379
      REDIS_PASSWORD: change-me

      CLUSTER_MODE: false
      CLUSTER_MAX_COUNT: 2
      ENV_ENCRYPTION_KEY: change-me-32-char-hex-or-secret
      FIREBASE_CONFIG: ''

      OPENAI_BASE_URL: https://api.deepseek.com
      OPENAI_API_KEY: <sk-key>

      CORS_ALLOWED_ORIGINS: http://localhost:3000,http://127.0.0.1:3000,http://localhost,https://localhost

      AVAILABLE_PLUGINS_FOLDER: /app/available-plugins
      INSTALLED_PLUGINS_FOLDER: /app/installed-plugins
      APP_DATA_FOLDER: /app/data/data/
      UPLOAD_FILE_TEMP_FOLDER: /app/data/temp
      UPLOAD_FILE_FOLDER: /app/data/data/
      PLUGINS_ENV_FILE: /app/data/data/plugin.env.json
      RUNNER_FLOW_FILE: /app/data/data/workflows/

      ROOT_ADMIN_USERNAME: admin
      ROOT_ADMIN_PASSWORD: change-me
      DEVELOPER_CONFIG_PASSWORD: change-me

      MAX_USER_LIMIT: 5
      MAX_ACTIVE_USER_LIMIT: 5
      MAX_USER_SESSION_LIMIT_PER_USER: 1
      MAX_ORGANIZATION_BRANCH: 1
      MAX_ROLE_LIMIT: 5
      MAX_SUBSCRIPTION_GRACE_PERIOD_DAYS: 14
      SUBSCRIPTION_END_DATE: '2099-01-01'
    volumes:
      - ./backend/installed-plugins:/app/installed-plugins
      - ./data:/app/data
      - ./backend/logs:/app/logs
      - ./available-plugins:/app/available-plugins
    depends_on:
      - db
      - redis
    networks:
      - app-network
    dns:
      - 1.1.1.1
      - 8.8.8.8

  frontend:
    build:
      context: ./frontend
      dockerfile: Dockerfile
    image: theparadance/quan-erp-base-frontend:1.0.0
    restart: unless-stopped
    platform: linux/amd64
    container_name: frontend
    environment:
      VITE_BACKEND_API: http://localhost:8080
      VITE_MODE: dev
    ports:
      - "80:80"
    volumes:
      - ./data/frontend/web-env.json:/usr/share/nginx/html/web-env.json
    networks:
      - app-network

networks:
  app-network:
    driver: bridge

3. ဝန်ဆောင်မှုများနှင့် port များ

db:5432 (DB_HOST)၊ redis:6379၊ backend:8080/8081၊ frontend:80 နှင့် host Nginx တို့ ပါဝင်ပါသည်။ Production တွင် db / redis ကို အများပြည်သူသို့ မဖွင့်ရပါ။

db (postgres:17) — 5432; DB_HOST=db၊ DB_PORT=5432; schema quan-erp; ./data/db-data
redis — 6379; REDIS_HOST=redis + REDIS_PASSWORD; ./data/redis
backend — :8080 / :8081; plugin နှင့် data + logs volume များ
frontend — :80; VITE_BACKEND_API သည် browser ရောက်နိုင်ရပါမည်
Host Nginx — ./install.sh install ဖြင့် TLS / reverse proxy

4. Plugin တင်သွင်းခြင်း

quan-erp build:prod|watch|pack:prod ဖြင့် stage လုပ်ပြီး၊ ERP UI မှ Install လုပ်ရပါသည်။

Build → available-plugins/<name>/<version>/
UI install ပြီးနောက် → installed-plugins/<name>/
Backend သည် installed=true ဖြစ်သော module များကို တင်သွင်းပါသည်
Frontend သည် module.js ကို load လုပ်ပြီး register(AppRegistry) ကို ခေါ်ပါသည်
local/dev တွင်သာ module row INSERT လုပ်ရပါမည် — UAT/prod မလုပ်ရပါ

TSBuild & stage

# From repo root
quan-erp build:prod sample-es
# Continuous during development
quan-erp watch sample-es

# Distributable zip (frontend + backend + metadata)
quan-erp pack:prod sample-es
quan-erp pack:prod sample-es ./dist-archives

5. ဗားရှင်း ကိုက်ညီမှု

Base image tag များနှင့် plugin @quan-erp/* ဗားရှင်းများကို တူညီအောင် ထားရှိရပါမည်။

plugin package.json အတွင်း @quan-erp/* သည် base image နှင့် တူညီရပါမည်
compose image tag များနှင့် BASE_VERSION ကို sync ထားရှိရပါမည်
module.metadata.json ရှိ pluginVersion / requiredBasedVersion ကိုက်ညီရပါမည်
base အဆင့်မြှင့်ပြီးနောက် ကိုက်ညီသော @quan-erp/* ဖြင့် plugin ကို ပြန်လည် တည်ဆောက်ရပါမည်

6. ပတ်ဝန်းကျင် ပြောင်းလဲမှုများ

DB_* → db:5432၊ REDIS_*၊ token များ၊ CORS၊ URL များနှင့် plugin/data folder များကို volume ဖြင့် တည်မြဲအောင် ထားရှိပါ။ Production တွင် migration များကို အသုံးပြုရပါမည်။

DB_* / DATABASE_HOST — နမူနာ stack တွင် db:5432; DB_SCHEMA = POSTGRES_DB
REDIS_* — redis service requirepass နှင့် တူညီရပါမည်
ACCESS_TOKEN_* / REFRESH_TOKEN_* / ENV_ENCRYPTION_KEY — template တန်ဖိုး မသုံးရပါ
CORS_ALLOWED_ORIGINS — browser origin များကို ထည့်သွင်းပါ
FRONTEND_URL / BACKEND_URL / VITE_BACKEND_API — ရောက်နိုင်သော URL များ
plugin / data folder path များ — volume ဖြင့် persist လုပ်ပါ
BASE_VERSION + image tag များ — plugin ဗားရှင်းများနှင့် ကိုက်ညီရပါမည်
DB_SYNC — local/dev သာ; staging/prod တွင် migration များ
MODE — template သည် dev; production mode ကို အသုံးပြုပါ

7. Staging နှင့် production စစ်ဆေးစာရင်း

./install.sh install ကို ဦးစွာ လုပ်ဆောင်ပါ။ ပုံသေ လျှို့ဝှက်ချက်များကို ပြောင်းလဲပါ။ db / redis ကို အများပြည်သူသို့ မဖွင့်ရပါ။ Nginx TLS ကို အသုံးပြုပါ။ Firebase / npm လျှို့ဝှက်ချက်များကို git မတင်ရပါ။ module seed မလုပ်ရပါ။

ပထမ start မတိုင်မီ ./install.sh install လုပ်ရပါမည်
Postgres / Redis / ROOT_ADMIN_* / token လျှို့ဝှက်ချက်အားလုံးကို ပြောင်းလဲရပါမည်
Postgres / Redis port များကို အများပြည်သူသို့ မဖွင့်ရပါ; Nginx TLS ကို အသုံးပြုပါ
./data၊ plugin နှင့် log များကို backup လုပ်ပါ
DB_SYNC=true၊ open CORS နှင့် နမူနာ လျှို့ဝှက်ချက်များကို ပိတ်ပါ
Plugin များကို UI install ဖြင့် တင်သွင်းပါ — production တွင် SQL seed မလုပ်ရပါ
Schema ပြောင်းလဲမှုကို migration များဖြင့် လုပ်ဆောင်ရပါမည်
FRONTEND_URL / BACKEND_URL / VITE_BACKEND_API သည် public hostname နှင့် တူညီရပါမည်
အဆင့်မြှင့်မီ base နှင့် @quan-erp/* ဗားရှင်းများကို စစ်ဆေးပါ
FIREBASE / npm လျှို့ဝှက်ချက်များကို git မတင်ရပါ

8. နေ့စဉ် လုပ်ငန်းဆောင်ရွက်မှုများ

./install.sh start|stop၊ base / plugin အဆင့်မြှင့်တင်ခြင်း၊ log၊ backup နှင့် rollback အစီအစဉ် ထားရှိရပါမည်။

Stack — cd installation && ./install.sh start|stop
Base update — image tag အသစ် → container များကို recreate
Plugin update — quan-erp build:prod|pack:prod → available-plugins → UI install
Health — docker compose ps; backend log များ
Data — Postgres volume နှင့် APP_DATA_FOLDER ကို backup လုပ်ပါ
Rollback — plugin ဗားရှင်း folder / image tag ဟောင်းများကို ထားရှိပါ

YAMLUseful compose commands

cd installation   # or cd base for the Node template
docker compose logs -f backend
docker compose restart backend frontend
docker compose down
./install.sh start

ပြဿနာဖြေရှင်းခြင်း

install မအောင်မြင် — OS / sudo / Docker repo ကို စစ်ဆေးပါ
docker permission — docker group အတွက် re-login လုပ်ပါ
start မအောင်မြင် — POSTGRES_* / REDIS_* / image tag များကို စစ်ဆေးပါ
DB မရောက်ရှိ — DB_HOST=db၊ DB_PORT=5432
VITE_BACKEND_API — browser ရောက်နိုင်သော host ကို အသုံးပြုပါ
Plugin မပေါ် — available-plugins / ဗားရှင်း / ဒေသခံ module row
UI ဗလာ — frontend ပြန်လည် တည်ဆောက် + ထပ်မံ Install
CORS / auth — FRONTEND_URL နှင့် origin များ
ဗားရှင်း အမှား — base နှင့် @quan-erp/* မတူညီခြင်း

Deployment အကူအညီ လိုအပ်ပါသလား

Quark ERP ကို တင်သွင်းရာတွင် အခက်အခဲရှိပါက The Paradance ထံမှ အကူအညီ ရယူနိုင်ပါသည်။ အခြေအနေအလိုက် အခမဲ့ သို့မဟုတ် အပိုကျသင့်ငွေ ဖြစ်နိုင်ပါသည် — လုပ်ငန်းအတိုင်းအတာ၊ အရေးပေါ်မှုနှင့် ပတ်ဝန်းကျင်ပေါ် မူတည်ပါသည်။

BASE_VERSION / image tag များ၊ OS၊ compose log နှင့် ပြန်လည် ထပ်မံစမ်းသပ်ရန် အဆင့်များကို ထည့်ပေးပါ
ရိုးရိုး လမ်းညွှန်မှုသည် အခမဲ့ ဖြစ်နိုင်ပါသည်; hands-on setup / production harden / custom ops များအတွက် ကျသင့်နိုင်ပါသည်
အခမဲ့ / အခပေး ကို စတင်မလုပ်မီ ရှင်းလင်းစွာ အတည်ပြုပေးပါသည်

Support →Email The Paradance →