Open Source Contribution Tracking

Distributed Venture Engine

A trustless platform for tracking contributions, managing distributed teams, and creating auditable payout trails. Built for transparency, designed for collaboration.

100%
Transparent
Auditable
Payout Trails
Trustless
Verification
Open
Source

Everything You Need for Distributed Teams

A complete platform for managing contributions, tracking work, and distributing rewards fairly.

Venture Management

Create and manage distributed ventures with customizable stages, roles, and governance structures.

  • Multi-stage project lifecycle
  • Role-based access control
  • Team collaboration tools

Contribution Tracking

Submit, verify, and track contributions with evidence-based proof of work and peer review.

  • Evidence-based submissions
  • Peer verification workflow
  • Weighted contribution units

Fair Payouts

Automated payout calculations with configurable allocation policies and transparent distribution.

  • Points-based distribution
  • Customizable allocation policies
  • Auditable payout trails

Dispute Resolution

Built-in dispute handling for contribution disagreements with escalation workflows.

  • Formal dispute process
  • Evidence attachment
  • Escalation to governance

GitHub Integration

Connect repositories, auto-link contributions to commits and PRs, and sync team members.

  • OAuth authentication
  • Repository linking
  • Webhook events

Audit Logging

Tamper-evident audit trail with hash-chained logs for complete transparency and accountability.

  • Hash-chained entries
  • Tamper detection
  • Full action history

How DVE Works

A step-by-step guide to managing distributed contributions

1

Create a Venture

Set up your distributed project with a name, description, and team structure. Define stages (ideation, development, launch, etc.) and configure roles (contributor, verifier, ops lead, governor) with appropriate permissions.

Venture → Stages → Roles → Team Members
2

Create Tasks & Track Work

Break down work into tasks with clear deliverables. Contributors claim tasks, submit evidence of completion (code commits, documents, designs), and request verification.

Task → Assign → Work → Evidence → Submit
3

Submit Contribution Units

Package completed work into Contribution Units (CUs) with weighted points based on effort, impact, and complexity. Attach evidence and submit for peer verification.

CU = Task + Evidence + Points + Weight
4

Verify Contributions

Designated verifiers review submitted CUs, check evidence, and approve or reject with feedback. Disputes can be raised if there are disagreements.

Review → Approve/Reject → Dispute (optional) → Verified
5

Create Payout Cycles

Define payout periods with allocation policies (costs %, reinvestment %, treasury %, payout pool %). Lock the policy, then calculate individual payouts based on verified points.

Create Cycle → Set Policy → Lock → Calculate → Approve → Distribute
6

Distribute Rewards

Payout statements are generated for each contributor showing their points, percentage share, and amount. Export to CSV for payment processing with full audit trail.

Points → % Share → Amount → Statement → Payment

System Architecture

Built on modern, scalable technologies

Backend API

RESTful API built with FastAPI and Python

FastAPI- Async Python web framework
PostgreSQL- Primary database
SQLAlchemy- Async ORM
JWT Auth- Token-based authentication
Redis- Caching & rate limiting

Frontend App

Modern React application with Next.js

Next.js 14- App Router
React 18- UI library
TypeScript- Type safety
Tailwind CSS- Styling
shadcn/ui- Component library

Core Data Model

Key entities and their relationships

┌─────────────┐    ┌─────────────┐    ┌──────────────────┐
│   Venture   │───▶│    Stage    │    │  TeamMembership  │
│             │    │             │    │                  │
│ - name      │    │ - name      │    │ - role           │
│ - slug      │    │ - order     │    │ - permissions    │
│ - stages[]  │    │ - tasks[]   │    │                  │
└─────────────┘    └─────────────┘    └──────────────────┘
       │                  │                    │
       ▼                  ▼                    ▼
┌─────────────┐    ┌─────────────┐    ┌──────────────────┐
│    Task     │───▶│  Evidence   │    │      User        │
│             │    │             │    │                  │
│ - title     │    │ - type      │    │ - username       │
│ - status    │    │ - url       │    │ - email          │
│ - assignee  │    │ - metadata  │    │ - is_admin       │
└─────────────┘    └─────────────┘    └──────────────────┘
       │
       ▼
┌─────────────────┐    ┌─────────────┐    ┌──────────────────┐
│ContributionUnit │───▶│PayoutCycle  │───▶│ PayoutStatement  │
│                 │    │             │    │                  │
│ - points        │    │ - policy    │    │ - total_points   │
│ - weight        │    │ - status    │    │ - net_amount     │
│ - status        │    │ - period    │    │ - line_items[]   │
└─────────────────┘    └─────────────┘    └──────────────────┘

REST API Reference

Comprehensive API for all DVE operations

Authentication

GET/auth/github/login
GET/auth/me
POST/auth/refresh

Ventures

GET/ventures
POST/ventures
GET/ventures/:id
GET/ventures/:id/team

Tasks

GET/ventures/:id/tasks
POST/ventures/:id/tasks
GET/tasks/:id/evidence

Contributions

GET/ventures/:id/contribution-units
POST/contribution-units
POST/contribution-units/:id/verify

Payouts

GET/ventures/:id/payout-cycles
POST/payout-cycles/:id/calculate
GET/payout-cycles/:id/statements

Admin

GET/admin/stats
GET/admin/users
GET/admin/audit-logs

Full API documentation available at /docs (development) or via OpenAPI spec

Role-Based Access Control

Flexible permissions for different team members

Contributor

Submit tasks, create contribution units, view project data

Verifier

Review and verify contribution units, approve work

Ops Lead

Manage payout cycles, configure policies, handle finances

Governor

Full admin access, manage team, resolve disputes

Ready to Build with DVE?

Start tracking contributions and building transparent payout systems for your distributed team.