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

# Statuses and approval

> Understand generation, review, and global Blueprint approval.

A document has a content status and a review state. The Blueprint also has one global approval state.

## Document content statuses

| Status                           | What it means                                                              | What to do                                                                                                                         |
| -------------------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Generating**                   | The current document is still being created. Its card shows a spinner.     | Wait. You may close the tab and return later.                                                                                      |
| **Ready**                        | The document answers everything it owns. Nothing is waiting on you.        | Open it and read the current version.                                                                                              |
| **Ready — your decision needed** | The document is buildable, but one decision is yours.                      | Open and read the item. Settle it now if the current Blueprint must include the answer; otherwise track the non-blocking decision. |
| **Needs Repair**                 | A required section is missing, contradictory, or not buildable as written. | Correct the context or proposal, then regenerate the document.                                                                     |
| **Blocked**                      | Work on this subject cannot begin until a dependency is resolved.          | Open the blocking item and resolve it before global approval.                                                                      |
| **Pending**                      | The document has not started generating yet.                               | Wait for the active Blueprint run.                                                                                                 |
| **Not Required**                 | Your product does not need content or remediation for this document.       | Open the stub once so its current version becomes **Reviewed**.                                                                    |

While any document is being created, **Project Health** shows **Generating** instead of its normal review badge.

## Not yet reviewed and Reviewed

* **Not yet reviewed** means you have not opened the current version of one of the 10 document cards.
* **Reviewed** means you opened that current document page. It records review only; it is not an approval signature.
* A regenerated, restored, or newly published version can return a document to **Not yet reviewed**.

## Sign Approve Blueprint

There is one approval for the complete current document set. There is no per-document Sign Approve action.

<Steps>
  <Step title="Finish generation">
    Wait until the document spinners stop and **Project Health** no longer shows **Generating**.
  </Step>

  <Step title="Review all 10 current documents">
    Open every current document card until each shows **Reviewed**. This includes opening a **Not Required** stub once.
  </Step>

  <Step title="Clear approval blockers">
    Resolve any **Needs Repair** or **Blocked** item. Regenerate affected documents and review their new versions.
  </Step>

  <Step title="Approve the current set">
    In **Blueprint Documents**, select **Sign Approve Blueprint**. This accepts the current Blueprint as one connected package.
  </Step>
</Steps>

**Project ZIP** remains locked until global approval succeeds. If regeneration, restore, or a new version changes the current set, review it and approve again before exporting another ZIP.

## Project health and before-go-live items

The **Project Health** panel collects blockers, review notes, and work that should be completed before production launch. These are not all equal:

* a **review note** is a visible assumption, decision, risk, or warning that deserves attention; it does not automatically mean a document is broken;
* a **Before go-live** item may be completed during implementation;
* a blocker prevents dependent work;
* a repair means the current document cannot safely join an approved Blueprint.

The Review Notes number counts visible review-note items across the Blueprint. Open the related document to read each item. Global approval accepts the notes visible in the complete current set; it does not silently remove them.

## Reported Problems in App Structure

**Reported Problems** are unresolved consistency findings returned with App Structure, such as a navigation link that references a feature missing from the map. The badge is the total number of findings, even when the panel shows only a shorter preview. These findings are not automatically resolved because the canvas rendered successfully.

Review every finding before global approval. Correct the product decision or source context when necessary, then use an Assistant proposal and regenerate the affected document. A repaired finding no longer appears in the current unresolved list.

<Warning>
  Do not approve a Blueprint with a **Blocked** or **Needs Repair** document. Approval represents your acceptance of the complete current document set.
</Warning>