Issue Log Workbench

Issue Log Workbench is a local-first, single-user web application for managing issue logs. Import your spreadsheet data, normalise each row into a structured Issue object, and work through your issues with list/dashboard views, a detailed edit form, and flexible export options.

Key Features

Feature	Description
Import	Load CSV or XLSX files; auto-detect or manually map columns to Issue fields
List view	Sortable, filterable table with badge indicators for notes, attachments, and actions
Detail form	Edit all fields, add Markdown notes, manage links, decisions, next actions, and file attachments
Dashboard	Summary statistics by status, category, and type; recently updated issues feed
Export	Download as CSV, XLSX, or Markdown report
Lifecycle	Enforce valid status transitions: Imported → Triaged → In Review → Resolved → Closed

Quick Navigation

• Quick Start — get the app running in under 5 minutes
• Importing Data — how to import a spreadsheet
• Exporting Data — export formats and options
• Launching as a macOS App — wrap the local server in an Automator app
• Design — architecture and design decisions
• API Reference — REST API endpoint reference

Design Philosophy

• Local-first: all data lives in a SQLite database on your own machine; no cloud account needed
• Single-user: designed for one analyst working through a batch of issues
• Minimal dependencies: runs with a simple pip install and a single CLI command
• Hackable: clean layered architecture (Domain → Services → API → Web) makes it easy to extend

Documentation Layout

This repository uses the following MkDocs layout:

• site/ contains the Markdown source content
• docs/ contains the generated static site for GitHub Pages

Run mkdocs build --clean whenever you want to refresh the published output.