# Electrical Circuit & Panel Mapper

Interactive, full-stack electrical circuit and panel mapping application for tracing branch circuits, documenting load centers, and mapping electrical devices (lighting fixtures, wall receptacles, switches, and dedicated appliances) across architectural floorplans.

Repository: [https://git.theta42.com/wmantly/electrical-chart](https://git.theta42.com/wmantly/electrical-chart)

---

## ⚡ Overview & Features

- **Interactive Architectural Schematic:**
  - Renders all 141 electrical devices (48 lights, 49 receptacles, 44 switches) and room structures derived from `diagram.drawio`.
  - Supports dual orientation modes: **Field Doc Landscape** (matching physical handheld floorplan printout) and **Draw.io Native**.
  - Smooth pan and zoom navigation (mouse wheel + click-and-drag).
- **Physical Panel Scheduling:**
  - **GE PowerMark Gold Load Center (Subpanel):** 12 slots with 1/2-inch THQP slim tandem breakers (`6A`, `6B`, `7A`, `7B`, `8A`, `8B`, `9A`, `9B`, `11A`, `11B`, 2-pole 240V heaters).
  - **Main Service Panel (Square D QO):** Main disconnect, subpanel feeder, 240V range/HVAC/dryer, utility branch circuits.
- **Painter Mode (Rapid Tagging):**
  - Click any breaker card in the sidebar to activate Painter Mode.
  - Click any device on the floor plan to instantly assign it to that breaker with zero dialogs.
  - Right-click any device to unassign it.
- **Room Bulk Actions & Lasso Selection:**
  - Assign entire rooms of receptacles or lighting in a single click via the Device Inspector.
- **Visual Circuit Tracing:**
  - Color-coded badges per circuit (`6A`, `7B`, `7A`, etc.).
  - Dashed circuit run lines dynamically link all devices sharing the same breaker.
  - Unmapped warning halos highlight every unverified fixture that still needs testing.
- **Exports:**
  - Export back to updated **Draw.io XML** with embedded circuit tags.
  - Export **Panel Schedule CSV** for printing panel door labels.
  - Export full **JSON state dump**.

---

## 🚀 Quickstart

### Prerequisites
- Node.js v18+ (tested on Node v22)
- npm

### Installation & Run

```bash
git clone ssh://gitea@git.theta42.com:2222/wmantly/electrical-chart.git
cd electrical-chart
npm install
npm start
```

Open [http://localhost:3456](http://localhost:3456) in your browser.

To run on a different port:
```bash
PORT=3000 npm start
```

---

## 📁 Project Architecture

```
electrical-chart/
├── app.js                 # Express application setup & middleware
├── bin/
│   └── www                # HTTP server launcher
├── conf/
│   └── base.js            # Configuration (port, database paths)
├── data/
│   └── electrical_chart.sqlite # SQLite database (auto-created on startup)
├── diagram.drawio         # Master Draw.io architectural source
├── lib/
│   └── seed.js            # Initial database seeder & circuit pre-mappings
├── models/
│   └── db.js              # better-sqlite3 connection & schema migrations
├── public/
│   ├── css/
│   │   └── style.css      # Dark blueprint theme & responsive styling
│   └── js/
│       └── app.js         # Interactive SVG rendering, pan/zoom, painter mode
├── routes/
│   ├── api.js             # REST API (/api/state, /api/devices/assign, exports)
│   └── render.js          # Main page render route
└── views/
    └── index.ejs          # EJS single-page layout
```