# jiangzmj/mascomm-fd-conceptualdesign architecture

> Architecture diagram of the GitHub repository jiangzmj/mascomm-fd-conceptualdesign, 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/jiangzmj/mascomm-fd-conceptualdesign
- Repository: https://github.com/jiangzmj/mascomm-fd-conceptualdesign

## Overview

This is a released research-data package, not an executable multi-agent system. Its user workflow is to examine the 50 benchmark products and compare the released mechanism results across structural validity, diversity, coordination cost, and flow-heterogeneity subgroups. The README documents the three evaluated mechanisms and five-repeat scope, but no generation or analysis code is included, so the graph shows only documented dataset relationships.

Main entry points: [`data/product_list_50.xlsx`](https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/data/product_list_50.xlsx) (Product cases), [`results/structural_validity_by_flow_heterogeneity_summary.csv`](https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/results/structural_validity_by_flow_heterogeneity_summary.csv) (Subgroup validity), [`results/structural_validity_summary.csv`](https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/results/structural_validity_summary.csv) (Validity summary), [`results/structural_diversity_summary.csv`](https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/results/structural_diversity_summary.csv) (Structural diversity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Benchmark input"]
  node_products[("Product cases")]
end

subgraph group_validity["Validity results"]
  node_validity_summary[("Validity summary")]
  node_heterogeneity_validity[("Subgroup validity")]
end

subgraph group_other_results["Other results"]
  node_diversity[("Structural diversity")]
  node_coordination[("Coordination cost")]
  node_heterogeneity_labels[("Heterogeneity labels")]
end

node_researcher(("Researcher"))

node_researcher -->|"reviews cases"| node_products
node_researcher -->|"compares validity"| node_validity_summary
node_researcher -->|"examines subgroups"| node_heterogeneity_validity
node_researcher -->|"compares diversity"| node_diversity
node_researcher -->|"compares cost"| node_coordination
node_products -->|"benchmarks cases"| node_validity_summary
node_products -->|"benchmarks cases"| node_heterogeneity_validity
node_products -->|"benchmarks cases"| node_diversity
node_products -->|"benchmarks cases"| node_coordination
node_heterogeneity_labels -->|"groups cases"| node_heterogeneity_validity

click node_products "https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/data/product_list_50.xlsx"
click node_validity_summary "https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/results/structural_validity_summary.csv"
click node_heterogeneity_validity "https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/results/structural_validity_by_flow_heterogeneity_summary.csv"
click node_diversity "https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/results/structural_diversity_summary.csv"
click node_coordination "https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/results/coordination_cost_summary.csv"
click node_heterogeneity_labels "https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/results/flow_heterogeneity_labels.xlsx"

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_products toneBlue
class node_validity_summary,node_heterogeneity_validity toneAmber
class node_diversity,node_coordination,node_heterogeneity_labels toneMint
class node_researcher toneIndigo
```

## Components

### Benchmark input

- [Product cases](https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/data/product_list_50.xlsx): `data/product_list_50.xlsx`

### Validity results

- [Validity summary](https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/results/structural_validity_summary.csv): `results/structural_validity_summary.csv`
- [Subgroup validity](https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/results/structural_validity_by_flow_heterogeneity_summary.csv): `results/structural_validity_by_flow_heterogeneity_summary.csv`

### Other results

- [Structural diversity](https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/results/structural_diversity_summary.csv): `results/structural_diversity_summary.csv`
- [Coordination cost](https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/results/coordination_cost_summary.csv): `results/coordination_cost_summary.csv`
- [Heterogeneity labels](https://github.com/jiangzmj/mascomm-fd-conceptualdesign/blob/main/results/flow_heterogeneity_labels.xlsx): `results/flow_heterogeneity_labels.xlsx`

### Other components

- **Researcher**

## Connections

- Researcher → Product cases: reviews cases (evidence: `README.md`)
- Researcher → Validity summary: compares validity (evidence: `README.md`)
- Researcher → Subgroup validity: examines subgroups (evidence: `README.md`)
- Researcher → Structural diversity: compares diversity (evidence: `README.md`)
- Researcher → Coordination cost: compares cost (evidence: `README.md`)
- Product cases → Validity summary: benchmarks cases (evidence: `README.md`)
- Product cases → Subgroup validity: benchmarks cases (evidence: `README.md`)
- Product cases → Structural diversity: benchmarks cases (evidence: `README.md`)
- Product cases → Coordination cost: benchmarks cases (evidence: `README.md`)
- Heterogeneity labels → Subgroup validity: groups cases (evidence: `README.md`)
