Server : Apache/2 System : Linux server-15-235-50-60 5.15.0-164-generic #174-Ubuntu SMP Fri Nov 14 20:25:16 UTC 2025 x86_64 User : gositeme ( 1004) PHP Version : 8.2.29 Disable Function : exec,system,passthru,shell_exec,proc_close,proc_open,dl,popen,show_source,posix_kill,posix_mkfifo,posix_getpwuid,posix_setpgid,posix_setsid,posix_setuid,posix_setgid,posix_seteuid,posix_setegid,posix_uname Directory :  /home/gositeme/domains/brickabois.com/

Upload File : current_dir [ Writeable ] document_root [ Writeable ]

# 🌐 The Free Village Network

A Social Ecosystem for Living Sovereignty

## Overview

The Free Village Network is a digital ecosystem with three interconnected dimensions:

1. **The Commons** - Social connection & dialogue (bilingual feeds, events, stories)
2. **The Ledger** - Governance & transparency (blockchain-backed cooperative treasury & voting)
3. **The Land** - Physical embodiment (real-world village nodes stewarding ecology, art, and learning)

## Project Structure

```
brickabois.com/
├── private_html/          # Secure files (not web-accessible)
│   ├── config.php         # Database & app configuration
│   └── database_schema.sql # Database schema
├── public_html/           # Web-accessible files
│   ├── api/               # RESTful API
│   │   ├── index.php      # API router
│   │   └── endpoints/     # API endpoints
│   │       ├── commons.php # The Commons API
│   │       ├── ledger.php  # The Ledger API
│   │       ├── land.php    # The Land API
│   │       └── auth.php    # Authentication API
│   ├── uploads/           # User-uploaded files
│   └── .htaccess          # Apache configuration
└── README.md              # This file
```

## Installation

### 1. Database Setup

Import the database schema:

```bash
mysql -u gositeme_brickaboiscom -p gositeme_brickaboiscom < private_html/database_schema.sql
```

Or via phpMyAdmin:
- Go to phpMyAdmin
- Select database `gositeme_brickaboiscom`
- Click "Import"
- Choose `private_html/database_schema.sql`

### 2. Configuration

Database credentials are already configured in `private_html/config.php`. The file is protected from web access via `.htaccess`.

### 3. Permissions

Ensure uploads directory is writable:

```bash
chmod 755 public_html/uploads
```

## API Endpoints

### Base URL
`https://brickabois.com/api`

### The Commons
- `GET /api/commons/posts` - Get posts feed
  - Query params: `village_id`, `limit`, `offset`
- `GET /api/commons/events` - Get events
  - Query params: `village_id`, `upcoming`

### The Ledger
- `GET /api/ledger/proposals` - Get governance proposals
  - Query params: `village_id`, `status`
- `GET /api/ledger/treasury` - Get treasury transactions
  - Query params: `village_id`, `limit`

### The Land
- `GET /api/land/villages` - Get villages
  - Query params: `slug`, `status`
- `GET /api/land/resources` - Get village resources
  - Query params: `village_id`, `type`

### Example Request

```bash
curl https://brickabois.com/api/land/villages
```

## Database Schema

### Core Tables

- **users** - Network members/citizens
- **villages** - Physical village nodes
- **posts** - Social feed content
- **events** - Community events
- **proposals** - Governance proposals
- **votes** - Voting records
- **treasury_transactions** - Financial transactions
- **village_resources** - Village projects (ecology, art, learning)

All tables support bilingual content (EN/FR).

## Security

- Database credentials stored in `private_html/` (not web-accessible)
- `.htaccess` prevents access to sensitive files
- Prepared statements for all database queries
- HTTPS enforced
- Security headers configured

## Development Status

✅ **Completed:**
- Database schema design
- Secure configuration system
- RESTful API structure
- Basic endpoints for all three dimensions

🚧 **In Progress:**
- Authentication system
- Frontend interface
- Bilingual content management

📋 **Planned:**
- Blockchain integration (The Ledger)
- Real-time features
- Advanced governance tools
- Village mapping interface

## Next Steps

1. Test API endpoints
2. Build frontend interface
3. Implement authentication
4. Add blockchain integration for The Ledger
5. Create village mapping system

## License

Proprietary - Free Village Network