Skip to content

khuynh22/Hack-With-Google

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

26 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Device Performance Monitoring πŸ“Šβš‘

AppSheet Google Workspace License Winner

πŸ† Winner of Hack With Google 2023 - $5,000 Prize
A comprehensive device performance monitoring system built with AppSheet and Google Workspace

πŸ“– View Complete Documentation Index | βš™οΈ Setup Guide | πŸ”— Integration Guide


πŸ“‹ Table of Contents


🎯 Introduction

This project was developed during the Hack With Google event, sponsored by BeMyApp, Google, and Onix. The hackathon focused on expanding knowledge about AppSheet and other generative AI features in Google Workspace, AppSheet, and Google Cloud products.

Event Details:

  • Tracks: Independent Developer & Emerging Mid-Market
  • Theme: Manufacturing
  • Result: πŸ† 1st Place Winner - $5,000 Prize
  • Event Link: Hack With Google
Hack With Google Event

πŸš€ Project Overview

Our project leverages AppSheet to create a comprehensive device performance monitoring system that revolutionizes how companies and electricians manage utility infrastructure. The solution enables real-time tracking of meters and transformers in the field, allowing immediate reporting of:

  • ⚠️ Artificial outages
  • πŸ“‰ Non-technical losses
  • ❌ Errors and warnings
  • πŸ“ Device status and location

πŸ’‘ Core Value Proposition

By implementing features such as interactive views, dashboards, performance graphs, and automated actions, along with integrations for Google Maps, OCR, and intelligent bots, our solution:

  • ⚑ Streamlines Operations - Real-time monitoring and automated workflows
  • πŸ’° Optimizes Budget - Reduces operational costs by up to 15%
  • πŸ“Š Maximizes Performance - Data-driven insights for better decision-making
  • 🌱 Promotes Energy Conservation - Monitors and reduces energy consumption
  • 🎯 Saves Time - Potential to save 30% of workload for over 1 million electricians in the US

πŸ’Ό Business Impact

Our solution delivers measurable benefits to three key stakeholder groups:

🏭 Device Manufacturing Companies

Impact on Testing & Quality:

  • ⏱️ 25% reduction in testing time
  • πŸ’° 15% cost savings on average
  • πŸ“ˆ Real-time performance analysis during manufacturing
  • βœ… Instant adjustments and optimizations
  • 🎯 Improved device quality and customer satisfaction

How it works: Manufacturing companies can implement our product during device testing phases, enabling immediate identification and resolution of issues during the production process.

⚑ Utility Companies / Electricity Providers

Impact on Operations:

  • πŸ“‰ 20% reduction in outage durations
  • πŸ”§ Decreased downtime and maintenance costs
  • πŸ” Proactive monitoring of meters, transformers, and circuits
  • 🎯 Improved service reliability for customers
  • πŸ“Š Better asset management and lifecycle tracking

How it works: Real-time monitoring allows utility companies to identify and respond to issues before they escalate into major outages.

πŸ‘· Electricians & Field Technicians

Impact on Productivity:

  • ⏰ 30 minutes saved per inspection (via OCR automation)
  • πŸ“ˆ 15% productivity increase
  • πŸ“± Digital audit logs replace physical paperwork
  • πŸ€– Automated form filling reduces manual data entry
  • βœ… Reduced human errors in reporting

How it works: OCR technology automatically fills inspection forms from meter photos, allowing electricians to focus on critical tasks and handle more service requests efficiently.


✨ Key Features

  • πŸ“Š Real-time Dashboard - Comprehensive overview of device performance metrics
  • πŸ—ΊοΈ Interactive Google Maps Integration - Visual device status tracking with color-coded pins
  • πŸ“ Digital Audit Logs - Paperless inspection and maintenance records
  • πŸ€– OCR Technology - Automatic data extraction from device photos
  • πŸ“ˆ Performance Analytics - Filterable charts and graphs for data-driven decisions
  • πŸ”” Automated Alert System - Email notifications for status changes
  • πŸ“± Mobile-First Design - Optimized for field technicians on-the-go
  • ☁️ Cloud-Based Storage - Google Sheets integration for centralized data management

πŸ”§ Implementation Details

The project is built entirely on Google Products (G-Suite, AppSheet) where the main interface is developed using AppSheet and data is managed in Google Sheets.

πŸ“± Mobile Application Interface

Mobile Interface

a) Overview Dashboard

