Skip to content

docs: Add OSCAR initialization lifecycle documentation#14

Open
tyronechrisharris wants to merge 39 commits intoearocorn:masterfrom
tyronechrisharris:jules-sync-23663118122
Open

docs: Add OSCAR initialization lifecycle documentation#14
tyronechrisharris wants to merge 39 commits intoearocorn:masterfrom
tyronechrisharris:jules-sync-23663118122

Conversation

@tyronechrisharris
Copy link
Copy Markdown

@tyronechrisharris tyronechrisharris commented Mar 27, 2026 •
edited
Loading

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:

alexrobin and others added 30 commits September 17, 2025 20:15
@alexrobin
[SML] Add support for assetType as defined in CS API standard
c98cfbb
@alexrobin
[Core] Mark lastError as volatile so it is immediately visible when
648c68a 
written from a different thread
@alexrobin
[CSAPI] Add client-side support for bearer token
63b1d39
@alexrobin
[Core] Log missing jar manifest at trace level
2c8eaa5
@earocorn
[UI] Add multi-select in Admin UI (opensensorhub#311)
231b45f
@earocorn
[DB] Update obs database test to use correct system UID (opensensorhu…
4a7ff51 
…b#314)

* Update obs database test to use correct system uid

* Swap outputName and description
@alexrobin
[UI] Keep showing module name in confirmation popup when only one module
1731041 
is selected
@alexrobin
[Core] Start/stop HTTP service modules using internal methods
277880c 
doStart()/doStop() but also set state in handleEvent. Reverts previous
change. Fixes opensensorhub#308
@alexrobin
[SML] Fix time range in conversion from generic feature to SML object
db4c75d
@alexrobin
[CSAPI] Extract method for reading JSON collection responses
e10e660
@alexrobin
[Core] Refactor ICommandResult and CommandResult to align better with CS
43826d6 
API requirements
@alexrobin
[SWE] Add support for collections of simple types in DataBlockProxy
c2c75ec
@alexrobin
[CSAPI] Implement new serialization for command results
6ff4508
@alexrobin
[CS API] Fixes in command status serialization + better error handling
6eff1c6
@nickgaray
Updates for logging under Java 21 (opensensorhub#317)
675a779 
* Updates for logging under Java 21

* Update logback-classic to address CVE

* Fix gradle recipe for building OSGi Bundles on Windows properly
@alexrobin
[Core] Don't use immutable lists as they cannot be deserialized from H2
195b300 
DB using the generic collection serializer provided with Kryo
@alexrobin
[Core] Keep processing commands if submit future completes exceptionally
43727e7
@alexrobin
[Core] Re-enable module loggers broken after upgrade to logback 1.5
0c56710
@tipatterson-dev
[CSAPI] Update JSON property names for control streams and commands (o…
5f59b5b 
…pensensorhub#318). Closes opensensorhub#272
@alexrobin
[CSAPI] Fix to deserialize command parameters + set timestamp
1729671
@alexrobin
[Core] Fix concurrency issues when reading from DataBlocks with internal
a8bfdb7 
block indexing
@eferre
[Core] Add method to complete command with result and message (opense…
7bdec8d 
…nsorhub#322)
@earocorn
[HttpServer] Use HandlerCollection instead of HandlerList for dynamic…
e55721c 
… handler registration (opensensorhub#320)
@earocorn
[DB] Add "query by definition" datastore tests (opensensorhub#316)
0830d34
@mdhsl
[DB] Add forceReadBackFromStorage and commits in obs store unit tests… (
e00a96c 
opensensorhub#319)
@alexrobin
[CSAPI] Client: URL encode IDs + added obs fetch tests (WIP)
758b8c2
@alexrobin
[H2] Fix to cleanly close feature database
850ade0
@earocorn
[CSAPI] Add system query parameter to DataStreams and ControlStreams …
fa0eeea 
…collection endpoints (opensensorhub#324)
@earocorn
Implement countMatchingEntries() in FederatedObsStore
9650356
@earocorn
remove atomic long reference
0c5f9e6
This was referenced Mar 27, 2026
Open
Open
Open
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

7 participants

@tyronechrisharris @alexrobin @earocorn @nickgaray @tipatterson-dev @eferre @mdhsl