# zonayed-dev/fabric-defect-annotation-project--fda- architecture

> Architecture diagram of the GitHub repository zonayed-dev/fabric-defect-annotation-project--fda-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zonayed-dev/fabric-defect-annotation-project--fda-
- Repository: https://github.com/zonayed-dev/fabric-defect-annotation-project--fda-

## Overview

This repository documents a manual textile-defect annotation QA project. A reviewer checks dataset annotations against source images using written criteria, records a status and confidence for each decision, and the notebook analyzes the resulting CSV into findings and a report. The source images are external and are not redistributed. Relationships are based on the README; no source excerpts were provided.

Main entry points: [`notebook/Fabric_Defect_Annotation_QA.ipynb`](https://github.com/zonayed-dev/fabric-defect-annotation-project--fda-/blob/main/notebook/Fabric_Defect_Annotation_QA.ipynb) (QA analysis), [`data/annotations_evaluated_public.csv`](https://github.com/zonayed-dev/fabric-defect-annotation-project--fda-/blob/main/data/annotations_evaluated_public.csv) (Reviewed annotations), [`guidelines/annotation_guidelines.md`](https://github.com/zonayed-dev/fabric-defect-annotation-project--fda-/blob/main/guidelines/annotation_guidelines.md) (Review criteria), [`report`](https://github.com/zonayed-dev/fabric-defect-annotation-project--fda-/tree/main/report) (QA visualizations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_review["Manual QA"]
  node_guidelines["Review criteria"]
  node_results[("Reviewed annotations")]
end

subgraph group_analysis["Data Analysis"]
  node_notebook["QA analysis"]
end

subgraph group_findings["QA Findings"]
  node_visuals["QA visualizations"]
  node_report["QA report"]
end

node_reviewer(("QA reviewer"))
node_dataset[("Fabric Defects")]

node_reviewer -->|"inspects images"| node_dataset
node_reviewer -->|"applies criteria"| node_guidelines
node_reviewer -->|"records decisions"| node_results
node_notebook -->|"validates and analyzes"| node_results
node_notebook -->|"generates charts"| node_visuals
node_notebook -->|"compiles findings"| node_report

click node_guidelines "https://github.com/zonayed-dev/fabric-defect-annotation-project--fda-/blob/main/guidelines/annotation_guidelines.md"
click node_results "https://github.com/zonayed-dev/fabric-defect-annotation-project--fda-/blob/main/data/annotations_evaluated_public.csv"
click node_notebook "https://github.com/zonayed-dev/fabric-defect-annotation-project--fda-/blob/main/notebook/Fabric_Defect_Annotation_QA.ipynb"
click node_visuals "https://github.com/zonayed-dev/fabric-defect-annotation-project--fda-/tree/main/report"
click node_report "https://github.com/zonayed-dev/fabric-defect-annotation-project--fda-/blob/main/report/fabric_defect_qa_report.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_guidelines,node_results,node_reviewer toneBlue
class node_notebook,node_dataset toneAmber
class node_visuals,node_report toneMint
```

## Components

### Manual QA

- [Review criteria](https://github.com/zonayed-dev/fabric-defect-annotation-project--fda-/blob/main/guidelines/annotation_guidelines.md): `guidelines/annotation_guidelines.md`
- [Reviewed annotations](https://github.com/zonayed-dev/fabric-defect-annotation-project--fda-/blob/main/data/annotations_evaluated_public.csv): `data/annotations_evaluated_public.csv`

### Data Analysis

- [QA analysis](https://github.com/zonayed-dev/fabric-defect-annotation-project--fda-/blob/main/notebook/Fabric_Defect_Annotation_QA.ipynb): `notebook/Fabric_Defect_Annotation_QA.ipynb`

### QA Findings

- [QA visualizations](https://github.com/zonayed-dev/fabric-defect-annotation-project--fda-/tree/main/report): `report`
- [QA report](https://github.com/zonayed-dev/fabric-defect-annotation-project--fda-/blob/main/report/fabric_defect_qa_report.md): `report/fabric_defect_qa_report.md`

### Other components

- **QA reviewer**
- **Fabric Defects**

## Connections

- QA reviewer → Fabric Defects: inspects images (evidence: `README.md`)
- QA reviewer → Review criteria: applies criteria (evidence: `README.md`)
- QA reviewer → Reviewed annotations: records decisions (evidence: `README.md`)
- QA analysis → Reviewed annotations: validates and analyzes (evidence: `README.md`)
- QA analysis → QA visualizations: generates charts (evidence: `README.md`)
- QA analysis → QA report: compiles findings (evidence: `README.md`)