Landing Page with Key Metrics:

The dashboard provides at-a-glance insights into your device network:

  • ⚑ Average Power consumption
  • πŸ“Š Number of Active Meters
  • ⚠️ Number of Errors/Warnings
  • πŸ”Œ Power Outages in the last 24 hours

Each metric card is interactive - click to view detailed information and drill down into specific data points.

b) Interactive Map

Google Maps API Integration with Status Indicators:

Map View

The Map tab integrates Google Maps API to display real-time device locations and status:

Color-Coded Status System:

  • 🟒 Green Pin - Device operating normally
  • 🟑 Yellow Pin - Warning status, requires inspection
  • πŸ”΄ Red Pin - Device down or broken, immediate action needed

Interactive Features:

  • Click on any pin to view/edit device information
  • Update device status in real-time
  • View technician visit history
  • Add specific notes for each device
  • Track who last inspected or repaired the device

This enables both electricians and management to respond to status changes as quickly as possible, minimizing downtime.

c) Audit Log

Digital Paperwork Replacement:

Audit Log

Eliminates physical paperwork by allowing electricians to modify and submit inspection forms directly through the app.

Smart Features:

  • πŸ“ Autofill Functionality - Time-efficient for managing thousands of meters
  • πŸ“· OCR Integration - Take a photo and automatically extract device information
  • ✍️ Digital Signatures - Sign and submit instantly
  • βœ… Validation - Quick review before submission
  • ⏱️ Time Savings - Average 30 minutes saved per inspection

How OCR Works:

  1. Electrician takes a photo of the device
  2. System automatically reads and fills form fields
  3. Technician reviews, signs, and submits
  4. Data syncs to cloud storage instantly

This reduces both time spent and human errors in data entry.

d) Performance Charts

Data Visualization & Analytics:

Performance Charts

Integrated with Google Sheets to build comprehensive visual analytics:

Features:

  • πŸ“Š Overall device performance metrics
  • πŸ“… Filterable by date and time ranges
  • πŸ” Filter by specific device ID
  • πŸ“ˆ Trend analysis over time
  • πŸ’‘ Data-driven insights for decision-making

Perfect for management to track performance, identify patterns, and make informed operational decisions.

e) Automated Bots

Intelligent Alert System:

Automated Bots

Automated Response System:

  • πŸ”΄ Detects when device status changes from Green β†’ Yellow or Red
  • πŸ“§ Automatically sends customized emails to assigned electricians
  • ⚑ Includes device details, location, and priority level
  • πŸ’° Saves significant costs through rapid response
  • 🎯 Reduces manual monitoring requirements

This automated notification system ensures that issues are addressed immediately, minimizing downtime and preventing cascading failures.


πŸš€ Getting Started

Prerequisites

  • AppSheet account (free or paid)
  • Google Workspace account
  • Access to Google Sheets

Quick Setup

  1. Create an AppSheet Account

  2. Access the Application

  3. Configure Data Source

    • The template data is available in this repository (Template Data.xlsx)
    • Upload to your Google Drive and connect to AppSheet
    • Alternatively, create a new Google Sheet with the same structure
  4. Customize Settings

    • Configure email addresses for automated notifications
    • Set up Google Maps API key (if not already configured)
    • Adjust OCR settings based on your meter types

Data Structure

The application uses the following main data tables:

  • Devices - Meter and transformer information
  • Audit Logs - Inspection and maintenance records
  • Users - Electricians and administrators
  • Alerts - Status change notifications

See Template Data.xlsx in this repository for the complete data schema.


πŸ”— GitHub-AppSheet Integration

While AppSheet doesn't natively support direct GitHub integration, you can connect your GitHub repository to AppSheet using several methods:

Option 1: Automation Platforms (Recommended for Most Users)

Using Integrately (No-Code Solution):

  1. Sign up at Integrately.com
  2. Connect your GitHub and AppSheet accounts
  3. Create automation workflows:
    • New GitHub issue β†’ Create AppSheet record
    • AppSheet form submission β†’ Create GitHub issue
    • GitHub commit β†’ Update AppSheet data

Benefits:

  • βœ… No coding required
  • βœ… Pre-built templates
  • βœ… 1-click setup
  • βœ… Suitable for basic automations

Option 2: Data Connection via CData

For Live GitHub Data in AppSheet:

  1. Use CData Connect Cloud to connect GitHub
  2. Authenticate with OAuth2
  3. Connect AppSheet to CData as a data source
  4. Build dashboards using live GitHub data (issues, PRs, commits)

Use Cases:

  • πŸ“Š Project management dashboards
  • πŸ› Bug tracking integration
  • πŸ“ˆ Development metrics reporting

Option 3: Advanced Workflow Automation

Using n8n or Pipedream (For Custom Workflows):

  • Build custom automations with visual workflow builders
  • Connect multiple services (GitHub, AppSheet, Slack, etc.)
  • Trigger actions based on complex conditions
  • Suitable for advanced integration needs

Example Workflows:

  • Deploy app updates when code is merged
  • Sync issue tracking between GitHub and AppSheet
  • Automated testing and deployment pipelines

Option 4: Google Apps Script (For Developers)

For maximum control, use Google Apps Script to create custom integrations:

// Example: Webhook handler for GitHub events
function doPost(e) {
  var payload = JSON.parse(e.postData.contents);
  // Process GitHub webhook
  // Update AppSheet via API
}

Integration Benefits for This Project

Integrating GitHub with this AppSheet application could enable:

  • πŸ“ Version Control - Track changes to app configuration
  • πŸ› Issue Tracking - Link device issues to GitHub issues
  • πŸ“Š Documentation - Keep technical docs in GitHub, sync to app
  • πŸ”„ Automated Backups - Backup AppSheet data to GitHub
  • πŸ‘₯ Collaboration - Coordinate development between teams

For detailed setup instructions, see INTEGRATION.md.


πŸ—ΊοΈ Future Roadmap

We're developing this product into a fully functional solution with enhanced features:

Phase 1: Enhanced Reporting

  • Comprehensive outage reports
  • Detailed billing integration
  • Custom report builder
  • Export to multiple formats (PDF, Excel, CSV)

Phase 2: Advanced Mapping

  • Interactive Device Connections - Click on a device to see all connected devices
  • Geo-Navigation - Direct routing for technicians to device locations
  • Heat Maps - Visualize outage patterns and high-risk areas
  • Network Topology View - Understand device relationships

Phase 3: Expanded Device Support

  • Solar panel monitoring
  • Battery storage systems
  • EV charging stations
  • Smart grid integration

Phase 4: Enhanced Analytics

  • Interconnected dynamic charts
  • Predictive maintenance algorithms
  • AI-powered anomaly detection
  • Energy consumption optimization

Phase 5: Improved OCR

  • Train OCR for additional meter types
  • Read more data points (currently: voltage and power)
  • Support for handwritten notes
  • Multi-language support

Phase 6: Enterprise Features

  • Multi-tenant architecture
  • Role-based access control
  • API for third-party integrations
  • SLA tracking and compliance

🀝 Contributing

We're looking to expand this product! If you're interested in collaborating, here's how you can help:

Ways to Contribute

  • πŸ’‘ Ideas & Feedback - Share your thoughts on new features
  • πŸ› Bug Reports - Found an issue? Let us know!
  • πŸ“– Documentation - Help improve our docs
  • πŸ’Ό Business Partnerships - Interested in deploying this solution?

Contact

For collaboration opportunities, please reach out:

Development Guidelines

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request with detailed description

πŸ‘₯ Team & Acknowledgments

The Power Rangers Team 🦸

Special thanks to our amazing team who worked together to create this award-winning solution!

Event Organizers & Mentors

We extend our gratitude to:

  • Hayden & Google Team - Technical guidance and platform support
  • Lucas & BeMyApp Team - Event organization and mentorship
  • Solange Jacob & Onix Team - Industry insights and support

This hackathon provided an invaluable learning opportunity and platform to showcase innovative solutions for the manufacturing and utility sectors.


πŸ“„ License

Copyright Β© 2023 Khang Nguyen Huynh. All rights reserved.

This project is proprietary software. Unauthorized copying, modification, distribution, or use of this software, via any medium, is strictly prohibited without explicit permission from the copyright holder.

For licensing inquiries, please contact: [email protected]


πŸ“š Additional Resources


⭐ Support This Project

If you find this project helpful or interesting:

  • ⭐ Star this repository
  • πŸ”„ Share with your network
  • πŸ’¬ Provide feedback and suggestions
  • 🀝 Consider collaboration opportunities

Built with ❀️ using AppSheet and Google Workspace
Hack With Google 2023 Winner πŸ†

About

My project that won 1st Place in Hack With Google event

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •