File Structure - Battery Simulation Tool

Version: 0.2.0
Date: 2026-03-08
Status: Active planning

1. Proposed Structure

site/
  battery-simulation-tool/
    index.html
    css/
      battery-simulation-tool.css
    js/
      main.js
      csv-parser.js
      simulation-engine.js
      chart-adapter.js
      export-utils.js
      ui.js
      vendor/
        plotly.min.js
    docs/
      README.md
      PROJECT_BRIEF.md
      URS.md
      FS.md
      DS.md
      FILE_STRUCTURE.md
      PAGE_SPEC.md
      SIMULATION_SPEC.md
      RISK_ASSESSMENT.md
      TEST_PLAN.md

2. Separation Rules

• parser logic should remain separate from simulation logic
• simulation logic should remain separate from chart code
• result export should remain separate from UI rendering
• docs stay project-local in the docs/ subfolder

3. Dependency Direction

• main.js coordinates startup
• ui.js interacts with DOM state
• csv-parser.js prepares normalized input and supports visible manual mapping
• simulation-engine.js calculates interval behavior
• chart-adapter.js prepares Plotly traces and layouts
• export-utils.js serializes outputs for download