# yadd-sanaauniversitygraduationproject/yadd architecture

> Architecture diagram of the GitHub repository yadd-sanaauniversitygraduationproject/yadd, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yadd-sanaauniversitygraduationproject/yadd
- Repository: https://github.com/yadd-sanaauniversitygraduationproject/yadd

## Overview

YADD is a requirements-and-design project for a proposed digital marketplace; the README explicitly says software implementation has not begun. This graph therefore describes the documented project workflow, not a running application: university requirements and decisions lead through research and analysis into design, readiness review, and derived academic chapters. The README also identifies the intended marketplace scope—professional services and home-produced goods in Sana’a—but detailed feature behavior is not evidenced in the supplied excerpts. Edges show only the README’s stated workflow; no source implementation was available to inspect.

Main entry points: [`docs/03-analysis/08-use-cases.md`](https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/03-analysis/08-use-cases.md) (Use cases and models), [`docs/03-analysis/00-project-baseline.md`](https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/03-analysis/00-project-baseline.md) (Baseline and decisions), [`docs/00-governance/06-readiness-checklist.md`](https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/00-governance/06-readiness-checklist.md) (Readiness audit), [`docs/02-research`](https://github.com/yadd-sanaauniversitygraduationproject/yadd/tree/main/docs/02-research) (Research)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_governance["Governance and planning"]
  node_governance["Project governance<br/>[README.md]"]
  node_baseline["Baseline and decisions"]
end

subgraph group_analysis["Research and analysis"]
  node_research["Research"]
  node_gathering["Data gathering"]
  node_srs["Requirements &#40;SRS&#41;<br/>[05-SRS.md]"]
  node_rules["Business rules"]
  node_models["Use cases and models<br/>[08-use-cases.md]"]
end

subgraph group_design["Design and outputs"]
  node_database["Database design"]
  node_interfaces["Interface design"]
  node_readiness["Readiness audit"]
  node_chapters["Academic chapters"]
end

node_university(("University requirements"))

node_university -->|"informs"| node_baseline
node_baseline -->|"guides"| node_research
node_research -->|"precedes"| node_gathering
node_gathering -->|"informs"| node_srs
node_srs -->|"precedes"| node_rules
node_rules -->|"precedes"| node_models
node_models -->|"informs"| node_database
node_models -->|"informs"| node_interfaces
node_database -->|"precedes"| node_readiness
node_interfaces -->|"precedes"| node_readiness
node_readiness -->|"gates"| node_chapters
node_governance -->|"sets authority"| node_baseline

click node_governance "https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/00-governance/README.md"
click node_baseline "https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/03-analysis/00-project-baseline.md"
click node_research "https://github.com/yadd-sanaauniversitygraduationproject/yadd/tree/main/docs/02-research"
click node_gathering "https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/03-analysis/02-data-gathering.md"
click node_srs "https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/03-analysis/05-SRS.md"
click node_rules "https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/03-analysis/06-business-rules.md"
click node_models "https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/03-analysis/08-use-cases.md"
click node_database "https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/04-design/01-database-design.md"
click node_interfaces "https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/04-design/03-interface-design.md"
click node_readiness "https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/00-governance/06-readiness-checklist.md"
click node_chapters "https://github.com/yadd-sanaauniversitygraduationproject/yadd/tree/main/docs/05-report-drafts"

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_governance,node_baseline toneBlue
class node_research,node_gathering,node_srs,node_rules,node_models toneAmber
class node_database,node_interfaces,node_readiness,node_chapters toneMint
class node_university toneIndigo
```

## Components

### Governance and planning

- [Project governance](https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/00-governance/README.md): `docs/00-governance/README.md`
- [Baseline and decisions](https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/03-analysis/00-project-baseline.md): `docs/03-analysis/00-project-baseline.md`

### Research and analysis

- [Research](https://github.com/yadd-sanaauniversitygraduationproject/yadd/tree/main/docs/02-research): `docs/02-research`
- [Data gathering](https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/03-analysis/02-data-gathering.md): `docs/03-analysis/02-data-gathering.md`
- [Requirements (SRS)](https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/03-analysis/05-SRS.md): `docs/03-analysis/05-SRS.md`
- [Business rules](https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/03-analysis/06-business-rules.md): `docs/03-analysis/06-business-rules.md`
- [Use cases and models](https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/03-analysis/08-use-cases.md): `docs/03-analysis/08-use-cases.md`

### Design and outputs

- [Database design](https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/04-design/01-database-design.md): `docs/04-design/01-database-design.md`
- [Interface design](https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/04-design/03-interface-design.md): `docs/04-design/03-interface-design.md`
- [Readiness audit](https://github.com/yadd-sanaauniversitygraduationproject/yadd/blob/main/docs/00-governance/06-readiness-checklist.md): `docs/00-governance/06-readiness-checklist.md`
- [Academic chapters](https://github.com/yadd-sanaauniversitygraduationproject/yadd/tree/main/docs/05-report-drafts): `docs/05-report-drafts`

### Other components

- **University requirements**

## Connections

- University requirements → Baseline and decisions: informs (evidence: `README.md`)
- Baseline and decisions → Research: guides (evidence: `README.md`)
- Research → Data gathering: precedes (evidence: `README.md`)
- Data gathering → Requirements (SRS): informs (evidence: `README.md`)
- Requirements (SRS) → Business rules: precedes (evidence: `README.md`)
- Business rules → Use cases and models: precedes (evidence: `README.md`)
- Use cases and models → Database design: informs (evidence: `README.md`)
- Use cases and models → Interface design: informs (evidence: `README.md`)
- Database design → Readiness audit: precedes (evidence: `README.md`)
- Interface design → Readiness audit: precedes (evidence: `README.md`)
- Readiness audit → Academic chapters: gates (evidence: `README.md`)
- Project governance → Baseline and decisions: sets authority (evidence: `README.md`)
