pediatric-ai-scribe-v3/docs
Daniel c9b6d6b3c9
Some checks failed
Forgejo Android APK / Root app tests (push) Successful in 47s
Forgejo Docker Build / Root app tests (push) Successful in 48s
Forgejo Android APK / Build signed APK (push) Successful in 2m22s
Forgejo Docker Build / Build Docker image (push) Successful in 11s
Forgejo Docker Build / Deploy to the host (push) Failing after 2s
docs: deploy.sh is the deploy path, and it was documented nowhere
scripts/deploy.sh landed on 2026-09-11 as "a deploy you can repeat, and prove
afterwards". It moves the PED_AI_IMAGE pin, waits for health, reads /api/build
to find out which revision is actually serving, and rolls back when that is not
the revision asked for. Its own comment says it: "Healthy is not the same as
running what was asked for."

No doc mentioned it. Both deployment.md and DEVELOPMENT.md instead showed
`build-image.sh` then `docker compose up -d --no-build` then `curl /api/health`
— a sequence that moves no pin and proves no revision. Following it deployed
nothing four times in one session, eventually reverting the app by 31 commits
and removing a feature, which was then reported as a bug.

Both docs now lead with deploy.sh and say why `up` by hand is not a deploy.

Also replaced yesterday's build-image.sh warning, which told the operator to
`sed` the pin themselves. That reimplemented, badly, one of the three things
deploy.sh already does — and it was written while auditing these very files
without noticing the script was there. It now prints the deploy.sh line to run.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Dv6sqaY6Vq3ChZHMem3cnU
2026-09-12 06:04:13 +02:00
..
logic docs: merge the duplicate pairs and correct them against the running app 2026-09-12 04:57:35 +02:00
ai-providers.md docs: merge the duplicate pairs and correct them against the running app 2026-09-12 04:57:35 +02:00
api-reference.md docs: merge the duplicate pairs and correct them against the running app 2026-09-12 04:57:35 +02:00
architecture.md docs: merge the duplicate pairs and correct them against the running app 2026-09-12 04:57:35 +02:00
authentication.md docs: accounts in the README, and the sign-in code path is verified end to end 2026-09-11 22:02:25 +02:00
clinical-assistant.md docs: merge the duplicate pairs and correct them against the running app 2026-09-12 04:57:35 +02:00
configuration.md docs: merge the duplicate pairs and correct them against the running app 2026-09-12 04:57:35 +02:00
database.md docs: merge the duplicate pairs and correct them against the running app 2026-09-12 04:57:35 +02:00
deployment.md docs: deploy.sh is the deploy path, and it was documented nowhere 2026-09-12 06:04:13 +02:00
developer-guide.md docs: deploy.sh is the deploy path, and it was documented nowhere 2026-09-12 06:04:13 +02:00
embeddings-setup.md simplify speech and embeddings through litellm 2026-05-09 05:09:02 +02:00
features-explained.md docs: merge the duplicate pairs and correct them against the running app 2026-09-12 04:57:35 +02:00
global-prompt-administration.md fix: reviewer findings — mhchem macro wrapping, regenerate history dedupe, strict safe image allowlist, stale docs 2026-09-08 19:25:31 +02:00
improvements.md docs: merge the duplicate pairs and correct them against the running app 2026-09-12 04:57:35 +02:00
learning-hub.md docs: merge the duplicate pairs and correct them against the running app 2026-09-12 04:57:35 +02:00
migrations.md docs: rewrite architecture, authentication, configuration, deployment, ai-providers, speech, database, learning-hub, migrations, developer-guide for public audience 2026-04-15 00:26:38 +02:00
mobile-build.md ci: route Android APK through Forgejo releases 2026-05-11 04:21:15 +02:00
module-conventions.md docs: merge the duplicate pairs and correct them against the running app 2026-09-12 04:57:35 +02:00
my-resources.md feat: record what a deck wanted and could not have 2026-09-11 22:51:15 +02:00
openid-setup.md feat: ED multi-stage UX, extensions polish, docs viewer + application-logic docs 2026-04-28 03:09:38 +02:00
ops-docs-ped-ai-and-milvus.md docs: Ops Docs page on how Ped-AI and the two Milvus servers work 2026-09-10 18:37:41 +02:00
retrieval-tuning.md docs: My Resources, sign-in codes, invitations, and what the image carries 2026-09-11 20:49:10 +02:00
scaling.md docs: merge the duplicate pairs and correct them against the running app 2026-09-12 04:57:35 +02:00
speech.md docs: merge the duplicate pairs and correct them against the running app 2026-09-12 04:57:35 +02:00