Vivo Robot Automation

Test automation project for Vivo app using Robot Framework and Appium.

📱 Overview

This project implements automated tests for Vivo app, focusing on smoke tests and critical flow tests to ensure application quality in each release.

🔧 Technologies Used

• Robot Framework: Keyword-driven automation testing framework
• Appium: Tool for mobile application test automation
• Python: Programming language used for custom keyword development
• Git: Version control system

📂 Project Structure

vivo-robot-automation/
├── .env.example         # Example environment variables (no real credentials)
├── .gitignore           # Files ignored by Git
├── docs/                # Project documentation
│   └── ENVIRONMENT_SETUP.md  # Guide for setting up environment variables
├── LICENSE              # MIT License
├── README.md            # Project documentation
├── requirements.txt     # Python dependencies
├── resources/           # Reusable keywords and resources
│   └── keywords.robot   # Test keywords with secure credentials handling
└── tests/
    ├── testcases/       # Test cases organized by functionality
    │   └── smoke_test_main_flow.robot  # Smoke test for main app flow
    └── data/            # Test data (if needed)

🚀 Main Test Cases

• Smoke Tests: Basic verification of critical functionalities
• Login Flow: Authentication process validation
• Payment Flows: Payment journey validation
• Main Navigation: Verification of elements and transitions between screens

⚙️ How to Run Tests

Prerequisites

• Python 3.7+
• Robot Framework
• Appium Server
• Android device or Emulator/Simulator

Installation

# Clone the repository
git clone https://github.com/mavieiradev/vivo-robot.git

# Install dependencies
pip install -r requirements.txt

# Configure environment variables (see docs/ENVIRONMENT_SETUP.md)
cp .env.example .env
# Edit .env with your credentials

# Configure Appium Server
appium

Running Tests

# Run all tests
robot -d results tests/testcases/

# Run smoke tests
robot -d results tests/testcases/smoke_test_main_flow.robot

# Run specific tests by tag
robot -d results -i login tests/testcases/

📊 Reports

Execution reports are automatically generated in the results folder after each execution, providing:

• Success/failure rate
• Execution time
• Failure screenshots
• Detailed logs

👤 Authors

• Mateus Vieira - QA Automation Engineer - GitHub

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.