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.

来源