15 lines
3.3 KiB
Markdown

# Utilities, caches, and data compatibility
Use this topic for basic utilities, precision, files, cache access, or legacy ciphertext. Confirm implementation ownership through the [application entry-point guide](../../apps/admin/src/utils/README.md) first.
| Question | Read first | Follow through |
| ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Precision, objects, files, and basic utilities | [Shared exports](../../packages/utils/package.json), [shared utilities](../../packages/utils/src) | [Application compatibility entry point](../../apps/admin/src/utils/index.ts), [utility API](../../apps/docs/reference/utils.md) |
| Application cache keys, Storage backends, and documentation-example isolation | [Application cache](../../apps/admin/src/utils/cache.ts), [cache backend](../../apps/admin/src/utils/cache-backend.ts), [key prefix](../../apps/admin/src/utils/app/prefix-cache-key.ts) | [Cache-key configuration](../../apps/admin/src/app-config/app-config.ts), [shared JSON storage](../../packages/utils/src/storage.ts), [layout and state](layout.md) |
| Legacy synchronous AES ciphertext | [Compatibility implementation](../../apps/admin/src/utils/legacy-crypto), [legacy import entry point](../../apps/admin/src/utils/c/index.ts) | [Ciphertext regressions](../../__test__/utils-contracts/legacy-crypto.spec.ts) |
| Vue lifecycle, DOM, and element utilities | [Shared composables and utilities](../../packages/composables/src) | [Application hooks and UI](ui.md), [Vue utility regressions](../../__test__/vue) |
Preserve keys, storage types, and serialization formats that callers depend on. Callers supply the Storage implementation to shared storage. Check application persistence and documentation iframe in-memory caches separately. Design historical-data migration before replacing a synchronous AES format or API.
Targeted verification: `pnpm harness verify utils`. Select relevant regressions from [cache tests](../../__test__/cache), [precision tests](../../__test__/precision), or [utility contracts](../../__test__/utils-contracts).