docs(demonstration): refine dependency diagram and tighten Inge persona description

- replace the simple Mermaid dependency chain with a structured pipeline diagram
- distinguish source inputs, support inputs, scripts, generated artifacts, and final output
- clarify Inge de Boer's styling, accessories, and clothing constraints
- make the persona description more specific and consistent

Author: pedropaulofb

resources/demonstration/README.md

@@ -385,28 +385,91 @@ Typical outputs:
 ## Dependency chain
 
 ```mermaid
-flowchart TD
-    A[prefix.csv]
-    B[input-standard.csv]
-    C[input-model.csv]
-    D[input-horizontal.csv]
-
-    E[create_instances.py]
-    F[instances.ttl]
-    G[infer_rules.py]
-    H[instances_extended.ttl]
-    I[run_query.py + query.rq]
-    J[query-output.csv]
-
-    A --> E
-    B --> E
-    C --> E
-    D --> E
-    E --> F
-    F --> G
-    G --> H
-    H --> I
-    I --> J
+flowchart LR
+  %% =========================
+  %% Source inputs
+  %% =========================
+  subgraph SRC["Source inputs"]
+    P["prefix.csv<br/>Prefix registry"]
+    IS["input-standard.csv<br/>Standard vertical mappings"]
+    IM["input-model.csv<br/>Model vertical mappings"]
+    IH["input-horizontal.csv<br/>Asserted horizontal alignments"]
+    Q["query.rq<br/>SPARQL SELECT query"]
+  end
+
+  %% =========================
+  %% Support inputs
+  %% =========================
+  subgraph SUP["Support inputs"]
+    DS["demo-schema.ttl<br/>Demo schema"]
+    HO["health-ri-ontology.ttl<br/>Reference ontology and hierarchy"]
+  end
+
+  %% =========================
+  %% Scripts
+  %% =========================
+  subgraph S["Scripts"]
+    CI["create_instances.py<br/>Build asserted instance graph"]
+    IR["infer_rules.py<br/>Materialize inferred knowledge"]
+    RQ["run_query.py<br/>Run query and export CSV"]
+  end
+
+  %% =========================
+  %% Generated artifacts
+  %% =========================
+  subgraph GEN["Generated artifacts"]
+    I["instances.ttl<br/>Asserted graph<br/>Intermediate artifact"]
+    IE["instances_extended.ttl<br/>Enriched graph<br/>Intermediate artifact"]
+  end
+
+  %% =========================
+  %% Final output
+  %% =========================
+  subgraph OUT["Final output"]
+    O["query-output.csv<br/>Exported query results"]
+  end
+
+  %% Flow into create_instances.py
+  P -->|expand CURIEs| CI
+  IS -->|provide standard concepts and mappings| CI
+  IM -->|provide model concepts and mappings| CI
+  IH -->|provide asserted alignments| CI
+
+  %% create_instances output
+  CI -->|generate asserted RDF graph| I
+
+  %% Flow into infer_rules.py
+  I -->|use asserted graph as input| IR
+  HO -->|use ontology hierarchy for reasoning| IR
+
+  %% infer_rules output
+  IR -->|generate enriched RDF graph| IE
+
+  %% Flow into run_query.py
+  DS -->|load schema graph| RQ
+  HO -->|load ontology graph| RQ
+  IE -->|load enriched instance graph| RQ
+  Q -->|provide SELECT query| RQ
+
+  %% Final export
+  RQ -->|export CSV results| O
+
+  %% Optional visual emphasis on pipeline
+  CI -.->|next step input| I
+  IR -.->|next step input| IE
+
+  %% Styling
+  classDef source fill:#EAF3FF,stroke:#1E5AA8,stroke-width:1.5,color:#0B2E59;
+  classDef support fill:#E8F8F0,stroke:#1B7F5A,stroke-width:1.5,color:#0F5132;
+  classDef script fill:#FFF4E5,stroke:#D97706,stroke-width:2,color:#7C2D12;
+  classDef intermediate fill:#F3E8FF,stroke:#7E57C2,stroke-width:2,color:#4A2A84;
+  classDef final fill:#E8F5E9,stroke:#2E7D32,stroke-width:2.5,color:#1B5E20;
+
+  class P,IS,IM,IH,Q source;
+  class DS,HO support;
+  class CI,IR,RQ script;
+  class I,IE intermediate;
+  class O final;
 ```
 
 ## Short summary

resources/demonstration/definitions/personas/descriptions - physical.md

@@ -112,28 +112,28 @@ Do not add a tie or glasses. Do not make him appear heavily wrinkled, significan
 
 ### Person description
 
