Delegation & Collaboration - Version Mapping
Domain: Delegation & Collaboration Domain Number: 10 First Introduced: V1.1 Status: Specification Complete Last Updated: 2025-10-25
Overview
This document maps Delegation & Collaboration domain features and entities to specific MVP and version releases. It provides a quick reference for understanding when cross-org collaboration capabilities were introduced and when team management features become available.
Version Timeline
| Version | Status | Key Features |
|---|---|---|
| MVP.0 | OUT OF SCOPE | Entire domain deferred |
| MVP.1 | OUT OF SCOPE | Still deferred |
| MVP.2 | OUT OF SCOPE | Still deferred |
| V1.1 | Planned | Full delegation, teams, tasks, notifications |
| V1.2 | Future | Enhanced delegation, multi-level chains |
| V2.0 | Future | Communications integration, revenue sharing |
Entity Version Mapping
MVP.0-MVP.2 Entities
| Entity | Status | Rationale |
|---|---|---|
| ALL | ❌ Deferred | MVP focuses on single-org villa management; no multi-org use cases |
V1.1 Entities
| Entity | Table Name | Purpose | Status |
|---|---|---|---|
| Delegation | delegations | Cross-org access grants | ✅ Planned |
| ResourceReference | resource_references | Granular resource-level access | ✅ Planned |
| DelegatedMembership | delegated_memberships | Derived membership views | ✅ Planned |
| Team | teams | User groups within org | ✅ Planned |
| TeamMembership | team_memberships | User-to-team assignments | ✅ Planned |
| Task | tasks | Work assignments and approvals | ✅ Planned |
| Notification | notifications | In-app alerts and messages | ✅ Planned |
| CollaborationLog | collaboration_logs | Cross-org audit trail | ✅ Planned |
V1.2 Entities
| Entity | Table Name | Purpose | Status |
|---|---|---|---|
| DelegationTemplate | delegation_templates | Reusable delegation configs | 📋 Future |
| DelegationChain | delegation_chains | Multi-level delegation tracking | 📋 Future |
| ApiKey | api_keys | System-to-system delegations | 📋 Future |
V2.0 Entities
| Entity | Table Name | Purpose | Status |
|---|---|---|---|
| NotificationTemplate | notification_templates | Rich notification designs | 📋 Future |
| RevenueShare | revenue_shares | Commission calculations | 📋 Future |
| WorkflowDefinition | workflow_definitions | Custom approval chains | 📋 Future |
Feature Version Mapping
MVP.0-MVP.2 Features (OUT OF SCOPE)
Status: ❌ Entire domain deferred
Rationale:
- Initial MVP targets single-org property management
- No cross-org collaboration requirements
- No team management needs (small operator teams)
- Simplifies MVP development and testing
Workarounds:
- Manual coordination between organizations
- Email-based communication for collaboration
- Single-user or small team operations only
V1.1 Features (Initial Implementation)
Delegation Management:
- ✅ Create cross-org delegation relationships
- ✅ Resource-level access grants (specific Spaces/Units)
- ✅ Scope-based permissions (read, write, manage)
- ✅ Temporal access controls (start_at, end_at)
- ✅ Delegation approval workflow
- ✅ Revocation with cascade cleanup
DelegatedMembership Resolution:
- ✅ Dynamic membership view generation
- ✅ Derived role mapping from delegation scope
- ✅ Authorization middleware integration
- ✅ TTL-based caching for performance
Team Management:
- ✅ Create and manage teams within orgs
- ✅ Team membership with roles (admin, member, viewer)
- ✅ Org-wide and account-scoped teams
- ✅ Team-based permission inheritance
Task & Workflow:
- ✅ Task creation and assignment
- ✅ Team-level and user-level assignments
- ✅ Approval workflows (requires_approval flag)
- ✅ Due date tracking
- ✅ Task status lifecycle (pending → completed)
- ✅ Resource linking (tasks tied to Spaces, Bookings, etc.)
Notifications:
- ✅ In-app notification generation
- ✅ Event-driven alerts (delegation changes, task assignments)
- ✅ Notification status tracking (sent, read, dismissed)
- ✅ Priority-based delivery
- ✅ Action URL deep linking
Audit & Compliance:
- ✅ CollaborationLog for all cross-org actions
- ✅ Immutable audit trail
- ✅ Both grantor and grantee can audit
- ✅ 7-year retention for compliance
Use Cases Enabled:
- ✅ TVL Ops managing owner properties
- ✅ Property manager delegations
- ✅ Partner channel access
- ✅ Team-based operations workflows
V1.2 Features (Enhanced Delegation)
Multi-Level Delegation:
- 📋 Delegation chains (owner → manager → contractor)
- 📋 Chain visibility and tracking
- 📋 Scope narrowing enforcement
Conditional Policies:
- 📋 Region-based delegation rules
- 📋 Brand-based access restrictions
- 📋 Resource attribute filtering
System Integration:
- 📋 API key-based delegations
- 📋 Service account support
- 📋 Programmatic delegation management
Templates & Automation:
- 📋 Delegation templates for common scenarios
- 📋 Auto-expiration with renewal workflows
- 📋 Bulk delegation operations
V2.0 Features (Communications & Revenue)
Communications Integration:
- 📋 Email notification delivery
- 📋 SMS alerts for urgent notifications
- 📋 Webhook notifications for external systems
- 📋 Rich notification templates (HTML emails)
- 📋 Notification preference management
- 📋 Digest notifications (daily/weekly summaries)
Revenue Sharing:
- 📋 Commission calculations based on delegations
- 📋 Automated payout distribution
- 📋 Revenue split configuration per delegation
- 📋 Financial reporting for delegated operations
Advanced Workflows:
- 📋 Visual workflow builder
- 📋 Parallel approval requirements
- 📋 Conditional task routing
- 📋 Recurring task templates
- 📋 Task dependency management
Workflow Version Mapping
| Workflow | MVP.0-MVP.2 | V1.1 | V1.2 | V2.0 |
|---|---|---|---|---|
| Create Delegation | ❌ | ✅ | ✅ Enhanced | ✅ |
| Access Delegated Resource | ❌ | ✅ | ✅ Chain support | ✅ |
| Revoke Delegation | ❌ | ✅ | ✅ | ✅ |
| Assign Task to Team | ❌ | ✅ | ✅ Templates | ✅ Workflows |
| Approval Workflow | ❌ | ✅ Basic | ✅ Multi-level | ✅ Visual builder |
| Generate Notifications | ❌ | ✅ In-app | ✅ | ✅ Email/SMS |
Dependency Version Mapping
V1.1 Dependencies
Required Domains:
- ✅ Identity & Tenancy (MVP.0) - Org, Account, User entities
- ✅ Authorization & Access (MVP.0) - Permission evaluation
Depended On By:
- 🔄 Supply (MVP.0) - Delegated space/unit management
- 🔄 Availability (MVP.0) - Delegated calendar access
- 🔄 Pricing (MVP.0) - Delegated pricing control
- 🔄 Bookings (MVP.0) - Cross-org booking management
- 🔄 Channels (MVP.0) - Channel partner delegations
- 🔄 Analytics (MVP.0) - Collaboration event tracking
Related:
- 🔄 Payments & Financials (MVP.0) - Revenue sharing (V2.0+)
Technical Implementation Timeline
V1.1 Implementation
Database:
- ✅ 8 tables: delegations, resource_references, delegated_memberships, teams, team_memberships, tasks, notifications, collaboration_logs
- ✅ 20+ indexes for query performance
- ✅ 8+ constraints for data integrity
- ✅ Time-based partitioning for collaboration_logs
API Endpoints:
- ✅ POST /api/delegations - Create delegation
- ✅ GET /api/delegations - List delegations (grantor & grantee views)
- ✅ DELETE /api/delegations/:id - Revoke delegation
- ✅ POST /api/teams - Create team
- ✅ POST /api/teams/:id/members - Add team member
- ✅ POST /api/tasks - Create task
- ✅ PATCH /api/tasks/:id - Update task status
- ✅ GET /api/notifications - List user notifications
- ✅ GET /api/collaboration-logs - Audit trail query
Authorization Middleware:
- ✅ Extended permission check to include DelegatedMembership
- ✅ Delegation scope resolution
- ✅ Cached delegation lookups (TTL: 5 min)
- ✅ Delegation expiration enforcement
Background Jobs:
- ✅ Notification generation worker
- ✅ Delegation expiration checker
- ✅ Collaboration log partitioning maintenance
Admin UI:
- ✅ Delegation management dashboard
- ✅ Team management interface
- ✅ Task assignment and approval UI
- ✅ Notification center
Business Rules by Version
V1.1 Rules
- ✅ Delegation Isolation: Delegations extend access, never transfer ownership
- ✅ Temporal Enforcement: Active only between start_at and end_at
- ✅ Scope Hierarchy: manage > write > read
- ✅ Audit Everything: All delegation events logged
- ✅ Cascade Revocation: Revoking delegation invalidates derived memberships
- ✅ Team Membership Prerequisites: Users must be org members first
- ✅ Task Assignment Constraints: Only assign to team/org members
- ✅ Approval Requirements: requires_approval tasks cannot complete without approval
- ✅ Notification Priority: High/urgent override user preferences
- ✅ Resource Reference Validation: Must exist in grantor org
V1.2 Rules
- 📋 Chain Scope Narrowing: Delegated scope can only be narrowed, never widened
- 📋 Template Immutability: Templates cannot be modified after use (versioning)
- 📋 API Key Expiration: System delegations require periodic rotation
Performance Targets by Version
V1.1 Targets
| Metric | Target | Measurement |
|---|---|---|
| Delegation resolution latency | < 100ms | p95 cached lookup |
| Authorization check overhead | < 10ms | Additional latency vs base check |
| Notification generation | < 5s | From event to notification created |
| Task assignment latency | < 500ms | Create + notify |
| Collaboration log query | < 2s | 90-day audit trail |
| Team member lookup | < 50ms | Cached membership resolution |
V1.2 Targets
| Metric | Target | Status |
|---|---|---|
| Multi-level delegation resolution | < 200ms | 📋 Chain traversal |
| Template instantiation | < 1s | 📋 Bulk operations |
Migration Notes
From MVP.2 to V1.1
New Capabilities:
- Full cross-org delegation infrastructure
- Team management
- Task workflows
- In-app notifications
Breaking Changes:
- None (greenfield feature)
Migration Steps:
- Deploy delegation domain schema (8 tables)
- Create initial delegation approval workflow
- Migrate existing cross-org access (if any) to Delegation entities
- Enable authorization middleware delegation checks
- Configure notification generation workers
- Train users on delegation and team management UI
Data Migration:
- No existing data to migrate (new domain)
- Seed initial Teams for existing organizations (optional)
From V1.1 to V1.2
New Capabilities:
- Multi-level delegation chains
- Delegation templates
- API key delegations
Breaking Changes:
- None (additive only)
Migration Steps:
- Deploy delegation_templates and delegation_chains tables
- Backfill existing delegations into chain tracking
- Enable template creation UI
- Configure API key rotation policies
Related Documents
- Delegation & Collaboration Specification - Complete domain spec
- Identity & Tenancy Specification - Base tenancy model
- Authorization & Access Specification - Permission evaluation
- V1.1 Product Vision - Overall V1.1 scope
- Roadmap - Future version planning
Glossary
- Delegation: Formal relationship granting one org controlled access to another org's resources
- Grantor: Organization granting access to its resources
- Grantee: Organization receiving delegated access
- DelegatedMembership: Temporary, derived membership view for cross-org users
- Scope: Permission level (read, write, manage)
- ResourceReference: Link to specific resources within a delegation
- Team: Group of users within an organization
- Task: Work assignment with optional approval requirement
- CollaborationLog: Immutable audit trail of cross-org actions
- Derived Role: Role granted via delegation scope mapping