Skip to content

Multi-Tenant Architecture - Product Requirements Document

Version: 2.0 | Status: Business Review | Date: 2026-01-15 Previous Version: 1.0 (Technical Draft) | Author: Product Team


Change Log

VersionDateChanges
2.02026-01-15Converted to business-focused format; added measurable outcomes and success metrics
1.02026-01-09Initial technical draft

1. Executive Summary

1.1 Purpose

Enable Toprent.app to serve multiple vehicle rental companies within a single platform while maintaining complete data isolation. Each rental company operates independently with their own customers, vehicles, orders, and business settings.

1.2 Business Value

Value AreaMeasurable OutcomeTimeframe
Infrastructure SavingsReduce hosting costs by 60-70% compared to single-tenant deploymentsWithin 12 months
Faster OnboardingProvision new rental companies in <24 hours vs. 2-4 weeks for dedicated systemsImmediate
Data SecurityZero cross-tenant data breaches or compliance incidentsOngoing
Market ExpansionEnable 50+ new tenant acquisitions annually without infrastructure scaling delaysWithin 12 months
Revenue GrowthUnlock marketplace revenue stream (5-10% transaction fees on cross-tenant rentals)Within 18 months

1.3 Target Users

User TypeBusiness Context
Company OwnersManage rental business operations, branding, and policies
Rental StaffHandle reservations, customer service, and daily operations
Delivery PersonnelPerform vehicle handoffs and pickups
Partner CompaniesShare vehicle fleets through marketplace
Platform OperationsManage tenant provisioning and platform health

1.4 Scope

Included:

  • Complete data isolation between rental companies
  • Company-specific branding, pricing, and policies
  • Cross-company user access (consultants, multi-location operators)
  • Independent payment processing per company
  • Optional marketplace for fleet sharing between partners
  • Per-company subscription plans and usage tracking

Excluded:

  • Self-service tenant provisioning (manual process)
  • Data migration/export tools (future consideration)

2. Success Metrics

MetricDefinitionBaselineTargetMeasurement Method
Infrastructure Cost per TenantMonthly hosting cost ÷ active tenantsN/A (new)<$50/tenant/month at 100+ tenantsCloud billing reports
Tenant Onboarding TimeHours from contract to operational system80-160 hours (est.)<24 hoursProvisioning timestamps
Data Isolation ComplianceCross-tenant data access incidents00 (maintain)Security audit logs, penetration tests
Tenant Activation Rate% of provisioned tenants actively using system within 7 daysN/A (new)>90%Login analytics
Marketplace Participation% of tenants enabling marketplace featuresN/A (new)30% within 12 monthsFeature flag analytics
Cross-Tenant RevenueMonthly GMV from marketplace transactions$0$50K/month within 18 monthsPayment processor reports
Tenant Retention% of tenants renewing annuallyN/A (new)>85%Subscription records
Support Ticket VolumeTenant isolation-related support ticketsN/A (new)<5/monthHelp desk categorization

3. User Stories

Company Owners (P0 - Critical)

IDStoryAcceptance Criteria
US-01As a company owner, I want my company data completely isolated from competitors so customer privacy is protectedGiven I’m logged in, when I access any data, then only my company’s records are visible; attempting to access another company’s data returns “not found”
US-02As a company owner, I want my branding on all customer materials so my brand identity is consistentGiven I’ve configured my logo and colors, when documents/emails are generated, then 100% display my branding with zero defaults
US-03As a company owner, I want my own pricing rules so I can run my business independentlyGiven I’ve configured pricing, when quotes are generated, then my rules are applied with zero influence from other companies

Company Owners (P1 - Important)

IDStoryAcceptance Criteria
US-04As a company owner, I want my own payment processor so funds flow to my accountGiven I’ve connected Stripe, when customers pay, then 100% of funds route to my account
US-05As a company owner, I want customizable legal documents so I comply with local regulationsGiven I’ve configured templates, when agreements are generated, then they use my templates with my legal language

Company Owners (P2 - Nice to Have)

IDStoryAcceptance Criteria
US-06As a company owner, I want to optionally rent partner vehicles so I can serve customers when my fleet is unavailableGiven marketplace is enabled, when staff searches vehicles, then partner inventory appears with clear partner branding

Rental Staff (P0 - Critical)

IDStoryAcceptance Criteria
US-07As rental staff, I want to see only my company’s data so I work efficiently without confusionGiven I’m logged in, when I view vehicles/orders/customers, then only my company’s records appear
US-08As rental staff, I want automatic pricing on reservations so quotes are consistentGiven I create a reservation, when pricing calculates, then my company’s rules apply automatically

Rental Staff (P1 - Important)

IDStoryAcceptance Criteria
US-09As rental staff, I want customers scoped to my company so I never access wrong dataGiven I search customers, when results appear, then only my company’s customers are shown

Delivery Personnel (P0 - Critical)

IDStoryAcceptance Criteria
US-10As delivery personnel, I want to see only my company’s tasks so I focus on my workGiven I’m logged in to mobile app, when I view tasks, then only my company’s deliveries/pickups appear

Platform Operations (P0 - Critical)

