# ericlucerogonzalez/ericlucerogonzalez.github.io architecture

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

- Interactive diagram: https://gitdiagram.com/ericlucerogonzalez/ericlucerogonzalez.github.io
- Repository: https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io

## Overview

Eric Lucero González’s personal portfolio and digital garden combines a localized portfolio with technical blog and LaTeX content, interactive project experiences, and lightweight engagement analytics. A visitor reaches the localized home page, browses portfolio or content areas, and can read or interact with posts; separate API routes record visits and likes for reporting. The README documents MDX features, while sampled sources confirm home-page composition, post lookup, feeds, and analytics persistence. Several route implementations were not sampled, so their internal render and content-loading links are intentionally not asserted.

Main entry points: [`app/models/index.js`](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/models/index.js) (Analytics models), [`app/[locale]/page.js`](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/%5Blocale%5D/page.js) (Localized home), [`app/components/MdCompos/ArtemisLiveTracker.js`](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/components/MdCompos/ArtemisLiveTracker.js) (Artemis tracker), [`app/components/MdCompos/lazyClient.js`](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/components/MdCompos/lazyClient.js) (Interactive MDX)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Portfolio and navigation"]
  node_home["Localized home<br/>[page.js]"]
  node_about["About portfolio<br/>[page.js]"]
end

subgraph group_content["Technical content"]
  node_blog["Blog pages<br/>[page.js]"]
  node_latex["LaTeX pages<br/>[page.js]"]
  node_mdx["Interactive MDX<br/>[lazyClient.js]"]
  node_latexwidgets["LaTeX showcase<br/>[LatexBlock.js]"]
  node_feedroute["Feed route<br/>[route.js]"]
end

subgraph group_projects["Interactive projects"]
  node_artemis["Artemis tracker"]
  node_artemisevents["Artemis events<br/>[ArtemisEvents.js]"]
  node_nasa["NASA live updates<br/>[NasaLiveUpdate.js]"]
  node_sorteo["World Cup simulator<br/>[SorteoMundial.js]"]
end

subgraph group_analytics["Engagement analytics"]
  node_tracking["Visit tracking API<br/>[route.js]"]
  node_likes["Likes API<br/>[route.js]"]
  node_stats["Stats API<br/>[route.js]"]
end

subgraph group_runtime["Content and data layer"]
  node_postdata["Post lookup<br/>[api.js]"]
  node_feed["Feed generation<br/>[feed.js]"]
  node_models["Analytics models<br/>[index.js]"]
  node_mongo[("MongoDB connector<br/>[mongo.js]")]
end

node_visitor(("Visitor"))
node_mongodb[("MongoDB")]

node_visitor -->|"opens"| node_home
node_home -->|"loads posts"| node_postdata
node_home -->|"renders"| node_latexwidgets
node_visitor -->|"opens"| node_about
node_visitor -->|"reads posts"| node_blog
node_visitor -->|"reads lessons"| node_latex
node_mdx -->|"loads dynamically"| node_artemis
node_mdx -->|"loads dynamically"| node_sorteo
node_artemis -->|"uses"| node_artemisevents
node_artemis -->|"uses"| node_nasa
node_feedroute -->|"requests feed"| node_feed
node_feed -->|"loads posts"| node_postdata
node_visitor -->|"sends visit"| node_tracking
node_tracking -->|"updates metrics"| node_models
node_visitor -->|"votes on posts"| node_likes
node_likes -->|"reads and writes"| node_models
node_visitor -->|"requests report"| node_stats
node_stats -->|"queries metrics"| node_models
node_models -->|"gets models"| node_mongo
node_mongo -.->|"connects"| node_mongodb

