AdeptHR AR Portal documentation

This site is the working knowledge base for the AdeptHR AR Portal and collections automation product. It combines product intent, implemented behavior, operational runbooks, architecture, and project meeting transcripts.

Start here

• Discovery explains the business problem, users, context, outcomes, constraints, and unresolved questions.
• Product shape describes the product by module and documents behavior that the implementation must preserve.
• Meeting transcripts preserves project decisions and source conversations while excluding the unrelated Risk Portal project.
• Project reference contains everything from the repository’s original docs/ directory.

Run the site locally

From the repository root:

bun install
bun run --cwd apps/docs dev

The production build is static and uses /docs as its public base path:

bun run --cwd apps/docs build

Cloudflare Pages should use apps/docs as its root, bun run build as the build command, and dist as the output directory. The companion apps/docs-edge Worker mounts that output beneath the application hostname without changing non-docs traffic.

Important behavioral constraints

• Email and notification cardinality is a correctness guarantee. Retries must neither duplicate nor lose sends.
• Restate owns durable workflows and scheduled execution; the Fastify process owns interactive HTTP and tRPC requests.
• Client-facing authentication uses short-lived, email-bound magic links.
• Database changes use Prisma migrations. prisma db push is prohibited.
• Raw email webhook bodies must remain available for signature verification.