# QA Scribe

QA Scribe is a local-first desktop testing notepad that helps testers capture a bounded testing Session and turn the raw material into structured Testware. The current application is a Rust/Tauri 2 desktop app with a React/Vite renderer, a Rust-owned SQLite store, and optional AI generation through already-authenticated local CLI tools.

## What it does

QA Scribe collects Notes, Findings, Drafts, screenshots, logs, API responses, and context in a local Session Library. The product language comes from `CONTEXT.md`, while the current implementation is described in `README.md` and split across `crates/qa-scribe-core`, `src-tauri`, and `frontend`.

## Main entry points

| Area | Where to start | Purpose |
| --- | --- | --- |
| Desktop app | `src-tauri/src/main.rs` | Opens the app-data directory, SQLite database, Tauri state, and command handler. |
| Rust core | `crates/qa-scribe-core/src/lib.rs` | Exports domain, storage, services, attachments, AI, and generation modules. |
| React renderer | `frontend/src/App.tsx` | Mounts `AppShell` with the controller from `frontend/src/app/useAppController.ts`. |
| Smoke harness | `crates/qa-scribe-app/src/main.rs` | Runs a non-GUI workflow for storage, attachments, generation context, drafts, and findings. |
| Release tooling | `.github/workflows/release.yml` | Builds signed desktop artifacts and Linux package repository assets. |

## Quick links

- [Download the English video overview directly (MP4)](https://raw.githubusercontent.com/wiki/ddv1982/qa-scribe/overview.mp4).
- [Video overview](video-overview.md) has the video download, captions, and source links.
- [Architecture](overview--architecture.md) explains how the renderer, Tauri bridge, core service layer, SQLite, files, and provider CLIs connect.
- [Getting started](overview--getting-started.md) lists install, run, build, and verification commands.
- [Features](features.md) covers Sessions, rich records, managed attachments, AI-assisted Testware, and settings.
- [Rust core](systems--rust-core.md) and [Frontend shell](systems--frontend-shell.md) are the main subsystem pages.