Skip to content

Update OSCAR submodule pointers for: docs: Add OSCAR initialization lifecycle documentation#136

Open
tyronechrisharris wants to merge 2 commits intoBotts-Innovative-Research:mainfrom
tyronechrisharris:jules-sync-23663118122
Open

Update OSCAR submodule pointers for: docs: Add OSCAR initialization lifecycle documentation#136
tyronechrisharris wants to merge 2 commits intoBotts-Innovative-Research:mainfrom
tyronechrisharris:jules-sync-23663118122

Conversation

@tyronechrisharris
Copy link
Copy Markdown
Collaborator

@tyronechrisharris tyronechrisharris commented Mar 27, 2026

This PR adds a comprehensive Markdown document oscar_initialization_lifecycle.md detailing the step-by-step initialization and restart lifecycle of the current working OSCAR hybrid system.

The document specifically answers four main questions to aid in migrating to a fully containerized Docker Compose stack:

  1. Startup Timing and Service Delays: Details the wait-state logic (pg_isready polling) used to delay the backend until PostGIS is fully initialized.
  2. Certificate Authority & TLS Generation: Documents how LocalCAUtility generates the Root CA and leaf certificates on backend startup, stores them in osh-keystore.p12, and exports the public Root CA.
  3. Database Provisioning & Authentication: Explains the .db_password generation via shell script and how scram-sha-256 is enforced in the PostGIS Dockerfile using POSTGRES_INITDB_ARGS.
  4. Setup Wizard & State Persistence: Outlines the specific conditions that flag the system as "Uninitialized" on boot, and how the admin password hash and TOTP secrets are persisted to user_permissions.json using Gson serialization.

PR created automatically by Jules for task 8430774786053900235 started by @tyronechrisharris


🔄 Auto-Distributed via Sync

Original Flat Repo PR: tyronechrisharris/oscar-flat#97

🔗 Related Updates in this Sync:

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