How upc-pre-202510-1asi0730-4368/catch-up works
Project Type and Purpose
• This is a single‐page application (SPA) front-end built with Vue 3 and Vite.
• It fetches news articles and sources from an external API and displays them in multiple languages (i18n).
• There is no custom backend—data is retrieved directly from third-party endpoints.
High-Level Architecture Layers
Layer 1: Presentation (Vue Components & Pages)
Layer 2: Domain Model (Entities & Assemblers)
Layer 3: Data Access (API Services)
Layer 4: External Services & Hosting
Main Components
• index.html / Vite Dev Server & Build
• src/main.js — Vue app bootstrap
• src/App.vue — Root application shell
• src/i18n.js + src/locales/*.json — Internationalization layer
• src/public components — Header/Footer/LanguageSwitcher
• src/news/components — ArticleList, ArticleItem, SourceList, SourceItem, UnavailableContent
• src/shared/logo-api.service.js — Logo fetching service
• src/news/services/news-api.service.js — News API client
• src/news/services/*.assembler.js — Transform raw JSON into domain entities
• src/news/model/*.entity.js — Article and Source domain objects
• src/style.css — Global styles
External Dependencies & Environment
• .env.development / .env.production — API URLs, keys, feature flags
• External HTTP endpoints (News API, Logo API)
Architectural Patterns & Principles
• Layered architecture: separation of concerns between UI, domain logic, and data access.
• Single Responsibility Principle: each service or assembler does one job.
• Composition: Vue components compose smaller components (e.g., ArticleList contains ArticleItem).
• Dependency‐inversion: components depend on abstract services, not on raw fetch calls.