> For the complete documentation index, see [llms.txt](https://docs.live-eo.com/surfacescout/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.live-eo.com/surfacescout/review-cases/case-lifecycle.md).

# Case LifeCycle

### Case definition

The **Case** is the cornerstone of SurfaceScout, acting as a central hub that consolidates insights from various time steps, notes from team members, field photos, and other relevant evidence. This comprehensive aggregation streamlines the process of managing and resolving field infringements efficiently.

<figure><img src="/files/WOx78bjlGWQo9mqnmbVu" alt="" width="563"><figcaption><p>A Case with 24 insights across 3 different time step</p></figcaption></figure>

### Case status & workflow

* **New:** The case has just been created, and no action has been taken yet. Cases are created automatically by the system when a new insight is registered or manually by a user when creating an insight or moving an insight from another case.
* **Pending:** The case is not actively being addressed. This status is set manually.
* **In Progress:** The case is actively being worked on, with a user assigned to it.
* **Escalated:** The case has been referred to an external party, such as authorities or contractors, for further action.
* **Closed:** The case is resolved, and no further action or review is required.
* **Reopened:** A previously closed case has been reopened, either automatically due to the addition of a new insight or manually by a user based on new information.

<figure><img src="/files/0UXfBxclC0rESpveG7qk" alt=""><figcaption><p>Case lifecycle</p></figcaption></figure>

### Workflow logic

For now the workflow logic is quite simple but some actions are not possible:

* Status `New` to `Reopened`
* Status `Pending` to `New` or `Reopened`
* Status `In Progress` to `New` / `Reopened`
* Status `Reopened` to `New`
* Status `Closed` to `New` / `In Progress` / `Pending` / `Escalated`
* Status `Escalated` to `New` / `Reopened`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.live-eo.com/surfacescout/review-cases/case-lifecycle.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.