Encore OS — Documentation

Status: ✅ Complete Spec Reference: PF-47 Bulk Operations Framework
Last Updated: 2026-03-04

Purpose

PF-47 provides a standardized bulk operations framework (delete, update, assign) with progress tracking, rollback, and rate limiting. This document captures integration points: PF dependencies consumed by PF-47 and the platform layer consumed by other cores.

PF Dependencies (Consumed by PF-47)

Dependency	Use	Type
PF-04 (Audit Logging)	All bulk operations and rollbacks are audited	Platform integration
PF-29 (Tasks)	One task per bulk operation for tracking and notifications	Platform integration
PF-42 (Rate Limiting)	Bulk operations use rate limiting (items per second); minimal in-PF-47 limit until PF-42 exists	Platform integration / interface

Platform Integration Layer

Location: /src/platform/bulk-operations/
Import path: @/platform/bulk-operations
Status: ✅ Complete

Public API (from spec)

API	Type	Description
`useBulkOperationsList(organizationId)`	Hook	List bulk operations for an organization
`useBulkOperationProgress(operationId)`	Hook	Single operation with realtime progress
`createBulkOperation(params)`	Function	Submit a new bulk operation
`rollbackBulkOperation(operationId)`	Function	Rollback within rollback window

Consumer Cores

All cores that need bulk delete, bulk update, or bulk assign (e.g. HR, FA, CE, CL, PM) consume this layer. Module-specific handlers define allowed entity types and fields per bulk operation type.

Usage Example

import {
  useBulkOperationsList,
  useBulkOperationProgress,
  createBulkOperation,
  rollbackBulkOperation,
} from '@/platform/bulk-operations';

Event Contracts

PF-47 does not publish domain events in the initial release. Audit events are handled via PF-04. Future enhancements may add events (e.g. bulk_operation_completed) for downstream consumers.

API Contracts

No REST/edge API is specified for initial release. All access is via the documented hooks and functions above. If an edge function or REST API is added later for server-to-server or external callers, it will be documented here.

Integration Matrix

CROSS_CORE_INTEGRATIONS.md: PF-47 → All Cores, Platform Layer, 📝 Planned, this document.

Start Here

Module Engineering Snapshots

Canonical AI Governance

Architecture

Integrations

Development

Decision Guides

Database

Module Reference

Testing

Migration

Operations

Governance & Security

Platform Internals

Bulk Operations Framework — Integration

Purpose

PF Dependencies (Consumed by PF-47)

Platform Integration Layer

Public API (from spec)

Consumer Cores

Usage Example

Event Contracts

API Contracts

Integration Matrix

See Also

​Purpose

​PF Dependencies (Consumed by PF-47)

​Platform Integration Layer

​Public API (from spec)

​Consumer Cores

​Usage Example

​Event Contracts

​API Contracts

​Integration Matrix

​See Also

Purpose

PF Dependencies (Consumed by PF-47)

Platform Integration Layer

Public API (from spec)

Consumer Cores

Usage Example

Event Contracts

API Contracts

Integration Matrix

See Also