blackroad-os/blackroad-operating-system
9
0
Fork 0
mirror of https://github.com/blackboxprogramming/BlackRoad-Operating-System.git synced 2026-03-17 05:57:21 -05:00
Code Issues Packages Projects Releases Wiki Activity
Files
d9d92773aabf10f962f07323ee2a3d047e5bcdde
blackroad-operating-system/infra/DOMAIN_ARCHITECTURE.md
Alexa Louise 9644737ba7 feat: Add domain architecture and extract core services from Prism Console 
## Domain Architecture
- Complete domain-to-service mapping for 16 verified domains
- Subdomain architecture for blackroad.systems and blackroad.io
- GitHub organization mapping (BlackRoad-OS repos)
- Railway service-to-domain configuration
- DNS configuration templates for Cloudflare

## Extracted Services

### AIops Service (services/aiops/)
- Canary analysis for deployment validation
- Config drift detection
- Event correlation engine
- Auto-remediation with runbook mapping
- SLO budget management

### Analytics Service (services/analytics/)
- Rule-based anomaly detection with safe expression evaluation
- Cohort analysis with multi-metric aggregation
- Decision engine with credit budget constraints
- Narrative report generation

### Codex Governance (services/codex/)
- 82+ governance principles (entries)
- Codex Pantheon with 48+ agent archetypes
- Manifesto defining ethical framework

## Integration Points
- AIops → infra.blackroad.systems (blackroad-os-infra)
- Analytics → core.blackroad.systems (blackroad-os-core)
- Codex → operator.blackroad.systems (blackroad-os-operator)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-29 13:39:08 -06:00

252 lines
10 KiB
Markdown
Raw Blame History

