README_EN.md

House Survey Workflow Assistant

English | 中文

Overview

This project streamlines real-estate media operations into one reliable workflow:

• parse listing lines
• generate Photo + VR folder trees
• run dual-lane media import
• append daily Excel records with style continuity

The repository keeps both tracks:

• Electron edition (mainline): modern UI, richer interactions, packaging-ready.
• Python edition (legacy-compatible): keeps old operational scripts available.

Core Features

• Batch folder generation from plain text input.
• Concurrent photo/VR import with live progress and speed.
• Excel template inheritance + row append + style consistency.
• Device identification strategy: volume label first, EXIF as fallback.
• Cinematic interface effects and Star-Wars-style HUD editor.

Repository Layout

.
├── electron-app/            # Electron + React + TypeScript app
├── src/                     # Python implementation
├── assets/icons/            # Icon assets
├── README.md                # Chinese documentation
└── README_EN.md             # English documentation

Quick Start (Electron mainline)

Requirements

• Node.js 20+
• npm 10+
• macOS / Windows

Development

cd electron-app
npm install
npm run dev

Packaging

cd electron-app
npm run build -- --mac
npm run build -- --win

Build outputs are generated in electron-app/dist/, archived artifacts in electron-app/release-artifacts/.

Quick Start (Python legacy)

pip install -r requirements.txt
python main.py

Troubleshooting

• Black screen after packaging: ensure dist is included in bundle and renderer assets use relative paths.
• Icon not applied: verify electron-app/build/icons/app.icns and app.ico exist.
• Excel write failure: close the opened workbook and retry.

Screenshots

Tech Stack

• Electron, React, TypeScript, Vite
• Three.js, Framer Motion, Tailwind CSS
• ExcelJS, openpyxl

---

If this project helps your workflow, a Star is always appreciated.