Merge pull request #21 from nextinterfaces/pdf-analyzer-1

Adds PDF Analyzer service

Author: nextinterfaces

Taskfile.yml

@@ -121,13 +121,11 @@ tasks:
         echo "🚀 Starting Air hot reload on port 8090..."
         air -c .air.toml
 
-#  dev:stop-port-forwards:
-#    desc: Stop all kubectl port-forward processes
-#    cmds:
-#      - |
-#        echo "🛑 Stopping all kubectl port-forward processes..."
-#        pkill -f "kubectl port-forward" || echo "No port-forwards running"
-#        echo "✅ Done"
+  dev:pdf-analyzer-service:
+    desc: Run pdf-analyzer-service in development mode with hot reload
+    dir: apps/pdf-analyzer-service
+    cmds:
+      - pnpm install && PORT=8091 pnpm dev
 
   # Docker tasks
   docker:build:items-service:
@@ -145,12 +143,18 @@ tasks:
     cmds:
       - docker build -t semcache-service:local ./apps/semcache-service
 
+  docker:build:pdf-analyzer-service:
+    desc: Build Docker image for pdf-analyzer-service
+    cmds:
+      - docker build -t pdf-analyzer-service:local ./apps/pdf-analyzer-service
+
   docker:build:all:
     desc: Build Docker images for all apps
     cmds:
       - task: docker:build:items-service
       - task: docker:build:website-app
       - task: docker:build:semcache-service
+      - task: docker:build:pdf-analyzer-service
 
   docker:run:items-service:
     desc: Run items-service Docker container locally
@@ -167,6 +171,11 @@ tasks:
     cmds:
       - docker run --rm -p 8080:8080 semcache-service:local
 
+  docker:run:pdf-analyzer-service:
+    desc: Run pdf-analyzer-service Docker container locally
+    cmds:
+      - docker run --rm -p 8080:8080 pdf-analyzer-service:local
+
   # Terraform tasks
   tf:init:
     desc: Initialize Terraform
@@ -273,6 +282,11 @@ tasks:
     cmds:
       - kubectl --kubeconfig={{.KUBECONFIG}} logs -l app=semcache-service --tail=100 -f
 
+  k8s:logs:pdf-analyzer-service:
+    desc: Get logs from pdf-analyzer-service
+    cmds:
+      - kubectl --kubeconfig={{.KUBECONFIG}} logs -l app=pdf-analyzer-service --tail=100 -f
+
   k8s:describe:items-service:
     desc: Describe items-service deployment
     cmds:
@@ -288,6 +302,11 @@ tasks:
     cmds:
       - kubectl --kubeconfig={{.KUBECONFIG}} describe deployment semcache-service
 
+  k8s:describe:pdf-analyzer-service:
+    desc: Describe pdf-analyzer-service deployment
+    cmds:
+      - kubectl --kubeconfig={{.KUBECONFIG}} describe deployment pdf-analyzer-service
+
   # Deployment tasks
   deploy:items-service:
     desc: Deploy items-service to Kubernetes
@@ -310,6 +329,14 @@ tasks:
       - echo "Waiting for rollout to complete..."
       - kubectl --kubeconfig={{.KUBECONFIG}} rollout status deployment/semcache-service --timeout=120s
 
+  deploy:pdf-analyzer-service:
+    desc: Deploy pdf-analyzer-service to Kubernetes
+    cmds:
+      - kubectl --kubeconfig={{.KUBECONFIG}} apply -f {{.K8S_DIR}}/apps/pdf-analyzer-service-deployment.yaml
+      - echo "✅ pdf-analyzer-service deployed"
+      - echo "Waiting for rollout to complete..."
+      - kubectl --kubeconfig={{.KUBECONFIG}} rollout status deployment/pdf-analyzer-service --timeout=120s
+
   deploy:headlamp-readonly:
     desc: Deploy Headlamp Kubernetes Dashboard (Read-Only Public)
     cmds:
@@ -324,6 +351,7 @@ tasks:
       - task: deploy:items-service
       - task: deploy:website-app
       - task: deploy:semcache-service
+      - task: deploy:pdf-analyzer-service
       - task: deploy:headlamp-readonly
 
   deploy:items-service:with-postgres:
@@ -422,6 +450,11 @@ tasks:
     cmds:
       - kubectl --kubeconfig={{.KUBECONFIG}} rollout restart deployment/semcache-service
 
+  rollout:restart:pdf-analyzer-service:
+    desc: Restart pdf-analyzer-service deployment
+    cmds:
+      - kubectl --kubeconfig={{.KUBECONFIG}} rollout restart deployment/pdf-analyzer-service
+
   rollout:status:items-service:
     desc: Check rollout status for items-service
     cmds:
@@ -437,6 +470,11 @@ tasks:
     cmds:
       - kubectl --kubeconfig={{.KUBECONFIG}} rollout status deployment/semcache-service
 
