ssmithx/NodeZero
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
NodeZero/PRD.md
ssmithx 9bfa47be7e NodeZero Funchal Archipelago Mesh Network 
Complete architecture and directory structure for the Funchal micro-economy deployment:

Documentation:
- README.md: Project overview, architecture, services, metrics, governance
- PRD.md: Product requirements document
- ARCHITECTURE.md: Multi-layered mesh architecture, node specs, topology
- GOVERNANCE.md: DAO model, treasury, voting, dispute resolution
- ROADMAP.md: Phased implementation plan (Months 1-24)
- DEPLOYMENT.md: Mesh network deployment guide

Services:
- mobility/: Decentralized ride-sharing
- housing/: Decentralized house-sharing
- logistics/: Local delivery network
- commerce/: Bitcoin-accepting businesses
- workforce/: Job boards, training, competency attestation
- governance/: Mesh services and decentralized operations

Infrastructure:
- infrastructure/: Mesh networks, archipelago nodes (200 nodes), internet
- config/: node.yml, mesh.yml, bitcoin.yml, profiles.yml, redis.yml
- docs/: Funchal service map, business onboarding, mobility plan
- scripts/: Deploy script
- .gitignore
2026-06-25 15:11:27 -04:00

13 KiB
Raw Blame History

Product Requirements Document (PRD)

NodeZero — Funchal Archipelago Mesh Network & Decentralized Economy

1. Purpose & Vision

NodeZero deploys a complete, decentralized service ecosystem to Funchal, Madeira. The system interlaces mesh networks, archival nodes, and localized services — each powered by Bitcoin (on-chain + Lightning) — to create a resilient, community-owned micro-economy.

Vision: "A fully decentralized, Bitcoin-integrated town where every service — rides, housing, deliveries, healthcare, education, governance — runs on a self-sovereign mesh network."

2. Scope

In Scope (Phase 1 — Funchal Core)

  1. Mesh Network Infrastructure: LoRa, WiFi mesh, cellular integration
  2. Archival Node Deployment: 200+ nodes storing local data
  3. Internet Access Layer: Mesh-redundant internet for all services
  4. Decentralized Ride-Sharing: Peer-to-peer transport routing
  5. Decentralized House-Sharing: Distributed booking & ownership ledger
  6. Local Delivery Network: Autonomous + human courier mesh routing
  7. Bitcoin-Accepting Businesses: Point-of-sale + Lightning integration
  8. Job Board & Workforce Platform: Skill verification on-chain
  9. Training & Competency Attestation: Credential system with verifiable tokens
  10. Integrated Mesh Services: Unified service layer across all domains

In Scope (Phase 2 — Expansion)

  1. Madeira Islands Rollout: Extend to Porto Santo & smaller islands
  2. Governance DAO: Token-based voting & treasury management
  3. Healthcare Mesh: Decentralized health records on mesh
  4. Agricultural Services: Supply chain transparency
  5. Tourism Integration: Visitor services & transient mesh access

Future (Phase 3-4)

  1. Atlantic Archipelago Mesh: Inter-island connectivity
  2. Global Coastal Deployment: Blueprint exportable to other island towns

3. Detailed Service Requirements

3.1 Mesh Network Infrastructure

  • LoRaWAN coverage for IoT devices (sensors, smart meters, deliveries)
  • WiFi 6/7 mesh for high-bandwidth services (video, data transfer)
  • Cellular backhaul (MEO, NOS, Vodafone integration for redundant links)
  • Fiber backbone in Funchal metropolitan center
  • Mesh routing protocol supporting autonomous node discovery & healing
  • Edge computing at each mesh node for local processing
  • Service mesh connecting all applications

KPIs:

  • Coverage radius: 5km from Funchal center (expandable)
  • Latency: <20ms mesh internal, <50ms to gateway
  • Bandwidth: 1Gbps uplink per gateway node
  • Redundancy: >=3 paths to every node

3.2 Archival Node Deployment

  • Node type: ARM64/Intel hybrid, 4U/2U form factors
  • Storage: 8TB-32TB per node (RAID1 for redundancy)
  • Uptime: 99.9% SLA with auto-failover
  • Data types: Mesh logs, service records, job postings, housing contracts, delivery history, merchant transactions, workforce credentials, mesh service logs

Node Categories:

Node Type Quantity Role
Core Archival 20 Primary data storage & routing
Edge Archival 80 Neighborhood data caching
Gateway 14 Internet uplink nodes
Micro Archival 86 Specialized (health, commerce, logistics)

3.3 Integrated Internet

  • Mesh-local internet: all services reachable even if external internet is down
  • External connectivity redundancy via >=2 cellular providers + fiber
  • DNS resolution within mesh
  • Local CDN for static mesh services

