# gabrielavasco2003-a11y/transforme-se-proa-serasa architecture

> Architecture diagram of the GitHub repository gabrielavasco2003-a11y/transforme-se-proa-serasa, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gabrielavasco2003-a11y/transforme-se-proa-serasa
- Repository: https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa

## Overview

Spoiler Esperado is a reader-focused web app for discovering books and managing a personal reading shelf. Its main workflow runs from book discovery and search to a book detail page, then into shelf tracking, ratings, reactions, and comments; account sessions support personalized features. The backend serves the frontend and exposes the documented API, persisting user and reading data in MongoDB. Account recovery and phone verification are separate flows, with email and SMS providers. The graph follows README capabilities; unsampled backend internals are represented at the server level.

Main entry points: [`backend/server.js`](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/backend/server.js) (Express API server), [`frontend/js/script.js`](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/script.js) (Home highlights), [`frontend/js/book.js`](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/book.js) (Book details), [`frontend/js/edit-shelf.js`](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/edit-shelf.js) (Reading progress)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Book discovery"]
  node_home["Home highlights<br/>[script.js]"]
  node_search["Book search<br/>[busca.js]"]
  node_book_detail["Book details<br/>[book.js]"]
  node_books_api["Google Books API"]
  node_jabuti_data["Jabuti titles<br/>[jabuti.json]"]
end

subgraph group_reading["Reading and social"]
  node_shelf_view["Personal shelf<br/>[shelf.js]"]
  node_shelf_edit["Reading progress<br/>[edit-shelf.js]"]
  node_comments["Book comments<br/>[book.js]"]
  node_reactions_data["Reaction options<br/>[reactions.json]"]
end

subgraph group_accounts["Accounts and verification"]
  node_registration["Registration<br/>[cadastro.js]"]
  node_login["Login and OAuth<br/>[login.js]"]
  node_profile["User profile<br/>[perfil.js]"]
  node_recovery["Password recovery<br/>[recuperar.js]"]
  node_phone_verify["Phone verification<br/>[validar.js]"]
  node_email_service["Brevo email"]
  node_sms_service["StackVerify SMS"]
  node_google_oauth["Google OAuth"]
end

subgraph group_platform["Application platform"]
  node_server["Express API server<br/>[server.js]"]
  node_mongo[("MongoDB")]
  node_offline["Offline storage and sync<br/>[offline.js]"]
  node_service_worker["Service worker cache<br/>[sw.js]"]
end

node_reader(("Reader"))

node_reader -->|"browses"| node_home
node_home -->|"loads highlights"| node_server
node_home -->|"loads titles"| node_jabuti_data
node_reader -->|"searches books"| node_search
node_search -->|"requests search"| node_server
node_server -->|"proxies book data"| node_books_api
node_reader -->|"opens book"| node_book_detail
node_book_detail -->|"requests comments"| node_server
node_book_detail -.->|"loads book details"| node_books_api
node_reader -->|"registers"| node_registration
node_reader -->|"signs in"| node_login
node_login -->|"authenticates"| node_server
node_login -->|"starts OAuth"| node_google_oauth
node_registration -->|"submits account"| node_server
node_reader -->|"views profile"| node_profile
node_profile -->|"loads user data"| node_server
node_reader -->|"recovers password"| node_recovery
node_recovery -->|"submits recovery"| node_server
node_server -->|"sends recovery code"| node_email_service
node_reader -->|"verifies phone"| node_phone_verify
node_phone_verify -->|"submits code"| node_server
node_server -->|"sends SMS code"| node_sms_service
node_reader -->|"views shelf"| node_shelf_view
node_shelf_view -->|"loads shelf"| node_server
node_reader -->|"updates reading"| node_shelf_edit
node_shelf_edit -->|"updates shelf"| node_server
node_shelf_edit -.->|"loads reactions"| node_reactions_data
node_server -->|"persists app data"| node_mongo
node_offline -->|"registers worker"| node_service_worker
node_offline -.->|"syncs queued requests"| node_server
node_server -->|"configures sign-in"| node_google_oauth

