AgileX Recruitment ATS

1 Architecture Overview

The demonstrator aligns with the 2nth.ai Cloudflare-first architecture. For local testing, Cloudflare Tunnel is replaced by direct localhost access.

2nth.ai Alignment

2 Prerequisites

brew install orbstack

brew install git node

3 Local Docker Setup

git clone https://github.com/hcengineering/huly-selfhost.git
cd huly-selfhost

./setup.sh --quick

docker compose ps # all services should show "Up"
docker compose logs -f # follow logs (Ctrl+C to exit)

4 Account & Workspace Creation

Create Admin Account (API)

curl -s -X POST "http://localhost:8087/_accounts" \
  -H "Content-Type: application/json" \
  -d '{"method": "signUp", "params": {
    "email": "admin@agilex.co.za",
    "password": "AgileX2024!",
    "firstName": "Craig",
    "lastName": "Sobey"
  }}'

Returns a JWT token for authenticated requests.

Create Workspace

# Use the token from signUp response
curl -s -X POST "http://localhost:8087/_accounts" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"method": "createWorkspace", "params": {
    "workspaceName": "AgileX Recruitment",
    "workspaceUrl": "agilex-recruitment"
  }}'

Returns a workspace token with the workspace UUID and URL.

- STATS_URL=http://stats:4900   # was: http://localhost:8087/_stats

5 Staff Onboarding (10 Members)

Each staff member is created in two steps: signUp (creates account) then invite + join (adds to workspace).

Step 1: Create Staff Accounts

# For each staff member:
curl -s -X POST "http://localhost:8087/_accounts" \
  -H "Content-Type: application/json" \
  -d '{"method": "signUp", "params": {
    "email": "thandi.mokoena@agilex.co.za",
    "password": "AgileX2024!",
    "firstName": "Thandi",
    "lastName": "Mokoena"
  }}'

Step 2: Create Invite Link (as workspace Owner)

curl -s -X POST "http://localhost:8087/_accounts" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OWNER_TOKEN" \
  -d '{"method": "createInviteLink", "params": {
    "email": "thandi.mokoena@agilex.co.za",
    "role": "OWNER",
    "expHours": 720
  }}'
# Returns: http://localhost:8087/login/join?inviteId=...

Step 3: Accept Invite (as the staff member)

# Extract inviteId from the URL, then:
curl -s -X POST "http://localhost:8087/_accounts" \
  -H "Content-Type: application/json" \
  -d '{"method": "join", "params": {
    "email": "thandi.mokoena@agilex.co.za",
    "password": "AgileX2024!",
    "inviteId": "INVITE_ID_HERE"
  }}'

Staff Directory

All staff passwords: AgileX2024!

6 Seed Recruitment Data

Data is seeded directly into CockroachDB using a Node.js script that generates SQL matching Huly's document schema (JSONB data column with class mixins).

Generate & Execute

# Generate SQL from seed script
node seed-recruitment.mjs > seed-data.sql

# Execute against CockroachDB
docker compose exec -T cockroach ./cockroach sql \
  --url="$DB_URL" < seed-data.sql

# Restart transactor to pick up new data
docker compose restart transactor

Client Organisations (10)

Vacancies (15)

Candidates (30)

7 Data Summary

Candidate Pipeline Distribution

8 Login Reference

9 Next Steps