Merge pull request 'fix' (#14) from 009-problem-resolution into development

Reviewed-on: https://gitea.maskantech.in/gitea_admin/support_backend/pulls/14

README.md

@@ -1,17 +1,66 @@
-### Development
+# SupportHub API
-- docker compose --env-file .env.development -f docker-compose.development.yml up -d --build
 
-### Test
+### Development (Docker)
-- docker compose --env-file .env.test -f docker-compose.test.yml up --build
+- Start all services: `docker compose --env-file .env.development -f docker-compose.development.yml up -d --build`
+- Start only database & cache (for local app development): `docker compose --env-file .env.development -f docker-compose.development.yml up -d postgres redis`
 
-### Production
+### Test (Docker)
-- docker compose --env-file .env.prod -f docker-compose.prod.yml up --build -d
+- `docker compose --env-file .env.test -f docker-compose.test.yml up --build`
 
-### Stop
+### Production (Docker)
-- docker compose -f docker-compose.prod.yml down
+- `docker compose --env-file .env.prod -f docker-compose.prod.yml up --build -d`
 
-### list containers
+### Stop / Down
-- docker compose --env-file .env.development -f docker-compose.development.yml ps
+- Stop production: `docker compose -f docker-compose.prod.yml down`
+- Stop development: `docker compose -f docker-compose.development.yml down`
+- Stop development & wipe volumes: `docker compose --env-file .env.development -f docker-compose.development.yml down -v`
+
+### List Containers & Logs
+- List containers: `docker compose --env-file .env.development -f docker-compose.development.yml ps`
+- Follow logs: `docker compose --env-file .env.development -f docker-compose.development.yml logs -f`
+
+---
+
+### Local Development (Host)
+1. Start database & cache in Docker:
+   ```bash
+   docker compose --env-file .env.development -f docker-compose.development.yml up -d postgres redis
+   ```
+2. Start API server in watch mode:
+   ```bash
+   npm run dev
+   ```
+
+---
+
+### Database Migrations & Prisma
+
+- **Generate Prisma Client**:
+  ```bash
+  npm run prisma:generate
+  ```
+
+- **Run / Apply Dev Migrations**:
+  ```bash
+  npx dotenv-cli -e .env.development -- npm run prisma:migrate
+  ```
+
+- **Deploy Migrations (Production/CI)**:
+  ```bash
+  npx dotenv-cli -e .env.development -- npm run prisma:deploy
+  ```
+
+- **Push Schema directly (Sync schema without migration files)**:
+  ```bash
+  npx dotenv-cli -e .env.development -- npx prisma db push
+  ```
+
+---
+
+### Database Seeding
+
+- **Seed Database (Roles, Products, Categories, Hierarchy & Demo data)**:
+  ```bash
+  npx dotenv-cli -e .env.development -- npm run prisma:seed
+  ```
 
-### logs
-- docker compose --env-file .env.development -f docker-compose.development.yml logs -f