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
parent 22f39b19a5
commit 9bfa47be7e
23 changed files with 2696 additions and 2 deletions
@@ -0,0 +1,60 @@
+# Business Onboarding Guide
+# NodeZero - Bitcoin-Accepting Businesses
+
+## 1. Business Requirements
+- Active business license in Madeira
+- Mesh verification application
+- BTC/Lightning payment capability
+- QR code POS setup
+- On-chain identity registration
+
+## 2. Onboarding Steps
+1. Apply via mesh (scan QR at any node)
+2. Submit business documentation
+3. Verify mesh identity
+4. Install Lightning POS terminal
+5. Configure payment settings
+6. Begin accepting Bitcoin payments
+
+## 3. Fee Structure
+| Category | Onboarding Fee | Yearly Fee | Transaction Fee |
+|----------|---------------|-----------|----------------|
+| Restaurant | EUR 50 | EUR 100 | 0.1% |
+| Retail | EUR 50 | EUR 100 | 0.1% |
+| Hotel | EUR 75 | EUR 150 | 0.1% |
+| Healthcare | EUR 50 | EUR 75 | 0.15% |
+| Tourism | EUR 50 | EUR 100 | 0.1% |
+| Transport | EUR 50 | EUR 100 | 0.1% |
+| Education | EUR 50 | EUR 50 | 0.1% |
+
+## 4. Payment Flow
+1. Customer presents / scans QR at POS
+2. Payment routed via Lightning (instant)
+3. Settlement to merchant wallet
+4. On-chain receipt for both parties
+5. Service recorded on mesh ledger
+
+## 5. Verification
+- Mesh verification badge (on-chain)
+- Rating system via mesh reviews
+- Periodic compliance checks
+- Renewable verification annually
+
+## 6. Supported Currencies
+- Bitcoin (BTC)
+- Lightning (satoshis)
+- USDC stablecoin
+- EUR (auto-converted)
+
+## 7. Business Benefits
+- Lower transaction fees than credit cards
+- Instant settlement
+- On-chain transaction history
+- Mesh verification badge
+- Treasury discount access
+- Access to workforce platform
+
+## 8. Contact
+- Mesh office: mesh.local/business
+- Lightning address: business@nodezero.funchal
+- Portal: portal.nodezero.funchal/business
@@ -0,0 +1,192 @@
+# Funchal Service Map
+# NodeZero - Geographic Service Areas
+
+---
+
+## 1. Service Area Zones
+
+Funchal is divided into service zones, each with designated node deployments
+and service configurations.
+
+### Zone A - Centro (Centro Historico + Mar)
+
+- **Area:** 2 km2, 60 nodes
+- **Key Locations:**
+  - Funchal Old Town (Monte district)
+  | Marina area (Marina do Funchal, Clube Naval)
+  - Town Square (Praça da Nossa Senhora do Monte Pico)
+  - Municipal Market (Mercado dos Lavradores)
+  - City Park (Jardim Publico)
+  - Cable Car stations
+- **Primary Services:**
+  - Tourism (hotel, dive centers, excursion operators)
+  - Retail shops and restaurants
+  - Cultural attractions (Museu de Cernadas, CR7 Museum)
+- **Node Type:** Core Archival, high-density
+- **Service Priority:** Highest (tourism-heavy, day-time population density)
+
+### Zone B - Zona Industrial (Industrial Zone)
+
+- **Area:** 3 km2, 50 nodes
+- **Key Locations:**
+  - Industrial park (Parque Industrial)
+  - Port facilities (Porto do Funchal)
+  - Warehouses and logistics centers
+- **Primary Services:**
+  - Logistics hub
+  - Manufacturing facilities
+  - Delivery center distribution
+  - Agricultural processing
+- **Node Type:** Edge Archival, micro nodes
+- **Service Priority:** High (logistics-heavy)
+
+### Zone C - Zona Comercial (Commercial District)
+
+- **Area:** 3 km2, 50 nodes
+- **Key Locations:**
+  - Shopping area (via Dr. Arsenio Ramos)
+  - Hotels and guesthouses
+  - Office buildings
+  - Banking and financial services
+- **Primary Services:**
+  - Business services
+  - Commerce (Bitcoin POS)
+  - Professional services
+  - Tourism support services
+- **Node Type:** Edge Archival, gateway nodes
+- **Service Priority:** High (commercial center)
+
+### Zone D - Porto e Armazens (Port & Warehouses)
+
+- **Area:** 2 km2, 40 nodes
+- **Key Locations:**
+  - Porto do Funchal (maritime port)
+  - Warehouses and distribution centers
+  - Fishing fleet base
+  - Ferry terminal (if operational)
+- **Primary Services:**
+  - Maritime services
+  - Cargo logistics
+  - Fisheries supply chain
+  - Shipping and delivery
+- **Node Type:** Micro nodes, logistics-focused
+- **Service Priority:** Medium-high (specialized zone)
+
+### Zone E - Zona Residencial Norte (North Residential)
+
+- **Area:** 2 km2, 40 nodes
+- **Key Locations:**
+  - Residential neighborhoods (Serra, Camacha)
+  - Schools and universities (University of Madeira)
+  - Healthcare facilities (HIM - Hospital Infan Maria Pia)
+  - Community centers
+- **Primary Services:**
+  - Healthcare mesh
+  - Education services
+  - Community services
+  - Housing sharing
+- **Node Type:** Edge Archival, health nodes
+- **Service Priority:** Medium (residential + institutional)
+
+### Zone F - Areas Perifericas (Outer Areas)
+
+- **Area:** 3 km2, 60 nodes
+- **Key Locations:**
+  - Suburban areas
+  - Approach roads to Funchal
+  - Outlying villages connected to Funchal
+  - Agricultural areas
+  - Golf courses (three major courses)
+- **Primary Services:**
+  - Agriculture
+  - Tourism (golf tourism, nature tourism)
+  - Residential services
+  - Delivery routes
+- **Node Type:** Edge Archival, micro nodes
+- **Service Priority:** Medium (spatially distributed need)
+
+---
+
+## 2. Coverage Heat Map
+
+```
+         North (Elevation: 150-400m)
+                |
+          [E3] [E2] [E1]
+        [E4]  [C5]  [C4]  [C3]
+         |     |     |     |
+[F1]<---F2----F3----F4----F5----[F6]
+ |     [E5]  [C6]  [c7]  [C8]    |
+ |     |     |     |     |       |
+[F7]<--[B6]--[B5]--[B4]--[B3]---[B2]
+ |     [D1]  [D2]  [D3]  [D4]    |
+ |     |     |     |     |       |
+ [A1]<-[A2]<-[A3]<-[A4]--[A5]-->[A6]
+         |     |     |     |
+        [M1]  [M2]  [M3]  [M4]
+         |     |     |     |
+  South (Elevation: 0-75m, Sea level)
+        
+Key: A = Zone A (Centro)
+     B = Zone B (Industrial)
+     C = Zone C (Commercial)
+     D = Zone D (Port)
+     E = Zone E (North Residential)
+     F = Zone F (Periphery)
+     M = Gateway/Maritime nodes
+```
+
+---
+
+## 3. Service Density by Zone
+
+| Zone | Residents | Businesses | Tourism Density | Node Density (km2) |
+|------|------|--------|- --|----------|-----|------|
+| A | 15,000 | 200 | Very High | 30 |
+| B | 8,000 | 150 | Low | 17 |
+| C | 12,000 | 180 | High | 17 |
+| D | 3,000 | 60 | Medium | 20 |
+| E | 20,000 | 80 | Medium | 20 |
+| F | 52,000 | 30 | Low | 20 |
+| **Total** | **110,000** | **700** | **- | **20** |
+
+---
+
+## 4. Future Expansion Zones (Madeira)
+
+| Zone | Area | Distance from Funchal | Population | Status |
+|------|---|--------|-------|----|---|
+| G | Ponta do Sol | 50 km | 8,000 | Phase 3 |
+| H | Calheta | 30 km | 25,000 | Phase 3 |
+| I | Santana | 35 km | 16,000 | Phase 3 |
+| J | Porto Santo | 45 km | 5,000 | Phase 3 |
+| K | Porto Moniz | 40 km | 6,000 | Phase 3 |
+| L | Ribeira Brava | 20 km | 16,000 | Phase 3 |
+
+---
+
+## 5. Mobile Service Routes
+
+### Ride-Sharing Corridors
+
+1. **Corridor 1:** Center <-> Marina
+2. **Corridor 2:** Center <-> Serra
+3. **Corridor 3:** Industrial <-> Commercial
+4. **Corridor 4:** Port <-> Commercial Center
+5. **Corridor 5:** North Residential <-> Funchal Center
+6. **Corridor 6:** Funchal <-> Airport
+7. **Corridor 7:** Golf route (Caniçal <-> Santa Cruz)
+8. **Corridor 8:** Town <-> Monte (tourist route)
+
+### Delivery Routes
+
+- **Route 1:** Hub-to-Hub (warehouse distribution)
+- **Route 2:** Last-mile (delivery to home)
+- **Route 3:** Hospital-to-hub (medical supplies)
+- **Route 4:** Restaurant-to-customer (food delivery)
+- **Route 5:** Agricultural hub-to-commercial
+- **Route 6:** Port-to-warehouse
+
+---
+
+*Service Map Version 1.0 - June 2026*
@@ -0,0 +1,97 @@
+# Mobility Plan
+# NodeZero Decentralized Ride-Sharing
+
+## 1. Ride-Sharing Architecture
+
+### Peer-to-Peer Model
+Residents offer rides to each other via mesh network:
+- Vehicle owners register on mesh
+- Availability broadcasted via mesh
+- Riders request via mesh app
+- Automatic matching and routing
+
+### Service Types
+- Commute rides (daily, scheduled routes)
+- On-demand rides (anytime, anywhere)
+- Tourist transport (airport, attractions, hotel)
+- Shuttle services (fixed routes, regular intervals)
+- Accessibility rides (wheelchair, priority seating)
+
+## 2. Ride Flow
+
+1. Rider opens app and enters destination
+2. Mesh routes request to available vehicles
+3. Best match (cost, time, distance) selected
+4. Driver accepts
+5. Ride tracked via mesh
+6. Payment via Lightning (instant)
+7. Rating shared on mesh
+
+## 3. Pricing Model
+
+### Dynamic Pricing
+- Base fare: 0.5 EUR + 0.1 EUR/km
+- Surge pricing during peak hours (up to 2x)
+- Vehicle type modifier (standard, large, accessible)
+- Distance modifier for long trips (>10km)
+
+### Payment Methods
+- Lightning payment (satoshis per ride)
+- Mesh tokens (NFTZ)
+- Fiat (auto-converted at mesh)
+- Tourist daily pass (1000 satoshis = unlimited rides)
+
+## 4. Vehicle Categories
+
+| Category | Capacity | Min Price | Max Price | Features |
+|--------|-----|
+| Standard | 4 | EUR 2.00 | EUR 15 | Basic, AC, rides anywhere |
+| Large | 6 | EUR 3.00 | EUR 25 | Extra space, luggage |
+| Accessible | 4 | EUR 2.50 | EUR 20 | Wheelchair, priority |
+| Tourist | 4 | EUR 1.00 | EUR 12 | English, attractions |
+| Shuttle | 20 | EUR 1.00 | EUR 5.00 | Fixed routes, scheduled |
+
+## 5. Key Metrics
+
+| Metric | Target | Notes |
+|---------|------------|-------|
+| Rides/day | 500 | Phase 1 target |
+| Average time | < 3 min | Dispatch time |
+| On-time rate | > 95% | |
+| Satisfaction | > 80% | Net promoter score |
+| Active drivers | > 300 | |
+| Revenue/day | EUR 10K | |
+
+## 6. Expansion Phases
+
+### Phase 1 (Months 1-6)
+- Start with 100 vehicles
+- Cover Zone A, B, C (Funchal center)
+- Commute and on-demand services
+- Tourist route integration
+
+### Phase 2 (Months 7-12)
+- Scale to 500 vehicles
+- Full zone coverage
+- Shuttle service expansion
+- Hospitality integration
+
+### Phase 3 (Months 13-18)
+- Inter-island routes
+- Airport connectivity
+- Extended coverage zones
+- Autonomous vehicle pilots
+
+## 7. Technical Notes
+- Mesh routing handles ride data
+- Real-time availability via mesh gossip
+- Offline booking capability
+- Lightning payment settlement
+- Ride history on mesh ledger
+
+## 8. Partnerships
+- Local taxi companies
+- Hotel concierge services
+- Dive center transport
+- Golf course shuttles
+- Airport transfer operators