Beehive

<img align="left" src="static/favicon.svg" width="30" title="Beehive Logo" alt="Beehive Logo">

A Data Framework for Behavioral Health with Digitized Drawings and Photographs.

Project Description

This project aims to analyze behavioral health and complement healthcare practice with community health metrics in Alaska using a data federation approach. By leveraging data from various sources, we can gain insights into behavioral health patterns and improve healthcare practices in the community.

Tech Stacks Used

• Backend: Flask (Python)
• Frontend: React (TypeScript) in frontend/
• User Authentication: Google OAuth2
• Local Authentication: JWT-based auth with optional Google OAuth for admin
• Database: MongoDB
• Storage: Local filesystem for media uploads in static/uploads/ with PDF thumbnails in static/uploads/thumbnails/

Workflow

graph TD;
  User["User uploads an image with title, description, sentiment & voice note"] -->|POST request| Backend[Flask Backend]
  Backend -->|Stores metadata| MongoDB[MongoDB Database]
  Backend -->|Stores image & voice note| StaticFolder[Static Folder]
  Admin["Admin views uploaded images & metadata"] -->|GET request| Backend
  Backend -->|Fetches data| MongoDB
  Backend -->|Serves images & voice notes| StaticFolder
  User & Admin -->|Authenticated| Auth[Flask Authentication]

Setup Instructions

For instructions to configure and run this project locally, see the setup.md.

GitHub Stars

Contributing

dev branch is our primary development branch. The main branch is our stable branch. Please create pull requests against the dev branch if you are contributing to ongoing development. For specific contribution guidelines, see the contributing.md.

Citation

If you use this work in your research, please cite the following publication:

• Abdullah, M. F, Kwon, J., Bagwan, Gupta, I., Moxley, D., and Kathiravelu, P. A Data Framework for Behavioral Health with Digitized Drawings and Photographs. In the 20th Annual IEEE International Systems Conference (SysCon). Accepted. 8 pages. April 2026.