From 6bad2cb3f51b7cd61e4626dbeef6b1d8ba5c51ca Mon Sep 17 00:00:00 2001 From: Doxa Life Date: Thu, 1 Oct 2026 00:06:16 +0000 Subject: [PATCH] Docs and comments: neutral wording, no private hosts or tool folders - The laptop guide clones from instead of a private host, and states what the Deep Research page is now (a full-page app with a "Back to homepage" button) and the link text under the research map ("Deep Research app"). - The two-route laptop guide speaks of a shared server instead of a team's, and no longer names where an outside checker lives. - The 1040-maps .gitignore drops a line for a local tool folder; the SemanticTreeLegend header describes the clone in plain terms. No behaviour changes. --- MOBILIZATION-MAPS-LAPTOP.md | 11 ++++++----- documentation/LAPTOP-6WAY.md | 16 ++++++++-------- embeddables/micro-frontends/1040-maps/.gitignore | 1 - .../src/components/SemanticTreeLegend.vue | 3 +-- 4 files changed, 15 insertions(+), 16 deletions(-) diff --git a/MOBILIZATION-MAPS-LAPTOP.md b/MOBILIZATION-MAPS-LAPTOP.md index d7f40c2f..38e2a98f 100644 --- a/MOBILIZATION-MAPS-LAPTOP.md +++ b/MOBILIZATION-MAPS-LAPTOP.md @@ -6,12 +6,12 @@ hidden Deep Research page and the Research page. No database, no Docker, no secr ## You need - **bun 1.3+** and **node 20+** -- Your login for git.nuxtbase.app (the repo is private) +- **git**, and the address of the repository that holds this branch ## Steps ```bash -git clone -b deep-research --single-branch https://git.nuxtbase.app/doxa-life/doxa-maps-cdn.git dx-life-deep-research +git clone -b deep-research --single-branch dx-life-deep-research cd dx-life-deep-research bun install PORT=4611 bun run dev @@ -55,11 +55,12 @@ back to MapLibre, so a map always starts. ## What is in this branch - `/deep-research`: the Deep Research gallery (the DX Maps mobilization maps in one app, the - Experimental section included), filling the page below the header. Every tab has an info button + Experimental section included), as a full-page app with no site header; its "Back to homepage" button sits + above the menu's Collapse button. Every tab has an info button that explains what the map does. - `/research`: DX Life's production page (fc4d622), with the research map on its own, now loaded from - this site's own `/dx-maps/`, and under it one new line: "Want Deeper Research? See our - Deep-Research Maps →", which links to `/deep-research` in the reader's language. The line is in all + this site's own `/dx-maps/`, and under it one new line: "Want Deeper Research? Deep Research + app →", which links to `/deep-research` in the reader's language. The line is in all 11 of the site's locales. - `/` and `/pray`: the engagement map and the prayer map (the simple map with those presets), as before. - `public/dx-maps/`: the DX Maps output folder, from DX Maps `development` 32715a5cc. diff --git a/documentation/LAPTOP-6WAY.md b/documentation/LAPTOP-6WAY.md index 905a97c7..9ed97165 100644 --- a/documentation/LAPTOP-6WAY.md +++ b/documentation/LAPTOP-6WAY.md @@ -1,13 +1,13 @@ # The Research Gallery on your laptop: two routes DX-life takes the dx-maps Research Gallery in **two routes**, one branch each. This page runs each of them on a -laptop, so you can see and test them before any server is involved. The same two run on the team's servers; +laptop, so you can see and test them before any server is involved. The same two run on a shared server; together that is the embed test (2 routes × laptop and server). | Route | DX-life branch | What runs | Docker | PocketBase | |---|---|---|---|---| | **Drop-in** (the default) | `research-gallery-drop-in` | this site alone; the maps are its own copy in `public/dx-maps` | no | no | -| **Subdomain** | `research-gallery-subdomain` | the dx-maps **team container** (Plugin Studio, PocketBase, the research site) + a local sign-in + this site | yes, about 5 GB | yes, for plugins that have users, an API or a database | +| **Subdomain** | `research-gallery-subdomain` | the dx-maps **container** (Plugin Studio, PocketBase, the research site) + a local sign-in + this site | yes, about 5 GB | yes, for plugins that have users, an API or a database | The **CDN** route (`research-gallery-cdn`) was retired on 2026-09-29. Its branch is kept for history. @@ -15,7 +15,7 @@ The **CDN** route (`research-gallery-cdn`) was retired on 2026-09-29. Its branch - **Checkouts side by side:** ``` - doxa-maps/ dx-maps, on development (the team's table) or main (production) + doxa-maps/ dx-maps, on development (work in progress) or main (production) doxa-life/ this repo ``` - **bun 1.3+** and **node 20+**. For the subdomain route, **Docker** with Compose: it uses about 1.4 GB, 2.5 GB while @@ -44,7 +44,7 @@ git restore public # dx-maps b Afterwards, put the site's copy back: `git restore public/dx-maps && git clean -fdq public/dx-maps`. -## 2. Subdomain (the dx-maps team container, with PocketBase) +## 2. Subdomain (the dx-maps container, with PocketBase) ```bash cd doxa-life && git switch research-gallery-subdomain @@ -52,8 +52,8 @@ bun run laptop subdomain ``` **The first time,** it makes `.env.laptop` (secrets, never committed) and stops if `GIT_TOKEN` is empty. -- Put a read token for the team's git server there and run it again. -- It builds dx-maps' container from `../doxa-maps/Dockerfile`, the image the team's server runs. +- Put a read token for the git server that hosts the repositories there and run it again. +- It builds dx-maps' container from `../doxa-maps/Dockerfile`, the image the shared server runs. - Pull dx-maps `development` first. The first start takes 5-10 minutes: the container clones, installs and publishes. @@ -66,7 +66,7 @@ It starts three services, all on `127.0.0.1` only: | http://localhost:4616/ | the Plugin Studio, PocketBase (`/pb`), `/cdn`, `/admin` | | http://localhost:4620/team | the local sign-in provider | -**Sign-in and roles**, the same as the team's server: +**Sign-in and roles**, the same as on the shared server: - Sign in to the Studio as **`admin`** (everything, including publishing and the PocketBase dashboard) or **`designer`** (the Studio and PocketBase's API). - Any other name is a plain team member, and is refused, as on the server. @@ -92,7 +92,7 @@ deletes them. `bun run laptop status` shows what's running. `/ar/embed-test` runs the same test right to left. - **`/research/?tab=regions-dashboard`** opens the gallery on its Regions tab, and `/regions` redirects there. On the subdomain route that means `http://research.localhost:4615/?tab=regions-dashboard`. -- **Headless**, dx-base's `check-embed-6way.mjs` (in the fleet's QA folder) checks, for every production plugin: +- **Headless**, a checker kept outside this repository (`check-embed-6way.mjs`) checks, for every production plugin: the script, its integrity hash, its element, its page, CORS, and the copy-paste snippet. The label reads `=@`: - drop-in: `drop-in=http://localhost:4611@http://localhost:4611/dx-maps/manifest.json`; diff --git a/embeddables/micro-frontends/1040-maps/.gitignore b/embeddables/micro-frontends/1040-maps/.gitignore index 33ad00de..e47536bc 100644 --- a/embeddables/micro-frontends/1040-maps/.gitignore +++ b/embeddables/micro-frontends/1040-maps/.gitignore @@ -26,7 +26,6 @@ dist/ # Internal engineering scratch — never commit .local-scratch/ -.lk10x/ .agent-restricted build-status.md embeddables/**/intel/ diff --git a/embeddables/micro-frontends/1040-maps/src/components/SemanticTreeLegend.vue b/embeddables/micro-frontends/1040-maps/src/components/SemanticTreeLegend.vue index 2f7cb574..d4456070 100644 --- a/embeddables/micro-frontends/1040-maps/src/components/SemanticTreeLegend.vue +++ b/embeddables/micro-frontends/1040-maps/src/components/SemanticTreeLegend.vue @@ -2,8 +2,7 @@ /** * SemanticTreeLegend — reusable hierarchical legend for any one-to-many semantic tree. * - * EXACT CLONE of the upstream PPLR module - * per user directive: "do a direct clone, only shave the API." Only difference vs. + * EXACT CLONE of the upstream PPLR module: a direct clone in which only the API is reduced. Only difference vs. * upstream is the