How ferney/turno-de-estudio works
Project Type and Purpose
• This is a static, client-side study tool website for nursing students and professionals.
• It delivers study content (HTML pages), quizzes (JSON question files), and interactivity (JavaScript) entirely in the browser.
• There is no server-side application logic beyond serving static assets.
File Structure Analysis
• Top-level files:
• index.html – landing page
• styles.css – global styling
• script.js – shared JavaScript utilities, site navigation, or common logic
• Content directory:
• content/*.html – standalone pages with notes (e.g., cateterismo.html, sondaje.html, welcome.html)
• JSON directory:
• json/preguntas-*.json – question banks for each quiz topic
• Quiz pages and scripts:
• quiz-cateterismo.html & script-cateterismo.js
• quiz-sondaje.html & script-sondaje.js
• No build scripts or server frameworks—pure static asset delivery.
Insights from README
• The site offers quizzes (“Preguntas”), notes, and tips.
• Content updates are static replacements of HTML or JSON.
• Intended for regular visits, self-assessment, and study reinforcement.
a. Main Components
• Client (Web Browser)
• Static Asset Server (e.g., Nginx, GitHub Pages)
• Static Assets:
– HTML pages (index, content, quizzes)
– CSS (styles.css)
– JavaScript (script.js, script-cateterismo.js, script-sondaje.js)
– JSON data (preguntas-cateterismo.json, preguntas-sondaje.json)
b. Relationships & Data Flows
1. Browser requests index.html → receives HTML + CSS + script.js
2. User clicks a link to a content or quiz page → browser fetches that HTML + its specific script
3. Quiz script issues an AJAX/fetch call to the appropriate JSON file
4. Browser parses JSON → dynamically renders questions and captures answers
c. Architectural Patterns & Principles
• Static Content Hosting: All resources are served as static files
• SPA-like Behavior on Quiz Pages: dynamic binding of JSON to HTML elements
• Separation of Concerns:
– Presentation (HTML/CSS)
– Data (JSON)
– Behavior (JavaScript)
d. Key Technologies
• HTML5 for structure
• CSS3 for styling
• Vanilla JavaScript (ES6+) for DOM manipulation + fetch API
• JSON as data interchange format
• Any static web server capable of hosting files (e.g., S3 + CloudFront, GitHub Pages)