# User Guide

```{warning}
This chapter is not written yet. No user-facing material exists in either
repository, and no screenshots have been captured.
```

The application surface is known from the frontend, so the outline below
reflects what a user actually sees. Every section needs screenshots taken from a
running deployment.

## Planned Structure

1. **Signing in.** Login with Energy Logserver credentials, what happens when an
   account lacks product access, session behaviour.
2. **The workspace shell.** Sidebar navigation, resizable panels, light and dark
   theme toggle.
3. **Workspaces.** Creating one, renaming, archiving, deleting, and what each
   role may do.
4. **Members.** Adding people by username, changing roles, removing members, and
   the rules that protect owners.
5. **Documents.** Uploading through the knowledge modal, watching processing
   states, listing, previewing, enabling and disabling a source, deleting.
6. **Asking questions.** Starting a conversation, streaming answers, follow-up
   questions and how scope carries between them.
7. **Reading an answer.** Citations, the sources panel, the artifacts and tools
   canvas, and how to verify a claim against its passage.
8. **Searching sources.** Name, title, metadata, text, semantic and smart hybrid
   search, and when to use which.
9. **Prompt library.** Saving and reusing prompts.
10. **Conversation history.** Reloading past conversations and what is retained.
11. **Settings and integrations.**

## What Is Needed To Write It

- Access to a running deployment with representative documents.
- Screenshots for each surface, in a single theme chosen for consistency.
- A decision on whether the guide covers all four workspace roles in one pass or
  splits administrator tasks into their own section.