Dev

.env.example

@@ -3,4 +3,10 @@ DIRECT_URL=
 SUPABASE_SERVICE_ROLE_KEY=
 SUPABASE_ANON_KEY=
 JWT_SECRET=
-PORT=3000
+GOOGLE_MAPS_API_KEY=
+A3S_BYPASS_LOGIN=false
+A3S_BYPASS_USERNAME=demo-tech
+A3S_BYPASS_USER_ID=tech-demo
+A3S_BYPASS_TOKEN=dev-bypass-token
+
+PORT=3000

.github/workflows/ci.yml

@@ -1,41 +1,57 @@
-name: CI
+name: CI Pipeline
 
 on:
   push:
-    branches: [main, dev]
-    paths-ignore:
-      - '**.md'
-      - 'docs/**'
-      - '.vscode/**'
+    branches: [ main, dev ]
   pull_request:
-    paths-ignore:
-      - '**.md'
-
-permissions:
-  actions: read
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
+    branches: [ main, dev ]
 
 jobs:
-  main:
+  test-and-build:
     runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: postgres:15-alpine
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+          POSTGRES_DB: a3service
+        ports:
+          - 5433:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
     steps:
-      - uses: actions/checkout@v4
-        with:
-          filter: tree:0
-          fetch-depth: 0
+      - uses: actions/checkout@v3
 
-      - uses: actions/setup-node@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
         with:
-          node-version: 24
-          cache: 'npm'
+          node-version: 22
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Generate Prisma Client
+        run: cd apps/api && npx prisma generate
+        env:
+          DATABASE_URL: postgresql://postgres:postgres@localhost:5433/a3service
+          DIRECT_URL: postgresql://postgres:postgres@localhost:5433/a3service
+
+      - name: Deploy Prisma Migrations
+        run: cd apps/api && npx prisma migrate deploy
+        env:
+          DATABASE_URL: postgresql://postgres:postgres@localhost:5433/a3service
+          DIRECT_URL: postgresql://postgres:postgres@localhost:5433/a3service
 
-      # Use --ignore-scripts to skip the husky 'prepare' stage entirely
-      - run: npm ci --ignore-scripts
-
-      - uses: nrwl/nx-set-shas@v4
+      - name: Build API
+        run: npx nx build shared-schema && npx nx build api
 
-      - run: npx nx affected -t lint
+      - name: Run Tests
+        run: npx nx run-many --target=test --all --coverage --forceExit
+        env:
+          DATABASE_URL: postgresql://postgres:postgres@localhost:5433/a3service
+          DIRECT_URL: postgresql://postgres:postgres@localhost:5433/a3service

.github/workflows/migrate.yml