IDStoryAcceptance Criteria
US-11As platform operations, I want automatic data isolation so no bugs cause data leakageGiven any user query, when executed, then tenant filtering is enforced at infrastructure level
US-12As platform operations, I want fast tenant provisioning so new companies start quicklyGiven a new contract, when provisioning runs, then tenant is operational within 24 hours

4. Functional Requirements

IDRequirementPriorityBusiness Rationale
FR-01All company-specific data must be isolated at infrastructure levelP0Prevents data breaches, ensures compliance
FR-02Users can access multiple companies with different roles per companyP0Supports consultants, franchises, multi-location operators
FR-03Each company has independent settings (branding, policies, pricing)P0Enables business autonomy
FR-04Vehicles can be owned or sourced from marketplace partnersP0Enables marketplace business model
FR-05Orders are company-specific with optional partner vehicle referencesP0Supports cross-company rentals
FR-06Customer data is fully isolated per company (no sharing)P0GDPR compliance, privacy protection
FR-07Payment processing routes to company-specific accountsP0Financial isolation, regulatory compliance
FR-08Each company has independent subscription plan with enforced limitsP0Enables tiered pricing model
FR-09Company-specific integrations operate independentlyP1Supports diverse third-party requirements
FR-10Documents and communications use company brandingP1Professional customer experience
FR-11Marketplace features respect company boundaries and opt-in settingsP1Controlled partner exposure
FR-12All operations are logged with company contextP1Audit compliance, security monitoring
FR-13Usage-based billing events are tracked per companyP2Enables consumption pricing model
FR-14Custom domains map uniquely to companiesP2Professional web presence

5. Business Rules

IDRuleBusiness Rationale
BR-01Users can belong to multiple companies with one role per companySupports consultants, franchises, enterprise groups
BR-02Company assignment cannot change after record creationPrevents accidental/malicious data transfer
BR-03Reference data (vehicle brands, models) is shared platform-wideReduces duplication, ensures consistency
BR-04Companies can customize shared reference dataEnables business-specific naming preferences
BR-05Partners are linked through explicit business relationshipsControls B2B marketplace access
BR-06Orders can reference partner vehicles for marketplace rentalsEnables cross-company revenue
BR-07Customers are never shared across companiesGDPR compliance, competitive protection
BR-08Financial records are always company-specificRegulatory compliance, accurate reporting
BR-09Subscription plans apply to company, not individual usersAligns billing with business entity
BR-10Marketplace participation is opt-in per companyRespects business autonomy
BR-11Account suspension preserves data but blocks accessSupports collections, regulatory holds
BR-12Account deletion cascades to all related dataGDPR “right to be forgotten” compliance

6. Acceptance Criteria

AC-01: Data Isolation Verification

Given a user authenticated to Company A
When they query any business data (orders, vehicles, customers)
Then only Company A records are returned
And no information about other companies is accessible or inferrable

AC-02: Cross-Company Access Prevention

Given a user attempts to access a resource belonging to another company
When the request is processed
Then a “not found” response is returned
And no existence information is leaked

AC-03: Company Branding Application

Given a company has configured custom branding
When any customer-facing material is generated
Then 100% of materials display company branding
And zero platform defaults appear

AC-04: Marketplace Visibility Control

Given a company has enabled marketplace
When staff searches available vehicles
Then own vehicles and partner vehicles are visible
And non-partner company vehicles remain hidden

AC-05: Subscription Limit Enforcement

Given a company has specific plan limits
When they attempt to exceed limits
Then the action is blocked
And upgrade messaging is displayed

AC-06: Payment Routing Accuracy

Given a company has connected payment processing
When a customer payment is processed
Then 100% of funds route to that company’s account
And financial records reflect correct company

AC-07: Multi-Language Support

Given different companies operate in different regions
When each company sets their language preference
Then all interfaces, emails, and documents default to that language
And customers can override with their preference


7. Dependencies

7.1 Foundation Status

Multi-tenant architecture is the foundational layer. No upstream dependencies.

7.2 Downstream Dependencies

All platform features depend on this architecture:

  • User Management & Authentication
  • Vehicle Fleet Management
  • Order & Reservation Processing
  • Payment & Financial Processing
  • Marketplace & Partner Features
  • Reporting & Analytics
  • Third-Party Integrations
  • Public Booking Widgets

8. Glossary

TermBusiness Definition
Tenant/CompanyA vehicle rental business using Toprent.app with isolated data
MarketplaceFeature enabling companies to rent vehicles from partner companies
PartnerAnother company with an established business relationship for fleet sharing
Plan LimitsSubscription-based restrictions (vehicles, users, reservations)
Billable EventsUsage tracked for consumption billing (SMS, emails, storage)
Custom DomainCompany’s own web address mapped to their Toprent presence
WidgetEmbeddable booking form displaying company branding and inventory

9. Approval

RoleNameDateStatus
Product OwnerPending
Engineering LeadPending
Business StakeholderPending

10. Unresolved Questions

  1. Self-service provisioning timeline? Currently manual - when to automate?
  2. Data export requirements? Legal/compliance need for tenant data portability?
  3. Marketplace fee structure? Fixed % or tiered by volume?
  4. Tenant deletion SLA? Time to complete cascade deletion for GDPR requests?
  5. Multi-region isolation? Separate data centers per geography for sovereignty?