Project file format

{
  "format": "foundation-project",       // required, exactly this
  "version": 1,                          // required, exactly 1
  "name": "Corner Café, Leeds",          // required: the project name

  "businessType": "coffee-shop",         // production | tech-startup | restaurant | coffee-shop | retail | service | custom
  "currency": "GBP",                     // USD EUR GBP IRR AED SAR TRY INR CAD AUD JPY CNY

  // The active category sets AFTER your adjustments. Don't list the always-on ones
  // (pre-operational, human-resources, revenue).
  "activeCapexCategories": ["leasehold-improvements", "kitchen-equipment", "furniture-fixtures", "pos-setup", "signage-branding", "initial-inventory"],
  "activeOpexCategories": ["raw-materials", "rent-lease", "maintenance", "payment-processing", "marketing", "admin"],

  "overview": {                          // any subset
    "productName": "Specialty coffee & bakery counter",
    "proposedCapacity": "~350 transactions/day at maturity",
    "applications": "Commuters and office workers, weekday mornings",
    "employment": 5,                     // must equal total headcount in human-resources
    "buildingOtherSqm": 85
  },

  // One array per category. Column keys exactly as in category-catalog.md.
  // Opex amounts are MONTHLY Year-1 run-rates. Put a source tag and a reason in "notes".
  "lineItems": {
    "rent-lease": [
      { "description": "Shop lease, 85 m²", "notes": "[quote] Rightmove listing #123, £2,300/mo + service charge", "monthlyCost": 2550 }
    ],
    "human-resources": [
      { "role": "Barista", "notes": "[benchmark] local rate £12.60/h × 170 h", "headcount": 3, "monthlySalary": 2140, "employerBurdenPct": 16 }
    ],
    "revenue": [
      {
        "product": "Coffee & drinks", "notes": "[estimate] 250/day avg Year 1 (≈70% of 350) × 30 days",
        "pricingMode": "unit", "unitPrice": 3.6, "monthlyVolume": 7500, "startMonth": 3
      }
    ]
  },

  "costSplit": [{ "id": "raw-materials", "fixedPct": 0 }],   // optional: only what you change
  "contingencyPct": 10,                                        // capex contingency, %

  "assumptions": {                       // any subset
    "taxRatePct": 25,
    "discountRatePct": 18,
    "revenueGrowthPct": 4,
    "workingCapitalMonths": 3,
    "projectionYears": 5
  },

  // Optional: restaurant/coffee-shop recipe model (units: see Foundation's unit list, g, kg, ml, l, piece, dozen)
  "ingredients": [{ "id": "ing-milk", "name": "Whole milk", "unit": "l", "pricePerUnit": 1.1 }],
  "recipes": [{ "id": "rec-latte", "productName": "Coffee & drinks", "batchYield": 1,
                "ingredients": [{ "id": "ri-1", "ingredientId": "ing-milk", "qty": 200, "unit": "ml" }] }],

  "projectDescription": "The founder's own description, verbatim.",

  // Optional: market size, annual values in the project's currency.
  "marketSizing": {
    "customerUnit": "Adults living or commuting within 10 minutes' walk",
    "geography": "Central Leeds",
    "tam": { "value": 4950000, "basis": "18,000 × 60% × 2.1/week × 52 × £4.20", "source": "Census 2021; national coffee survey 2025" },
    "sam": { "value": 2700000, "basis": "Weekday mornings & lunch, takeaway + 30 seats", "source": "Own estimate from TAM" },
    "som": { "value": 450000, "basis": "Capacity-limited: 300 drinks/day plus food", "source": "Operating plan" }
  },

  // Optional: competitors (rows) × features (columns). "has" lists feature ids.
  "competitorBenchmark": {
    "features": [{ "id": "f1", "name": "Oat milk at no extra charge" }],
    "competitors": [{ "id": "c1", "name": "Chain café on the same street", "has": ["f1"] }]
  }
}