3.4 Decentralized Ride-Sharing

  • Peer-to-peer: Residents offer rides to each other
  • Mesh-based routing: Real-time ride data flows through mesh nodes
  • Bitcoin/Lightning payments: Pay-per-ride with instant settlement
  • On-chain ride ledger: Trip history, ratings, disputes
  • Supports: daily commute, tourist transport, elderly mobility
  • Features:
    • Dynamic pricing (supply/demand algorithm on-chain)
    • Carpool optimization
    • Accessible vehicle options
    • Tourist pass (temporary mesh identity + wallet)

KPIs:

  • 500+ rides/day by Phase 1 completion
  • Average dispatch time <3 minutes
  • 95% on-time rate

3.5 Decentralized House-Sharing

  • Smart contract leases for long-term and short-term housing
  • Ownership registry on Bitcoin (via Ordinals/Stacks)
  • Mesh-based availability: Real-time room/house availability feed
  • Tokenized equity: Fractional ownership of properties via tokens
  • Tenant verification: On-chain identity + credit scoring

Features:

  • Host dashboard (local mesh + mobile access)
  • Auto-scheduling via mesh consensus
  • Utility billing via Lightning microtransactions
  • Dispute resolution through decentralized arbitration

KPIs:

  • 2,000 housing units registered by Phase 1
  • 30% short-term rental capacity
  • <5% vacancy rate utilization

3.6 Local Delivery Network

  • Multi-modal: Pedestrian, bicycle, drone, vehicular
  • Mesh-orchestrated: Delivery routing computed by mesh nodes
  • Bitcoin/Lightning payments: Per-delivery microtransactions
  • Delivery types:
    • Food & grocery
    • Medical supplies
    • Mail & packages
    • E-commerce last mile
    • Emergency deliveries

Features:

  • Real-time delivery tracking on mesh
  • Autonomous drone corridors (high-priority)
  • Consolidated neighborhood delivery hubs
  • Carbon-negative delivery priority

KPIs:

  • 1,000+ deliveries/day
  • Average delivery time <45 min urban
  • 80% cost savings vs traditional courier

3.7 Bitcoin-Accepting Businesses

  • Merchant POS on Lightning: QR code payments, no banking intermediaries
  • On-chain receipts for businesses and customers
  • Mesh-verified merchants (identity, ratings, compliance)
  • Automatic settlement to merchant wallet
  • Multi-currency support: BTC + stablecoin + fiat conversion

Business Categories:

  • Restaurants & cafes
  • Retail shops
  • Hotels & guesthouses
  • Healthcare providers
  • Education services
  • Tourism operators
  • Transportation

KPIs:

  • 500+ businesses onboarded (Phase 1)
  • 80% of businesses accepting Lightning
  • Daily transaction volume: EUR 50K+

3.8 Job Board & Workforce Platform

  • Decentralized job board: On-chain job postings & applications
  • Skill registry: Workers attested on mesh
  • Smart contracts for employment: Freelance, contract, full-time
  • Wage payments via Lightning

Features:

  • Employer dashboard (mesh-accessible)
  • Job matching algorithm (mesh-orchestrated)
  • Freelance gig economy section
  • Real-time skill & availability updates
  • International worker support (visa, credential recognition)

KPIs:

  • 5,000+ workers registered
  • 1,000+ active job postings
  • 50+ job matches/day

3.9 Training & Competency Attestation

  • On-chain credentialing: Skills, certifications, licenses verifiable on Bitcoin
  • Mesh-based learning platform: Courses available offline (mesh-synced)
  • Digital badges: NFT-based competency badges (stackable, verifiable)
  • Employer trust layer: Employers can verify worker credentials instantly

Training Areas:

  • Healthcare (nursing, elderly care, medical technician)
  • Hospitality (tourism, cooking, diving/surf instructor)
  • Technology (network admin, IT support, software dev)
  • Trades (electrical, plumbing, construction)
  • Logistics (drone pilot, delivery routing, warehouse)

Features:

  • Self-service credential upload (mesh-gate supported)
  • Community attestation (peer-verified skills)
  • Institution partnership (local schools, universities accept mesh credentials)
  • Training history on-chain

KPIs:

  • 10,000+ attestations issued (Phase 1)
  • 95% credential verification rate
  • 40% workforce with at least 1 mesh credential

4. Technical Requirements

4.1 Architecture

+--------------------------------------------------------------+
|                    Application Layer                         |
+--+---+---+---+---+--+-------+---+------+------+-+           |
| Rides |Houses|Jobs |Bills |Health| ...  |
+--+---+---+---+---+--+-------+---+------+------+-+           |
           +------+-------+-------+-------+                    |
                    Service Mesh                             |
+--------------------------------------------------------------+
|                                                  |           |
|  +-----------+ +-----------+ +-----------+      |           |
|  | Core     | | Edge      | | Gateway   |      |           |
|  | Archival | | Archival  | | Archival  |      |           |
|  +-----------+ +-----------+ +-----------+      |           |
|                                                  |           |
|  +--------+  +--------+  +-+  +-+              |           |
|  |BTC+LNV |  |External|  |F| |C|              |           |
|  |TXs, IDs,|  |Internet|  |i| |e|              |           |
|  |Treasury |  +--------+  |b| |l|              |           |
|  +--------+  +-+-+-+-+-+-+ |a| |l|              |           |
+--|----------|--+-+-+-+-+-+-+-|b| |r|-------------+
   |    Wi-Fi |   LoRa   |  Cellular  |  Fiber    |
   +----------+----------+------------+-----------+
                     FUNCHAL MESH NETWORK

