greenflame089
29 lines
1018 B
Markdown
29 lines
1018 B
Markdown
# Architecture — Q-Edit
|
|
|
|
## Overview
|
|
|
|
- **UI shell**: `index.html` + `style.css`
|
|
- **App logic**: `script.js` (currently a single-file controller)
|
|
- **New utilities**: `src/utils/format.js` (pure helpers; safe to unit test)
|
|
- **Docs & CI**: under `docs/` and `.gitea/`
|
|
|
|
## Data Flow (current)
|
|
|
|
1. DOM is initialized from `index.html`.
|
|
2. `script.js` wires event listeners, loads data (local or remote), renders lists in `#content-summary` and sidebars (`#file-tree`), and manages pagination/filtering.
|
|
3. User interactions update in-memory state and the DOM.
|
|
|
|
## Near-Term Refactor Plan
|
|
|
|
- Gradually split `script.js` into modules:
|
|
- `src/state/*` for app state
|
|
- `src/services/*` for data I/O
|
|
- `src/ui/*` for rendering
|
|
- `src/utils/*` for helpers (started)
|
|
- Load modules via `<script type="module">` or continue classic scripts by exposing namespaces on `window` (decision TBD via ADR).
|
|
|
|
## Compatibility
|
|
|
|
- App remains deployable as static files.
|
|
- Tests run in Node (jsdom) and do not require a server.
|