# DBAOps Sovereign™
## Enterprise Database Operations Platform

**Release 1.3.0 Gold Master** — production-deliverable baseline.  
**Trademark & brand (your label):** **`delivery/TRADEMARK-AND-BRAND.md`**  
**Enterprise handoff pack:** **`delivery/DELIVERY-MANIFEST.md`** — then **`npm run package:enterprise`** (or **`npm run package:pilot`**) writes the complete tree to **`pilot-before-website/DBAOps-Sovereign-1.3.0-enterprise/`** on **Windows, macOS, or Linux**. **Start here for QA / pilot (before the public website):** **`pilot-before-website/START-HERE.md`**.

**Gold Master install story:** **`docs/INSTALL-CROSS-PLATFORM.md`** — **`npm run setup`**, shell scripts, or **`npm run docker:up`** for API + UI on **Docker Desktop** everywhere.

Before promotion / packaging: **`npm run verify:deploy`** (syntax + API tests; optional env flags per **`docs/CUSTOMER-DEPLOYMENT.md`**). After **`npm run build`**, start the API and run **`npm run verify:smoke`** (or **`.\scripts\verify-release.ps1 -Smoke`** on Windows, **`./scripts/verify-release.sh`** on Unix).

**The Apex of Database Administration · The Nexus of Fleet Sovereignty**

Powered by **RHOYLLE INNOVATION EMPIRE LLC**  
DBAOps™ Serial No. 99717776

---

## Quick start (all operating systems)

### Gold Master quickstart

Use this repo as the **Gold Master** source tree — typically checked out to **`DBAOps-Sovereign/`** (example absolute path on the authoring workstation: **`K:\RHOYLLE BUSINESS EMPIRE LLC\Business Plans\PRODUCTS\DBAOps-Sovereign`**).

```bash
npm install
npm run setup                    # copies .env examples, installs api + web deps, prints next steps
npm run verify:deploy            # recommended: syntax check + full API Jest suite (see package.json)
npm start                        # dev: API :3041 (SOVEREIGN_API_PORT) + Fleet Command (CRA dev server, default :3000)
```

**Simulator catalog:** To point the incident-rehearsal simulator at an approved JSON catalog in sovereign / air-gapped builds, set **`SOVEREIGN_SIMULATOR_CATALOG_PATH`** in `.env` (template in **`.env.example`**; reference catalog **`src/api/data/dbaopsSimulator.catalog.json`**).

**Docker (identical on Windows, macOS, Linux):**

```bash
npm run docker:up      # or: docker compose -f docker-compose.all-in-one.yml up --build
# UI http://localhost:3000 · API http://localhost:3041
```

**Windows PowerShell** (optional): `.\scripts\install.ps1`, `.\scripts\build.ps1`, `.\scripts\run.ps1` — same outcome as the commands above.

**macOS / Linux / WSL:** `./scripts/install.sh`, `./scripts/run.sh`, `./scripts/build.sh` (see **`docs/INSTALL-CROSS-PLATFORM.md`**).

---

## Project Structure

```
DBAOps-Sovereign/
├── src/
│   ├── api/              # REST API (Node.js + Express)
│   ├── web/              # React dashboard (Fleet Command UI)
│   ├── database/         # SovereignRepository schema & migrations
│   └── collectors/       # PowerShell collection modules
├── scripts/              # Build, run, deploy automation
└── docs/                 # Setup & deployment guides
```

---

## Prerequisites

- **Node.js** 18+ and **npm** (required for development and enterprise bundle)
- **Docker Desktop** (optional; recommended for “same bits everywhere” evaluation and pilot)
- **SQL Server** 2022+ (for production SovereignRepository; optional for evaluation / mock paths)
- **PowerShell** 7+ on **Windows** collector hosts; PowerShell scripts under `scripts/` are optional convenience on Windows

**Install prerequisites on the machine:** **`docs/INSTALL-REQUIREMENTS.md`** — quick path: **`npm run install:requirements`** (optional flags: Windows **`-IncludeDocker`**, **`-IncludePowerShell7`**, **`-IncludeGit`**, **`-IncludeSqlExpress`**; Unix **`--with-docker`**, **`--yes`** for non-interactive Linux).

---

## When You Return

1. Set `SOVEREIGN_DB_CONNECTION` in `.env` (or update `src/api/config.js`)
2. Run `.\scripts\migrate.ps1` to create the database schema
3. Run `.\scripts\run.ps1` to start API and dashboard
4. Open http://localhost:3000 for dashboard, http://localhost:3041/api/health for API

---

## Documentation

| Doc | Use |
|-----|-----|
| **`delivery/DELIVERY-MANIFEST.md`** | **Master index** of enterprise deliverables |
| **`delivery/ENTERPRISE-DELIVERY.md`** | How top B2B products are delivered (aligned set) |
| **`docs/USER-MANUAL.md`** | Operators — screens, license, collectors, troubleshooting |
| **`docs/ARCHITECTURE.md`** | Logical architecture (diagram) |
| **`docs/PILOT-RUNBOOK.md`** | Single-day pilot checklist |
| **`docs/FINAL-PRODUCT-SNAPSHOT.md`** | **Gold Master snapshot** — stacks, run + verify commands, readiness tooling, deferred / buyer-risk items |
| **`docs/TIERS.md`** | License / editions (pilot vs paid); no separate “Community” SKU in code |
| **`docs/INSTALL-CROSS-PLATFORM.md`** | **Primary install path** — every OS + Docker |
| **`docs/INSTALL-REQUIREMENTS.md`** | **Node, Docker, SQL, Git, PowerShell** — winget/brew/apt + manual links |
| **`docs/CUSTOMER-DEPLOYMENT.md`** | Production deployment |
| **`delivery/SECURITY-HARDENING.md`** | Production security checklist |
| **`delivery/EULA-TEMPLATE.md`** | Draft EULA structure — **attorney review required** |
| **`delivery/SUPPORT-AND-SLA-TEMPLATE.md`** | Support / severity template |
| **`marketing/README.md`** | Where to add screenshots & flyers (not pre-generated in repo) |

## Commercial / paying customers

**DBAOps Sovereign™** is offered commercially by **RHOYLLE INNOVATION EMPIRE LLC** (DBAOps™ Serial No. 99717776). For production installs, use:

- **`docs/CUSTOMER-DEPLOYMENT.md`** — TLS, secrets, license, SQL, ingest key, CORS  
- **`CHANGELOG.md`** — release notes (e.g. **1.3.0** customer baseline)  
- **`GET /api/openapi.json`** — machine-readable API contract  

Licensing is enforced via **`ctl.License`** and the **`LICENSE_BLOCK`** response on mutations when the subscription is inactive, expired, or over instance limits (see deployment doc).

---

© 2026 RHOYLLE INNOVATION EMPIRE LLC. DBAOps™ and DBAOps Sovereign™ are trademarks of RHOYLLE INNOVATION EMPIRE LLC.