-A realistic adult woman in her early-to-mid 40s, with a friendly, grounded, approachable presence that feels natural and unpretentious. She looks like a practical, capable professional rather than a polished executive.
+A realistic adult woman in her early-to-mid 40s, with a friendly, grounded, approachable presence that feels natural and unpretentious. She looks like a practical, capable professional rather than a highly polished executive.
 
 ### Physical appearance
 
 She has light fair skin with a soft pink-to-neutral undertone and a healthy, natural complexion with slight real-life texture, giving her a believable, approachable appearance. Her face is moderately long and softly narrow, with a gently high forehead, leaner cheeks, a softly defined jawline, and a rounded chin. Her features are open, natural, and expressive rather than delicate, glamorous, symmetrical, or refined.
 
 Her eyes are clear medium blue, lively but calm, with a warm, attentive expression that suggests friendliness and patience. They are medium-sized, slightly rounded, and set in a way that feels direct and approachable. Her eyebrows are light-to-medium blonde or dark blonde, natural in shape, softly defined, and not heavily styled or sharply sculpted. Her nose is medium in size, fairly straight, and gently narrow, with a natural, unforced structure that suits the face without looking dramatic or refined. Her lips are medium in fullness, with a softer outline and a naturally warm expression that can shift into a broader, genuine smile.
 
-Her hair is dark blonde to light blonde, naturally straight to slightly loose-textured, usually worn pulled back in a practical low ponytail or loosely gathered style for work. A few soft strands may frame the face, and the overall look is tidy but relaxed, reflecting someone focused on work rather than appearance. It is not sleek, sharply cut, or salon-polished. No glamorous styling, no fashion-forward finish, and no overly deliberate hair design.
+Her hair is dark blonde to light blonde, naturally straight to slightly loose-textured, usually worn pulled back in a practical low ponytail or loosely gathered style for work. A few soft strands may frame the face, and the overall look is tidy and professional, reflecting someone focused on work rather than appearance. It is not sharply cut, fashion-forward, or overly deliberate in its styling.
 
-She may wear very minimal jewelry, such as a fine necklace, tiny studs, or no visible jewelry at all. Glasses are optional, but should be subtle and understated if present. No glamorous styling, no visible tattoos, and no statement accessories.
+She may wear very minimal jewelry, such as a fine necklace and tiny studs. Glasses are optional, but should be subtle and understated if present. No glamorous styling, no visible tattoos, and no statement accessories.
 
 Her makeup is minimal to nearly absent: perhaps light concealer, a natural lip tone, and very subtle definition around the eyes, but overall natural and realistic.
 
 ### Clothing and style
 
 She is dressed in understated modern professional attire:
 
-- muted gray, charcoal, soft navy, or subdued olive outer layer
-- light gray, dusty blue, soft teal, or off-white blouse, knit top, or simple layered shirt
+- muted gray blazer
+- dusty blue blouse, knit top, or simple layered shirt
 - practical, believable, office-appropriate or academic-professional styling
-- minimal accessories, possibly a thin necklace, simple watch, or nothing visible
+- minimal accessories, including a thin necklace
 
 Her overall style reads as warm, reliable, thoughtful, and approachable: someone who works carefully with documentation, coordination, stewardship, or governance, and whose appearance reflects trustworthiness and clarity rather than executive polish.
 
@@ -148,9 +148,9 @@ Preserve these features carefully:
 - medium, fairly straight nose with natural proportions
 - medium lips with a genuine, warm smile
 - dark blonde to light blonde hair, usually pulled back in a low practical style
-- minimal makeup and understated accessories
-- muted, realistic professional clothing in gray, blue, olive, or off-white tones
+- minimal makeup and understated accessories, including a fine necklace
+- muted, realistic professional clothing in gray and blue tones
 
 ### Useful negative constraints
 
-Do not make her olive-skinned, dark-haired, glamorous, delicate-featured, or highly polished. Do not use deep brown eyes, a broad sturdy jawline, thick dark wavy hair, a structured low bun, or strongly executive styling. Do not make the expression overly reserved, severe, or portrait-formal; allow a more open, friendly smile. Do not make the styling editorial, luxurious, or portrait-perfect. Keep the result realistic, approachable, natural, and clearly suited to a practical professional role.
+Do not make her olive-skinned, dark-haired, glamorous, delicate-featured, or overly polished. Do not use deep brown eyes, a broad sturdy jawline, thick dark wavy hair, a structured low bun, or strongly executive styling. Do not make the expression overly reserved, severe, or portrait-formal; allow a more open, friendly smile. Do not make the styling editorial, luxurious, or portrait-perfect. Keep the result realistic, approachable, natural, and clearly suited to a practical professional role.