Architecture overview: MinIO, Redis, and 16 persist adapters

PersistCandleAdapter.usePersistCandleAdapter(class implements IPersistCandleInstance {
  constructor(
    readonly symbol: string,
    readonly interval: CandleInterval,
    readonly exchangeName: string,
  ) {}
  async waitForInit(initial: boolean) {
    if (!initial) return;
    await waitForInfra();   // gates first-touch on Redis ready; MinIO connects lazily
  }
  async writeCandlesData(candles: CandleData[]): Promise<void> {
    for (const candle of candles) {
      await ioc.candleDataService.create({
        symbol: this.symbol,
        interval: this.interval,
        open: candle.open,
        high: candle.high,
        low: candle.low,
        close: candle.close,
        timestamp: candle.timestamp,
        volume: candle.volume,
      });
    }
  }
  async readCandlesData(limit: number, sinceTimestamp: number) {
    // walks per-timestamp MinIO GETs using findBySymbolIntervalTimestamp
  }
});

constructor(public readonly BUCKET_NAME: string) {
  const [bucketName, ...folders] = BUCKET_NAME.split("/");
  this.bucketName = bucketName;         // "backtest-kit"
  this.rootPrefix = folders.length
    ? `${folders.join("/")}/`           // "candle-items/"
    : "";
}

const TIMESTAMP_PAD = String(Number.MAX_SAFE_INTEGER).length;

const GET_STORAGE_KEY_FN = (entryId: string, when: Date) => {
  const inverted = String(Number.MAX_SAFE_INTEGER - when.getTime())
    .padStart(TIMESTAMP_PAD, "0");
  return `${inverted}_${entryId}`;
};