Skip to content

Feature/unified device data structure and UI ux improvements - #26

Merged
dcbert merged 6 commits into
mainfrom
feature/unified-device-data-structure-and-ui-ux-improvements
Aug 10, 2026
Merged

dcbert merged 6 commits into
mainfrom
feature/unified-device-data-structure-and-ui-ux-improvements

Conversation

@dcbert

@dcbert dcbert commented Aug 10, 2026

Copy link
Copy Markdown
Owner

This pull request implements a major unification of device and pool models in the backend, simplifying the Django admin interface and removing legacy model support. It also adds a management command for verifying the migration to unified tables, updates environment documentation for clarity, and includes a test result artifact. The most important changes are grouped below:

Backend Model/Admin Unification:

  • Refactored backend/api/admin.py to register unified models (Device, DeviceMiningStats, DeviceHardwareStats, DeviceSystemInfo, PoolStats) instead of legacy-specific models (such as BitAxeDevice, AvalonDevice, etc.), updating admin views, filters, and fields to match the new unified schema. The admin interface is now streamlined and less redundant.
  • Removed the now-obsolete backend/api/avalon_serializers.py file, eliminating Avalon-specific serializers in favor of a unified approach.

Migration Verification Tooling:

  • Added a new management command verify_device_unification.py to verify that data in unified device/pool tables matches legacy tables (if present), supporting strict mode and registry-only reporting. This aids in post-migration validation and troubleshooting.

Configuration and Documentation Improvements:

  • Updated .env.example with clearer comments, production hints, and improved documentation for environment variables, including frontend/backend port mappings and CORS origins.

Testing:

  • Added a test result artifact for a frontend page test to .vite/vitest/results.json, indicating a failed test for MiningDashboard.test.jsx.

dcbert added 5 commits July 23, 2026 15:53
- Refactor device management to use a single state for all devices.
- Update API calls to fetch devices from a unified endpoint.
- Modify dialogs to handle device make selection and update forms accordingly.
- Enhance DeviceTable to display device make and adjust layout.
- Update tests to reflect changes in device structure and API responses.

docs: improve Umbrel app documentation

- Clarify app structure and prerequisites for publishing.
- Update architecture section to reflect service roles and data handling.
- Enhance initial setup instructions for clarity and completeness.
- Revise app description to highlight features and self-sovereignty.
…sets and custom options

- Implemented GlobalTimeRange component with UI for selecting time ranges.
- Added context provider (TimeRangeContext) to manage time range state.
- Created utility functions for handling time range logic and storage.
- Developed tests for GlobalTimeRange component and time range utilities.
- Included support for relative presets and custom absolute time ranges.
- Refactor MiningDashboard to support multiple device makes and improve data fetching logic.
- Update API endpoints to remove 'bitaxe' prefix for consistency.
- Introduce a new NotificationsSettings component in SettingsPage for managing notification preferences.
- Enhance settings handling to avoid sending empty secrets during updates.
- Add upgrade smoke script for verifying device unification post-migration.
- Update tests to reflect changes in API endpoints and default time ranges.
- Added adaptive time-axis helpers for chart labels in formatters.js.
- Updated index.css with a new Amber Minimal theme using oklch color values.
- Implemented new time range parsing and configuration functions in timeRange.js.
- Enhanced various dashboard components (Analytics, Mining, BitAxeDeviceDetails) to utilize adaptive time-axis configurations.
- Updated chart components to support dynamic tick formatting based on selected time range.
- Refactored CSS styles to use CSS variables for colors and fonts.
- Introduced jsconfig.json for improved module resolution in the frontend.
…board

- Added new status and surface color configurations in Tailwind CSS.
- Updated Vite configuration to include AnalyticsDashboard tests.
- Removed obsolete upgrade smoke script.
- Improved Umbrel README with updated service descriptions and installation instructions.
- Updated Umbrel app YAML for better clarity on MinerSentinel's capabilities.
- Introduced new ChartFrame component for consistent chart layouts.
- Created MakeBadge component for device manufacturer representation.
- Added EmptyState and ErrorState components for better user feedback.
- Implemented SectionHeader for improved layout consistency.
- Developed DataFreshness and HealthBar components for real-time metrics.
- Created MetricCard for unified KPI display across dashboards.
- Added StatusIndicator for operational status representation.
- Implemented formatters for consistent metric formatting and testing.
- Added unit tests for formatters to ensure reliability.
@dcbert dcbert self-assigned this Aug 10, 2026
Copilot AI lite review requested due to automatic review settings August 10, 2026 20:13

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review this pull request because it exceeds the maximum number of lines (20,000). Try reducing the number of changed lines and requesting a review from Copilot again.

@dcbert
dcbert merged commit d43c3b3 into main Aug 10, 2026
5 checks passed
@dcbert
dcbert deleted the feature/unified-device-data-structure-and-ui-ux-improvements branch August 10, 2026 20:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants