MBO Management Application

• MBOs (Management by Objectives) are a way to set clear, measurable goals that help align personal growth with team and company priorities.
• For Solutions Engineers at SnapLogic, MBOs provide structure, visibility, and accountability around learning, contributions, and impact.
• This project was created to centralize and simplify how we propose, track, and approve MBOs across the team.
• It allows engineers to easily submit their objectives, get feedback from managers, and track their progress in one place.
• Managers can quickly approve or reject MBOs, assign points, and ensure balanced contributions across different focus areas.
• The dashboard also fosters transparency by highlighting top contributors and team performance.
• We wanted a simple but effective tool tailored to our workflow. By tracking MBOs quarterly, we ensure continuous improvement and celebrate meaningful achievements.
• Ultimately, this tool supports a stronger, more engaged SE community. :)

Security Features

• Environment-based configuration
• No hardcoded credentials
• Password hashing
• Role-based access control
• CSRF protection
• Secure headers
• Audit logging

Prerequisites

• Python 3.9+
• PostgreSQL

Setup Instructions

1. Environment Setup

1. Clone the repository
2. Create a virtual environment:

SnapLogic MBO Tracker

Solutions Engineer MBO Management System

A comprehensive platform for tracking, managing, and reporting on Management by Objectives (MBOs)

📋 Overview

The SnapLogic MBO Tracker is a web-based application designed to streamline the process of creating, tracking, and approving Management by Objectives (MBOs) for Solutions Engineers. This platform enables engineers to document their achievements, managers to review and approve MBOs, and leadership to gain insights into team performance across different regions.

What are MBOs?

Management by Objectives (MBOs) are a performance management approach where employees and managers work together to set, track, and evaluate goals. In the context of this application, MBOs fall into three main categories:

• Learning and Certification: Professional development activities
• Demo & Assets: Creation of demos, tools, or assets for customer engagements
• Impact Outside of Pod: Contributions that extend beyond the immediate team

✨ Key Features

For Engineers

• Create and submit MBOs for approval
• Track progress on personal objectives
• View historical performance data
• Filter and sort MBOs by various criteria
• Download reports of personal achievements

For Managers

• Review and approve team members' MBOs
• Assign points based on impact and quality
• Track team performance metrics
• Generate reports for quarterly reviews
• View team progress dashboards

For Administrators

• Manage user accounts and permissions
• Configure system settings
• Access comprehensive reporting across regions
• Monitor overall platform usage

🔍 Detailed Feature Breakdown

User Management

• Role-based access control (Admin, Manager, Employee)
• Secure password management with reset functionality
• User profile customization with profile pictures
• Region-based team organization (EMEA, AMER, APAC)

MBO Management

• Structured MBO creation with type categorization
• Progress tracking (Not Started, In Progress, MVP, Finished)
• Approval workflow (Pending Approval, Approved, Rejected)
• Point allocation system for performance measurement

Dashboard & Reporting

• Interactive dashboards with filtering capabilities
• Team progress visualization
• Sortable data tables for all MBO types
• Excel and CSV export functionality
• Quarter-based performance tracking

Security Features

• Environment-based configuration
• No hardcoded credentials
• Password hashing with Werkzeug
• Role-based access control
• CSRF protection
• Secure headers with Flask-Talisman
• Comprehensive audit logging

Mobile Responsiveness

• Adaptive design for all screen sizes
• Optimized table views for mobile devices
• Touch-friendly interface elements
• Horizontal scroll indicators for data tables

🛠️ Technology Stack

graph TD
    A[Frontend] --> B[HTML/CSS/JavaScript]
    A --> C[Flask Templates]
    D[Backend] --> E[Python]
    D --> F[Flask Framework]
    G[Database] --> H[PostgreSQL]
    I[Security] --> J[Flask-Login]
    I --> K[Flask-WTF for CSRF]
    I --> L[Werkzeug Security]
    M[Deployment] --> N[Docker]
    M --> O[Gunicorn]

Loading

• Frontend: HTML, CSS, JavaScript
• Backend: Python, Flask
• Database: PostgreSQL
• Authentication: Flask-Login
• Form Handling: Flask-WTF
• Security: Werkzeug, Flask-Talisman
• Deployment: Docker, Gunicorn

📊 Data Model

erDiagram
    USER {
        int id PK
        string email
        string username
        string first_name
        string last_name
        string position
        string role
        string password_hash
        string profile_picture
        datetime created_at
        string region
        int manager_id FK
    }
    
    MBO {
        int id PK
        string title
        string description
        string mbo_type
        string progress_status
        string approval_status
        int points
        string optional_link
        datetime created_at
        int user_id FK
    }
    
    USER_SETTINGS {
        int id PK
        int user_id FK
        string key
        string value
        datetime created_at
        datetime updated_at
    }
    
    USER ||--o{ MBO : creates
    USER ||--o{ USER : manages
    USER ||--o{ USER_SETTINGS : has

Loading

🚀 Getting Started

Prerequisites

• Python 3.9+
• PostgreSQL
• Docker (optional)

Installation

Option 1: Standard Setup

1. Clone the repository

   git clone https://github.com/yourusername/snaplogic-mbo-tracker.git
   cd snaplogic-mbo-tracker

2. Create a virtual environment

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Create a .env file based on .env.example:

   cp .env.example .env

5. Edit the .env file and set your own values for all environment variables

2. Database Setup

1. Create a PostgreSQL database

2. Update the DATABASE_URL in your .env file

3. Initialize the database:

4. Install dependencies

   pip install -r requirements.txt

5. Configure environment variables

   cp .env.sample .env
   # Edit .env file with your configuration

6. Initialize the database

   flask db upgrade

3. Create Admin User

flask init-admin

4. Run the Application

Development Mode

flask run

Production Mode

gunicorn -w 4 "run:app"

Project Structure

app/
  ├── __init__.py          # Application factory
  ├── models.py            # Database models
  ├── auth/                # Authentication blueprint
  │   ├── __init__.py
  │   └── routes.py
  ├── main/                # Main blueprint
  │   ├── __init__.py
  │   └── routes.py
  ├── mbo/                 # MBO blueprint
  │   ├── __init__.py
  │   └── routes.py
  ├── static/              # Static files
  │   └── css/
  │       └── style.css
  ├── templates/           # HTML templates
  │   ├── auth/
  │   ├── main/
  │   ├── mbo/
  │   ├── layout.html
  │   └── auth_layout.html
  └── utils/               # Utility functions
      ├── __init__.py
      ├── date_utils.py
      └── security_utils.py

Security Best Practices

6. Create admin user

   flask init-admin

7. Run the application

   flask run

Option 2: Docker Setup

1. Clone the repository

   git clone https://github.com/yourusername/snaplogic-mbo-tracker.git
   cd snaplogic-mbo-tracker

2. Configure environment variables

   cp .env.sample .env
   # Edit .env file with your configuration

3. Build and run with Docker Compose

   docker-compose up -d

4. Create admin user

   docker-compose exec web flask init-admin

📱 Application Screenshots

Dashboard

MBO Creation

Team Progress

Mobile View

🔄 Workflow

sequenceDiagram
    participant Engineer
    participant Manager
    participant System
    
    Engineer->>System: Create MBO
    System->>Manager: Notification of pending MBO
    Manager->>System: Review MBO
    alt Approved
        Manager->>System: Approve & assign points
        System->>Engineer: Notification of approval
    else Rejected
        Manager->>System: Reject with feedback
        System->>Engineer: Notification of rejection
        Engineer->>System: Revise and resubmit
    end
    Engineer->>System: Update progress status
    System->>Manager: Notification of status change
    Manager->>System: Generate quarterly report

Loading

📁 Project Structure

app/
├── __init__.py          # Application factory
├── models.py            # Database models
├── config.py            # Configuration settings
├── helpers.py           # Helper functions
├── routes.py            # Main routes
├── static/              # Static files
│   ├── css/
│   │   └── style.css
│   └── img/
│       └── snaplogic_logo.png
├── templates/           # HTML templates
│   ├── dashboard.html
│   ├── layout.html
│   ├── login.html
│   ├── mbo_form.html
│   └── ...
└── utils/               # Utility functions
    ├── __init__.py
    ├── date_utils.py
    ├── email_utils.py
    ├── file_utils.py
    ├── report_utils.py
    └── security_utils.py

🔒 Security Best Practices

1. Environment Variables: All sensitive information is stored in environment variables, not in the code.
2. Password Security: Passwords are hashed using Werkzeug's security functions.
3. CSRF Protection: All forms are protected against Cross-Site Request Forgery.
4. Secure Headers: HTTP security headers are set using Flask-Talisman.
5. Audit Logging: Security events are logged for auditing purposes.
6. Database Security: Parameterized queries prevent SQL injection.
7. Input Validation: All user inputs are validated before processing.
8. Session Management: Secure session handling with Flask-Login.

🤝 Contributing?

Contributions are not welcome, sorry...! This is an internal project :)

🙏 Acknowledgements

• SnapLogic for supporting the development of this tool
• The ROO AI tool for its excellent job as an AI assistent!
• My manager for letting me do this project
• Me as a contributor who have helped create this application