How mbs-23/fiberops-inventory-api works
FiberOps is a small Spring API for exchanges, fibre routes, and region-owned maintenance work orders. Clients call the exchange and route endpoints for inventory and use the work-order endpoints to queue, read, or open jobs; the work-order service sets the region within each transaction, while PostgreSQL row-level security enforces visibility and write scope. The README documents the API, migrations, route-length function, and RLS behavior. Some subsystem links are therefore documented rather than verified against unsampled implementation files.
Main entry points: WorkOrderService.java Work-order operations · FibreRouteRepository.java Route access · ExchangeController.java Exchange endpoints · ExchangeService.java Exchange operations
Components 17
Exchange inventory
- Exchange endpoints
src/main/java/io/github/mbs23/fiberops/exchange/ExchangeController.java - Exchange operations
src/main/java/io/github/mbs23/fiberops/exchange/ExchangeService.java - Exchange access
src/main/java/io/github/mbs23/fiberops/exchange/ExchangeRepository.java - Exchange model
src/main/java/io/github/mbs23/fiberops/exchange/Exchange.java
Fibre routes
- Route endpoints
src/main/java/io/github/mbs23/fiberops/route/FibreRouteController.java - Route queries
src/main/java/io/github/mbs23/fiberops/route/FibreRouteService.java - Route access
src/main/java/io/github/mbs23/fiberops/route/FibreRouteRepository.java - Route model
src/main/java/io/github/mbs23/fiberops/route/FibreRoute.java
Work orders
- Work-order endpoints
src/main/java/io/github/mbs23/fiberops/workorder/WorkOrderController.java - Work-order operations
src/main/java/io/github/mbs23/fiberops/workorder/WorkOrderService.java - Work-order access
src/main/java/io/github/mbs23/fiberops/workorder/WorkOrderRepository.java - Work-order model
src/main/java/io/github/mbs23/fiberops/workorder/WorkOrder.java
Persistence and security
- Transaction region scope
src/main/java/io/github/mbs23/fiberops/db/RegionScope.java - PostgreSQL
- Schema and function
src/main/resources/db/migration/V1__schema.sql - Work-order RLS
src/main/resources/db/migration/V3__work_order_rls.sql
Other components
- API client
Connections 17
- API client → Exchange endpoints: requests
README.md - API client → Route endpoints: requests
README.md - API client → Work-order endpoints: requests
README.md - Exchange endpoints → Exchange operations: dispatches
src/main/java/io/github/mbs23/fiberops/exchange/ExchangeController.java - Exchange operations → Exchange access: queries and saves
src/main/java/io/github/mbs23/fiberops/exchange/ExchangeService.java - Exchange access → PostgreSQL: reads and writes
- Route endpoints → Route queries: dispatches
src/main/java/io/github/mbs23/fiberops/route/FibreRouteController.java - Route queries → Route access: queries
src/main/java/io/github/mbs23/fiberops/route/FibreRouteService.java - Route access → PostgreSQL: queries function
src/main/java/io/github/mbs23/fiberops/route/FibreRouteRepository.java - Work-order endpoints → Work-order operations: dispatches
src/main/java/io/github/mbs23/fiberops/workorder/WorkOrderController.java - Work-order operations → Transaction region scope: sets region
src/main/java/io/github/mbs23/fiberops/workorder/WorkOrderService.java - Transaction region scope → PostgreSQL: sets transaction setting
README.md - Work-order operations → Work-order access: queries and saves
src/main/java/io/github/mbs23/fiberops/workorder/WorkOrderService.java - Work-order operations → Route access: checks route
src/main/java/io/github/mbs23/fiberops/workorder/WorkOrderService.java - Work-order access → PostgreSQL: queries and writes
- Schema and function → PostgreSQL: defines schema
README.md - Work-order RLS → PostgreSQL: enforces isolation
README.md