@@ -0,0 +1,32 @@
+name: Migrate
+
+on:
+  push:
+    branches:
+      - dev
+    paths:
+      - 'apps/api/prisma/**'
+  workflow_dispatch: 
+
+jobs:
+  migrate:
+    runs-on: ubuntu-latest
+    env:
+      DATABASE_URL: ${{ secrets.DATABASE_URL }}
+      DIRECT_URL: ${{ secrets.DIRECT_URL }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci --ignore-scripts
+
+      - name: Generate Prisma Client
+        run: npx prisma generate --schema=apps/api/prisma/schema.prisma
+
+      - name: Run migration
+        run: npx prisma migrate deploy --schema=apps/api/prisma/schema.prisma --config=apps/api/prisma.config.ts

.gitignore

@@ -69,18 +69,33 @@ vitest.config.*.timestamp*
 __pycache__/
 *.pyc
 
-# Python
+# Python virtual environments
+.venv/
+venv/
+
+# Python cache
 __pycache__/
 *.pyc
 *.pyo
-.python-version
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+#.python-version <-- if using pyenv, but we want to keep it in the repo to ensure everyone uses the same Python version
 
 # Jupyter
 .ipynb_checkpoints/
 
-# Data pipeline
+# Data pipeline local/private files
 data-pipeline/.env
 apps/data-pipeline/.env
+data-pipeline/raw_pdfs/
+apps/data-pipeline/raw_pdfs/
+apps/data-pipeline/notes/
+apps/data-pipeline/output_json/_debug/
+# for scraper
+apps/data-pipeline/input/manual_sources.generated.json
+
 
 # TODO: migrate raw_pdfs to Git LFS when volume grows
 # apps/data-pipeline/raw_pdfs/

.husky/commit-msg

@@ -1,23 +1,26 @@
-# Get the commit message
-commit_msg=$(cat "$1")
+#!/bin/sh
+
+# Validate commit message format:
+#   type(scope): description
+# Allowed types: feat, fix, chore, docs, refactor, ci
+# Allowed scopes: mobile, api, shared, pipeline, ci
 
-# A3Service Regex: type(scope): description
+commit_msg=$(cat "$1")
 regex="^(feat|fix|chore|docs|refactor|ci)\((mobile|api|shared|pipeline|ci)\): .+$"
 
-# Universal shell matching
 if echo "$commit_msg" | grep -Eq "$regex"; then
-    echo "✅ Commit message follows convention."
+    echo "Commit message follows convention."
     exit 0
-else
-    echo "----------------------------------------------------------------------"
-    echo "❌ COMMIT FAILED"
-    echo "Message: $commit_msg"
-    echo ""
-    echo "Format must be: type(scope): description"
-    echo "Allowed Types:  feat, fix, chore, docs, refactor, ci"
-    echo "Allowed Scopes: mobile, api, shared, pipeline, ci"
-    echo ""
-    echo "Example: feat(api): implement boiler service logic"
-    echo "----------------------------------------------------------------------"
-    exit 1
-fi
+fi
+
+echo "----------------------------------------------------------------------"
+echo "COMMIT FAILED"
+echo "Message: $commit_msg"
+echo ""
+echo "Format must be: type(scope): description"
+echo "Allowed Types:  feat, fix, chore, docs, refactor, ci"
+echo "Allowed Scopes: mobile, api, shared, pipeline, ci"
+echo ""
+echo "Example: feat(api): implement boiler service logic"
+echo "----------------------------------------------------------------------"
+exit 1

.husky/pre-commit

@@ -1,21 +1,19 @@
 #!/bin/sh
 
-local_branch_name="$(git rev-parse --abbrev-ref HEAD)"
+# Pre-commit checks:
+# 1) Enforce branch naming convention
+# 2) Run lint for affected projects
 
-# 1. --- EXCLUSION BLOCK ---
-# Allow structural branches to bypass naming conventions
-if [[ "$local_branch_name" == "main" || "$local_branch_name" == "dev" ]]; then
-    echo "✅ Structural branch detected ($local_branch_name). Skipping naming check."
-else
-    # 2. --- NAMING ENFORCEMENT ---
-    valid_branch_regex="^(feat|fix|chore|docs|refactor)\((mobile|api|shared|pipeline|ci)\)\/[a-z0-9-]+$"
+local_branch_name="$(git rev-parse --abbrev-ref HEAD)"
+valid_branch_regex="^(feat|fix|chore|docs|refactor|ci)\((mobile|api|shared|pipeline|ci)\)/[a-z0-9-]+$"
 
-    if [[ ! $local_branch_name =~ $valid_branch_regex ]]; then
+if [ "$local_branch_name" != "main" ] && [ "$local_branch_name" != "dev" ]; then
+    if ! echo "$local_branch_name" | grep -Eq "$valid_branch_regex"; then
         echo "----------------------------------------------------------------------"
-        echo "❌ ERROR: Invalid branch name '$local_branch_name'"
+        echo "ERROR: Invalid branch name '$local_branch_name'"
         echo "A3Service standards require: type(scope)/description"
         echo "----------------------------------------------------------------------"
-        echo "💡 HOW TO FIX THIS:"
+        echo "How to fix:"
         echo "1. Rename your branch locally:"
         echo "   git branch -m 'feat(scope)/your-description'"
         echo ""
@@ -24,17 +22,12 @@ else
         echo "   B) Delete remote:  git push origin --delete '$local_branch_name'"
         echo "   C) Push new name:  git push origin 'feat(scope)/new-name'"
         echo ""
-        echo "3. Or, delete it and start over:"
-        echo "   git checkout <base-branch>  # e.g., main or a feature branch"
-        echo "   git branch -D '$local_branch_name'"
-        echo ""
-        echo "ALLOWED TYPES: feat, fix, chore, docs, refactor"
+        echo "ALLOWED TYPES: feat, fix, chore, docs, refactor, ci"
         echo "ALLOWED SCOPES: mobile, api, shared, pipeline, ci"
         echo "----------------------------------------------------------------------"
         exit 1
     fi
 fi
 
-# 3. --- QUALITY GATE ---
-echo "🔍 Running Nx Linter on affected files..."
+echo "Running Nx lint on affected projects..."
 npx nx affected -t lint --base=origin/main --parallel=3

.husky/pre-push

@@ -1,21 +1,19 @@
 #!/bin/sh
 
-local_branch_name="$(git rev-parse --abbrev-ref HEAD)"
+# Pre-push checks:
+# 1) Enforce branch naming convention
+# 2) Run lint for affected projects
 
-# 1. --- EXCLUSION BLOCK ---
-# Allow structural branches to bypass naming conventions
-if [[ "$local_branch_name" == "main" || "$local_branch_name" == "dev" ]]; then
-    echo "✅ Structural branch detected ($local_branch_name). Skipping naming check."
-else
-    # 2. --- NAMING ENFORCEMENT ---
-    valid_branch_regex="^(feat|fix|chore|docs|refactor)\((mobile|api|shared|pipeline|ci)\)\/[a-z0-9-]+$"
+local_branch_name="$(git rev-parse --abbrev-ref HEAD)"
+valid_branch_regex="^(feat|fix|chore|docs|refactor|ci)\((mobile|api|shared|pipeline|ci)\)/[a-z0-9-]+$"
 
-    if [[ ! $local_branch_name =~ $valid_branch_regex ]]; then
+if [ "$local_branch_name" != "main" ] && [ "$local_branch_name" != "dev" ]; then
+    if ! echo "$local_branch_name" | grep -Eq "$valid_branch_regex"; then
         echo "----------------------------------------------------------------------"
-        echo "❌ ERROR: Invalid branch name '$local_branch_name'"
+        echo "ERROR: Invalid branch name '$local_branch_name'"
         echo "A3Service standards require: type(scope)/description"
         echo "----------------------------------------------------------------------"
-        echo "💡 HOW TO FIX THIS:"
+        echo "How to fix:"
         echo "1. Rename your branch locally:"
         echo "   git branch -m 'feat(scope)/your-description'"
         echo ""
@@ -24,17 +22,12 @@ else
         echo "   B) Delete remote:  git push origin --delete '$local_branch_name'"
         echo "   C) Push new name:  git push origin 'feat(scope)/new-name'"
         echo ""
-        echo "3. Or, delete it and start over:"
-        echo "   git checkout <base-branch>  # e.g., main or a feature branch"
-        echo "   git branch -D '$local_branch_name'"
-        echo ""
-        echo "ALLOWED TYPES: feat, fix, chore, docs, refactor"
+        echo "ALLOWED TYPES: feat, fix, chore, docs, refactor, ci"
         echo "ALLOWED SCOPES: mobile, api, shared, pipeline, ci"
         echo "----------------------------------------------------------------------"
         exit 1
     fi
 fi
 
-# 3. --- QUALITY GATE ---
-echo "🔍 Running Nx Linter on affected files..."
+echo "Running Nx lint on affected projects..."
 npx nx affected -t lint --base=origin/main --parallel=3

.npmrc

@@ -0,0 +1 @@
+legacy-peer-deps=true

apps/api/jest.e2e.config.cjs

@@ -0,0 +1,19 @@
+module.exports = {
+  displayName: 'api-e2e',
+  preset: 'ts-jest/presets/default-esm',
+  testEnvironment: 'node',
+  rootDir: __dirname,
+  testMatch: ['<rootDir>/tests/e2e/**/*.spec.ts'],
+  moduleFileExtensions: ['ts', 'js', 'json'],
+  extensionsToTreatAsEsm: ['.ts'],
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1',
+  },
+  globals: {
+    'ts-jest': {
+      useESM: true,
+      tsconfig: '<rootDir>/tsconfig.spec.json',
+    },
+  },
+  coverageDirectory: '../../coverage/apps/api-e2e',
+};

apps/api/prisma.config.ts

@@ -0,0 +1,23 @@
+import { config } from "dotenv";
+import { join } from "path";
+
+import { existsSync } from "fs";
+
+let envPath = join(process.cwd(), ".env");
+if (!existsSync(envPath)) {
+  envPath = join(process.cwd(), "../../.env");
+}
+config({ path: envPath });
+
+import { defineConfig } from "prisma/config";
+
+export default defineConfig({
+  schema: "prisma/schema.prisma",
+  migrations: {
+    path: "prisma/migrations",
+    seed: "tsx prisma/seed.ts",
+  },
+  datasource: {
+    url: process.env.DIRECT_URL ?? "",
+  },
+});