Skip to content

docs: name locuscompare as the read-only serving account#32

Merged
boxiangliu merged 1 commit into
mainfrom
docs/connect-account
Jul 7, 2026
Merged

docs: name locuscompare as the read-only serving account#32
boxiangliu merged 1 commit into
mainfrom
docs/connect-account

Conversation

@boxiangliu

Copy link
Copy Markdown
Contributor

What

Junbin provisioned a dedicated read-only account, locuscompare. This promotes it to the serving account in the connect how-to and .env.example, and demotes the public locusview_test demo to exploration-only.

  • How-to §0 — new locuscompare section: password via the secret store / gitignored .env (never committed); the app reads it from .env automatically. Verified read-only + PII-safe (SHOW GRANTS → 990 SELECT/USAGE, no writes; user table denied, ERROR 1142). The old demo account moves to §0b, marked superseded.
  • Access-model table, §2 note, and §4 env block/SQLAlchemy URL updated to locuscompare.
  • .env.example: USER=locuscompare, PORT=31987, host filled; password stays blank.

Why

The credential now lives in the secret layer, not in a doc — the difference between "works in dev" and "how production connects" (ADR-0008). The demo login stays only for quick public exploration.

Safety

git grep confirms the real password is in no tracked file — it exists only in the gitignored .env. This PR changes only docs.

Junbin provisioned a dedicated read-only account (`locuscompare`). Promote it to
THE serving account in the connect how-to + .env.example; demote the public
`locusview_test` demo login to exploration-only.

- how-to §0: new `locuscompare` section (password via secret store / gitignored
  .env, never committed); verified read-only + PII-safe (990 SELECT/USAGE grants,
  `user` denied). Old §0 demo → §0b, marked superseded.
- Access-model table + §2 note + §4 env block/URL updated to `locuscompare`.
- .env.example: user=locuscompare, port=31987, host filled; password stays blank.

No secret committed (verified: password only in gitignored .env).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@boxiangliu boxiangliu requested a review from gaojunbin July 7, 2026 03:10
@boxiangliu boxiangliu merged commit ee0f04f into main Jul 7, 2026
3 checks passed
@boxiangliu boxiangliu deleted the docs/connect-account branch July 7, 2026 10:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants