# 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](how-to-contribute--patterns-and-conventions.md) explains how this vocabulary shows up in code.