+  rollout:status:pdf-analyzer-service:
+    desc: Check rollout status for pdf-analyzer-service
+    cmds:
+      - kubectl --kubeconfig={{.KUBECONFIG}} rollout status deployment/pdf-analyzer-service
+
   # DNS and networking tasks
   dns:clear-cache:
     desc: Clear DNS cache (macOS)
@@ -466,10 +504,15 @@ tasks:
     cmds:
       - curl -s https://app.roussev.com/semcache/v1/health | jq
 
+  health:pdf-analyzer-service:
+    desc: Check health of pdf-analyzer-service
+    cmds:
+      - curl -s https://app.roussev.com/pdf-analyzer/v1/health | jq
+
   clean:docker:
     desc: Clean Docker images
     cmds:
-      - docker rmi items-service:local website-app:local semcache-service:local || true
+      - docker rmi items-service:local website-app:local semcache-service:local pdf-analyzer-service:local || true
 
   # Port forwarding tasks
 #  port-forward:items-service:

Tiltfile

@@ -215,6 +215,37 @@ k8s_resource(
     ]
 )
 
+# ============================================================================
+# PDF Analyzer Service (Node.js + Express + TypeScript)
+# ============================================================================
+
+# Build Docker image for pdf-analyzer-service (using dev Dockerfile with hot reload)
+docker_build(
+    'pdf-analyzer-service',
+    context='./apps/pdf-analyzer-service',
+    dockerfile='./apps/pdf-analyzer-service/Dockerfile.dev',
+    live_update=[
+        sync('./apps/pdf-analyzer-service/src', '/app/src'),
+        sync('./apps/pdf-analyzer-service/package.json', '/app/package.json'),
+        run('cd /app && pnpm install', trigger=['./apps/pdf-analyzer-service/package.json']),
+    ]
+)
+
+# Deploy pdf-analyzer-service
+k8s_yaml('infra/k8s/local/pdf-analyzer-service-local.yaml')
+
+# Configure pdf-analyzer-service resource
+k8s_resource(
+    'pdf-analyzer-service',
+    port_forwards='8085:8080',
+    labels=['apps'],
+    resource_deps=['jaeger', 'prometheus'],
+    links=[
+        link('http://localhost:8085/v1/health', 'Health Check'),
+        link('http://localhost:8085/docs', 'API Docs (Swagger UI)'),
+    ]
+)
+
 # ============================================================================
 # Headlamp Kubernetes Dashboard (Read-Only)
 # ============================================================================

apps/pdf-analyzer-service/.dockerignore

@@ -0,0 +1,8 @@
+node_modules
+.dist
+dist
+.git
+Dockerfile
+Dockerfile.dev
+.env
+**/.DS_Store

apps/pdf-analyzer-service/Dockerfile

@@ -0,0 +1,36 @@
+# syntax=docker/dockerfile:1
+
+# ---------- deps ----------
+FROM node:20-alpine AS deps
+WORKDIR /app
+RUN corepack enable && corepack prepare [email protected] --activate
+COPY package.json pnpm-lock.yaml* ./
+RUN pnpm install --frozen-lockfile || pnpm install
+
+# ---------- builder ----------
+FROM node:20-alpine AS builder
+WORKDIR /app
+RUN corepack enable && corepack prepare [email protected] --activate
+COPY --from=deps /app/node_modules ./node_modules
+COPY package.json tsconfig.json ./
+COPY src ./src
+COPY api ./api
+RUN pnpm build
+
+# prune dev deps to prod-only
+RUN pnpm prune --prod
+
+# ---------- runner ----------
+FROM node:20-alpine AS runner
+WORKDIR /app
+ENV NODE_ENV=production
+ENV PORT=8080
+
+# only copy runtime artifacts
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/api ./api
+COPY --from=builder /app/node_modules ./node_modules
+COPY package.json ./package.json
+
+EXPOSE 8080
+CMD ["node", "dist/index.js"]

apps/pdf-analyzer-service/Dockerfile.dev

@@ -0,0 +1,19 @@
+# Development Dockerfile with hot reload using tsx
+FROM node:20-alpine
+
+WORKDIR /app
+
+# Enable pnpm
+RUN corepack enable && corepack prepare [email protected] --activate
+
+# Install dependencies first for cache
+COPY package.json pnpm-lock.yaml* ./
+RUN pnpm install
+
+# Copy source
+COPY . .
+
+EXPOSE 8080
+ENV PORT=8080
+
+CMD ["pnpm", "dev"]

apps/pdf-analyzer-service/api/openapi.yaml

@@ -0,0 +1,27 @@
+openapi: 3.0.3
+info:
+  title: PDF Analyzer Service API
+  version: 0.1.0
+  description: Simple service with health and docs for PDF Analyzer
+servers:
+  - url: /
+paths:
+  /v1/health:
+    get:
+      summary: Health check
+      operationId: healthCheck
+      tags: [system]
+      responses:
+        '200':
+          description: Service is healthy
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status:
+                    type: string
+                    example: ok
+                  commit:
+                    type: string
+                    example: local-dev