Building Pure Deterministic Energy Planning Engines in TypeScript (Zero-Database Architecture)

Описание и применение

Создание чистых, детерминированных движков расчётов энергетических систем на TypeScript без использования баз данных, с прозрачными предположениями и воспроизводимыми результатами.

Задача

Engineering tools for solar, battery, and EV charger sizing often rely on complex, stateful architectures that introduce databases, user tracking, and non-deterministic behavior, making calculations opaque and hard to audit.

Результат

Deterministic, stateless energy calculation engines that return transparent, provenance‑rich results, enabling accurate sizing of batteries, solar arrays, and EV chargers without hidden assumptions or database dependencies.

Рабочий процесс

• Define strict engine contract: pure function, no side effects, reproducible invariants.
• Create typed input interfaces and a CalculationResult envelope with provenance and warnings.
• Implement core physics (e.g., Peukert’s law) in pure functions with validation.
• Expose results via UI as LaTeX cards and assumptions audit tables.
• Publish an open developer API for external integration.
• Ensure all engines are unit-tested for bit‑for‑bit reproducibility.
• Deploy without any database or user‑tracking infrastructure.

Доказательства

Every calculator engine in our codebase obeys three strict mathematical constraints: Pure Function Signature, Zero Side Effects, Reproducible Invariants.

Источник

Typed input provenance and transparent assumptions are returned in a CalculationResult envelope.

Источник

Implementation of Peukert’s electrochemical law in pure TypeScript demonstrates the engine’s practicality.

Источник