diff --git a/10-systems/applications/gitbucket.md b/10-systems/applications/gitbucket.md index 07e2dde..45cb54c 100644 --- a/10-systems/applications/gitbucket.md +++ b/10-systems/applications/gitbucket.md @@ -93,7 +93,7 @@ | `con2` | private | `master` | 2025-10-10 | `ecb9d38` | dormant-2025 | | | `fast-kognitest` | public | `master` | 2025-08-04 | `adfd80c` | dormant-2025 | | | `gate_interface` | private | `master` | 2025-07-18 | `85c2a62` | dormant-2025 | | -| `vmk-demo-bot` | public | `master` | 2025-07-15 | `d57cc60` | dormant-2025 | | +| `vmk-demo-bot` | public | `master` | 2025-07-15 | `5dcc60` | dormant-2025 | | | `mia_bot` | private | `master` | 2025-06-06 | `17060f8` | dormant-2025 | | | `fix-cyrillic` | public | `master` | 2025-05-26 | `1bb4de2` | dormant-2025 | | | `duck-search-for-ai` | private | `master` | 2025-04-25 | `27b45d9` | dormant-2025 | | @@ -124,7 +124,7 @@ | `vue-indexer` | public | `master` | 2024-09-24 | `4e69344` | old-2024 | | | `open-logistic-tycoon` | public | `master` | 2024-07-10 | `bd50659` | old-2024 | | | `olainfarm` | private | `master` | 2024-07-09 | `9a677cc` | old-2024 | | -| `wppverif` | private | `master` | 2024-06-20 | `d5c2f52` | old-2024 | | +| `wppverif` | private | `master` | 2024-06-20 | `d3c2f52` | old-2024 | | | `wpp-verif` | private | `master` | 2024-06-19 | `30becd1` | old-2024 | | | `wplms_user_transport` | private | `master` | 2024-06-18 | `3726f81` | old-2024 | | | `home-web-panel` | private | `master` | 2024-06-06 | `1e68e09` | old-2024 | | @@ -152,7 +152,7 @@ Useful next groups: -- Gnexus core: `gnexus-auth`, `gnexus-auth-client-py`, `gnexus-auth-client-php`, `gnexus-ui-kit`, `gnexus-book`. +- Gnexus core: `gnexus-auth`, `gnexus-auth-client-py`, `gnexus-auth-client-php`, `gnexus-ui-kit`, `gnexus-book`, `gnexus-handbook`. - Public services: `gnexus-welcome-page`, `lytvak`, `navi-1`, `navi-webclient`, `smart-home-server`. - AI/search/media tools: `vec_search`, `duck-search-for-ai`, `web-page-scrubber`, `voice-gen`, `whisper`, `music-parser`. - Home/infrastructure tools: `smart-home-server`, `home-web-panel`, `subnet_status`, `upsmon`, `disk-space-api`, `ubuntu_server_scripts`. diff --git a/10-systems/applications/gnexus-handbook.md b/10-systems/applications/gnexus-handbook.md new file mode 100644 index 0000000..e283bb0 --- /dev/null +++ b/10-systems/applications/gnexus-handbook.md @@ -0,0 +1,38 @@ +--- +owner: gmikcon +status: active +last_reviewed: 2026-10-04 +review_interval: 90d +confidence: high +source_of_truth: gitbucket-repository +--- + +# Gnexus Handbook + +Gnexus Handbook is the canonical repository of platform policy, conventions, and instructions for all Gnexus services. It answers "how should a new service be built"; gnexus-book answers "what exists and where". + +## Repository + +- Git URL: `https://git.gnexus.space/git/root/gnexus-handbook.git` +- Web: `https://git.gnexus.space/root/gnexus-handbook` +- Default branch: `master` +- Initial commit: `e10b4c3` (2026-10-04, 14 files) + +## Role + +- The owner references this repository instead of repeating conventions in every task or chat. +- Agents must read the handbook README before creating a new service. +- Raw file links for services and docs: `https://git.gnexus.space/root/gnexus-handbook/raw/master/` + +## Structure + +- `00-principles.md` — platform principles (self-hosted, open-source, budget-first, secrets, safety-first, documentation) +- `10-platform/` — auth (gnexus-auth SSO), ui (gnexus-ui-kit), notifications (Gnexus Synapse), secrets (gnexus-creds), git (GitBucket) +- `20-deployment/` — hosting, domains, backups +- `30-operations/` — monitoring (hard-panel, Synapse alerts), documentation rules (gnexus-book) +- `90-templates/` — new service checklist, service documentation template + +## Boundaries + +- Rules only. Facts (IPs, versions, state, routes) belong in gnexus-book. +- No secrets in the repository.