4.2 Protocols & Standards

  • Network: IPv6 over WiFi/LoRa/Cellular/fiber
  • Mesh Protocol: Custom overlay + BGP/MPLS hybrid
  • Consensus: Lightning/BTC hybrid for financial; Raft for service config
  • Data: Event-sourced, append-only logs (CQRS pattern)
  • Identity: Bitcoin-based DIDs (Decentralized Identifiers)
  • Authentication: Mesh tokens + passkeys
  • Encryption: End-to-end TLS + mesh network key rotation

4.3 Hardware

  • Archival Nodes: Industrial-grade ARM64 servers
  • Mesh Gateways: High-power WiFi 6 APs + LoRa concentrators
  • Edge Devices: Smart meters, POS terminals, delivery trackers
  • Power: Solar-optimized with UPS backup

4.4 Software

  • OS: Linux (Debian-based, custom kernel for IoT)
  • Container: Docker on all nodes
  • Orchestration: Mesh-aware K8s (micro-K8s per neighborhood)
  • Language: Rust (performance-critical), JavaScript/TypeScript (services), Go (mesh routing)
  • Database: CRDT-based distributed (for offline capability), SQLite for edge

5. Phased Implementation

Phase 1 (Months 1-6) — Funchal Core Pilot

  • Deploy 50 archival nodes (pilot zone in city center + marina district)
  • Establish mesh network in Funchal center
  • Launch ride-sharing pilot (100 vehicles)
  • Onboard 100 houses to mesh sharing platform
  • Launch job board (beta)
  • Onboard 100 businesses to Bitcoin/Lightning
  • Deploy 10 delivery hubs
  • Launch competency attestation system (initial 2,000 credentials)

Phase 2 (Months 7-12) — Full Rollout

  • Expand to 200 archival nodes
  • Full mesh coverage of Funchal
  • Scale to 500 rides/day, 2,000 housing units
  • Full business onboarding (500+)
  • Delivery network operational (1,000+/day)
  • 5,000 workers, 10,000 attestations
  • Launch DAO governance
  • Healthcare mesh integration

Phase 3 (Months 13-18) — Madeira Islands Expansion

  • Extend mesh to Porto Santo and smaller surrounding islands
  • Deploy inter-island gateway nodes
  • Launch tourist mesh passes
  • Agricultural supply chain integration
  • Tourism integration (hotel, dive center, excursion bookings)

Phase 4 (Months 19-24) — Atlantic Archipelago Blueprint

  • Standardize deployment package
  • Deploy 2-3 additional Atlantic/coastal towns
  • Export Funchal model as template
  • Full Bitcoin treasury operational
  • Autonomous mesh operations (minimal human intervention)

6. Budget & Resources (High-Level)

Category Phase 1 Phase 2 Phase 3-4 Total
Hardware (nodes, APs, gateways) EUR 1.2M EUR 0.8M EUR 1.5M EUR 3.5M
Software development EUR 0.6M EUR 0.5M EUR 0.4M EUR 1.5M
Deployment & installation EUR 0.4M EUR 0.3M EUR 0.5M EUR 1.2M
Operations & maintenance EUR 0.3M/yr EUR 0.4M/yr EUR 0.6M/yr EUR 6.3M (3yr)
Marketing & onboarding EUR 0.2M EUR 0.3M EUR 0.4M EUR 0.9M
Contingency EUR 0.3M EUR 0.3M EUR 0.4M EUR 1.0M
Subtotal EUR 3.0M EUR 2.4M EUR 3.8M EUR 16.4M

7. Success Criteria

Metric Phase 1 Target Phase 2 Target Phase 3-4 Target
Mesh coverage 4 km2 25 km2 Full Madeira
Active users 5,000 20,000 100,000+
Nodes online 50 200 500+
BTC tx volume/day EUR 10K EUR 50K EUR 200K+
Households online 500 5,000 20,000+
Workers employed via mesh 500 3,000 10,000+
System uptime 99% 99.5% 99.9%
Resident satisfaction 70% 80% 90%+

8. Risks & Mitigations

Risk Impact Mitigation
Internet dependency for external services High Full mesh-local operations; offline fallback
Bitcoin price volatility Medium Stablecoin support; automated hedging
Resident adoption Medium Community onboarding program; incentives
Hardware failures Medium Redundant mesh paths; auto-failover
Regulatory changes Low Flexible architecture; legal advisory board
Climate events (storms) High Ruggedized hardware; elevated node placement

PRD Version 1.0 — June 2026 Author: NodeZero Product Team Approved: Pending Community Vote