Deploy a full stack of archival nodes, a mesh network, and decentralized services to the town of Funchal, Madeira — creating a resilient, self-sovereign micro-economy that serves as a blueprint for other islands and coastal towns.

The Archipelago of Services

                    ┌──────────────────────────────────┐
                    │       FUNCHAL, MADEIRA            │
                    │                                  │
    ┌───────────────┼─────────────────────────────────┼────────────────┐
    │               │         ARCHIPELAGO LAYER         │                │
    │  ┌──────────┐ │   ┌──────────┐  ┌──────────┐   │    ┌────────┐  │
    │  │ Mesh     │ │   │ Archival │  │ Gateway  │◄──┼───►│ Cloud  │  │
    │  │ Nodes    │ │   │  Nodes   │  │  Nodes   │   │    │  Fail  │  │
    │  └────┬─────┘ │   └──────────┘  └──────────┘   │    │  over  │  │
    │       │       │       ▲              ▲          │    │  Lay   │  │
    │  ┌────▼────────────────────────────▼────────┐   │    └────────┘  │
    │  │           MESH INTERNET LAYER            │◄──┼────────────────┘
    │  │    LoRa │ WiFi Mesh | Cellular | Fiber    │
    └──┼──────────────────│─────────────│─────│──┼────┘
       │   ┌────────┐ ┌──────────┐ ┌────────┐   │
       └─►│Mobility│ │ Housing  │ │Commerce│   │
           │        │ │          │ │        │   │
           └────────┘ └──────────┘ └────────┘   │
                ▲           ▲          ▲          │
                └───────────┼──────────┘          │
                    ┌───────┴────────┐           │
                    │  Workforce &   │           │
                    │  Governance    │           │
                    └────────────────┘           │
                         │             ┌─────────▼────────┐
                         └────────────►│   Logistics &    │
                                       │   Deliveries     │
                                       └──────────────────┘

Core Services

Service	Status	Priority
Mesh Network Infrastructure	Planned	P0
Archival Node Deployment	Planned	P0
Decentralized Ride-Sharing	Planned	P1
Decentralized House-Sharing	Planned	P1
Local Delivery Network	Planned	P1
Bitcoin-Accepting Merchants	Planned	P1
Job Board & Workforce	Planned	P2
Training & Competency Attestation	Planned	P2
Integrated Mesh Services	Planned	P1
Local Internet Access	Planned	P0
Future Expansion Nodes	Planned	P2
Governance DAO Layer	Planned	P2

Directory Structure

NodeZero/
├── README.md              # This overview
├── PRD.md                 # Product Requirements Document
├── ARCHITECTURE.md        # Technical architecture
├── GOVERNANCE.md          # Governance model
├── ROADMAP.md             # Implementation phases
├── config/                # Configuration files
│   ├── node.yml           # Archival node configs
│   ├── mesh.yml           # Mesh networking parameters
│   └── bitcoin.yml        # Bitcoin integration config
├── docs/                  # Expanded documentation
├── scripts/               # Deployment & ops scripts
├── infrastructure/        # Mesh network & node infrastructure
│   ├── mesh/              # Mesh topology, routing, protocols
│   ├── nodes/             # Archival node specs & deployment
│   └── internet/          # Internet connectivity layers
├── mobility/              # Decentralized ride-sharing
├── housing/               # Decentralized house-sharing
├── logistics/             # Local delivery network
├── commerce/              # Bitcoin-accepting businesses
├── workforce/             # Job board, training, attestation
├── governance/            # Mesh services & decentralized governance
└── expansion/             # Future service areas

Key Metrics

Target Coverage: Funchal municipality (~75 km2)
Node Capacity: 200+ interconnected archival nodes
Mesh Nodes: 500+ edge nodes across the urban core
Population Served: ~110,000 residents
Bitcoin Throughput: Lightning Network enabled
Internet Uptime: 99.9% via mesh redundancy

Getting Started

# Explore the architecture
cat ARCHITECTURE.md

# View product requirements
cat PRD.md

# Check deployment configs
cat config/node.yml
cat config/mesh.yml

# Deploy the pilot mesh network
./scripts/deploy_mesh.sh

Governance

Funchal's NodeZero operates under a hybrid governance model:

Community Staking: Residents stake tokens to validate nodes
DAO Council: Elected representatives manage mesh services
Bitcoin Treasury: Decentralized treasury for service funding
Transparent Ledger: All governance decisions recorded on-chain

Expansion Path

Phase 1 (Funchal core) -> Phase 2 (Madeira islands) -> Phase 3 (Atlantic archipelago) -> Phase 4 (Global coastal deployment)

NodeZero: Building the decentralized town, one mesh node at a time.