# 💰 Smartup Zero Currency Ledger System A git-native, transparent, and democratically governed dual-currency system for collective ownership and fair compensation. **Status**: ✅ **FULLY OPERATIONAL** - Complete system with live transparency on timeline0.org and working task-SC integration --- ## 🎯 What We Built The **Currency Ledger System** is the financial backbone of Smartup Zero, implementing: - **Smartup Credits (SC)**: 1 SC = €1 treasury claim for completed work - **Social Karma (SK)**: Non-transferable reputation currency for community contributions - **Book of Owners**: Complete organizational chart with team memberships and role assignments - **Progressive Transparency**: Public governance with strategic development protection - **Democratic Validation**: Community oversight of all currency awards and policy changes - **Pending SC System**: Phased validation for large retrospective awards (like founding work) - **Task-Based Work System**: Effort-based assessment and SC allocation for collaborative work ## 🚀 Live Public Transparency **All currency data is publicly visible on timeline0.org:** - 📖 **[Book of Owners](https://timeline0.org/smartup-zero/book-of-owners/)** - Live organizational chart - 💰 **[Financial Transparency](https://timeline0.org/smartup-zero/financial-transparency/)** - Complete financial health - 💱 **[Currency System](https://timeline0.org/smartup-zero/currency-system/)** - How it all works *Pages auto-generate from CSV ledger data - complete transparency in action.* ## 💎 Founder Accountability Model **Current Status**: 82,200 SC pending validation representing 10 years of R&D work ### Democratic Vesting Schedule - **Design Phase**: 24,660 SC (30%) - Needs Team Captain validation - **Production Phase**: 32,880 SC (40%) - Needs community vote - **Organization Phase**: 24,660 SC (30%) - Automatic at market success ### Integrity Principles - ✅ **Cannot self-validate** - Founder subject to same democratic rules - ✅ **Success alignment** - Vesting tied to collective achievement - ✅ **Community oversight** - Every SC requires external approval - ✅ **Transparent process** - All validation public and recorded **This demonstrates Smartup Zero's "no special founders" principle in practice.** --- ## 🏗️ System Architecture ``` currency-ledger/ ├── ledger/ # Transaction records (public) │ ├── smartup-credits/ # Live SC awards and redemptions │ ├── social-karma/ # SK awards and decay events │ ├── pending-sc/ # Awaiting democratic validation │ ├── treasury/ # EUR balance and liability tracking │ └── task-management/ # Work session logs and task tracking ├── ownership/ # Organizational structure (public) │ ├── book-of-owners.csv # Public ownership registry with aliases │ ├── license-transactions.csv # License purchase/upgrade history │ └── identity-mapping.csv # Private: real names ↔ aliases (NEVER COMMITTED) ├── policies/ # Configuration and rules (public) │ ├── credit-rates.yml # SC award rates and ADM split rules │ ├── karma-rules.yml # SK categories, thresholds, decay rates │ ├── validation-rules.yml # Democratic oversight processes │ ├── license-policies.yml # License types and capabilities │ ├── organizational-structure.yml # Teams, roles, assignment rules │ └── task-management/ # Effort assessment and work coordination │ ├── effort-assessment-template.yml │ └── mission-leader-rules.yml └── scripts/ # Management and automation tools ├── validate-ledger.py # System integrity checking ├── generate-reports.py # Financial transparency reports ├── manage-owners.py # License and ownership management ├── manage-organization.py # Team and role assignments ├── validate-pending-sc.py # Pending SC validation workflows ├── update-profile.py # Personal information updates ├── generate-public-pages.py # Auto-generate timeline0.org pages ├── system-check.py # Comprehensive system validation ├── destroy-sc.py # SC destruction for system integrity └── task-management/ # Task workflow automation ├── create-task-with-budget.py └── assess-work-session.py ``` ## 📊 Current System Status ### Financial Health: ✅ **EXCELLENT** - **Live SC Outstanding**: 153 SC (€153 liability) - **Pending SC**: 82,200 SC (awaiting validation) - **EUR Treasury**: €0 (no current funding) - **3x Rule**: ✅ PENDING (SC outstanding but no treasury funding yet) ### Organizational Status: ✅ **READY** - **Total Owners**: 1 (robbert_founder) - **Teams Formed**: 1 (Leadership Team) - **Roles Assigned**: 1 (Founding Entrepreneur) - **License Distribution**: 1 Work License --- ## 🎯 Task-Based Work System ### The ADM Triangle for Collaborative Work Every task involves three roles: - **Attacker (Senior)**: Performs primary work, mentors junior (90% SC) - **Defender (Junior)**: Learns, provides QA, documents process (10% SC) - **Midfielder (Bot)**: Coordinates, logs activity, handles administration ### Effort-Based Assessment Work sessions are evaluated using structured criteria: - **Attacker Effort** (1-10): Time investment, approach quality, communication, mentoring - **Defender Learning** (1-10): Engagement level, skill acquisition, contributions - **Collaborative Quality** (1-10): Team coordination, problem-solving, documentation ### SC Payout Based on Effort Quality - **Excellent Session** (27-30 points): 95-100% of budgeted SC - **Good Session** (24-27 points): 80-95% of budgeted SC - **Adequate Session** (18-24 points): 60-80% of budgeted SC - **Poor Session** (6-18 points): 20-60% of budgeted SC - **Failed Session** (0-6 points): 0-20% of budgeted SC --- ## 🚀 How to Use the System ### For Team Captains ```bash # Create a new task with SC budget python3 scripts/task-management/create-task-with-budget.py \ --objective 5_3_0 \ --team-repo 3_1_leadership_team \ --title "Fix authentication bug" \ --description "Resolve login issues in mobile app" \ --sc-budget 100 \ --captain your_alias \ --attacker senior_dev \ --defender junior_dev # Assess completed work session python3 scripts/task-management/assess-work-session.py \ --task-id 6_1_3_0 \ --mission-leader your_alias \ --start-time 2025-01-16T14:00:00Z \ --end-time 2025-01-16T18:00:00Z \ --attacker-effort-score 8 \ --defender-learning-score 7 \ --collaboration-score 9 \ --session-notes "Detailed assessment of work quality and collaboration" ``` ## 🚀 How to Use the System ### For Current Owner (robbert_founder) ```bash # Check system health python3 currency-ledger/scripts/system-check.py # View organizational chart python3 currency-ledger/scripts/manage-organization.py # Generate transparency reports python3 currency-ledger/scripts/generate-reports.py # Update public website pages python3 currency-ledger/scripts/generate-public-pages.py # Update personal profile python3 currency-ledger/scripts/update-profile.py ``` ### For Future Team Captains ```bash # Review pending SC validations python3 currency-ledger/scripts/validate-pending-sc.py # Validate founder's design phase work (24,660 SC) # Process: Review work → Community discussion → Leadership vote → Validation ``` ## 🔧 Key Operations ### Adding New Owners ```python from scripts.manage_owners import OwnershipManager manager = OwnershipManager() manager.add_new_owner( real_name="Alice Johnson", email="alice@example.com", display_name="alice_builder", license_type="work", payment_eur=200 ) ``` ### For Contributors 1. **Join**: Purchase license via Open Collective 2. **Onboard**: Get added to Book of Owners 3. **Contribute**: Claim tasks, work in ADM pairs 4. **Progress**: Advance through license tiers based on SK accumulation 5. **Lead**: Become Team Captain, validate others' work ## 🔧 Key Operations ### SC Lifecycle Management 1. **Task Creation**: Captain allocates SC budget to specific objectives 2. **Work Session**: ADM pair collaborates on task completion 3. **Effort Assessment**: Mission leader evaluates session quality 4. **Pending Validation**: SC awards go to pending-sc for review 5. **Democratic Approval**: Team Captain validates through existing system 6. **SC Award**: Validated SC moves to live ledger ### SC Destruction (System Integrity) ```bash # Destroy SC for system corrections or personal choice python3 scripts/destroy-sc.py \ --owner account_alias \ --amount 50 \ --reason "System integrity correction" \ --destroyer captain_alias ``` ### Treasury Management ```bash # Monitor system health and 3x rule compliance python3 scripts/generate-reports.py # Validate pending SC entries python3 scripts/validate-pending-sc.py ``` --- ## 🎯 Success Metrics The currency system succeeds when: - **Democratic**: All owners can see and influence how money flows - **Fair**: Contributors earn proportional to verified effort and value created - **Sustainable**: Treasury growth keeps pace with SC awards - **Scalable**: System works at 10x, 100x current contributor count - **Aligned**: Individual incentives serve collective SDG mission - **Transparent**: Every transaction auditable by anyone, anytime ## 📈 Live System Data **First Task-Based SC Awards (Historic)**: - Task 6_1_3_0: Prototype Effort-Based Task-SC Integration System - Session Score: 26/30 (85% payout) - Awards: 153 SC (robbert_founder), 17 SC (test_defender - system test account, later destroyed) - Evidence: Complete audit trail in session logs and transaction records **System Test Account**: `test_defender` appears in financial records as a documented system testing artifact used during development of the effort-based assessment system. --- ## 🔄 Integration Roadmap ### Phase 1: ✅ COMPLETE (Validation Phase) - ✅ Complete currency system operational - ✅ Public transparency live on timeline0.org - ✅ Task-SC integration system built and tested - ✅ Effort-based assessment framework implemented - ✅ First SC awards through collaborative work sessions ### Phase 2: Design Phase - 🎯 Team Captains validate 24,660 SC (Design tranche) - 🎯 Engelbot integration for automated task coordination - 🎯 Open Collective treasury sync for funding flows - 🎯 Matrix/Element integration for real-time session notifications - 🎯 Advanced mission leader dashboard and assessment tools ### Phase 3: Production Phase - 🎯 Community validates 32,880 SC (Production tranche) - 🎯 Advanced reporting and analytics dashboards - 🎯 Automated treasury management and redemption processing - 🎯 50+ owners with mature democratic governance - 🎯 Cross-team collaboration and skill development tracking ### Phase 4: Organization Phase - 🎯 Final 24,660 SC automatically vests at market success - 🎯 Full production deployment with global 24/7 coverage - 🎯 Template system for launching additional Smartups - 🎯 Proven model scaling to multiple SDG-focused organizations ## 🤝 Contributing to the System This currency system is itself a collective creation. Improvements welcome: 1. **Identify Enhancement**: System limitation or optimization opportunity 2. **Propose Solution**: Detailed proposal in General Forum 3. **Community Discussion**: Democratic debate and refinement 4. **Implementation**: Code changes with full testing and validation 5. **Integration**: Merge with updated documentation and transparency reports ## 📋 Development History **Task 6_0_3_0 - System Foundation (August 2025)**: Complete prototype of effort-based task-SC integration system built through collaborative work session between robbert_founder (attacker) and test_defender (defender). Established foundational workflows for task creation, effort assessment, and SC distribution through existing democratic validation system. **Key Innovations Implemented**: - Structured effort assessment using 30-point scoring system - Session-based work logging with complete audit trails - Integration with existing currency ledger validation workflows - SC destruction capabilities for system integrity maintenance - Mission leader role for real-time work coordination **System Integrity Measures**: - Book of Owners integration ensures only licensed members earn SC - Progressive transparency maintains public accountability - Democratic validation prevents unilateral SC awards - Complete audit trails enable full transaction history review --- ## 🌍 Planetary Organization Vision This system enables: - **24/7 Global Operations**: Contributors worldwide working across timezones - **Equal Compensation**: Same SC rates regardless of geographic location - **Borderless Collaboration**: Skills and contributions valued over nationality - **Democratic Governance**: All major decisions subject to community oversight - **Sustainable Economics**: Treasury growth balanced with SC liability management **Built with transparency and democratic accountability in mind.** This system embodies the core Smartup principle: Technology should serve collective human needs, built by and for the communities that use it, with full democratic accountability and protection from extraction. **Ready to earn your first Smartup Credits?** Complete a task, demonstrate effort and collaboration, and join the future of work! 🚀 --- **Version**: 1.1 (Updated August 2025) **Status**: Production-ready with active task-based SC system **Next Update**: Integration with Engelbot automation and expanded team operations