Sync prod's commit graph to dev

.github/workflows/azure-acr-deploy-frontend-dev.yml

@@ -0,0 +1,71 @@
+name: Frontend - Build and Deploy on Azure (Dev)
+
+on:
+  push:
+    branches: [development]
+    paths:
+      - "frontend/**"
+      - ".github/workflows/azure-deploy-frontend-dev.yml"
+  workflow_dispatch:
+
+env:
+  REGISTRY: mploycontainerregistry-hncsekeah2gagbgb.azurecr.io
+  FRONTEND_IMAGE_NAME: nextjs-frontend
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+        with:
+          driver-opts: |
+            image=moby/buildkit:latest
+            network=host
+
+      - name: Log in to Azure Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ secrets.ACR_USERNAME }}
+          password: ${{ secrets.ACR_PASSWORD }}
+
+      - name: Build and push image (with ACR cache)
+        uses: docker/build-push-action@v6
+        with:
+          context: ./frontend
+          file: ./frontend/Dockerfile
+          push: true
+          tags: |
+            ${{ env.REGISTRY }}/${{ env.FRONTEND_IMAGE_NAME }}:development
+          cache-from: type=registry,ref=${{ env.REGISTRY }}/${{ env.FRONTEND_IMAGE_NAME }}:buildcache
+          cache-to: type=registry,ref=${{ env.REGISTRY }}/${{ env.FRONTEND_IMAGE_NAME }}:buildcache,mode=max
+
+  deploy:
+    needs: build-and-push
+    runs-on: ubuntu-latest
+    environment: development
+    steps:
+      - name: Azure login
+        uses: azure/login@v2
+        with:
+          creds: ${{ secrets.AZURE_CREDENTIALS }}
+
+      - name: Deploy to Azure Container Apps (Dev)
+        uses: azure/container-apps-deploy-action@v2
+        with:
+          registryUrl: ${{ env.REGISTRY }}
+          registryUsername: ${{ secrets.ACR_USERNAME }}
+          registryPassword: ${{ secrets.ACR_PASSWORD }}
+          containerAppName: mploy-frontend-dev
+          resourceGroup: ${{ secrets.AZURE_RESOURCE_GROUP_DEV }}
+          imageToDeploy: ${{ env.REGISTRY }}/${{ env.FRONTEND_IMAGE_NAME }}:development
+          targetPort: 3000
+          environmentVariables: >
+            NOTION_API_KEY=${{ secrets.NOTION_API_KEY }}
+            NOTION_DATABASE_ID=${{ secrets.NOTION_DATABASE_ID }}
+            MONGODB_URI=${{ secrets.MONGODB_URI }}
+            NODE_ENV=development

.github/workflows/azure-acr-deploy-frontend-prod.yml

@@ -0,0 +1,78 @@
+name: Frontend - Build and Deploy on Azure (Prod)
+
+on:
+  push:
+    branches: [production]
+    paths:
+      - "frontend/**"
+      - ".github/workflows/azure-deploy-frontend-prod.yml"
+  workflow_dispatch:
+
+env:
+  REGISTRY: mploycontainerregistry-hncsekeah2gagbgb.azurecr.io
+  FRONTEND_IMAGE_NAME: nextjs-frontend
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+        with:
+          driver-opts: |
+            image=moby/buildkit:latest
+            network=host
+
+      - name: Log in to Azure Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ secrets.ACR_USERNAME }}
+          password: ${{ secrets.ACR_PASSWORD }}
+
+      - name: Set version tag
+        id: vars
+        run: |
+          VERSION="v$(date +'%Y.%m.%d')-${GITHUB_RUN_NUMBER}"
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Build and push :production and versioned tags (with ACR cache)
+        uses: docker/build-push-action@v6
+        with:
+          context: ./frontend
+          file: ./frontend/Dockerfile
+          push: true
+          tags: |
+            ${{ env.REGISTRY }}/${{ env.FRONTEND_IMAGE_NAME }}:production
+            ${{ env.REGISTRY }}/${{ env.FRONTEND_IMAGE_NAME }}:${{ steps.vars.outputs.version }}
+          cache-from: type=registry,ref=${{ env.REGISTRY }}/${{ env.FRONTEND_IMAGE_NAME }}:buildcache
+          cache-to: type=registry,ref=${{ env.REGISTRY }}/${{ env.FRONTEND_IMAGE_NAME }}:buildcache,mode=max
+
+  deploy:
+    needs: build-and-push
+    runs-on: ubuntu-latest
+    environment: production
+    steps:
+      - name: Azure login
+        uses: azure/login@v2
+        with:
+          creds: ${{ secrets.AZURE_CREDENTIALS }}
+
+      - name: Deploy to Azure Container Apps (Prod)
+        uses: azure/container-apps-deploy-action@v2
+        with:
+          registryUrl: ${{ env.REGISTRY }}
+          registryUsername: ${{ secrets.ACR_USERNAME }}
+          registryPassword: ${{ secrets.ACR_PASSWORD }}
+          containerAppName: mploy-frontend
+          resourceGroup: ${{ secrets.AZURE_RESOURCE_GROUP_PROD }}
+          imageToDeploy: ${{ env.REGISTRY }}/${{ env.FRONTEND_IMAGE_NAME }}:production
+          targetPort: 3000
+          environmentVariables: >
+            NOTION_API_KEY=${{ secrets.NOTION_API_KEY }}
+            NOTION_DATABASE_ID=${{ secrets.NOTION_DATABASE_ID }}
+            MONGODB_URI=${{ secrets.MONGODB_URI }}
+            NODE_ENV=production

