Skip to content

docs: Add OSCAR initialization lifecycle documentation#189

Open
tyronechrisharris wants to merge 112 commits intoopensensorhub:masterfrom
tyronechrisharris:jules-sync-23663118122
Open

docs: Add OSCAR initialization lifecycle documentation#189
tyronechrisharris wants to merge 112 commits intoopensensorhub:masterfrom
tyronechrisharris:jules-sync-23663118122

Conversation

@tyronechrisharris
Copy link
Copy Markdown

@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:

mdhsl and others added 30 commits September 24, 2025 18:14
…range indexed column; fix system serialization/deserialization
…range indexed column; fix system serialization/deserialization
…zation

Update command status serialization for osh-core changes and add inli…
…ATURE and command; fix blocking connection while executing a DROP request; improve the use of batch
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.

5 participants