NiceGUI web-ui implementatio on uv monorepo workspace structure

[hannalee2]

Key Changes

• Architecture & Refactoring in GUI:

  • Adopted an MVC (Model-View-Controller) pattern to separate logic, data models, and UI components.
  • Reorganized the project structure to include dedicated folders for components, services, static, models, and controllers.
  • Moved core logic into controllers and consolidated configuration management in status.py.

• UI Implementation:

  • Built the frontend using NiceGUI with Tailwind CSS for styling, replacing the initial test implementation.
  • Implemented reusable components for the queue sidebar and inspector views.
  • Added support for image rendering, mask overlays, and a custom theme via theme.css.

• Backend & Integration:

  • Integrated FastAPI backend communication for file processing and QC report generation.
  • Added Pydantic models for JSON validation of backend results.
  • Implemented a health check API for backend service status.
  • Optimized performance by using temporary files instead of loading images directly into RAM.

• Workflow Enhancements:

  • Implemented an event-driven subscription pattern for handling UI interactions (uploads, process requests).
  • Added options to save JSON QC reports to the output folder and toggle mask data return for the GUI.

• Deployment Options & Limitations

  • Web Option: This mode utilizes web sockets for real-time interaction. Please note that there is a limit of 1000 files per upload due to web socket limitations.
  • Native (Default) Option: This mode operates directly without uploading, and there is no file limit per upload.

• Testing

  • Validated file path handling and JSON output parsing.
  • Verified backend health check and event handling integration.