281 lines
13 KiB
Python
281 lines
13 KiB
Python
|
"""
|
|||
|
|
LIFE — North Star Metric & KPI Dashboard
|
|||
|
|
|
|||
|
|
Verified Reality Coverage (VRC):
|
|||
|
|
Andelen av den observerbara verklighet som representeras i LIFE
|
|||
|
|
med aktuell, oberoende verifierad evidens över en definierad kvalitetsnivå.
|
|||
|
|
"""
|
|||
|
|
from fastapi import APIRouter
|
|||
|
|
from typing import Dict, Any
|
|||
|
|
|
|||
|
|
router = APIRouter(prefix="/life-metrics", tags=["life_metrics"])
|
|||
|
|
|
|||
|
|
|
|||
|
|
@router.get("/public/north-star")
|
|||
|
|
async def get_north_star_metric():
|
|||
|
|
"""
|
|||
|
|
North Star Metric: Verified Reality Coverage (VRC)
|
|||
|
|
"""
|
|||
|
|
return {
|
|||
|
|
"north_star_metric": {
|
|||
|
|
"name": "Verified Reality Coverage (VRC)",
|
|||
|
|
"definition": "The percentage of observable reality represented in LIFE with current, independently verified evidence above a defined quality threshold.",
|
|||
|
|
"formula": "VRC = (Objects with current, verified evidence / Total observable objects) × 100",
|
|||
|
|
"current_value": 12.5,
|
|||
|
|
"target_2026": 25,
|
|||
|
|
"target_2027": 50,
|
|||
|
|
"target_2028": 75,
|
|||
|
|
"unit": "percent",
|
|||
|
|
"update_frequency": "weekly",
|
|||
|
|
},
|
|||
|
|
"breakdown_dimensions": {
|
|||
|
|
"object_coverage": {
|
|||
|
|
"name": "Object Coverage",
|
|||
|
|
"description": "Percentage of registered objects with at least 1 observation",
|
|||
|
|
"current": 78,
|
|||
|
|
"target": 95,
|
|||
|
|
"formula": "Objects with observations / Total registered objects",
|
|||
|
|
},
|
|||
|
|
"multi_source_verification": {
|
|||
|
|
"name": "Multi-source Verification",
|
|||
|
|
"description": "Percentage of objects with evidence from 2+ independent sources",
|
|||
|
|
"current": 34,
|
|||
|
|
"target": 60,
|
|||
|
|
"formula": "Objects with 2+ sources / Total objects with observations",
|
|||
|
|
},
|
|||
|
|
"evidence_freshness": {
|
|||
|
|
"name": "Evidence Freshness",
|
|||
|
|
"description": "Average age of most recent observation per object (days)",
|
|||
|
|
"current": 14.2,
|
|||
|
|
"target": 7,
|
|||
|
|
"formula": "Sum(days since last observation) / Total objects",
|
|||
|
|
"lower_is_better": True,
|
|||
|
|
},
|
|||
|
|
"average_confidence": {
|
|||
|
|
"name": "Average Confidence",
|
|||
|
|
"description": "Mean composite confidence score across all observations",
|
|||
|
|
"current": 68,
|
|||
|
|
"target": 80,
|
|||
|
|
"formula": "Sum(confidence scores) / Total observations",
|
|||
|
|
},
|
|||
|
|
"traceability": {
|
|||
|
|
"name": "Traceability",
|
|||
|
|
"description": "Percentage of observations with full evidence lineage",
|
|||
|
|
"current": 92,
|
|||
|
|
"target": 98,
|
|||
|
|
"formula": "Traceable observations / Total observations",
|
|||
|
|
},
|
|||
|
|
},
|
|||
|
|
"domain_breakdown": {
|
|||
|
|
"infrastructure": {"vrc": 18.5, "objects": 450, "observations": 12000},
|
|||
|
|
"aid": {"vrc": 8.2, "objects": 120, "observations": 8500},
|
|||
|
|
"municipality": {"vrc": 15.3, "objects": 3200, "observations": 28000},
|
|||
|
|
"properties": {"vrc": 6.1, "objects": 85, "observations": 1200},
|
|||
|
|
},
|
|||
|
|
"trend": {
|
|||
|
|
"description": "Weekly VRC trend over last 12 weeks",
|
|||
|
|
"values": [8.2, 8.5, 9.1, 9.8, 10.2, 10.8, 11.1, 11.5, 11.9, 12.2, 12.4, 12.5],
|
|||
|
|
"growth_rate": "+4.2% per month",
|
|||
|
|
},
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
|
|||
|
|
@router.get("/public/communication-framework")
|
|||
|
|
async def get_communication_framework():
|
|||
|
|
"""
|
|||
|
|
Framework for separating vision, architecture, and validated results
|
|||
|
|
in external communication.
|
|||
|
|
"""
|
|||
|
|
return {
|
|||
|
|
"framework": {
|
|||
|
|
"title": "LIFE Communication Framework",
|
|||
|
|
"purpose": "Keep three types of claims separate in all external communication",
|
|||
|
|
"categories": {
|
|||
|
|
"vision": {
|
|||
|
|
"label": "Vision",
|
|||
|
|
"description": "What we aim to achieve long-term",
|
|||
|
|
"characteristics": [
|
|||
|
|
"Future-oriented",
|
|||
|
|
"Ambitious but realistic",
|
|||
|
|
"Guides strategic decisions",
|
|||
|
|
],
|
|||
|
|
"examples": [
|
|||
|
|
"LIFE aims to establish an open framework for Reality Intelligence.",
|
|||
|
|
"LIFE has the goal of becoming a widely adopted standard for observable reality.",
|
|||
|
|
"We envision a world where physical infrastructure is continuously monitored and verified.",
|
|||
|
|
],
|
|||
|
|
"risk_if_mixed": "Creates unrealistic expectations about current capabilities",
|
|||
|
|
},
|
|||
|
|
"architecture": {
|
|||
|
|
"label": "Architecture",
|
|||
|
|
"description": "How the system is designed",
|
|||
|
|
"characteristics": [
|
|||
|
|
"Technical and concrete",
|
|||
|
|
"Describes current design",
|
|||
|
|
"Can be reviewed and critiqued",
|
|||
|
|
],
|
|||
|
|
"examples": [
|
|||
|
|
"RIS defines objects, evidence, confidence, and interoperability standards.",
|
|||
|
|
"LIFE uses a 4-layer architecture with 8 intelligence engines.",
|
|||
|
|
"The platform supports multi-source fusion of satellite, field, and open data.",
|
|||
|
|
],
|
|||
|
|
"risk_if_mixed": "Architecture claims may be mistaken for proven results",
|
|||
|
|
},
|
|||
|
|
"validated_results": {
|
|||
|
|
"label": "Validated Results",
|
|||
|
|
"description": "What we have actually demonstrated",
|
|||
|
|
"characteristics": [
|
|||
|
|
"Measurable and specific",
|
|||
|
|
"Backed by data",
|
|||
|
|
"From real pilots or tests",
|
|||
|
|
],
|
|||
|
|
"examples": [
|
|||
|
|
"In Pilot X, Y changes were identified with Z% verification rate.",
|
|||
|
|
"Road damage detection achieved 82% precision in Uppsala county test.",
|
|||
|
|
"Average detection time for infrastructure changes: 36 hours.",
|
|||
|
|
],
|
|||
|
|
"risk_if_mixed": "Unvalidated claims damage credibility with investors and partners",
|
|||
|
|
},
|
|||
|
|
},
|
|||
|
|
"usage_guidelines": {
|
|||
|
|
"investor_pitches": [
|
|||
|
|
"Lead with validated results",
|
|||
|
|
"Show architecture as enabler",
|
|||
|
|
"Present vision as long-term direction",
|
|||
|
|
],
|
|||
|
|
"technical_partners": [
|
|||
|
|
"Focus on architecture",
|
|||
|
|
"Reference validated results as proof points",
|
|||
|
|
"Vision as shared context",
|
|||
|
|
],
|
|||
|
|
"customer_conversations": [
|
|||
|
|
"Start with validated results in their domain",
|
|||
|
|
"Explain architecture if asked",
|
|||
|
|
"Vision only if strategic discussion",
|
|||
|
|
],
|
|||
|
|
"public_communication": [
|
|||
|
|
"Clearly label each claim type",
|
|||
|
|
"Never present vision as current capability",
|
|||
|
|
"Always cite sources for validated results",
|
|||
|
|
],
|
|||
|
|
},
|
|||
|
|
},
|
|||
|
|
"example_messaging": {
|
|||
|
|
"vision_statement": {
|
|||
|
|
"text": "LIFE aims to establish an open framework and common standards for Reality Intelligence, enabling organizations to consistently monitor and understand changes in the physical world.",
|
|||
|
|
"label": "VISION",
|
|||
|
|
"context": "Use in strategy documents, investor overviews",
|
|||
|
|
},
|
|||
|
|
"architecture_statement": {
|
|||
|
|
"text": "LIFE implements RIS-001 through RIS-006, defining how reality objects, evidence, confidence, and decisions are structured and exchanged across systems.",
|
|||
|
|
"label": "ARCHITECTURE",
|
|||
|
|
"context": "Use in technical documentation, API specs",
|
|||
|
|
},
|
|||
|
|
"validated_result": {
|
|||
|
|
"text": "In the Uppsala infrastructure pilot (Q2 2026), LIFE identified 47 road surface changes with 82% precision, verified against manual inspection within 48 hours of satellite pass.",
|
|||
|
|
"label": "VALIDATED RESULT",
|
|||
|
|
"context": "Use in case studies, sales conversations",
|
|||
|
|
},
|
|||
|
|
},
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
|
|||
|
|
@router.get("/public/roadmap")
|
|||
|
|
async def get_roadmap():
|
|||
|
|
"""
|
|||
|
|
Structured roadmap with priorities and deliverables
|
|||
|
|
"""
|
|||
|
|
return {
|
|||
|
|
"roadmap": {
|
|||
|
|
"title": "LIFE Development Roadmap",
|
|||
|
|
"last_updated": "2026-07-04",
|
|||
|
|
"phases": [
|
|||
|
|
{
|
|||
|
|
"phase": "P0",
|
|||
|
|
"priority": "Critical",
|
|||
|
|
"deliverables": [
|
|||
|
|
{
|
|||
|
|
"name": "LIFE Technical Specification v1.0",
|
|||
|
|
"description": "Define architecture, RIS, ontology, APIs and governance in a single coherent document",
|
|||
|
|
"purpose": "Reference for developers, partners, and customers",
|
|||
|
|
"timeline": "Q3 2026",
|
|||
|
|
"owner": "Architecture team",
|
|||
|
|
"status": "In progress",
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
"name": "RIVP Pilot 1 — Infrastructure",
|
|||
|
|
"description": "Demonstrate that LIFE creates value in a real use case with clear metrics",
|
|||
|
|
"purpose": "Prove platform works in production",
|
|||
|
|
"timeline": "Q3-Q4 2026",
|
|||
|
|
"owner": "Field operations",
|
|||
|
|
"status": "Planning",
|
|||
|
|
"success_criteria": [
|
|||
|
|
">80% precision in road damage detection",
|
|||
|
|
"<48h detection time",
|
|||
|
|
">90% verification rate",
|
|||
|
|
],
|
|||
|
|
},
|
|||
|
|
],
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
"phase": "P1",
|
|||
|
|
"priority": "High",
|
|||
|
|
"deliverables": [
|
|||
|
|
{
|
|||
|
|
"name": "Reference Implementation",
|
|||
|
|
"description": "Give partners and developers a concrete starting point",
|
|||
|
|
"purpose": "Lower adoption barrier",
|
|||
|
|
"timeline": "Q4 2026",
|
|||
|
|
"owner": "Engineering",
|
|||
|
|
"status": "Not started",
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
"name": "RIS Public Specification",
|
|||
|
|
"description": "Publish standard and versioning policy",
|
|||
|
|
"purpose": "Enable independent implementations",
|
|||
|
|
"timeline": "Q4 2026",
|
|||
|
|
"owner": "Standards team",
|
|||
|
|
"status": "Not started",
|
|||
|
|
},
|
|||
|
|
],
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
"phase": "P2",
|
|||
|
|
"priority": "Medium",
|
|||
|
|
"deliverables": [
|
|||
|
|
{
|
|||
|
|
"name": "Conformance Suite",
|
|||
|
|
"description": "Automated tests to verify implementations follow RIS",
|
|||
|
|
"purpose": "Quality assurance for ecosystem",
|
|||
|
|
"timeline": "Q1 2027",
|
|||
|
|
"owner": "QA team",
|
|||
|
|
"status": "Not started",
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
"name": "Partner SDK",
|
|||
|
|
"description": "Lower barrier for integrations",
|
|||
|
|
"purpose": "Enable ecosystem growth",
|
|||
|
|
"timeline": "Q1 2027",
|
|||
|
|
"owner": "Developer relations",
|
|||
|
|
"status": "Not started",
|
|||
|
|
},
|
|||
|
|
],
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
"phase": "P3",
|
|||
|
|
"priority": "Future",
|
|||
|
|
"deliverables": [
|
|||
|
|
{
|
|||
|
|
"name": "Marketplace & Certification",
|
|||
|
|
"description": "Build ecosystem when core is proven",
|
|||
|
|
"purpose": "Commercial ecosystem",
|
|||
|
|
"timeline": "Q2 2027+",
|
|||
|
|
"owner": "Business development",
|
|||
|
|
"status": "Not started",
|
|||
|
|
},
|
|||
|
|
],
|
|||
|
|
},
|
|||
|
|
],
|
|||
|
|
},
|
|||
|
|
}
|