ObanPowertools.Web.Router (oban_powertools v0.5.0)

Copy Markdown View Source

Provides routing helpers to inject the Oban Powertools Web interface.

Host applications own the outer "/ops/jobs" scope and browser pipeline. This module owns only the native Powertools route tree mounted inside that host-owned shell. Native Powertools pages own audited mutations, while the optional /ops/jobs/oban bridge stays a nested read-only inspection surface.

Summary

Functions

oban_powertools_routes(path)

Mounts the native Powertools route tree inside a host-owned browser scope.

Functions

oban_powertools_routes(path)

(macro)

Mounts the native Powertools route tree inside a host-owned browser scope.

The public contract for the optional bridge is:

  • the host router owns the outer "/ops/jobs" scope
  • the host router owns pipe_through(:browser) for that outer scope
  • oban_powertools_routes("/oban") owns only the inner native LiveView routes beneath that host-owned scope
  • when Oban.Web.Router is available, the optional bridge path is "/oban" beneath the same host-owned outer scope
  • the optional bridge reuses ObanPowertools.Web.LiveAuth plus a Powertools- owned resolver adapter over documented Oban.Web.Resolver hooks
  • the optional bridge remains read-only, while native Powertools pages own audited mutations

The optional bridge contract stays thin. Powertools owns only the nested mount, actor handoff, access mapping, and shared display formatting hooks. It does not become a shadow dashboard or generic Oban Web plugin surface, and it does not replace native Powertools pages for audited mutations.