click node_home "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/script.js"
click node_search "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/busca.js"
click node_book_detail "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/book.js"
click node_jabuti_data "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/data/jabuti.json"
click node_shelf_view "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/shelf.js"
click node_shelf_edit "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/edit-shelf.js"
click node_comments "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/book.js"
click node_reactions_data "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/data/reactions.json"
click node_registration "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/cadastro.js"
click node_login "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/login.js"
click node_profile "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/perfil.js"
click node_recovery "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/recuperar.js"
click node_phone_verify "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/validar.js"
click node_server "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/backend/server.js"
click node_offline "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/offline.js"
click node_service_worker "https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/sw.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_search,node_book_detail,node_books_api,node_jabuti_data toneBlue
class node_shelf_view,node_shelf_edit,node_comments,node_reactions_data toneAmber
class node_registration,node_login,node_profile,node_recovery,node_phone_verify,node_email_service,node_sms_service,node_google_oauth toneMint
class node_server,node_mongo,node_offline,node_service_worker toneRose
class node_reader toneIndigo
```

## Components

### Book discovery

- [Home highlights](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/script.js): `frontend/js/script.js`
- [Book search](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/busca.js): `frontend/js/busca.js`
- [Book details](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/book.js): `frontend/js/book.js`
- **Google Books API**
- [Jabuti titles](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/data/jabuti.json): `frontend/data/jabuti.json`

### Reading and social

- [Personal shelf](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/shelf.js): `frontend/js/shelf.js`
- [Reading progress](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/edit-shelf.js): `frontend/js/edit-shelf.js`
- [Book comments](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/book.js): `frontend/js/book.js`
- [Reaction options](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/data/reactions.json): `frontend/data/reactions.json`

### Accounts and verification

- [Registration](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/cadastro.js): `frontend/js/cadastro.js`
- [Login and OAuth](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/login.js): `frontend/js/login.js`
- [User profile](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/perfil.js): `frontend/js/perfil.js`
- [Password recovery](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/recuperar.js): `frontend/js/recuperar.js`
- [Phone verification](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/validar.js): `frontend/js/validar.js`
- **Brevo email**
- **StackVerify SMS**
- **Google OAuth**

### Application platform

- [Express API server](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/backend/server.js): `backend/server.js`
- **MongoDB**
- [Offline storage and sync](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/offline.js): `frontend/js/offline.js`
- [Service worker cache](https://github.com/gabrielavasco2003-a11y/transforme-se-proa-serasa/blob/main/frontend/js/sw.js): `frontend/js/sw.js`

### Other components

- **Reader**

## Connections

- Reader → Home highlights: browses (evidence: `README.md`)
- Home highlights → Express API server: loads highlights (evidence: `README.md`)
- Home highlights → Jabuti titles: loads titles (evidence: `frontend/js/script.js`)
- Reader → Book search: searches books (evidence: `README.md`)
- Book search → Express API server: requests search (evidence: `frontend/js/busca.js`)
- Express API server → Google Books API: proxies book data (evidence: `README.md`)
- Reader → Book details: opens book (evidence: `README.md`)
- Book details → Express API server: requests comments (evidence: `frontend/js/book.js`)
- Book details → Google Books API: loads book details (evidence: `README.md`)
- Reader → Registration: registers (evidence: `README.md`)
- Reader → Login and OAuth: signs in (evidence: `README.md`)
- Login and OAuth → Express API server: authenticates (evidence: `README.md`)
- Login and OAuth → Google OAuth: starts OAuth (evidence: `README.md`)
- Registration → Express API server: submits account (evidence: `frontend/js/cadastro.js`)
- Reader → User profile: views profile (evidence: `README.md`)
- User profile → Express API server: loads user data (evidence: `frontend/js/perfil.js`)
- Reader → Password recovery: recovers password (evidence: `README.md`)
- Password recovery → Express API server: submits recovery (evidence: `frontend/js/recuperar.js`)
- Express API server → Brevo email: sends recovery code (evidence: `README.md`)
- Reader → Phone verification: verifies phone (evidence: `README.md`)
- Phone verification → Express API server: submits code (evidence: `frontend/js/validar.js`)
- Express API server → StackVerify SMS: sends SMS code (evidence: `README.md`)
- Reader → Personal shelf: views shelf (evidence: `README.md`)
- Personal shelf → Express API server: loads shelf (evidence: `frontend/js/shelf.js`)
- Reader → Reading progress: updates reading (evidence: `README.md`)
- Reading progress → Express API server: updates shelf (evidence: `frontend/js/edit-shelf.js`)
- Reading progress → Reaction options: loads reactions (evidence: `README.md`)
- Express API server → MongoDB: persists app data (evidence: `README.md`)
- Offline storage and sync → Service worker cache: registers worker (evidence: `frontend/js/offline.js`)
- Offline storage and sync → Express API server: syncs queued requests (evidence: `frontend/js/offline.js`)
- Express API server → Google OAuth: configures sign-in (evidence: `README.md`)
