overview glossary

Glossary

The product vocabulary is defined in CONTEXT.md. Use these terms in code, UI, tests, and docs.

Term	Meaning	Key files
Session	A bounded testing effort for a feature, bug, build, ticket, target, or objective.	crates/qa-scribe-core/src/domain/session.rs, frontend/src/app/sessionActions.ts
Entry	A raw item captured during a Session, such as a Note, Observation, API Response, Log, or possible Finding.	crates/qa-scribe-core/src/domain/entry.rs
Evidence	An Entry or attachment that supports a generated testware item, bug report, finding, or conclusion.	crates/qa-scribe-core/src/domain/finding.rs
Finding	A structured conclusion drawn from Entries, such as a bug, risk, passed check, failed check, question, or follow-up.	crates/qa-scribe-core/src/domain/finding.rs, frontend/src/views/FindingsView.tsx
Testware	Structured QA outputs generated or maintained from a Session.	crates/qa-scribe-core/src/domain/draft.rs, frontend/src/views/TestwareView.tsx
Draft	Editable Testware created from a Session, often with AI assistance and then revised by the user.	crates/qa-scribe-core/src/domain/draft.rs
AI Run	An immutable record of an AI generation request and response metadata.	crates/qa-scribe-core/src/domain/ai_run.rs
Generation Context	The selected subset of Session data sent to a local provider CLI.	crates/qa-scribe-core/src/generation/workflow.rs
Managed attachment	A file imported into app-data storage and referenced by metadata plus a stable attachment ID.	crates/qa-scribe-core/src/attachments/mod.rs
Record	UI umbrella term for a Draft or Finding rendered through shared rich-record components.	frontend/src/views/RichRecordView.tsx, frontend/src/views/RecordCollectionView.tsx

Avoid legacy terms listed in CONTEXT.md, such as Project, Notebook, Artifact, Item, Proof, and AI output. The patterns page explains how this vocabulary shows up in code.