mirror of
https://github.com/blackboxprogramming/blackroad-apps.git
synced 2026-03-17 05:57:22 -05:00
Rewrite README — clean table format, remove emoji spam
RoadChain-SHA2048: f1c3e1fc929efc25 RoadChain-Identity: alexa@sovereign RoadChain-Full: f1c3e1fc929efc25a6b17ecc6d11ef7328891b301726031c2003deb60387b28a9dce8ccd7caa7fb26208d4f2db5903333823d5d0227bfa4e30dc548ea86daf3f9aaf47bace8243f7d5320f36bd5c1e06167e20dec150961eb0c8cce84b711b7eae9859773c5750f02985ceaf34aa4d2b9731af51b0ebcd8707ac632a3d4d0a91a49e164cf9e2b094e9b81ba7aa580f641f0f12ad160530df59e477c427880466b518db4912756a6399d8d5020d1214045deffb4497889e7701efc2dc6857a4588e1b426e5ed99d222b50ea71ee9e9f4328f94965e47ca18737aceb486a710bef09e8b4ac41b045908a791d39ce9611bb5ccd6053945076ed002e653d0c60ab4b
This commit is contained in:
151
README.md
151
README.md
@@ -1,142 +1,57 @@
|
|||||||
# BlackRoad Ecosystem 🛣️
|
# BlackRoad Apps
|
||||||
|
|
||||||
Complete suite of platforms for the BlackRoad operating system.
|
Application suite for the BlackRoad OS platform. 8 services spanning project management, streaming, blockchain, and infrastructure monitoring.
|
||||||
|
|
||||||
## Applications
|
## Applications
|
||||||
|
|
||||||
### 🗺️ RoadMap
|
| App | Stack | Description |
|
||||||
**Project Planning & Collaboration Platform**
|
|-----|-------|-------------|
|
||||||
- Tech: Next.js, TypeScript, WebSockets
|
| **RoadMap** | Next.js, TypeScript, WebSockets | Project planning with real-time Kanban boards |
|
||||||
- Features: Real-time collaboration, Kanban boards, Analytics
|
| **RoadWork** | Node.js, Express | Job board with AI matching |
|
||||||
- Target: aria64 (Raspberry Pi)
|
| **RoadWorld** | Go, Gin, WebGL | Earth exploration and virtual environments |
|
||||||
|
| **RoadChain** | Rust, Actix-web, SHA-256 | Blockchain verification and immutable storage |
|
||||||
|
| **RoadCoin** | Python, FastAPI, Redis | Equity crowdfunding and crypto payments |
|
||||||
|
| **RoadView** | Node.js | Creative suite — design, video, AI generation |
|
||||||
|
| **PitStop** | Go, Gin | Infrastructure dashboard with real-time metrics |
|
||||||
|
| **RoadSide** | Node.js, Socket.io | Deployment portal and server connections |
|
||||||
|
|
||||||
### 💼 RoadWork
|
## Deploy
|
||||||
**Job Portal & Entrepreneur Platform**
|
|
||||||
- Tech: Node.js, Express, MongoDB simulation
|
|
||||||
- Features: Job board, AI matching, Entrepreneur networking, Funding connections
|
|
||||||
- Target: aria64 (Raspberry Pi)
|
|
||||||
|
|
||||||
### 🌍 RoadWorld
|
|
||||||
**Metaverse & Game Creation Platform**
|
|
||||||
- Tech: Go, Gin, WebSockets, WebGL
|
|
||||||
- Features: Open world Earth simulation, Virtual HQs, Game creation, 3D assets
|
|
||||||
- Target: shellfish (Droplet)
|
|
||||||
|
|
||||||
### ⛓️ RoadChain
|
|
||||||
**Blockchain Verification System**
|
|
||||||
- Tech: Rust, Actix-web, SHA-256
|
|
||||||
- Features: Immutable data storage, Proof of work, Transaction verification
|
|
||||||
- Target: shellfish (Droplet)
|
|
||||||
|
|
||||||
### 💰 RoadCoin
|
|
||||||
**Non-IPO Funding Platform**
|
|
||||||
- Tech: Python, FastAPI, Redis
|
|
||||||
- Features: Equity crowdfunding, Crypto payments, Smart contracts
|
|
||||||
- Target: shellfish (Droplet)
|
|
||||||
|
|
||||||
### 🎨 RoadView
|
|
||||||
**Creative Suite**
|
|
||||||
- Tech: Node.js (future: Vue.js + Python)
|
|
||||||
- Features: Design tools, Video editing, AI generation, YouTube integration
|
|
||||||
- Target: aria64 (Raspberry Pi)
|
|
||||||
|
|
||||||
### 🔧 PitStop
|
|
||||||
**Infrastructure Dashboard**
|
|
||||||
- Tech: Go, Gin
|
|
||||||
- Features: Real-time metrics, Container management, DNS, Deployments
|
|
||||||
- Target: aria64 (Raspberry Pi)
|
|
||||||
|
|
||||||
### 🚦 RoadSide
|
|
||||||
**Connections & Deploy Portal**
|
|
||||||
- Tech: Node.js, Socket.io
|
|
||||||
- Features: Server connections, Deployment UI, DNS config, CLI integration
|
|
||||||
- Target: aria64 (Raspberry Pi)
|
|
||||||
|
|
||||||
## Quick Deploy
|
|
||||||
|
|
||||||
Deploy all applications:
|
|
||||||
```bash
|
```bash
|
||||||
cd ~/blackroad-apps
|
# Deploy all
|
||||||
./DEPLOY_ALL.sh
|
./DEPLOY_ALL.sh
|
||||||
```
|
|
||||||
|
|
||||||
Deploy individual app:
|
# Deploy one app
|
||||||
```bash
|
~/blackroad-deploy/br-deploy deploy ~/blackroad-apps/roadmap aria64
|
||||||
cd ~/blackroad-deploy
|
|
||||||
./br-deploy deploy ~/blackroad-apps/roadmap aria64
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Architecture
|
## Architecture
|
||||||
|
|
||||||
```
|
Apps run on Raspberry Pi nodes (aria64) and DigitalOcean droplets behind Caddy reverse proxy.
|
||||||
┌─────────────────────────────────────────┐
|
|
||||||
│ BlackRoad Ecosystem │
|
|
||||||
├─────────────────────────────────────────┤
|
|
||||||
│ │
|
|
||||||
│ ┌──────────┐ ┌──────────┐ │
|
|
||||||
│ │ aria64 │ │shellfish │ │
|
|
||||||
│ │ (Pi) │ │ (Droplet)│ │
|
|
||||||
│ └────┬─────┘ └────┬─────┘ │
|
|
||||||
│ │ │ │
|
|
||||||
│ ┌────▼─────────────▼────┐ │
|
|
||||||
│ │ Caddy Reverse Proxy │ │
|
|
||||||
│ └─────────┬───────────── ┘ │
|
|
||||||
│ │ │
|
|
||||||
│ ┌────▼────┐ │
|
|
||||||
│ │ Apps │ │
|
|
||||||
│ └─────────┘ │
|
|
||||||
└─────────────────────────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
## Deployment Status
|
|
||||||
|
|
||||||
Check deployments:
|
|
||||||
```bash
|
```bash
|
||||||
|
# Check deployments
|
||||||
~/blackroad-deploy/br-deploy list aria64
|
~/blackroad-deploy/br-deploy list aria64
|
||||||
~/blackroad-deploy/br-deploy list shellfish
|
|
||||||
```
|
|
||||||
|
|
||||||
View logs:
|
# View logs
|
||||||
```bash
|
|
||||||
~/blackroad-deploy/br-deploy logs roadmap aria64
|
~/blackroad-deploy/br-deploy logs roadmap aria64
|
||||||
~/blackroad-deploy/br-deploy logs roadworld shellfish
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## DNS Configuration
|
## Project Structure
|
||||||
|
|
||||||
Set up domains for each app:
|
```
|
||||||
```bash
|
blackroad-apps/
|
||||||
~/blackroad-deploy/scripts/dns-manager.sh set roadmap.blackroad.io aria64
|
roadmap/ # Project planning
|
||||||
~/blackroad-deploy/scripts/dns-manager.sh set roadwork.blackroad.io aria64
|
roadwork/ # Job portal
|
||||||
~/blackroad-deploy/scripts/dns-manager.sh set roadworld.blackroad.io shellfish
|
roadworld/ # Earth exploration
|
||||||
~/blackroad-deploy/scripts/dns-manager.sh set roadchain.blackroad.io shellfish
|
roadchain/ # Blockchain
|
||||||
~/blackroad-deploy/scripts/dns-manager.sh set roadcoin.blackroad.io shellfish
|
roadcoin/ # Crowdfunding
|
||||||
~/blackroad-deploy/scripts/dns-manager.sh set roadview.blackroad.io aria64
|
roadview/ # Creative suite
|
||||||
~/blackroad-deploy/scripts/dns-manager.sh set pitstop.blackroad.io aria64
|
pitstop/ # Infrastructure dashboard
|
||||||
~/blackroad-deploy/scripts/dns-manager.sh set roadside.blackroad.io aria64
|
roadside/ # Deploy portal
|
||||||
|
DEPLOY_ALL.sh # Batch deploy script
|
||||||
```
|
```
|
||||||
|
|
||||||
## Tech Stack Summary
|
## License
|
||||||
|
|
||||||
- **Frontend**: Next.js, React, Vue.js, Svelte
|
Copyright 2026 BlackRoad OS, Inc. All rights reserved.
|
||||||
- **Backend**: Node.js, Python, Go, Rust
|
|
||||||
- **Real-time**: WebSockets, Socket.io
|
|
||||||
- **Data**: PostgreSQL, MongoDB, Redis
|
|
||||||
- **Blockchain**: Custom Rust implementation
|
|
||||||
- **3D/Graphics**: Three.js, WebGL
|
|
||||||
- **Deployment**: Docker, Custom buildpacks
|
|
||||||
|
|
||||||
## Features Across Ecosystem
|
|
||||||
|
|
||||||
✅ Real-time collaboration
|
|
||||||
✅ AI integration
|
|
||||||
✅ Blockchain verification
|
|
||||||
✅ Metaverse/3D worlds
|
|
||||||
✅ Job matching
|
|
||||||
✅ Funding platforms
|
|
||||||
✅ Creative tools
|
|
||||||
✅ Infrastructure monitoring
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
Built for BlackRoad OS 🛣️
|
|
||||||
|
|||||||
Reference in New Issue
Block a user