# BlackRoad Domain Architecture
> **Last Updated**: 2025-11-29
> **Purpose**: Map verified domains to services, repos, and Railway deployments
---
## Domain Inventory
### Primary Domains
| Domain | Purpose | Target Service | Railway Service |
|--------|---------|----------------|-----------------|
| **blackroad.systems** | Enterprise OS Platform | API Gateway | blackroad-os-api-gateway |
| **blackroad.io** | Consumer Platform | Web App | blackroad-os-web |
| **blackroadinc.us** | Corporate Site | Static/Landing | blackroad-os-home |
| **blackroadai.com** | AI Platform | Prism Console | blackroad-prism-console |
| **lucidia.earth** | Lucidia Platform | Lucidia Service | (future) |
| **lucidia.studio** | Creator Studio | Creator Pack | blackroad-os-pack-creator-studio |
### Quantum/Research Domains
| Domain | Purpose | Target Service |
|--------|---------|----------------|
| **blackroadquantum.com** | Quantum Computing Hub | blackroad-os-research |
| **blackroadquantum.info** | Quantum Documentation | blackroad-os-docs |
| **blackroadquantum.net** | Quantum Network/API | blackroad-os-pack-research-lab |
| **blackroadquantum.shop** | Quantum Marketplace | (future) |
| **blackroadquantum.store** | Quantum Assets | (future) |
| **blackroadqi.com** | Quantum Intelligence | blackroad-os-research |
| **lucidiaqi.com** | Lucidia Quantum | blackroad-os-research |
### Specialty Domains
| Domain | Purpose | Target Service |
|--------|---------|----------------|
| **blackroad.me** | Personal/Profile | blackroad-os-web |
| **blackroad.network** | Network Services | blackroad-os-infra |
| **aliceqi.com** | Alice/Personal Brand | (static) |
---
## Subdomain Architecture
### blackroad.systems (Enterprise)
```
blackroad.systems
├── api.blackroad.systems → blackroad-os-api-gateway
├── core.blackroad.systems → blackroad-os-core
├── operator.blackroad.systems → blackroad-os-operator
├── beacon.blackroad.systems → blackroad-os-beacon
├── prism.blackroad.systems → blackroad-prism-console
├── docs.blackroad.systems → blackroad-os-docs
├── console.blackroad.systems → blackroad-os-master
├── infra.blackroad.systems → blackroad-os-infra
├── archive.blackroad.systems → blackroad-os-archive
├── demo.blackroad.systems → blackroad-os-demo
└── status.blackroad.systems → (health dashboard)
```
### blackroad.io (Consumer)
```
blackroad.io
├── app.blackroad.io → blackroad-os-web (main app)
├── home.blackroad.io → blackroad-os-home (landing)
├── roadview.blackroad.io → (search platform - future)
├── roadwork.blackroad.io → blackroad-os-pack-education
├── roadworld.blackroad.io → (metaverse - future)
├── roadtrip.blackroad.io → blackroad-os-pack-creator-studio
├── roadchain.blackroad.io → (blockchain - future)
├── agents.blackroad.io → blackroad-os-agents
└── api.blackroad.io → blackroad-os-api
```
### Pack Subdomains
```
packs.blackroad.systems (or blackroad.io)
├── finance.blackroad.systems → blackroad-os-pack-finance
├── legal.blackroad.systems → blackroad-os-pack-legal
├── research.blackroad.systems → blackroad-os-pack-research-lab
├── creator.blackroad.systems → blackroad-os-pack-creator-studio
├── education.blackroad.systems → blackroad-os-pack-education
├── devops.blackroad.systems → blackroad-os-pack-infra-devops
└── brand.blackroad.systems → blackroad-os-brand
```
---
## GitHub Organization Mapping
### BlackRoad-OS (Primary)
| Repository | Domain | Purpose |
|------------|--------|---------|
| blackroad-os | blackroad.io | Main monorepo/orchestration |
| blackroad-os-web | app.blackroad.io | Consumer web application |
| blackroad-os-core | core.blackroad.systems | Core API & backend |
| blackroad-os-api | api.blackroad.io | Public API |
| blackroad-os-api-gateway | api.blackroad.systems | API gateway/routing |
| blackroad-os-operator | operator.blackroad.systems | GitHub automation |
| blackroad-os-beacon | beacon.blackroad.systems | Health monitoring |
| blackroad-os-master | console.blackroad.systems | Master console |
| blackroad-os-home | home.blackroad.io | Landing page |
| blackroad-os-docs | docs.blackroad.systems | Documentation |
| blackroad-os-demo | demo.blackroad.systems | Demo environment |
| blackroad-os-archive | archive.blackroad.systems | Archive storage |
| blackroad-os-infra | infra.blackroad.systems | Infrastructure |
| blackroad-os-agents | agents.blackroad.io | Agent system |
| blackroad-os-research | research.blackroad.systems | Research platform |
| blackroad-os-brand | brand.blackroad.systems | Brand assets |
| blackroad-os-ideas | - | Ideas repository |
### Pack Repositories
| Repository | Domain | Purpose |
|------------|--------|---------|
| blackroad-os-pack-finance | finance.blackroad.systems | Finance automation |
| blackroad-os-pack-legal | legal.blackroad.systems | Legal & compliance |
| blackroad-os-pack-research-lab | research.blackroad.systems | Research tools |
| blackroad-os-pack-creator-studio | creator.blackroad.systems | Creator tools |
| blackroad-os-pack-education | education.blackroad.systems | Education platform |
| blackroad-os-pack-infra-devops | devops.blackroad.systems | DevOps tools |
### Other Organizations
| Organization | Domain Focus | Purpose |
|--------------|--------------|---------|
| BlackRoad-AI | blackroadai.com | AI/ML services |
| BlackRoad-Labs | blackroadquantum.* | Research & quantum |
| BlackRoad-Education | roadwork.blackroad.io | Education platform |
| BlackRoad-Media | - | Media & content |
| BlackRoad-Studio | lucidia.studio | Creator studio |
| BlackRoad-Cloud | blackroad.network | Cloud infrastructure |
| BlackRoad-Security | - | Security services |
| BlackRoad-Foundation | - | Open source & community |
| BlackRoad-Interactive | - | Gaming & metaverse |
| BlackRoad-Hardware | - | Hardware projects |
| BlackRoad-Ventures | - | Investments |
| BlackRoad-Gov | - | Government/compliance |
| BlackRoad-Archive | archive.blackroad.systems | Archive management |
| Blackbox-Enterprises | - | Parent company |
---
## Railway Service to Domain Mapping
### Current Railway Services (BlackRoad OS Project)
| Railway Service | Primary Domain | Subdomain |
|----------------|----------------|-----------|
| blackroad | blackroad.io | (root) |
| blackroad-os | blackroad.io | os.blackroad.io |
| blackroad-os-master | blackroad.systems | console.blackroad.systems |
| blackroad-os-home | blackroad.io | home.blackroad.io |
| blackroad-os-operator | blackroad.systems | operator.blackroad.systems |
| blackroad-os-beacon | blackroad.systems | beacon.blackroad.systems |
| blackroad-os-core | blackroad.systems | core.blackroad.systems |
| blackroad-os-api | blackroad.io | api.blackroad.io |
| blackroad-os-api-gateway | blackroad.systems | api.blackroad.systems |
| blackroad-os-web | blackroad.io | app.blackroad.io |
| blackroad-os-docs | blackroad.systems | docs.blackroad.systems |
| blackroad-os-demo | blackroad.systems | demo.blackroad.systems |
| blackroad-os-infra | blackroad.systems | infra.blackroad.systems |
| blackroad-os-archive | blackroad.systems | archive.blackroad.systems |
| blackroad-os-research | blackroad.systems | research.blackroad.systems |
| blackroad-prism-console | blackroad.systems | prism.blackroad.systems |
| blackroad-os-pack-finance | blackroad.systems | finance.blackroad.systems |
| blackroad-os-pack-legal | blackroad.systems | legal.blackroad.systems |
| blackroad-os-pack-research-lab | blackroad.systems | lab.blackroad.systems |
| blackroad-os-pack-creator-studio | blackroad.io | creator.blackroad.io |
| blackroad-os-pack-infra-devops | blackroad.systems | devops.blackroad.systems |
---
## DNS Configuration (Cloudflare)
### Root Domain Records
```dns
# blackroad.systems
@ A (Railway IP or CNAME to Railway)
api CNAME blackroad-os-api-gateway-production.up.railway.app
core CNAME blackroad-os-core-production.up.railway.app
operator CNAME blackroad-os-operator-production.up.railway.app
beacon CNAME blackroad-os-beacon-production.up.railway.app
prism CNAME blackroad-prism-console-production.up.railway.app
docs CNAME blackroad-os-docs-production.up.railway.app
console CNAME blackroad-os-master-production.up.railway.app
infra CNAME blackroad-os-infra-production.up.railway.app
demo CNAME blackroad-os-demo-production.up.railway.app
archive CNAME blackroad-os-archive-production.up.railway.app
research CNAME blackroad-os-research-production.up.railway.app
finance CNAME blackroad-os-pack-finance-production.up.railway.app
legal CNAME blackroad-os-pack-legal-production.up.railway.app
devops CNAME blackroad-os-pack-infra-devops-production.up.railway.app
# blackroad.io
@ A (Railway IP or CNAME to Railway)
app CNAME blackroad-os-web-production.up.railway.app
home CNAME blackroad-os-home-production.up.railway.app
api CNAME blackroad-os-api-production.up.railway.app
agents CNAME blackroad-os-agents-production.up.railway.app
creator CNAME blackroad-os-pack-creator-studio-production.up.railway.app
```
---
## Implementation Priority
### Phase 1: Core Infrastructure (Now)
1. ✅ blackroad.systems → api.blackroad.systems (API Gateway)
2. ✅ prism.blackroad.systems (Prism Console)
3. ✅ operator.blackroad.systems (Operator)
4. ✅ beacon.blackroad.systems (Beacon)
5. [ ] core.blackroad.systems (Core API)
6. [ ] docs.blackroad.systems (Documentation)
### Phase 2: Consumer Platform
1. [ ] blackroad.io root
2. [ ] app.blackroad.io (Main app)
3. [ ] home.blackroad.io (Landing)
4. [ ] api.blackroad.io (Public API)
### Phase 3: Packs & Extensions
1. [ ] finance.blackroad.systems
2. [ ] legal.blackroad.systems
3. [ ] research.blackroad.systems
4. [ ] creator.blackroad.io
5. [ ] education.blackroad.io
### Phase 4: Advanced
1. [ ] blackroadquantum.com
2. [ ] lucidia.earth
3. [ ] lucidia.studio
---
## Service Health Endpoints
All services should expose:
- `GET /health` - Basic health check
- `GET /v1/sys/health` - Detailed system health
- `GET /v1/sys/identity` - Service identity
- `GET /v1/sys/version` - Version info
---
*This document defines the canonical mapping between domains, services, and repositories for BlackRoad OS.*
Reference in New Issue View Git Blame Copy Permalink