barsa 29ad4236d6 Enhance development scripts and update package dependencies

- Added a new script command `dev:studio` to facilitate studio management in development.
- Updated the Prisma dependency in BFF package to version 6.16.0 for improved features and bug fixes.
- Refactored Dockerfiles for BFF and Portal to enhance health check mechanisms during startup.
- Removed deprecated WhmcsApiMethodsService to streamline the integration services.
- Cleaned up various components and services in the SIM management module for better maintainability and clarity.

2025-12-02 18:56:38 +09:00

2.6 KiB

Raw Blame History

Prisma Configuration

Overview

This directory contains the Prisma schema and migrations for the BFF application.

Important: Docker Build Behavior

The Problem with Monorepos

Prisma embeds the schema path into the generated client. In a monorepo, this path is relative to the workspace root (e.g., apps/bff/prisma/schema.prisma). However, in production Docker containers, the directory structure is flattened by pnpm deploy, placing the schema at prisma/schema.prisma.

How We Solve This

In the Dockerfile, we regenerate the Prisma client inside the production directory layout so the embedded path is /app/prisma/schema.prisma:

WORKDIR /app
RUN npx prisma@6.16.0 generate --schema=prisma/schema.prisma

This ensures the embedded schema path matches the production layout.

Directory Structure

Development (Monorepo)

/project-root/
├── apps/bff/
│   ├── prisma/
│   │   ├── schema.prisma    ← Schema here
│   │   └── migrations/
│   └── src/
└── packages/

Production (Docker Container)

/app/
├── prisma/
│   ├── schema.prisma        ← Schema here (flattened)
│   └── migrations/
├── dist/
└── node_modules/
    └── .prisma/client/      ← Generated client

Commands

Command	Description
`pnpm db:generate`	Regenerate Prisma client (`--schema=prisma/schema.prisma`)
`pnpm db:migrate`	Run migrations (dev) with explicit schema path
`pnpm db:studio`	Open Prisma Studio with explicit schema path
`pnpm db:reset`	Reset database with explicit schema path

Binary Targets

The schema includes binary targets for both development and production:

binaryTargets = ["native", "linux-musl-openssl-3.0.x"]

native: For local development (macOS, Windows, Linux)
linux-musl-openssl-3.0.x: For Alpine Linux in Docker

Troubleshooting

"Could not load schema from path" Error

This error occurs when the Prisma client was generated with a different schema path than what exists in the current environment.

Solution: Ensure the Dockerfile regenerates the Prisma client from the production-like directory structure (see above).

Client Not Found

If you see "Prisma Client not found" errors:

Run pnpm db:generate locally
For Docker, ensure the Dockerfile includes the prisma generate step

Migration Strategy

Create migrations locally: pnpm db:migrate
Commit the migration files
In production, the entrypoint runs: prisma migrate deploy --schema=/app/prisma/schema.prisma

2.6 KiB Raw Blame History