Welcome to MovieTracker Documentation

MovieTracker is a web application for discovering, tracking, and reviewing movies. It was designed and implemented as the final project for the Software Quality Assurance course, with a strong focus on software architecture, quality attributes, automated testing, and modern development practices.

The application allows users to search for movies, view detailed information, manage a personal watchlist, and share reviews, while integrating with the TMDB API to provide up-to-date movie data.

Getting Started

If you want to run MovieTracker locally, begin with the Quick Start Guide, which explains the prerequisites, installation steps, and available deployment modes.

Documentation Overview

This documentation provides a comprehensive overview of the project, including:

• Architecture and design decisions

• Quality goals and quality scenarios

• Deployment and runtime views

• Testing strategy and automated test suites

• Development and operational guidelines

• Technology stack and external dependencies

Whether you are a developer, reviewer, stakeholder or our teacher, these pages will help you understand how MovieTracker is built, deployed, tested, and maintained.

We hope you find this documentation useful and informative.

Getting Started

• Quick Start Guide
  • Prerequisites
  • Installation Steps
  • Docker Operating Modes
  • Configuration
• Local Development
  • Prerequisites
  • Installation Steps
  • Project Structure

Architecture

• 1 - Introduction and goals
  • G1 – Easy Movie Discovery
  • G2 – Integration with External Movie Data
  • G3 – Personalized Watchlist Management
  • G4 – Lightweight and Maintainable Architecture
  • G5 – Public Access to Movie Information
  • G6 – Secure User Authentication
  • 1.1 Requirements
  • 1.2 Quality goals
  • 1.3 Stakeholders
• 2 - Architecture Constraints
  • 2.1 Technical Constraints
  • 2.2 Organizational Constraints
• 3 - Context and Scope
  • 3.1 Business context
  • 3.2 Technical context
• 4 - Solution Strategy
• 5 - Building Block View
  • 5.1 Level 1 - Whitebox Overall System
  • 5.2 Level 2 - Backend (Whitebox)
  • 5.2.1 Router Layer
  • 5.2.2 Service Layer
• 6 - Runtime View
  • 6.1 Scenario: Add Movie to Watchlist
  • 6.2 Scenario: Remove Movie from Watchlist
  • 6.3 Scenario: View Movie Details
• 7 - Deployment view
  • 7.1 Infrastructure overview
  • 7.2 Container Architecture
  • 7.3 Environment Configuration
  • 7.4 Network Topology
• 8 - Crosscutting Concepts
  • 8.1 Domain Model
  • 8.2 Authentication
  • 8.3 External API Communication
  • 8.4 Testing Strategy
• 9 - Architecture decisions
  • ADR01 - Architecture Pattern
  • ADR02 - Backend
  • ADR03 - Frontend
  • ADR04 - Database
  • ADR05 - Reverse Proxy
  • ADR06 - External Service
  • ADR07 - Containerization
  • ADR08 - Code Analysis Tool
  • ADR09 - Framework e2e Tests
  • ADR10 - Unit and Integration Test Technology
  • ADR11 - Architecture Test Technology
• 10 - Quality Requirements
  • 10.1 Quality Requirements Overview
  • 10.2 Quality scenarios
• 11 - Risks and Technical Debt
  • 11.1 Technical risks
  • 11.2 Business/domain risks
  • 11.3 Technical debt
• Glossary

Architecture Decision Records

• ADR01 - Architecture Pattern
• ADR02 - Backend Technology
• ADR03 - Frontend Technology
• ADR04 - Database Technology
• ADR05 - Reverse Proxy
• ADR06 - External Service Technology
• ADR07 - Conatainerization Platform
• ADR08 - Code Analysis Tool Technology
• ADR09 - Framework end-to-end tests
• ADR10 - Unit and Integration Test
• ADR11 - Architecture Testing Framework

About the students

Authors: Daniel Schmerber, Bernhard Blietz, Paula Macedo da Cruz