> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wittify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Project Overview

> KPIs and recent activity for this project.

<Note>
  **Project Overview** is the per-project home page that loads after you pick a project from the [Welcome](/en/Systems/Chat-with-Documents/Welcome) picker, the project switcher in the sidebar, or any deep link of the shape `/{lang}/chat-with-docs/{projectId}/overview`.
</Note>

## Page anatomy

| Region               | What you see                                                                                                                                                              |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Topbar breadcrumb    | **Chat with Your Documents / `{project name}` / Overview**. The project name is clickable and opens [Project Settings](/en/Systems/Chat-with-Documents/Project-Settings). |
| Project header       | Project name, an optional description below it, and a small role chip on the end edge.                                                                                    |
| Quick stats grid     | Four small cards summarising what is in the project.                                                                                                                      |
| Recent activity card | Latest chats grouped by time bucket.                                                                                                                                      |
| Coming-soon strip    | A friendly hint shown while the project ramps up.                                                                                                                         |

## Project header

| Element      | What it shows                                                                                     |
| ------------ | ------------------------------------------------------------------------------------------------- |
| Project name | The display name. Clickable, routes to Project Settings.                                          |
| Description  | The optional one-line summary you set when the project was created. Hidden if empty.              |
| Role chip    | One of **Owner**, **Admin**, **Analyst**, **Viewer**. Tells you at a glance what you can do here. |

## Quick stats grid

Four cards, each shows a count plus a link to the matching list page.

| Card                | What it shows                              | Click                                                                         |
| ------------------- | ------------------------------------------ | ----------------------------------------------------------------------------- |
| **Knowledge bases** | Count of KBs in this project.              | Routes to [Knowledge Bases](/en/Systems/Chat-with-Documents/Knowledge-Bases). |
| **Documents**       | Count of documents across all KBs.         | Routes to [Documents](/en/Systems/Chat-with-Documents/Documents).             |
| **SQL sources**     | Count of connected read-only databases.    | Routes to [SQL Sources](/en/Systems/Chat-with-Documents/SQL-Sources).         |
| **Recent chats**    | Count of chats started in the last 7 days. | Routes to [Chats](/en/Systems/Chat-with-Documents/Chats).                     |

When a stat is zero, the card stays in place but reads **0** with a small *Get started* link to the matching create flow.

## Recent activity card

A list of the most recent chats in this project, grouped by time bucket.

| Group           | Behaviour                                                        |
| --------------- | ---------------------------------------------------------------- |
| **Today**       | Chats started today.                                             |
| **Yesterday**   | Chats started yesterday.                                         |
| **Last 7 days** | Chats started in the last week, excluding the two buckets above. |
| **Older**       | Anything older than 7 days.                                      |

Each row shows the chat title (the first question you asked), a small relative timestamp, and the chat-canvas icon. Click any row to open the chat in [Chat Canvas](/en/Systems/Chat-with-Documents/Chat-Canvas).

When the project has no chats yet, the card collapses to a one-line empty state with a **Start a chat** link.

## Coming-soon strip

While the project is still being set up, a small strip surfaces a friendly hint:

*This view lights up once you create knowledge bases and start conversations.*

The strip disappears once you have at least one KB and one chat.

## Roles and capabilities

The UI hides controls you do not have permission for. The backend re-checks every action server-side, so even if a control somehow leaked into the UI, the server would reject the request.

| Role        | Read | Write         | Share | Delete project |
| ----------- | ---- | ------------- | ----- | -------------- |
| **Owner**   | Yes  | Yes           | Yes   | Yes            |
| **Admin**   | Yes  | Yes           | Yes   | No             |
| **Analyst** | Yes  | Yes (limited) | No    | No             |
| **Viewer**  | Yes  | No            | No    | No             |

## Common questions

<AccordionGroup>
  <Accordion title="The quick stats cards are all zero. Did I land on the wrong project?">
    Possibly. Check the project name in the topbar breadcrumb. If it matches what you expected, the project genuinely has no content yet, click into a card to start adding knowledge bases or chats.
  </Accordion>

  <Accordion title="The Recent activity card is empty.">
    You have not started any chats in this project yet. Click **Chats** in the sidebar (or the **Recent chats** card here) and start one.
  </Accordion>

  <Accordion title="My role chip says Viewer, can I still browse the data?">
    Yes. Viewers can read everything that has already been added: documents, transcripts, chats. They cannot upload new documents, run new chats that write data, or change settings.
  </Accordion>

  <Accordion title="Where can I see usage and quotas?">
    Open Project Settings (click the project name in the breadcrumb). The **Usage** card surfaces storage, monthly LLM spend, and any quota usage.
  </Accordion>

  <Accordion title="The Overview page looks empty even after I created a KB and uploaded documents.">
    Document counts can take a moment to refresh while the engine processes uploads. Reload the page or wait a few seconds. The Knowledge Bases page itself shows a per-document **Status** chip with the live state.
  </Accordion>

  <Accordion title="Can I rename the project from here?">
    No. Click the project name in the breadcrumb to open Project Settings, where the **Rename** field lives.
  </Accordion>

  <Accordion title="Why is there no per-project dashboard like CCQA's Overview?">
    This product is a knowledge tool, not an analytics product. The interesting numbers (LLM spend, retrieval latency) land in Project Settings as they ship. We do not stack a second dashboard on top.
  </Accordion>

  <Accordion title="What does the project switcher in the sidebar do exactly?">
    It lets you flip between projects without leaving the current page. So if you are on Project A's Overview and switch to Project B, you land on Project B's Overview. If you are on Project A's Knowledge Bases tab and switch to Project B, you land on Project B's Knowledge Bases tab.
  </Accordion>
</AccordionGroup>

## Where to go next

<CardGroup cols={2}>
  <Card title="Knowledge Bases" icon="folder-tree" href="/en/Systems/Chat-with-Documents/Knowledge-Bases">Create a KB, upload documents, build the corpus.</Card>
  <Card title="SQL Sources" icon="database" href="/en/Systems/Chat-with-Documents/SQL-Sources">Connect a read-only database.</Card>
  <Card title="Chats" icon="comments" href="/en/Systems/Chat-with-Documents/Chats">Start a conversation grounded in your sources.</Card>
  <Card title="Project Settings" icon="gear" href="/en/Systems/Chat-with-Documents/Project-Settings">Rename, configure retrieval, manage usage, danger zone.</Card>
</CardGroup>