smartup-zero
/
1_general_forum
1
1
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
1_general_forum/currency-ledger/README.md

344 lines
14 KiB
Markdown
Raw Permalink Blame History

# 💰 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
Reference in New Issue View Git Blame Copy Permalink