chore(docs+devops): cross-module doc sync + sprint archival moves + compose updates

Bundled pre-session doc + ops work:
- docs/modules/**: sync across advisory-ai, airgap, cli, excititor,
  export-center, findings-ledger, notifier, notify, platform, router,
  sbom-service, ui, web (architectural + operational updates)
- docs/features/**: updates to checked excititor vex pipeline,
  developer workspace, quick verify drawer
- docs top-level: README, quickstart, API_CLI_REFERENCE, UI_GUIDE,
  code-of-conduct/TESTING_PRACTICES updates
- docs/qa/feature-checks/: FLOW.md + excititor state update
- docs/implplan/: remaining sprint updates + new Concelier source
  credentials sprint (SPRINT_20260422_003)
- docs-archived/implplan/: 30 sprint archival moves (ElkSharp series,
  misc completed sprints)
- devops/compose: .env + services compose + env example + router gateway
  config updates

File-level granularity preserved.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
master
2026-04-22 16:06:39 +03:00
parent ad77711ac2
commit 7943cfb3af
121 changed files with 10483 additions and 387 deletions

View File

@@ -59,6 +59,7 @@ The setup script will:
- Verify all prerequisites are installed
- Offer to add hosts file entries (50 services need unique loopback IPs)
- Create `.env` from the example template (works out of the box, no editing needed)
- Seed the local admin credential from `STELLAOPS_ADMIN_PASS` (default `Admin@Stella2026!`)
- Create or reuse the external frontdoor Docker network from `.env` (`FRONTDOOR_NETWORK`, default `stellaops_frontdoor`)
- Build .NET solutions and Docker images
- Launch the full platform stack (`docker-compose.stella-ops.yml`)
@@ -73,6 +74,45 @@ To skip builds and only start infrastructure:
./scripts/setup.sh --infra-only # Linux/macOS
```
### Local admin credentials
The local compose template ships with:
- Username: `admin`
- Password env var: `STELLAOPS_ADMIN_PASS`
- Default local value: `Admin@Stella2026!`
Override it before running setup if you do not want the default local password:
```powershell
$env:STELLAOPS_ADMIN_PASS = 'Admin@Stella2026!'
.\scripts\setup.ps1
```
```bash
export STELLAOPS_ADMIN_PASS='Admin@Stella2026!'
./scripts/setup.sh
```
### Local UI builds that actually reach `stella-ops.local`
By default the local frontdoor serves the Angular console from the `console-dist`
Docker volume. That means a plain `ng build` can succeed while the browser still
shows the old UI bundle.
For active UI work, switch the gateway to the bind-mounted dev override once:
```powershell
cd devops/compose
docker compose -f docker-compose.stella-ops.yml -f docker-compose.dev-ui.yml up -d router-gateway
cd ../../src/Web/StellaOps.Web
npx ng build --configuration=development --watch
```
After that, refresh `https://stella-ops.local` after rebuilds. The local auth and
Playwright helpers already tolerate self-signed local certificates; keep product
runtime TLS validation strict.
## 3. First 30 minutes path
1. Start platform quickly (reuse existing images):
@@ -84,8 +124,9 @@ To skip builds and only start infrastructure:
docker compose -f devops/compose/docker-compose.stella-ops.yml ps
```
3. Open **https://stella-ops.local**.
4. Complete the setup wizard and create the first administrator account for this install.
5. Sign in with the credentials you just created.
4. Sign in with `admin` and the `STELLAOPS_ADMIN_PASS` value used during setup.
Default local password: `Admin@Stella2026!`.
5. If the install opens the setup wizard, continue the first-run or reconfigure flow from the authenticated session.
Optional demo datasets are manual-only and not part of the default bootstrap path. If you explicitly need them for demo purposes, use the manual seeding section in [DEV_ENVIRONMENT_SETUP.md](dev/DEV_ENVIRONMENT_SETUP.md).
@@ -123,6 +164,7 @@ docker compose -f devops/compose/docker-compose.stella-ops.yml --profile sigstor
| `stellaops-dev-rekor` restarting without `--profile sigstore` | Optional profile container from older runs | Non-blocking for default setup; ignore or clean old container |
| `SM remote service probe failed (localhost:56080)` in `stella --verbose ...` or crypto diagnostics | Optional China SM Remote plugin probe | Non-blocking for default crypto profile; ordinary CLI payload commands now suppress this startup noise |
| Manual demo seed endpoint still returns HTTP 500 after patching source | Running old container image | Rebuild/restart platform image and retest |
| `ng build` succeeds but `stella-ops.local` still shows the old UI | `router-gateway` is still serving the `console-dist` Docker volume | Apply `docker-compose.dev-ui.yml` with `docker compose -f devops/compose/docker-compose.stella-ops.yml -f devops/compose/docker-compose.dev-ui.yml up -d router-gateway`, then rebuild the Angular app |
| Port conflicts | Local process already using mapped port | Override in `devops/compose/.env` (`devops/compose/env/stellaops.env.example`) |
## Next steps