.github/workflows/lint-checker.yml

@@ -1,9 +1,6 @@
 name: Frontend Lint Checker
 
 on:
-  push:
-    paths:
-      - 'frontend/**'
   pull_request:
     paths:
       - 'frontend/**'

.gitignore

@@ -59,5 +59,10 @@ desktop.ini
 *.bak
 *.backup
 
+# Lock file for pnpm
+pnpm-lock.yaml
 
 /repo-to-text/
+
+# Typescript build info
+frontend/tsconfig.tsbuildinfo

README.md

@@ -1,60 +1,118 @@
-# MPloy Job Board
+# MPLOY - MAC Job Board
 
-A modern job board application built with Next.js, Spring Boot, and Go, designed to help students find internships and job opportunities.
+Hey there! 👋
 
-### Frontend
-- Next.js 15 with App Router
-- React 19
-- TypeScript
-- Mantine UI
-- Tailwind CSS
+This is a modern, intelligent job board platform that automatically aggregates job listings, providing users with a streamlined experience to search, filter, and discover relevant opportunities. The platform updates daily with fresh listings through our smart AI robots.
 
-### Backend
-- Spring Boot (Kotlin)
-- Redis for caching
-- RESTful APIs
+## Features 🚀
+
+- Jobs update automatically every single day from various sources (automatically deduplicated)
+- We use AI to help fix, sort and summarise the listings
+- You can filter for exactly what you want (e.g. Big Tech Intern Roles for International students)
+- Works perfectly on phone or laptop
+- Server-side rendering (where possible) with Next.js 15 App Router
+- Multiple filters can be applied at once, including text search
+- Desktop/mobile responsive UI: list/details on desktop, modal on mobile
+- State persists in URL: search, filters, pagination (`/jobs?q=dev&location=sydney&page=2`)
+- Direct job links supported (`/jobs/[id]`)
+- Parallel data fetching for faster loads
+- Real-time job search with debouncing
+
+## Frontend
+
+- Next.js 15: Utilizing the App Router for server-side rendering and optimized client-side navigation
+- React 19: For building the interactive user interface components
+- TypeScript: Ensuring type safety across the codebase
+- Mantine UI: For consistent, accessible UI components
+- Tailwind CSS: For utility-first styling and responsive design
+
+### Key Patterns
+
+- **State Management**: Start with props; use custom hooks for reusable logic; Context for global state (e.g., job filters).
+- **Data Flow**: URL as source of truth for filters/search; debounced API calls; prefetching for pagination.
+- **Components**: Keep thin (50-150 lines); use layouts for shared UI; mark client components with "use client".
+- **Features Used**: Intercepting routes for modals; Suspense for loading; Error boundaries; useMemo/useRef for optimization.
+
+### Structure
+
+```
+src/
+├── app/
+│   ├── jobs/          # Main jobs route with filters, listing, details
+│   │   ├── [id]/      # Dynamic job page
+│   │   └── error.tsx  # Job-specific error handling
+│   ├── layout.tsx     # Root layout with providers
+│   └── page.tsx       # Home (redirects to /jobs)
+├── components/
+│   ├── jobs/          # Job cards, lists, details, filters
+│   └── layout/        # Nav, logo, search bar
+├── context/
+│   └── filter/        # Filter state provider
+└── lib/               # Utils, theme
+```
+
+## Backend
+
+- Server Actions: Answers search and feedback requests
+- MongoDB: Stores job listings and related metadata
+- GoLang: Powers our web robots (this part is not open source)
 
 ## Getting Started
 
 ### Prerequisites
+
 - Node.js 20+
 - Java 17
 - Go 1.21+
 - Docker & Docker Compose
 - Redis
 
 ### Local Development
-```bash
-# Start all services
-docker compose -f docker-compose.dev.yml up
-# Alternative if Make is installed
-make dev
 
-# Frontend only
+```bash
 cd frontend
 npm install
 npm run dev
+```
+
+## Environment Variables
 
-# Backend only
-cd backend
-./gradlew bootRun
+```
+MONGODB_URI=
+MONGODB_DATABASE=default
+MONGODB_COLLECTION=listings
+
+NODE_ENV=development
 ```
 
 ## Development Guidelines
 
 ### Git Workflow
 
 #### Branch Structure
-- `main` - Production branch
+
+- `production` - Production branch
 - `dev` - Development branch
 - Feature branches follow the pattern:
   ```
   <component>/<developer>/<feature-name>
   Examples:
   - backend/edwn/redis-caching
   - frontend/sarah/job-filters
-  - fullstack/alex/docker-setup
   ```
-
+
+### Coding Conventions
+
+- Use kebab-case for files (e.g., `product-card.ts`); camelCase for hooks (e.g., `useCustomHook`).
+- Group related components in feature directories (e.g., `components/jobs/filters/`).
+- Prioritize server components; use "use client" only when needed.
+- Build with scalability and observability in mind (e.g., structured logging with Pino).
+
+## Deployment (Development and Production)
+
+- We are deployed on Azure Container Apps via Github Actions.
+- GitHub Actions -> builds containers -> Azure Containers Registry -> Azure Container Apps.
+
 ## License
-This project is licensed under the MIT License.
+
+This project is licensed under the MIT License.