README.md

ARX App

This repository contains the product application for app.arxsec.io, ARX's AI workforce infrastructure for objective-aligned enterprise execution.

It contains:

• The FastAPI execution layer at the repo root
• The Next.js objective and workforce dashboard in frontend/
• API docs and OpenAPI artifacts in docs/api/
• A repo-to-docs implementation map in docs/IMPLEMENTATION_INVENTORY.md
• Human surface maps for API, dashboard, connectors, and operations
• Repository boundary rules in docs/REPO_BOUNDARIES.md
• Maintenance matrices and generated inventories under docs/ and docs/generated/

The code was split out of /Users/mr.frierson/Project-Agent/arxsec-api on May 15, 2026 so the objective-led product app can evolve independently from the public marketing site.

Local development

API:

``bash pip install -r requirements.txt uvicorn main:app --reload --port 5000 ``

Frontend:

``bash cd frontend cp .env.example .env.local npm ci npm run dev ``

Repo layout

``text . ├── app/ FastAPI application code for objective, worker, and posture workflows ├── frontend/ Next.js app for app.arxsec.io ├── docs/api/ API reference and committed OpenAPI artifact ├── scripts/ Operational scripts, including OpenAPI export ├── supabase/ Schema and migrations └── tests/ Backend test suite ``

Documentation maintenance

``bash python3 scripts/generate_docs_inventory.py ``

Run this after adding or renaming API routers, dashboard routes, or connector modules. See docs/DOCS_MAINTENANCE_CHECKLIST.md.

Split notes

• The source monorepo at /Users/mr.frierson/Project-Agent was left untouched.
• Some CI files were copied from the old monorepo and updated to run from this repo root.
• If you later want to preserve full commit history per path, we can do a follow-up git filter-repo migration before publishing.