NodeZero/PRD.md

# 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)

11. **Madeira Islands Rollout:** Extend to Porto Santo & smaller islands
12. **Governance DAO:** Token-based voting & treasury management
13. **Healthcare Mesh:** Decentralized health records on mesh
14. **Agricultural Services:** Supply chain transparency
15. **Tourism Integration:** Visitor services & transient mesh access

### Future (Phase 3-4)

16. **Atlantic Archipelago Mesh:** Inter-island connectivity
17. **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*