Skip to main content

Environment setup

Requirements​

  • Node.js >= 20
  • pnpm
  • PostgreSQL (for api_oms)

Clone and install​

git clone <repo-url>
cd CODE

Install dependencies for each project:

cd vn.merchant.api_oms && pnpm install
cd ../vn.merchant.api_payment && pnpm install
cd ../vn.merchant.web_payment && pnpm install

Environment configuration​

Each project has an .env.example file — copy it to .env.dev and fill in the details:

cp .env.example .env.dev

api_oms​

  • DATABASE_URL — PostgreSQL connection string
  • APP_PORT — Server port

api_payment​

  • MOMO_DOMAIN, ZALOPAY_DOMAIN, VNPAY_DOMAIN — Payment gateway domains
  • Each platform requires separate key configuration via API settings

Run development​

pnpm dev

This runs NestJS in --watch mode — auto-reloads on code changes.

Database migration​

pnpm prisma:dev

Runs prisma migrate dev with .env.dev. Do not run prisma:staging or prisma:production without approval.

Contents