commerce-api-build

What problem does it solve?

This Skill defines a standardized blueprint for building a robust commerce backend using NestJS, Prisma, and PostgreSQL, ensuring consistent module design and integration points with payment services like PortOne.

Core Features & Use Cases

• Modular architecture: Defines apps/api/modules for auth, product, cart, order, payment, referral, payout, webhook.
• End-to-end payment flow: Describes PortOne payment verification, webhook handling, order confirmation, and referral ledger distribution.
• OpenAPI and shared types: Instructions to generate OpenAPI and publish shared types for front-end consumption.
• Security and data integrity: Emphasizes Prisma schema, BigInt for amounts, ci encryption, idempotent webhooks.

Quick Start

Follow this blueprint to scaffold the API modules, wire PortOne integration, run migrations, and publish the OpenAPI docs.