generated from coulomb/repo-seed
tegwick
ea2c2c6403
Split infrastructure vs payment-processing costs. Liquidity burn now uses infrastructure cash out only (€1,155.20 cumulative) because Stripe fees are already deducted from net member payments. Total platform cost (€1,158.24) remains visible for gross-margin economics.
117 lines
2.5 KiB
Python
117 lines
2.5 KiB
Python
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
from decimal import Decimal
|
|
from typing import Literal
|
|
|
|
CostCategory = Literal["fixed", "variable"]
|
|
MemberStatus = Literal["active", "churned", "paused"]
|
|
PricingModelStatus = Literal["active", "candidate", "retired"]
|
|
LiquidityStatus = Literal["burning", "neutral", "generating"]
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class Product:
|
|
id: str
|
|
name: str
|
|
lifecycle_phase: str
|
|
currency: str
|
|
description: str
|
|
active_pricing_model_id: str
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class PricingModel:
|
|
id: str
|
|
name: str
|
|
model_type: str
|
|
lifecycle_phase: str
|
|
currency: str
|
|
access_fee_amount: Decimal
|
|
access_fee_cadence: str
|
|
status: PricingModelStatus
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class CostEntry:
|
|
id: str
|
|
name: str
|
|
category: CostCategory
|
|
amount: Decimal
|
|
currency: str
|
|
cadence: str
|
|
allocation: str
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class MonthlyPlatformCost:
|
|
period: str
|
|
infrastructure_cost: Decimal
|
|
payment_processing_cost: Decimal
|
|
active_members: int
|
|
gross_revenue: Decimal
|
|
|
|
@property
|
|
def total_platform_cost(self) -> Decimal:
|
|
return self.infrastructure_cost + self.payment_processing_cost
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class Budget:
|
|
currency: str
|
|
initial_budget: Decimal
|
|
started: str
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class RevenueEntry:
|
|
id: str
|
|
period: str
|
|
gross_amount: Decimal
|
|
fees_amount: Decimal
|
|
refunds_amount: Decimal
|
|
net_amount: Decimal
|
|
currency: str
|
|
source: str
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class MembershipRecord:
|
|
id: str
|
|
status: MemberStatus
|
|
joined_at: str
|
|
plan_id: str
|
|
churned_at: str | None = None
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class EconomicsSnapshot:
|
|
period: str
|
|
currency: str
|
|
active_members: int
|
|
monthly_revenue: Decimal
|
|
monthly_infrastructure_cost: Decimal
|
|
monthly_payment_processing_cost: Decimal
|
|
monthly_total_platform_cost: Decimal
|
|
cost_per_member: Decimal
|
|
gross_margin: Decimal
|
|
gross_margin_pct: Decimal
|
|
pricing_model_count: int
|
|
revenue_source: str
|
|
period_net_liquidity: Decimal
|
|
liquidity_status: LiquidityStatus
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class LiquiditySummary:
|
|
currency: str
|
|
through_period: str
|
|
initial_budget: Decimal
|
|
cumulative_member_payments: Decimal
|
|
cumulative_infrastructure_cost: Decimal
|
|
cumulative_payment_processing_cost: Decimal
|
|
cumulative_total_platform_cost: Decimal
|
|
cumulative_net_liquidity: Decimal
|
|
remaining_budget: Decimal
|
|
liquidity_status: LiquidityStatus
|
|
months_tracked: int |