click node_home "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/%5Blocale%5D/page.js"
click node_about "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/%5Blocale%5D/about/page.js"
click node_blog "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/%5Blocale%5D/blog/%5Bslug%5D/page.js"
click node_latex "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/%5Blocale%5D/latex/%5Bslug%5D/page.js"
click node_mdx "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/components/MdCompos/lazyClient.js"
click node_latexwidgets "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/components/LatexBlock.js"
click node_artemis "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/components/MdCompos/ArtemisLiveTracker.js"
click node_artemisevents "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/components/MdCompos/ArtemisEvents.js"
click node_nasa "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/components/MdCompos/NasaLiveUpdate.js"
click node_sorteo "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/components/MdCompos/SorteoMundial.js"
click node_postdata "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/lib/api.js"
click node_feedroute "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/%5Blocale%5D/feed.xml/route.js"
click node_feed "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/lib/feed.js"
click node_tracking "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/api/track/route.js"
click node_likes "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/api/likes/%5Bslug%5D/route.js"
click node_stats "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/api/stats/route.js"
click node_models "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/models/index.js"
click node_mongo "https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/lib/mongo.js"

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_home,node_about toneBlue
class node_blog,node_latex,node_mdx,node_latexwidgets,node_feedroute,node_mongodb toneAmber
class node_artemis,node_artemisevents,node_nasa,node_sorteo toneMint
class node_tracking,node_likes,node_stats toneRose
class node_postdata,node_feed,node_models,node_mongo,node_visitor toneIndigo
```

## Components

### Portfolio and navigation

- [Localized home](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/%5Blocale%5D/page.js): `app/[locale]/page.js`
- [About portfolio](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/%5Blocale%5D/about/page.js): `app/[locale]/about/page.js`

### Technical content

- [Blog pages](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/%5Blocale%5D/blog/%5Bslug%5D/page.js): `app/[locale]/blog/[slug]/page.js`
- [LaTeX pages](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/%5Blocale%5D/latex/%5Bslug%5D/page.js): `app/[locale]/latex/[slug]/page.js`
- [Interactive MDX](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/components/MdCompos/lazyClient.js): `app/components/MdCompos/lazyClient.js`
- [LaTeX showcase](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/components/LatexBlock.js): `app/components/LatexBlock.js`
- [Feed route](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/%5Blocale%5D/feed.xml/route.js): `app/[locale]/feed.xml/route.js`

### Interactive projects

- [Artemis tracker](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/components/MdCompos/ArtemisLiveTracker.js): `app/components/MdCompos/ArtemisLiveTracker.js`
- [Artemis events](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/components/MdCompos/ArtemisEvents.js): `app/components/MdCompos/ArtemisEvents.js`
- [NASA live updates](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/components/MdCompos/NasaLiveUpdate.js): `app/components/MdCompos/NasaLiveUpdate.js`
- [World Cup simulator](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/components/MdCompos/SorteoMundial.js): `app/components/MdCompos/SorteoMundial.js`

### Engagement analytics

- [Visit tracking API](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/api/track/route.js): `app/api/track/route.js`
- [Likes API](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/api/likes/%5Bslug%5D/route.js): `app/api/likes/[slug]/route.js`
- [Stats API](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/api/stats/route.js): `app/api/stats/route.js`

### Content and data layer

- [Post lookup](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/lib/api.js): `app/lib/api.js`
- [Feed generation](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/lib/feed.js): `app/lib/feed.js`
- [Analytics models](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/models/index.js): `app/models/index.js`
- [MongoDB connector](https://github.com/ericlucerogonzalez/ericlucerogonzalez.github.io/blob/main/app/lib/mongo.js): `app/lib/mongo.js`

### Other components

- **Visitor**
- **MongoDB**

## Connections

- Visitor → Localized home: opens (evidence: `README.md`)
- Localized home → Post lookup: loads posts (evidence: `app/[locale]/page.js`)
- Localized home → LaTeX showcase: renders (evidence: `app/[locale]/page.js`)
- Visitor → About portfolio: opens (evidence: `README.md`)
- Visitor → Blog pages: reads posts (evidence: `README.md`)
- Visitor → LaTeX pages: reads lessons (evidence: `README.md`)
- Interactive MDX → Artemis tracker: loads dynamically (evidence: `app/components/MdCompos/lazyClient.js`)
- Interactive MDX → World Cup simulator: loads dynamically (evidence: `app/components/MdCompos/lazyClient.js`)
- Artemis tracker → Artemis events: uses (evidence: `app/components/MdCompos/ArtemisLiveTracker.js`)
- Artemis tracker → NASA live updates: uses (evidence: `app/components/MdCompos/ArtemisLiveTracker.js`)
- Feed route → Feed generation: requests feed (evidence: `app/[locale]/feed.xml/route.js`)
- Feed generation → Post lookup: loads posts (evidence: `app/lib/feed.js`)
- Visitor → Visit tracking API: sends visit (evidence: `app/api/track/route.js`)
- Visit tracking API → Analytics models: updates metrics (evidence: `app/api/track/route.js`)
- Visitor → Likes API: votes on posts (evidence: `app/api/likes/[slug]/route.js`)
- Likes API → Analytics models: reads and writes (evidence: `app/api/likes/[slug]/route.js`)
- Visitor → Stats API: requests report (evidence: `app/api/stats/route.js`)
- Stats API → Analytics models: queries metrics (evidence: `app/api/stats/route.js`)
- Analytics models → MongoDB connector: gets models (evidence: `app/models/index.js`)
- MongoDB connector → MongoDB: connects
