PLBA2-2. Реализация

This commit is contained in:
2026-10-10 19:36:32 +03:00
parent 473cde126f
commit 71998a6b13
120 changed files with 3675 additions and 21 deletions
+40
View File
@@ -0,0 +1,40 @@
# Application configuration
PLBA2 reads `config.yaml` from the application root. The application supplies a
typed decoder for its own fields; PLBA2 validates the common identity and worker
fields and keeps the application model in the same snapshot.
```yaml
application_id: inventory-service
workers:
inventory_sync:
disabled: false
interval_seconds: 60
cleanup:
pause_seconds: 300
database_url: "..."
```
`application_id` is optional. A non-empty value is used unchanged; otherwise
identity resolution uses `[project].name` from `pyproject.toml`, then a UUIDv4.
The resolved value is passed to `ApplicationRuntime` through `RuntimeContext`
before dependent components start.
Each worker entry may set `disabled` (default `false`) and one schedule:
`interval_seconds` or `pause_seconds`. Enabled workers need exactly one positive
finite schedule. A disabled worker is skipped at application start and does not
need a schedule. Changing `disabled` takes effect on the next application start;
valid schedule updates are used when the next worker cycle is planned.
The application defines every other YAML field and its typed model. This file is
for rarely changed technical parameters. Business parameters, feature toggles,
and technical values that must change remotely while the process is running
belong in the application-owned `settings` table, read through `SettingsReader`.
Load and validate the initial file before starting dependent components. A
missing, malformed, or invalid initial file raises `ApplicationConfigLoadError`
and blocks startup. After startup, `ApplicationConfigManager.watch` checks for
file changes. It swaps in a fully validated snapshot atomically; previously
returned snapshots remain unchanged. If an update is invalid or unreadable,
`reload_if_changed` returns a failure and the manager keeps the last valid
snapshot. The watcher passes that error to the application's callback.