Workforce Modeler

Sprint 1 of ARX Product 4 — the consultant-grade decision-support tool that takes an enterprise org chart and produces a board-ready AI workforce blueprint in editorial PDF format.

This is an isolated FastAPI app. It does not depend on arxsec-api/ or the Next.js console. It can be deployed independently.

Sprint 1 scope

• Manual intake form (no HRIS integration)
• Hardcoded knowledge graph of 10 Sales workforce agent patterns
• Rule-based mapping (no optimization model)
• Static 8-page board-ready PDF in editorial style via ReportLab

Sprint 2+ expands the knowledge graph (75 → 200 patterns), adds Workday/BambooHR integrations, multi-scenario comparison, and industry-specific overlays.

Run locally

``bash cd workforce-modeler python3 -m venv .venv && source .venv/bin/activate pip install -r requirements.txt uvicorn app.main:app --reload --port 8090 ``

Then open <http://localhost:8090>.

Endpoints

| Method | Path | Description | | ------ | ----------- | ------------------------------------ | | GET | / | Intake form (HTML) | | POST | /model | Generate the blueprint PDF (returns application/pdf) | | GET | /health | Liveness probe |

Layout

`` workforce-modeler/ app/ main.py FastAPI app knowledge_graph.py 10 Sales agent patterns mapper.py Rule-based org-chart → workforce mapping pdf_generator.py ReportLab 8-page board report templates/ index.html Intake form (editorial style) static/ editorial.css Editorial design tokens (Fraunces, mono, paper-ink) requirements.txt README.md ``