Clean up Gen AI Dev running process (opendatahub-io#5527)

* Clean up Gen AI Dev running process

* PR change

* updated README in genAI

Author: ikeola13

packages/gen-ai/.env.development

@@ -1,2 +1,7 @@
 APP_ENV=development
-DEPLOYMENT_MODE=standalone
+DEPLOYMENT_MODE=standalone
+LLAMA_STACK_URL=<your-llama-stack-url>
+MAAS_URL=<your-maas-url>
+DISTRIBUTION_NAME=<your-distribution-name>
+MAAS_NAMESPACE=<your-maas-namespace>
+PLAYGROUND_NAMESPACE=<your-playground-namespace>

packages/gen-ai/Makefile

@@ -17,7 +17,7 @@ include ${ENV_FILE}
 export $(shell sed 's/=.*//' ${ENV_FILE})
 endif
 
-.PHONY: help dev-install-dependencies dev-frontend dev-bff dev-start clean clean-all
+.PHONY: help dev-install-dependencies dev-frontend dev-bff dev-start dev-start-no-portforward dev-portforward clean clean-all
 
 help: ## Display this help message
 	@echo "Available commands:"
@@ -33,7 +33,7 @@ dev-bff-mock: ## Run only the bff in development mode
 
 .PHONY: dev-bff
 dev-bff:
-	cd bff && LLAMA_STACK_URL=${LLAMA_STACK_URL} AUTH_TOKEN=user_token AUTH_TOKEN_HEADER=Authorization AUTH_TOKEN_PREFIX="Bearer " make run STATIC_ASSETS_DIR=../frontend/dist
+	cd bff && MAAS_URL=${MAAS_URL} DISTRIBUTION_NAME=${DISTRIBUTION_NAME} LLAMA_STACK_URL=${LLAMA_STACK_URL} AUTH_TOKEN=user_token AUTH_TOKEN_HEADER=Authorization AUTH_TOKEN_PREFIX="Bearer " make run STATIC_ASSETS_DIR=../frontend/dist
 
 
 .PHONY: dev-frontend
@@ -44,8 +44,22 @@ dev-frontend: ## Run only the frontend in development mode
 dev-start-mock: ## Run both frontend and bff in development mode
 	make -j 2 dev-bff-mock dev-frontend
 
+.PHONY: dev-portforward
+dev-portforward: ## Start port-forwarding in separate terminals
+	@echo "Starting port-forward for maas-api..."
+	@oc port-forward -n ${MAAS_NAMESPACE} svc/maas-api 8081:8080 &
+	@sleep 1
+	@echo "Starting port-forward for lsd-genai-playground-service..."
+	@oc port-forward -n ${PLAYGROUND_NAMESPACE} svc/lsd-genai-playground-service 8321:8321 &
+	@echo "Port-forwarding started in background!"
+
 .PHONY: dev-start
-dev-start:
+dev-start: dev-portforward ## Start frontend, bff, and port-forwarding
+	@sleep 2
+	make -j 2 dev-bff dev-frontend
+
+.PHONY: dev-start-no-portforward
+dev-start-no-portforward: ## Start frontend and bff without port-forwarding
 	make -j 2 dev-bff dev-frontend
 
 clean: ## Clean build artifacts and node_modules

packages/gen-ai/README.md

@@ -110,6 +110,20 @@ make run MOCK_MAAS_CLIENT=true
 make dev-bff-mock
 ```
 
+## Running Frontend and BFF Together
+
+For convenience, you can start both the frontend and BFF simultaneously using these Makefile targets from the root of the gen-ai package:
+
+```bash
+# Start frontend, bff, and port-forwarding
+make dev-start
+
+# Start frontend and bff without port-forwarding
+make dev-start-no-portforward
+```
+
+These commands will run both services in parallel, making it easier to start your development environment with a single command.
+
 ## Building and Running with Docker
 
 The project includes a multi-stage Dockerfile that builds both the frontend and backend components and creates a minimal production image.
@@ -179,8 +193,8 @@ docker run -p 8080:8080 \
 A complimentary script is provided to build and run GenAI Studio as standalone application
 in OpenShift by using the build and deploy capacities of OpenShift through the `oc new-app` command.
 
-
 Prerequisites:
+
 - Logged into OpenShift (`oc login`) and a target project selected (`oc project <name>`)
 - Current git branch tracks a remote and the remote fetch URL uses HTTPS
 - A browser extension that allows "Autorization: Bearer <oc whoami -t >" token
@@ -192,6 +206,7 @@ Run from the repository root:
 ```
 
 What the script does (high level):
+
 - Detects repo URL and current branch; validates HTTPS fetch URL
 - Creates a Docker BuildConfig via `oc new-app` (scoped to `packages/gen-ai`)
 - Patches the BuildConfig to use `packages/gen-ai/Dockerfile`