# sntl84/metromate-website-roadmap architecture

> Architecture diagram of the GitHub repository sntl84/metromate-website-roadmap, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sntl84/metromate-website-roadmap
- Repository: https://github.com/sntl84/metromate-website-roadmap

## Overview

This repository is primarily a roadmap and planning repository for a community heritage and trade platform, not the platform’s application code. Its planned user journey is community members discovering heritage, family, and community services, alongside trade and business opportunities. A small, implemented utility adds a separate gold-rate briefing workflow: a user supplies a query, the script requests a brief from Perplexity, and prints text or JSON. Product domains below reflect README-described capabilities; the actual application backend and frontend are not present in the sampled source.

Main entry points: [`README.md`](https://github.com/sntl84/metromate-website-roadmap/blob/main/README.md) (Community Platform), [`integrations/pplx-gold-tracker/gold_rate_brief.py`](https://github.com/sntl84/metromate-website-roadmap/blob/main/integrations/pplx-gold-tracker/gold_rate_brief.py) (Gold Rate Brief), [`MetroMate/README.md`](https://github.com/sntl84/metromate-website-roadmap/blob/main/MetroMate/README.md) (MetroMate Services), [`Family-Reg-V1-Final.html`](https://github.com/sntl84/metromate-website-roadmap/blob/main/Family-Reg-V1-Final.html) (Family Registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_community["Community Platform"]
  node_platform["Community Platform<br/>[README.md]"]
  node_heritage["Heritage and Lineage<br/>[README.md]"]
  node_family["Family Registry"]
  node_portal["Member Portal<br/>[Member_Portal.md]"]
  node_matrimony["Matrimony Discovery<br/>[Matrimony.md]"]
  node_education["Education Discovery<br/>[School_Section.md]"]
  node_healthcare["Healthcare Discovery<br/>[Healthcare.md]"]
end

subgraph group_commerce["Trade and Services"]
  node_directory["Business Directory<br/>[README.md]"]
  node_trade["Trade Directory<br/>[Trade_Directory.md]"]
  node_metromate["MetroMate Services<br/>[README.md]"]
  node_leadgen["Lead Generation"]
end

subgraph group_integration["Market Briefing"]
  node_goldbrief["Gold Rate Brief<br/>[gold_rate_brief.py]"]
end

node_member(("Community Member"))
node_golduser(("Brief Requester"))
node_perplexity["Perplexity Agent API"]

node_member -->|"uses planned"| node_platform
node_platform -->|"preserves"| node_heritage
node_platform -->|"documents families"| node_family
node_platform -->|"plans member access"| node_portal
node_platform -->|"enables discovery"| node_matrimony
node_platform -->|"enables discovery"| node_education
node_platform -->|"enables discovery"| node_healthcare
node_platform -->|"plans directory"| node_directory
node_platform -->|"supports trade"| node_trade
node_metromate -->|"offers leads"| node_leadgen
node_golduser -->|"queries"| node_goldbrief
node_goldbrief -->|"requests brief"| node_perplexity

click node_platform "https://github.com/sntl84/metromate-website-roadmap/blob/main/README.md"
click node_heritage "https://github.com/sntl84/metromate-website-roadmap/blob/main/README.md"
click node_family "https://github.com/sntl84/metromate-website-roadmap/blob/main/Family-Reg-V1-Final.html"
click node_portal "https://github.com/sntl84/metromate-website-roadmap/blob/main/sprint-sheets/Member_Portal.md"
click node_matrimony "https://github.com/sntl84/metromate-website-roadmap/blob/main/sprint-sheets/Matrimony.md"
click node_education "https://github.com/sntl84/metromate-website-roadmap/blob/main/sprint-sheets/School_Section.md"
click node_healthcare "https://github.com/sntl84/metromate-website-roadmap/blob/main/sprint-sheets/Healthcare.md"
click node_directory "https://github.com/sntl84/metromate-website-roadmap/blob/main/backend-architecture-study/README.md"
click node_trade "https://github.com/sntl84/metromate-website-roadmap/blob/main/sprint-sheets/Trade_Directory.md"
click node_metromate "https://github.com/sntl84/metromate-website-roadmap/blob/main/MetroMate/README.md"
click node_leadgen "https://github.com/sntl84/metromate-website-roadmap/blob/main/MetroMate/services/B2B-Lead-Generation.md"
click node_goldbrief "https://github.com/sntl84/metromate-website-roadmap/blob/main/integrations/pplx-gold-tracker/gold_rate_brief.py"

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_platform,node_heritage,node_family,node_portal,node_matrimony,node_education,node_healthcare toneBlue
class node_directory,node_trade,node_metromate,node_leadgen toneAmber
class node_goldbrief,node_golduser,node_perplexity toneMint
class node_member toneIndigo
```

## Components

### Community Platform

- [Community Platform](https://github.com/sntl84/metromate-website-roadmap/blob/main/README.md): `README.md`
- [Heritage and Lineage](https://github.com/sntl84/metromate-website-roadmap/blob/main/README.md): `README.md`
- [Family Registry](https://github.com/sntl84/metromate-website-roadmap/blob/main/Family-Reg-V1-Final.html): `Family-Reg-V1-Final.html`
- [Member Portal](https://github.com/sntl84/metromate-website-roadmap/blob/main/sprint-sheets/Member_Portal.md): `sprint-sheets/Member_Portal.md`
- [Matrimony Discovery](https://github.com/sntl84/metromate-website-roadmap/blob/main/sprint-sheets/Matrimony.md): `sprint-sheets/Matrimony.md`
- [Education Discovery](https://github.com/sntl84/metromate-website-roadmap/blob/main/sprint-sheets/School_Section.md): `sprint-sheets/School_Section.md`
- [Healthcare Discovery](https://github.com/sntl84/metromate-website-roadmap/blob/main/sprint-sheets/Healthcare.md): `sprint-sheets/Healthcare.md`

### Trade and Services

- [Business Directory](https://github.com/sntl84/metromate-website-roadmap/blob/main/backend-architecture-study/README.md): `backend-architecture-study/README.md`
- [Trade Directory](https://github.com/sntl84/metromate-website-roadmap/blob/main/sprint-sheets/Trade_Directory.md): `sprint-sheets/Trade_Directory.md`
- [MetroMate Services](https://github.com/sntl84/metromate-website-roadmap/blob/main/MetroMate/README.md): `MetroMate/README.md`
- [Lead Generation](https://github.com/sntl84/metromate-website-roadmap/blob/main/MetroMate/services/B2B-Lead-Generation.md): `MetroMate/services/B2B-Lead-Generation.md`

### Market Briefing

- [Gold Rate Brief](https://github.com/sntl84/metromate-website-roadmap/blob/main/integrations/pplx-gold-tracker/gold_rate_brief.py): `integrations/pplx-gold-tracker/gold_rate_brief.py`

### Other components

- **Community Member**
- **Brief Requester**
- **Perplexity Agent API**

## Connections

- Community Member → Community Platform: uses planned (evidence: `README.md`)
- Community Platform → Heritage and Lineage: preserves (evidence: `README.md`)
- Community Platform → Family Registry: documents families (evidence: `README.md`)
- Community Platform → Member Portal: plans member access (evidence: `README.md`)
- Community Platform → Matrimony Discovery: enables discovery (evidence: `README.md`)
- Community Platform → Education Discovery: enables discovery (evidence: `README.md`)
- Community Platform → Healthcare Discovery: enables discovery (evidence: `README.md`)
- Community Platform → Business Directory: plans directory (evidence: `README.md`)
- Community Platform → Trade Directory: supports trade (evidence: `README.md`)
- MetroMate Services → Lead Generation: offers leads (evidence: `README.md`)
- Brief Requester → Gold Rate Brief: queries (evidence: `integrations/pplx-gold-tracker/gold_rate_brief.py`)
- Gold Rate Brief → Perplexity Agent API: requests brief (evidence: `integrations/pplx-gold-tracker/gold_rate_brief.py`)
