Senior comments

def calculate_discount(price, user):
	# Premium users get 20% off to match our competitor pricing
	# Tested with focus group Aug 2023 - increased retention by 12%
	# Decision doc: docs/decisions/premium-pricing.md
	PREMIUM_DISCOUNT_RATE = 0.20
	
	if user.premium:
		return price 
	return price * (1 - PREMIUM_DISCOUNT_RATE)

// Per BSA regulations (31 CFR 103.33), we must report
// transfers >$10k within 15 days. To avoid reporting overhead,
// we cap individual transfers at this threshold.
//
// Users can make multiple transfers; this is legally compliant.
// Legal review: 2023-04-15
// Regulation reference: https://www.fincen.gov/resources/statutes-regulations/a
const MAX_TRANSFER_AMOUNT = 10000;
 
async function createTransfer (amount: number, from: Account, to: Account) {
	if (amount › MAX_TRANSFER_AMOUNT) {
		throw new TransferLimitExceededError ('Transfers are limited to $${MAX_TRANSFER_AMOUNT} per transaction. ' + 'This is a regulatory requirement, not a technical limitation.')
	}
	// ... rest of implementation
}

// Stripe charges 2.9% + $0.30 per transaction
// We pass this through to users on transactions ‹$10
// For larger transactions, we absorb it (reduces churn by 8%)
const FEE_THRESHOLD = 1000; // in cents

// We tried async/await here but hit deadlocks under load
// See incident post-mortem: docs/incidents/2024-01-15-deadlock.md
// Synchronous approach is slower but reliable
fn process_batch_sync(items: Vec<Item>) -> Result<(> {

// API rate limited to 100 req/min per docs/api-limits.md
// We batch requests to stay under limit with 20% safety margin
const maxRequestsPerMinute = 80

// TODO: Move to event-driven architecture
// Blocked on: Kafka cluster provisioning (INFRA-445)
// Timeline: Q2 2024
// This polling approach is temporary
pollForUpdates() ;

// Payment provider SLA is 30s for 99.9% of requests
// Set timeout to 1.5x SLA to balance user experience vs cost
// Any request ›45s has <0.01% chance of success (data: metrics/payment-latency.md)
// Engineering decision: better to fail fast and retry
const PAYMENT_TIMEOUT_MS = 45000;