Compare commits

..
1 Commits
Author SHA1 Message Date
Jeroen SchweitzerandClaude Opus 4.5 3fbd794f67 fix(auth): correct endpoint path /auth/me → /auth/users/me
Build and Push / release (push) Successful in 3s
Build and Push / build (push) Successful in 2m57s
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-03 23:40:53 +01:00
87 changed files with 668 additions and 9505 deletions
+4 -5
View File
@@ -13,12 +13,11 @@ pubspec.lock
*.gr.dart
*.mocks.dart
# All generated *.g.dart files (from json_serializable, riverpod, version_builder)
# These are regenerated by build_runner during CI/CD builds
# Keep version.g.dart - it's generated but should be committed
# so CI/CD builds have version info without running the generator
# Other *.g.dart files (from json_serializable, etc.) are ignored
lib/**/*.g.dart
# Generated health.json (regenerated by tool/generate_health_json.dart during build)
web/health.json
!lib/version.g.dart
# IDE
.idea/
+4 -2
View File
@@ -59,8 +59,10 @@ This project uses version-tag-based CI/CD. Releases trigger automated Docker bui
3. Commit changes: `git commit -m "chore: release vX.X.X"`
4. Create git tag: `git tag vX.X.X`
5. Push with tags: `git push origin master --tags`
CI/CD auto-triggers when a tag starting with `v` is pushed.
6. Create release in Gitea UI (git.schweitz.net → Releases → New Release)
* Select the tag
* Add release notes (can copy from CHANGELOG)
* **Publish** the release (this triggers CI/CD)
**What happens on release:**
-312
View File
@@ -7,318 +7,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
## [1.5.1] - 2026-01-07
### Changed
- **Environment widgets layout redesign** - All 4 widgets always visible with responsive layout
- Desktop (>900px): 4-in-a-row with 30/20/20/30 width distribution (Sun | Weather | Air Quality | Forecast)
- Tablet (600-900px): 2x2 grid layout
- Mobile (<600px): Stacked vertically
- Widgets now show "No data available" state instead of being hidden or using mock data
- Sun position widget now calculates position from system clock
- Defaults to 6am/6pm (12-hour day/night cycles) when API sun times unavailable
- Environment data refresh interval changed from 5 minutes to 1 hour
## [1.5.0] - 2026-01-06
### Added
- **Dynamic Environment Widgets** - Live weather, sun position, and forecast data from Qdrant
- `SunPositionWidget` - Animated semicircle arc showing sun/moon position based on current time
- Gradient colors: yellow for daytime, orange for sunrise/sunset, blue for night
- Displays sunrise, sunset times and daylight duration
- `WeatherWidget` - Current temperature, conditions, humidity from API
- `ForecastWidget` - Multi-day weather forecast with conditions icons
- `AirQualityWidget` - AQI display (only shown when data available)
- Environment data provider with auto-refresh every 5 minutes
- Environment datasource calling `GET /tools/environment`
- Freezed models for environment data (weather, forecast, sun times, air quality)
- Comprehensive widget tests for environment section
### Changed
- Dashboard layout now displays dynamic environment data instead of static widgets
- Weather and air quality widgets accept optional API data parameters
## [1.4.0] - 2026-01-05
### Added
- **Decentralized Room Registry** - Each room registers itself with central registry
- `RoomDefinition` class with id, label, icons, routes, and permissions
- `RoomRegistry` singleton for managing all rooms
- Dynamic navigation tabs built from registry
- Settings dropdown builds from available rooms
- Permission-based room filtering support
- **Media Room** - New placeholder room for future media management features
- **Parlor** - Now a proper feature folder with router registration
### Changed
- Room navigation is now fully dynamic via registry
- `top_header_bar.dart` uses `roomRegistry.all` instead of hardcoded list
- `app_scaffold.dart` uses registry for route matching and navigation
- Settings page dropdown populated from `roomRegistry.all`
- Routers moved to per-room pattern:
- `lib/features/front_hall/router.dart` (new)
- `lib/features/parlor/router.dart` (new)
- `lib/features/media_room/router.dart` (new)
- Existing `control_room/router.dart` and `security/router.dart` now register with registry
- Documentation updated in ARCHITECTURE.md with Room Registry Pattern section
### Removed
- Hardcoded room lists in `top_header_bar.dart` and `app_scaffold.dart`
- `_PlaceholderPage` widget in `app_router.dart` (each room has its own page)
## [1.3.1] - 2026-01-05
### Fixed
- Default room preference now applies on app load
- Root `/` redirects to user's preferred default room
- Front Hall moved to `/front-hall` route (was `/`)
## [1.3.0] - 2026-01-05
### Added
- **URL deep-linking for DataGrids** - State is now reflected in URL query parameters
- `?search=` - DataGrid search query
- `?sort=` - Column ID for sorting
- `?order=desc` - Sort direction
- `?id=` - Opened document ID (proxy hosts page)
- `PageUrlState` utility class (`lib/routing/url_state.dart`) for URL ↔ state serialization
- Browser URL updates via `replaceState` without triggering GoRouter rebuilds
- `id` field added to `DataGridColumn` for unique column identification in URLs
- `FilterPanelSemantics` class for filter panel semantic IDs
- TESTING.md documentation for semantic widgets and automation testing
### Changed
- `idSelector` in DataGridController now returns `String` (was `Object`) for URL compatibility
- All DataGrid pages now support URL deep-linking:
- Containers list (`/control-room/containers`)
- Proxy hosts (`/control-room/proxy-hosts`)
- Users (`/security/users`)
- Groups (`/security/groups`)
- Router passes `GoRouterState` to pages for query parameter access
## [1.2.0] - 2026-01-05
### Added
- **Semantic labels for UI automation** (`lib/core/semantics/`)
- `semantic_ids.dart` - Centralized semantic identifier constants
- `semantic_widget.dart` - Helper widget and extension for adding semantics
- Enables browser automation tools (Puppeteer, WebDriver) via accessibility tree
- Semantic IDs added to:
- Profile dropdown button and menu items (theme options, settings, logout)
- Room navigation tabs (Front Hall, Control Room, Security, Parlor)
- NavPanel items (sidebar navigation)
- `SemanticsBinding.instance.ensureSemantics()` enabled on web builds
## [1.1.16] - 2026-01-05
### Fixed
- Theme toggle causing logout due to AuthInterceptor auto-signout on 401
- Removed aggressive `signOut()` call in `AuthInterceptor.onError`
- 401 errors now propagate to calling code for graceful handling
- Preferences API 401 no longer triggers full logout redirect
## [1.1.15] - 2026-01-05
### Fixed
- Theme toggle causing auth issues due to AuthNotifier auto-dispose
- Applied `@persistentRiverpod` annotation to AuthNotifier
- AuthProvider now persists for app lifetime, preventing rebuild on theme change
## [1.1.14] - 2026-01-04
### Fixed
- Theme toggle causing auth issues due to ThemeProvider auto-dispose
- Added `@persistentRiverpod` annotation for providers that need keepAlive
- ThemeProvider now persists for app lifetime
### Added
- `@persistentRiverpod` annotation in `core/providers/annotations.dart`
- Reusable annotation for providers that should not auto-dispose
- Documented in ARCHITECTURE.md
## [1.1.13] - 2026-01-04
### Added
- Settings page with Appearance, Navigation, and Account sections
- Theme toggle in user profile dropdown (System/Light/Dark)
- Theme syncs with API preferences on login
- Default room preference syncs with backend
### Changed
- Theme changes now persist to both local storage and API
## [1.1.12] - 2026-01-04
### Changed
- Control Room navigation reorganized:
- New "Stack" section with Containers and Proxy Hosts
- New "Data Management" section with PostgreSQL, Redis, Qdrant, Neo4j placeholders
- Removed: Networks, Volumes, Images (Portainer) and Redirections, Streams, Certificates (NPM)
## [1.1.11] - 2026-01-04
### Fixed
- API client providers now use `keepAlive: true` to prevent Ref invalidation
- Fixes "DioException [unknown]: null" error on /security/users and other API pages
- AuthInterceptor's stored Ref was becoming invalid when provider auto-disposed
## [1.1.10] - 2026-01-04
### Changed
- Removed page swipe transitions - all navigation is now instant (NoTransitionPage)
## [1.1.9] - 2026-01-04
### Changed
- Moved health check to `/health` directory - URL is now `/health` instead of `/health.html`
- Enables NPM forward auth path exclusion for health endpoint
## [1.1.8] - 2026-01-04
### Changed
- Dark background (`#1a1a2e`) on web/index.html to prevent white flash during auth redirects
## [1.1.7] - 2026-01-04
### Removed
- Removed `/callback` route from Flutter router - AuthController handles callback in main() before app starts
- Removed `_OidcCallbackPage` widget - no visible auth UI needed
## [1.1.6] - 2026-01-04
### Changed
- **Auth moved to standalone controller** - Handles OIDC completely outside Riverpod
- New `AuthController` runs in `main()` before `runApp()` - avoids provider lifecycle issues
- Handles callback, token exchange, and /auth/sync before app starts
- If auth not ready (redirecting), app doesn't start at all
- `AuthProvider` now just loads stored tokens (no async OIDC logic)
- Fixes "Cannot use Ref after disposed" errors from autoDispose providers
## [1.1.5] - 2026-01-04
### Fixed
- Race condition in OIDC callback: AuthProvider.build() was initiating silent OIDC while the callback page was processing, causing PKCE state to be cleared. Now skips silent OIDC when on `/callback` route.
## [1.1.4] - 2026-01-04
### Fixed
- Silent OIDC fallback: when `prompt=none` fails with `login_required` (no Authentik session), automatically fall back to regular OIDC flow to show login UI
## [1.1.3] - 2026-01-04
### Changed
- **Web auth uses silent OIDC with JWT Bearer tokens**
- Uses `prompt=none` to silently obtain JWT when Authentik session exists (via NPM forward auth)
- Flutter sends Bearer token to core-api instead of relying on forward auth cookies
- Fixes cross-subdomain cookie issues between home.schweitz.net and api.schweitz.net
- Callback now syncs with `/auth/sync` to get user profile and roles from core-api
- API interceptor now adds Bearer token on web (previously skipped)
## [1.1.2] - 2026-01-04
### Changed
- **Web auth simplified**: Skip Flutter OIDC on web - NPM forward auth handles it
- NPM authenticates at proxy level before app loads
- No more redundant OIDC redirect after NPM auth completes
- Fixes "Cannot use Ref after disposed" error from conflicting auth flows
- Mobile still uses Flutter OIDC flow
### Added
- Logout now redirects to Authentik to end SSO session
- Clears local tokens AND invalidates Authentik session
- Uses OIDC end_session_endpoint from discovery document
- Redirects back to app after Authentik logout completes
## [1.1.0] - 2026-01-04
### Changed
- **Dockerfile rebuild fix**: Added `flutter clean` before build to prevent stale cached artifacts
- VERSION build arg added for explicit cache busting
- Reordered build steps: clean → pub get → build_runner → health.json → flutter build
- Ensures deployed app always matches the version in health.json
### Fixed
- Replaced deprecated `dart:html` with `package:web` in iframe_view_web.dart
- Uses `web.HTMLIFrameElement` instead of `html.IFrameElement`
- Fixes deprecation warnings for Flutter 3.x web builds
## [1.0.12] - 2026-01-04
### Changed
- Removed login page - auth now auto-initiates from AppScaffold
- No more redirect to /login, just auto-start OIDC if not authenticated
- Shows loading screen during auth, error screen on failure with retry
- Seamless experience when Authentik session exists
### Removed
- Removed /login route and _LoginPage widget
## [1.0.11] - 2026-01-04
### Changed
- Web auth now extracts user info directly from JWT instead of syncing with core-api
- Eliminates CORS preflight issues with /auth/sync endpoint
- Decodes JWT claims (name, email, groups) client-side
- Bearer token will be used for API authentication
## [1.0.10] - 2026-01-04
### Fixed
- Fixed OIDC callback route being redirected to login before processing
- Moved callback route exception check BEFORE the auth redirect check in router
- This was preventing token exchange from ever happening
- Added favicon.ico to web root for proper browser tab icon display
## [1.0.9] - 2026-01-04
### Fixed
- Fixed OIDC callback Riverpod state modification error
- Deferred callback processing to `addPostFrameCallback` to avoid modifying state during widget build
## [1.0.8] - 2026-01-04
### Changed
- Switched from hash-based URLs (`/#/login`) to path-based URLs (`/login`)
- Required for OIDC callback to work correctly
- Uses conditional import to avoid breaking mobile/desktop builds
## [1.0.7] - 2026-01-04
### Fixed
- Fixed OIDC PKCE state loss across browser redirect
- Code verifier and state now persist in sessionStorage instead of memory
- Prevents "No code verifier" error after Authentik redirect
## [1.0.6] - 2026-01-04
### Fixed
- Fixed version generation in CI/CD builds
- Removed generated files (version.g.dart, health.json) from git tracking
- These files are now regenerated from pubspec.yaml during Docker build
## [1.0.5] - 2026-01-04
### Changed
- **Web authentication now uses OIDC** instead of NPM forward auth
- Added `OidcServiceWeb` for browser redirect-based Authorization Code flow with PKCE
- Added `/callback` route to handle Authentik redirect after login
- Login page now shows "Sign in with Authentik" button for both web and mobile
- Tokens stored in SharedPreferences and synced with core-api via `/auth/sync`
- Added web utility functions (`web_utils.dart`) with conditional imports for non-web platforms
- Added `crypto` and `web` packages for PKCE SHA-256 and browser API access
### Fixed
- Removed cross-origin cookie dependency that caused authentication failures on web
## [1.0.4] - 2026-01-03
### Added
- `health.json` generated at build time with app version info
- `health.html` now displays version, title, and status from health.json
## [1.0.3] - 2026-01-03
### Fixed
+3 -14
View File
@@ -3,29 +3,18 @@ FROM ghcr.io/cirruslabs/flutter:stable AS builder
WORKDIR /app
# VERSION arg busts cache when version changes in pubspec.yaml
# Extract version: docker build --build-arg VERSION=$(grep '^version:' pubspec.yaml | cut -d' ' -f2) .
ARG VERSION=0.0.0
RUN echo "Building version: $VERSION"
# Copy dependency files first for better caching
COPY pubspec.yaml pubspec.lock* ./
COPY pubspec.yaml ./
# Get dependencies
# Get dependencies (generates pubspec.lock)
RUN flutter pub get
# Copy the rest of the application
COPY . .
# Clean any cached build artifacts to ensure fresh build
RUN flutter clean && flutter pub get
# Generate code with build_runner (after clean for fresh generation)
# Generate code with build_runner
RUN dart run build_runner build --delete-conflicting-outputs
# Generate health.json with version info
RUN dart run tool/generate_health_json.dart
# Build for web release with production configuration
# These URLs enable authentication (requiresAuth = true when URL contains schweitz.net)
RUN flutter build web --release \
-86
View File
@@ -1,86 +0,0 @@
# Auth Flow Refactor: Invisible Token Exchange
> Research note for future implementation
## Problem
The `/callback?code=...` URL is visible in the browser during token refresh. This happens every time tokens need refreshing, not just on initial login. The current implementation appears to re-run the full OIDC redirect flow (`prompt=none`) instead of using the refresh_token.
## Current Behavior
```
Token expires → Redirect to Authentik (prompt=none) →
Redirect to /callback?code=xxx → Exchange code → Continue
```
User sees URL flicker to `/callback` repeatedly.
## Desired Behavior
```
Token expires → Show overlay (lock/lightning icon) →
XHR refresh request → Hide overlay → Continue
```
No URL changes. No redirects. Just a brief visual indicator.
## Key Insight
**Only the initial authorization MUST redirect** (user needs to see Authentik login UI).
Everything else can be XHR:
| Operation | Current | Should Be |
|-----------|---------|-----------|
| Initial login | Redirect | Redirect (unavoidable) |
| Token exchange (code → tokens) | Redirect to /callback | XHR POST |
| Token refresh | Full OIDC with prompt=none | XHR POST with refresh_token |
| Session expired | Redirect | Redirect (unavoidable) |
## Token Refresh via XHR
```dart
final response = await dio.post(
'https://authentik.schweitz.net/application/o/token/',
data: {
'grant_type': 'refresh_token',
'refresh_token': storedRefreshToken,
'client_id': clientId,
},
options: Options(
contentType: Headers.formUrlEncodedContentType,
),
);
// Returns new access_token, refresh_token, expires_in
```
## Potential Blocker: CORS
Authentik's token endpoint may block browser XHR. Solutions:
1. **Configure Authentik CORS** - Allow `home.schweitz.net` origin
2. **Proxy through core-api** (recommended)
- Flutter → `POST /auth/refresh` → core-api → Authentik
- Keeps client_secret server-side
- No CORS issues
## Implementation Steps
1. [ ] Verify Authentik is issuing refresh_tokens (check token response)
2. [ ] Check if refresh_token is being stored (SharedPreferences)
3. [ ] Test XHR to token endpoint (check CORS)
4. [ ] If CORS blocked, add `/auth/refresh` endpoint to core-api
5. [ ] Refactor `AuthProvider` to use XHR refresh instead of full OIDC flow
6. [ ] Add refresh overlay UI (lock icon + brief animation)
7. [ ] Remove `prompt=none` redirect logic for refresh cases
## Files to Investigate
- `lib/core/auth/auth_provider.dart` - Main auth state management
- `lib/core/auth/oidc_service_web.dart` - OIDC implementation
- `lib/core/api/api_interceptors.dart` - Token refresh trigger point
## References
- CHANGELOG entries v1.1.3-v1.1.6 document the current auth architecture
- AuthController runs in `main()` before `runApp()` (v1.1.6 pattern)
Binary file not shown.

Before

Width:  |  Height:  |  Size: 5.3 MiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.4 MiB

+9 -223
View File
@@ -20,7 +20,6 @@ lib/
│ ├── auth/ # Authentik OIDC integration
│ ├── config/ # Environment configuration
│ ├── error/ # Error types and handling
│ ├── semantics/ # Semantic IDs for automation
│ └── theme/ # Material 3 theming
├── routing/ # go_router configuration
├── shared/ # Reusable components
@@ -28,20 +27,14 @@ lib/
│ └── layouts/ # App scaffold, navigation
├── features/ # Feature modules (rooms)
│ ├── front_hall/ # Dashboard - estate overview
│ │ └── router.dart # Room registration
│ ├── control_room/ # Infrastructure
│ │ ├── router.dart # Room registration
│ │ ├── containers/ # Container management
│ │ ── npm/ # Proxy hosts management
│ ├── security/ # User & access management
│ │ ── router.dart # Room registration
│ ├── users/ # User management
│ └── groups/ # Group management
── parlor/ # AI chat & automation hub
│ │ └── router.dart # Room registration
│ ├── media_room/ # Media management (future)
│ │ └── router.dart # Room registration
│ └── settings/ # User preferences
│ │ ── stacks/ # Stack management
│ ├── networks/ # Network management
│ │ ── volumes/ # Volume management
│ ├── parlor/ # Housekeeping - home automation
├── library/ # Knowledge management (future)
── study/ # Secretarial tasks (future)
└── chat/ # Tatlock chat - omnipresent, NOT a room
```
@@ -51,16 +44,13 @@ lib/
|---------|-----------|---------|
| Front Hall | `features/front_hall/` | Dashboard, overview, quick access |
| Control Room | `features/control_room/` | Infrastructure management |
| Security | `features/security/` | User & access management |
| Parlor | `features/parlor/` | AI chat & automation hub |
| Media Room | `features/media_room/` | Media management (future) |
| *(non-room)* | `features/settings/` | User preferences |
| Parlor | `features/parlor/` | Home automation |
| Library | `features/library/` | Knowledge, docs, bookmarks |
| Study | `features/study/` | Email, calendar (hidden for now) |
| *(omnipresent)* | `chat/` | Tatlock assistant dock |
Note: `chat/` lives at the top level of `lib/` (not under `features/`) because it's not a navigable room - it's an omnipresent dock injected at the layout level.
Each room has a `router.dart` file that registers the room with the central registry. See [Room Registry Pattern](#room-registry-pattern) for details.
## Feature Structure
Each feature follows a three-layer architecture:
@@ -430,41 +420,6 @@ ContainerRepository containerRepository(Ref ref) {
}
```
### Persistent Providers
By default, `@riverpod` generates providers with `isAutoDispose: true`, meaning they dispose when no longer watched. This causes issues for:
- **API clients** with interceptors that store a `Ref`
- **App-level state** like theme, auth, config
- **Providers with listeners** to other providers
Use `@persistentRiverpod` from `core/providers/annotations.dart` for these cases:
```dart
import 'package:tatlock_ui/core/providers/annotations.dart';
// ✅ Correct - persists for app lifetime
@persistentRiverpod
Dio coreApiClient(Ref ref) { ... }
@persistentRiverpod
class ThemeNotifier extends _$ThemeNotifier { ... }
// ❌ Wrong - auto-dispose can invalidate stored Ref
@riverpod
Dio coreApiClient(Ref ref) { ... }
```
**When to use `@persistentRiverpod`:**
| Use Case | Annotation | Example |
|----------|------------|---------|
| API clients with interceptors | `@persistentRiverpod` | `coreApiClient`, `tatlockApiClient` |
| Auth state provider | `@persistentRiverpod` | `AuthNotifier` |
| Theme/config providers | `@persistentRiverpod` | `ThemeNotifier` |
| Feature data providers | `@riverpod` (default) | `ContainersNotifier` |
| UI state providers | `@riverpod` (default) | `SearchFilterNotifier` |
## File Naming Conventions
| Type | Convention | Example |
@@ -554,172 +509,3 @@ import 'package:tatlock_ui/features/containers/domain/entities/container.dart';
// Bad - importing model in presentation
import '../data/models/container_model.dart'; // Don't do this
```
## Semantic Identifiers for Automation
All interactive widgets should have semantic identifiers for UI automation. This enables reliable testing with Puppeteer, Appium, and other automation tools.
### Quick Reference
```dart
import 'package:tatlock_ui/core/semantics/semantic_ids.dart';
// Wrap interactive widgets with Semantics
Semantics(
identifier: DataGridSemantics.row(item.id),
label: 'Select ${item.name}',
child: MyRowWidget(item: item),
)
```
### Key Points
1. **Central ID Registry** - All IDs defined in `lib/core/semantics/semantic_ids.dart`
2. **Naming Convention** - `{area}_{component}_{identifier}` (e.g., `dataGrid_row_abc123`)
3. **Web Enabled** - Semantics tree exposed via `SemanticsBinding.instance.ensureSemantics()` in `main.dart`
For complete documentation on semantic patterns, automation queries, and best practices, see **[TESTING.md](./TESTING.md)**.
## Room Registry Pattern
The application uses a **decentralized room registry** pattern for navigation. Each feature/room registers itself with the central registry, providing:
- **Decoupled navigation** - Rooms define their own routes, icons, and metadata
- **Permission-based filtering** - Rooms can specify required permissions
- **Dynamic UI** - Settings dropdowns and tab bars build from registry
- **Single source of truth** - All room metadata in one place per room
### Architecture
```
lib/routing/room_registry.dart # Central registry class
lib/features/{room}/router.dart # Per-room registration
```
### Room Definition
Each room's `router.dart` exports a `RoomDefinition` and register function:
```dart
// lib/features/control_room/router.dart
import 'package:tatlock_ui/routing/room_registry.dart';
/// Room definition with all metadata.
final controlRoomRoom = RoomDefinition(
id: 'control-room', // Preference value, URL segment
label: 'Control Room', // Display name
icon: Icons.dns_outlined, // Unselected icon
selectedIcon: Icons.dns, // Selected icon
defaultRoute: '/control-room/containers', // Landing route
routes: controlRoomRoutes, // Function returning List<RouteBase>
requiredPermissions: [], // Empty = accessible to all
);
/// Register with the central registry.
void registerControlRoom() {
roomRegistry.register(controlRoomRoom);
}
/// Routes for go_router.
List<RouteBase> controlRoomRoutes() {
return [
GoRoute(path: '/control-room', ...),
// Sub-routes...
];
}
```
### Registration Order
Rooms are registered in `app_router.dart` in display order:
```dart
void _initializeRoomRegistry() {
if (roomRegistry.all.isNotEmpty) return; // Skip if initialized
// Registration order = tab order
registerFrontHall();
registerControlRoom();
registerSecurity();
registerParlor();
registerMediaRoom();
}
```
### Using the Registry
**Navigation tabs** (`top_header_bar.dart`):
```dart
List<RoomDefinition> get _rooms => roomRegistry.all;
// Build tab for each room
for (final room in _rooms) {
IconButton(
icon: Icon(isSelected ? room.selectedIcon : room.icon),
onPressed: () => onRoomSelected(index),
);
}
```
**Settings dropdown**:
```dart
DropdownButton<String>(
items: roomRegistry.all
.map((room) => DropdownMenuItem(
value: room.id,
child: Text(room.label),
))
.toList(),
);
```
**Router** - All routes from registry:
```dart
ShellRoute(
routes: [
...roomRegistry.allRoutes(),
// Plus non-room routes like /settings
],
);
```
**Route matching**:
```dart
int _selectedIndex(BuildContext context) {
final location = GoRouterState.of(context).matchedLocation;
return roomRegistry.indexOfRoute(location);
}
```
### Permission Filtering
Rooms can specify required permissions:
```dart
final adminRoom = RoomDefinition(
id: 'admin',
requiredPermissions: ['admin:access'],
// ...
);
// Filter by user permissions
final accessibleRooms = roomRegistry.accessibleTo(userPermissions);
```
### Adding a New Room
1. Create feature folder: `lib/features/{room_name}/`
2. Create `router.dart` with `RoomDefinition` and register function
3. Create placeholder page in `presentation/pages/{room_name}_page.dart`
4. Add `register{RoomName}()` call to `_initializeRoomRegistry()` in `app_router.dart`
5. Import the router in `app_router.dart`
### Current Rooms
| Room | ID | Default Route |
|------|-----|---------------|
| Front Hall | `front-hall` | `/front-hall` |
| Control Room | `control-room` | `/control-room/containers` |
| Security | `security` | `/security/users` |
| Parlor | `parlor` | `/parlor` |
| Media Room | `media-room` | `/media-room` |
-368
View File
@@ -1,368 +0,0 @@
# Testing & Automation Guide
This document covers automated testing patterns for Tatlock UI, focusing on semantic identifiers that enable reliable UI automation.
## Overview
Tatlock UI uses Flutter's **Semantics tree** to expose stable identifiers for automated testing. These identifiers are accessible to:
- **Puppeteer** (via Chrome DevTools accessibility API)
- **Appium** (via accessibility labels)
- **WebDriver** (via ARIA attributes)
- **Flutter integration tests**
The semantics system is enabled on web in `main.dart`:
```dart
if (kIsWeb) {
SemanticsBinding.instance.ensureSemantics();
}
```
## Semantic Identifiers
All semantic IDs are centralized in `lib/core/semantics/semantic_ids.dart`. This provides:
1. **Stable selectors** - IDs don't change with UI refactoring
2. **Type safety** - Compile-time verification of ID usage
3. **Discoverability** - Single source of truth for automation targets
### Available ID Classes
| Class | Purpose | Example IDs |
|-------|---------|-------------|
| `ProfileSemantics` | User profile dropdown | `profile_button`, `profile_menu_settings` |
| `RoomTabSemantics` | Main navigation tabs | `roomTab_frontHall`, `roomTab_controlRoom` |
| `NavSemantics` | Side navigation panel | `nav_panel`, `nav_item_{id}` |
| `DataGridSemantics` | Data tables | `dataGrid_row_{id}`, `dataGrid_search` |
| `DialogSemantics` | Modal dialogs | `dialog_confirm`, `dialog_cancel` |
| `SettingsSemantics` | Settings page | `settings_theme`, `settings_defaultRoom` |
| `StateSemantics` | Loading/error states | `state_auth_loading`, `snackbar_{type}` |
### ID Naming Convention
```
{area}_{component}_{identifier}
```
- **area**: Feature or section (e.g., `profile`, `nav`, `dataGrid`)
- **component**: Widget type (e.g., `menu`, `button`, `row`)
- **identifier**: Specific item (e.g., `light`, `settings`, `selectAll`)
Examples:
- `profile_menu_theme_dark` - Dark theme option in profile menu
- `dataGrid_row_abc123` - Row with ID "abc123" in data grid
- `nav_item_containers` - Containers nav item
## Adding Semantics to Widgets
### Method 1: Direct Semantics Widget
Use Flutter's `Semantics` widget with the `identifier` property:
```dart
import 'package:tatlock_ui/core/semantics/semantic_ids.dart';
Semantics(
identifier: ProfileSemantics.button,
label: 'Open profile menu',
button: true,
child: IconButton(
icon: Icon(Icons.person),
onPressed: () => ...,
),
)
```
### Method 2: SemanticWidget Wrapper
Use the convenience wrapper from `lib/core/semantics/semantic_widget.dart`:
```dart
import 'package:tatlock_ui/core/semantics/semantic_ids.dart';
import 'package:tatlock_ui/core/semantics/semantic_widget.dart';
SemanticWidget(
id: DataGridSemantics.search,
label: 'Search data grid',
textField: true,
child: TextField(
decoration: InputDecoration(hintText: 'Search...'),
),
)
```
### Method 3: Extension Method
Use the `withSemantics` extension for inline wrapping:
```dart
TextField(
decoration: InputDecoration(hintText: 'Search...'),
).withSemantics(
id: DataGridSemantics.search,
label: 'Search data grid',
)
```
### Dynamic IDs
For lists and grids, use the generator methods:
```dart
// Row in a data grid
Semantics(
identifier: DataGridSemantics.row(item.id), // "dataGrid_row_abc123"
child: DataGridRow(item: item),
)
// Navigation item
Semantics(
identifier: NavSemantics.item(route.id), // "nav_item_containers"
child: NavItem(route: route),
)
// Bulk action button
Semantics(
identifier: DataGridSemantics.bulkAction('delete'), // "dataGrid_bulk_delete"
child: IconButton(icon: Icon(Icons.delete), ...),
)
```
## Querying from Puppeteer
Puppeteer can query semantic identifiers via Chrome's accessibility tree:
```javascript
// Connect to Chrome with DevTools protocol
const browser = await puppeteer.connect({
browserURL: 'http://localhost:9222'
});
const page = await browser.newPage();
// Get accessibility snapshot
const snapshot = await page.accessibility.snapshot({ interestingOnly: false });
// Find element by semantic identifier
function findBySemanticId(node, id) {
if (node.name === id || node.description === id) {
return node;
}
for (const child of node.children || []) {
const found = findBySemanticId(child, id);
if (found) return found;
}
return null;
}
// Example: Find profile button
const profileButton = findBySemanticId(snapshot, 'profile_button');
// Example: Find a specific data grid row
const row = findBySemanticId(snapshot, 'dataGrid_row_abc123');
```
### Using Chrome DevTools MCP
With the Chrome DevTools MCP server, you can query semantics directly:
```javascript
// Take a snapshot (returns accessibility tree)
const snapshot = await mcp__chrome_devtools__take_snapshot();
// Click by semantic ID (uid in snapshot)
await mcp__chrome_devtools__click({ uid: 'profile_button' });
// Fill input by semantic ID
await mcp__chrome_devtools__fill({
uid: 'dataGrid_search',
value: 'my search query'
});
```
## Best Practices
### 1. Add Semantics to Interactive Elements
Every clickable, tappable, or input element should have a semantic identifier:
```dart
// Buttons
Semantics(
identifier: 'myFeature_submit',
button: true,
label: 'Submit form',
child: ElevatedButton(...),
)
// Text fields
Semantics(
identifier: 'myFeature_email',
textField: true,
label: 'Email address',
child: TextField(...),
)
// Checkboxes
Semantics(
identifier: 'myFeature_rememberMe',
checked: isChecked,
label: 'Remember me',
child: Checkbox(...),
)
```
### 2. Use Meaningful Labels
Labels help both accessibility tools and test debugging:
```dart
// Good - descriptive label
Semantics(
identifier: DataGridSemantics.rowAction(item.id, 'delete'),
label: 'Delete ${item.name}',
button: true,
child: ...,
)
// Bad - no context
Semantics(
identifier: 'btn1',
child: ...,
)
```
### 3. Register New IDs Centrally
Always add new semantic IDs to `semantic_ids.dart`:
```dart
/// My new feature IDs.
abstract class MyFeatureSemantics {
static const submitButton = 'myFeature_submit';
static const cancelButton = 'myFeature_cancel';
static const nameField = 'myFeature_name';
/// Generate ID for a list item.
static String item(String id) => 'myFeature_item_$id';
}
```
### 4. Test ID Stability
Semantic IDs should remain stable across releases. When refactoring:
- Keep existing IDs unchanged
- Add deprecation comments if IDs must change
- Update automation tests when IDs change
### 5. Exclude Decorative Elements
Don't add semantic IDs to purely decorative elements:
```dart
// Decorative icon - no semantics needed
Icon(Icons.star, color: Colors.yellow)
// Interactive icon - needs semantics
Semantics(
identifier: 'rating_star_3',
button: true,
label: 'Rate 3 stars',
child: IconButton(
icon: Icon(Icons.star),
onPressed: () => rate(3),
),
)
```
## DataGrid Semantic Patterns
The DataGrid component has comprehensive semantic coverage:
```
dataGrid - The grid container
dataGrid_search - Search input field
dataGrid_search_clear - Clear search button
dataGrid_selectAll - Select all checkbox
dataGrid_header_{columnId} - Column header (sortable)
dataGrid_row_{itemId} - Row container
dataGrid_row_{itemId}_checkbox - Row selection checkbox
dataGrid_row_{itemId}_actions - Row actions menu trigger
dataGrid_row_{itemId}_action_{actionId} - Specific row action
dataGrid_bulk_{actionId} - Bulk action button
dataGrid_bulk_clear - Clear selection button
dataGrid_loading - Loading indicator
dataGrid_empty - Empty state message
dataGrid_error - Error state message
dataGrid_refresh - Refresh button
```
### Example: Automating DataGrid Selection
```javascript
// Select all rows
await click('dataGrid_selectAll');
// Select specific row
await click('dataGrid_row_abc123_checkbox');
// Perform bulk delete
await click('dataGrid_bulk_delete');
// Confirm in dialog
await click('dialog_confirm');
```
## Debugging Semantics
### Flutter DevTools
1. Open Flutter DevTools
2. Go to "Inspector" tab
3. Enable "Semantics" overlay
4. Click widgets to see their semantic properties
### Chrome DevTools
1. Open DevTools (F12)
2. Go to "Accessibility" tab
3. Inspect the accessibility tree
4. Search for semantic identifiers
### Programmatic Inspection
```dart
// In a test, dump the semantics tree
debugDumpSemanticsTree();
// Check if semantics are enabled
print('Semantics enabled: ${SemanticsBinding.instance.semanticsEnabled}');
```
## Integration with URL Routing
For deep-linkable test scenarios, semantic IDs work with URL query parameters:
```
/control-room/containers?selected=abc123
```
Automation can:
1. Navigate to URL with query params
2. Verify selection state via `dataGrid_row_abc123_checkbox` (checked: true)
3. Interact with selected rows via semantic IDs
See [URL Routing](#url-routing) section for query parameter patterns.
## Checklist for New Features
When adding a new feature, ensure semantic coverage:
- [ ] Add semantic ID class to `semantic_ids.dart`
- [ ] Wrap all buttons with `Semantics` + `identifier`
- [ ] Wrap all inputs with `Semantics` + `identifier`
- [ ] Wrap list/grid items with dynamic IDs
- [ ] Add labels for accessibility
- [ ] Test that IDs appear in accessibility snapshot
- [ ] Document IDs in this file if they establish new patterns
+2 -3
View File
@@ -2,7 +2,6 @@ import 'package:dio/dio.dart';
import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:tatlock_ui/core/api/api_interceptors.dart';
import 'package:tatlock_ui/core/config/app_config.dart';
import 'package:tatlock_ui/core/providers/annotations.dart';
import 'api_client_native.dart' if (dart.library.html) 'api_client_web.dart'
as platform;
@@ -10,7 +9,7 @@ import 'api_client_native.dart' if (dart.library.html) 'api_client_web.dart'
part 'api_client.g.dart';
/// Provides the Dio instance for Core API.
@persistentRiverpod
@riverpod
Dio coreApiClient(Ref ref) {
final options = BaseOptions(
baseUrl: AppConfig.coreApiUrl,
@@ -34,7 +33,7 @@ Dio coreApiClient(Ref ref) {
}
/// Provides the Dio instance for Tatlock API.
@persistentRiverpod
@riverpod
Dio tatlockApiClient(Ref ref) {
final options = BaseOptions(
baseUrl: AppConfig.tatlockApiUrl,
+20 -6
View File
@@ -10,7 +10,8 @@ import 'package:tatlock_ui/core/error/app_exception.dart';
/// Adds authentication token to requests.
///
/// - **LAN mode**: Skipped entirely (no auth required)
/// - **Web + Mobile**: Adds Bearer token from OIDC authentication
/// - **Web**: Skipped (cookies handle auth via NPM forward auth)
/// - **Mobile**: Adds Bearer token from OIDC authentication
class AuthInterceptor extends Interceptor {
AuthInterceptor(this._ref);
@@ -24,11 +25,17 @@ class AuthInterceptor extends Interceptor {
return;
}
// Add Bearer token for all platforms (web + mobile)
// Skip Bearer token on web - cookies handle auth via NPM forward auth
if (kIsWeb) {
handler.next(options);
return;
}
// Mobile: Add Bearer token from OIDC authentication
final authState = _ref.read(authProvider);
authState.whenData((auth) {
if (auth.isAuthenticated && auth.accessToken != null) {
if (auth.isAuthenticated && auth.accessToken != null && auth.accessToken != 'web-session') {
options.headers['Authorization'] = 'Bearer ${auth.accessToken}';
}
});
@@ -38,9 +45,16 @@ class AuthInterceptor extends Interceptor {
@override
void onError(DioException err, ErrorInterceptorHandler handler) {
// Don't auto-signout on 401 - let calling code handle auth errors gracefully.
// Auto-signout was causing issues (e.g., theme toggle triggering logout when
// preferences API returned 401).
// Skip auth error handling for LAN development
if (!AppConfig.requiresAuth) {
handler.next(err);
return;
}
if (err.response?.statusCode == 401) {
// Token expired - trigger re-authentication
_ref.read(authProvider.notifier).signOut();
}
handler.next(err);
}
}
-288
View File
@@ -1,288 +0,0 @@
import 'dart:convert' show jsonDecode, jsonEncode;
import 'dart:developer' as developer;
import 'package:dio/dio.dart';
import 'package:flutter/foundation.dart' show kIsWeb;
import 'package:shared_preferences/shared_preferences.dart';
import '../config/app_config.dart';
import 'auth_datasource.dart';
import 'auth_state.dart';
import 'oidc_service_web.dart';
import 'permissions.dart';
import 'user_preferences.dart';
import 'web_utils.dart' as web_utils;
/// Standalone auth controller that handles OIDC flow before app starts.
///
/// This runs outside of Riverpod to avoid lifecycle issues. Call [initialize]
/// in main() before runApp(). The controller will:
/// 1. Handle callback if on /callback route (exchange code, sync, store tokens)
/// 2. Check for valid stored tokens
/// 3. Redirect to silent OIDC if no tokens (app won't continue)
///
/// Once auth is complete, [AuthProvider] can simply read the stored tokens.
class AuthController {
// Storage keys (same as AuthProvider)
static const _accessTokenKey = 'auth_access_token';
static const _refreshTokenKey = 'auth_refresh_token';
static const _expiresAtKey = 'auth_expires_at';
static const _userIdKey = 'auth_user_id';
static const _authentikIdKey = 'auth_authentik_id';
static const _userNameKey = 'auth_user_name';
static const _userEmailKey = 'auth_user_email';
static const _avatarUrlKey = 'auth_avatar_url';
static const _rolesKey = 'auth_roles';
static const _preferencesKey = 'auth_preferences';
/// Initialize auth before app starts.
///
/// Returns true if auth is ready (tokens available).
/// Returns false if redirecting (app should not continue).
/// Throws on error.
static Future<bool> initialize() async {
// Skip auth entirely for LAN mode
if (!AppConfig.requiresAuth) {
developer.log('Auth not required (LAN mode)', name: 'auth_controller');
return true;
}
// Only handle web auth here - mobile uses different flow
if (!kIsWeb) {
developer.log('Non-web platform, skipping controller init', name: 'auth_controller');
return true;
}
final currentUrl = web_utils.getCurrentUrl();
developer.log('Auth controller init, URL: $currentUrl', name: 'auth_controller');
// Check if we're on the callback route
if (currentUrl.contains('/callback')) {
return _handleCallback(currentUrl);
}
// Check for valid stored tokens
final prefs = await SharedPreferences.getInstance();
final accessToken = prefs.getString(_accessTokenKey);
if (accessToken != null) {
final expiresAtMs = prefs.getInt(_expiresAtKey);
final expiresAt = expiresAtMs != null
? DateTime.fromMillisecondsSinceEpoch(expiresAtMs)
: null;
if (expiresAt == null || expiresAt.isAfter(DateTime.now())) {
developer.log('Valid tokens found', name: 'auth_controller');
return true; // Auth ready
}
developer.log('Tokens expired', name: 'auth_controller');
}
// No valid tokens - initiate silent OIDC
developer.log('No valid tokens, starting silent OIDC', name: 'auth_controller');
await _initiateSilentOidc();
return false; // Redirecting, app should not continue
}
/// Handle the OIDC callback.
static Future<bool> _handleCallback(String url) async {
final uri = Uri.parse(url);
final code = uri.queryParameters['code'];
final state = uri.queryParameters['state'];
final error = uri.queryParameters['error'];
developer.log('Handling callback: code=${code != null}, error=$error', name: 'auth_controller');
// Handle errors
if (error != null) {
if (error == 'login_required') {
// Silent auth failed - no session, start regular OIDC
developer.log('Silent auth failed (login_required), starting regular OIDC', name: 'auth_controller');
await _initiateRegularOidc();
return false;
}
throw Exception('Auth error: $error - ${uri.queryParameters['error_description']}');
}
if (code == null || state == null) {
throw Exception('Invalid callback - missing code or state');
}
// Exchange code for tokens
developer.log('Exchanging code for tokens', name: 'auth_controller');
final oidcService = OidcServiceWeb();
final tokens = await oidcService.exchangeCode(code, state);
// Sync with core-api
developer.log('Syncing with core-api', name: 'auth_controller');
final dio = Dio(BaseOptions(
baseUrl: AppConfig.coreApiUrl,
headers: {
'Content-Type': 'application/json',
'Accept': 'application/json',
},
));
final authDatasource = AuthDatasource(dio);
final syncResponse = await authDatasource.syncUser(tokens.accessToken);
developer.log('Synced user: ${syncResponse.name}', name: 'auth_controller');
// Store credentials
await _storeAuth(
accessToken: tokens.accessToken,
refreshToken: tokens.refreshToken,
expiresAt: tokens.expiresAt,
userId: syncResponse.userId,
authentikId: syncResponse.authentikId,
userName: syncResponse.name,
userEmail: syncResponse.email,
avatarUrl: syncResponse.avatarUrl,
roles: syncResponse.roles,
preferences: syncResponse.preferences,
);
// Redirect to home (removes callback params from URL)
developer.log('Auth complete, redirecting to home', name: 'auth_controller');
web_utils.redirectTo('/');
return false; // Redirecting
}
/// Initiate silent OIDC (prompt=none).
static Future<void> _initiateSilentOidc() async {
final oidcService = OidcServiceWeb();
final authUrl = await oidcService.getAuthorizationUrl(silent: true);
developer.log('Redirecting to silent OIDC', name: 'auth_controller');
web_utils.redirectTo(authUrl);
}
/// Initiate regular OIDC (shows login UI).
static Future<void> _initiateRegularOidc() async {
final oidcService = OidcServiceWeb();
final authUrl = await oidcService.getAuthorizationUrl(silent: false);
developer.log('Redirecting to regular OIDC', name: 'auth_controller');
web_utils.redirectTo(authUrl);
}
/// Store auth data.
static Future<void> _storeAuth({
required String accessToken,
String? refreshToken,
DateTime? expiresAt,
String? userId,
String? authentikId,
String? userName,
String? userEmail,
String? avatarUrl,
List<Role>? roles,
UserPreferences? preferences,
}) async {
final prefs = await SharedPreferences.getInstance();
await prefs.setString(_accessTokenKey, accessToken);
if (refreshToken != null) {
await prefs.setString(_refreshTokenKey, refreshToken);
}
if (expiresAt != null) {
await prefs.setInt(_expiresAtKey, expiresAt.millisecondsSinceEpoch);
}
if (userId != null) await prefs.setString(_userIdKey, userId);
if (authentikId != null) await prefs.setString(_authentikIdKey, authentikId);
if (userName != null) await prefs.setString(_userNameKey, userName);
if (userEmail != null) await prefs.setString(_userEmailKey, userEmail);
if (avatarUrl != null) await prefs.setString(_avatarUrlKey, avatarUrl);
if (roles != null) {
final rolesJson = jsonEncode(roles.map((r) => {
'id': r.id,
'name': r.name,
'domain': r.domain.value,
'category': r.category,
'action': r.action.name,
}).toList());
await prefs.setString(_rolesKey, rolesJson);
}
if (preferences != null) {
await prefs.setString(_preferencesKey, jsonEncode(preferences.toJson()));
}
}
/// Load stored auth state (for AuthProvider to use).
static Future<AuthState> loadStoredAuth() async {
try {
final prefs = await SharedPreferences.getInstance();
final accessToken = prefs.getString(_accessTokenKey);
if (accessToken == null) {
return const AuthState();
}
final expiresAtMs = prefs.getInt(_expiresAtKey);
final expiresAt = expiresAtMs != null
? DateTime.fromMillisecondsSinceEpoch(expiresAtMs)
: null;
final rolesJson = prefs.getString(_rolesKey);
final roles = rolesJson != null ? _parseRoles(rolesJson) : <Role>[];
final prefsJson = prefs.getString(_preferencesKey);
final preferences = prefsJson != null
? UserPreferences.fromJson(jsonDecode(prefsJson) as Map<String, dynamic>)
: null;
return AuthState(
isAuthenticated: true,
accessToken: accessToken,
refreshToken: prefs.getString(_refreshTokenKey),
expiresAt: expiresAt,
userId: prefs.getString(_userIdKey),
authentikId: prefs.getString(_authentikIdKey),
userName: prefs.getString(_userNameKey),
userEmail: prefs.getString(_userEmailKey),
avatarUrl: prefs.getString(_avatarUrlKey),
roles: roles,
preferences: preferences,
);
} catch (e) {
developer.log('Failed to load stored auth: $e', name: 'auth_controller');
return const AuthState();
}
}
static List<Role> _parseRoles(String json) {
try {
final list = jsonDecode(json) as List<dynamic>;
return list.map((item) {
final map = item as Map<String, dynamic>;
final domain = Domain.fromString(map['domain'] as String);
final action = Action.fromString(map['action'] as String);
if (domain == null || action == null) return null;
return Role(
id: map['id'] as String,
name: map['name'] as String,
domain: domain,
category: map['category'] as String? ?? 'general',
action: action,
);
}).whereType<Role>().toList();
} catch (e) {
return [];
}
}
/// Clear stored auth (for logout).
static Future<void> clearAuth() async {
final prefs = await SharedPreferences.getInstance();
await prefs.remove(_accessTokenKey);
await prefs.remove(_refreshTokenKey);
await prefs.remove(_expiresAtKey);
await prefs.remove(_userIdKey);
await prefs.remove(_authentikIdKey);
await prefs.remove(_userNameKey);
await prefs.remove(_userEmailKey);
await prefs.remove(_avatarUrlKey);
await prefs.remove(_rolesKey);
await prefs.remove(_preferencesKey);
}
}
+85 -114
View File
@@ -1,31 +1,29 @@
import 'dart:convert' show jsonDecode, jsonEncode;
import 'dart:convert';
import 'dart:developer' as developer;
import 'package:dio/dio.dart';
import 'package:flutter/foundation.dart' show kIsWeb;
import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:shared_preferences/shared_preferences.dart';
import '../config/app_config.dart';
import '../providers/annotations.dart';
import 'auth_datasource.dart';
import 'auth_state.dart';
import 'oidc_service.dart';
import 'oidc_service_web.dart';
import 'permissions.dart';
import 'user_preferences.dart';
import 'web_utils.dart' as web_utils;
part 'auth_provider.g.dart';
/// Provides authentication state and operations.
///
/// Supports OIDC Authorization Code flow with PKCE on all platforms:
/// - **Web**: Browser redirect to Authentik, callback via /callback route
/// - **Mobile**: flutter_appauth with custom URL scheme
/// Supports two authentication flows:
/// - **Web**: NPM forward auth with Authentik (cookies handled by proxy)
/// - **Mobile**: OIDC Authorization Code flow with flutter_appauth
///
/// After OIDC authentication, syncs with core-api via POST /auth/sync
/// to get user profile, roles, and preferences.
@persistentRiverpod
/// On web, the app calls GET /auth/me to check if user is authenticated
/// via NPM forward auth headers. On mobile, uses OIDC flow then POST /auth/sync.
@riverpod
class AuthNotifier extends _$AuthNotifier {
// Storage keys
static const _accessTokenKey = 'auth_access_token';
@@ -41,12 +39,71 @@ class AuthNotifier extends _$AuthNotifier {
@override
Future<AuthState> build() async {
// AuthController.initialize() in main() handles OIDC flow before app starts.
// By the time we get here, tokens are already stored (or we're in LAN mode).
// Just load the stored auth state.
// On web with auth required, try to get user from NPM forward auth
if (kIsWeb && AppConfig.requiresAuth) {
final webAuth = await _tryWebAuth();
if (webAuth != null) {
return webAuth;
}
// If web auth failed, user needs to refresh to trigger NPM login
developer.log('Web auth not available - user may need to login via proxy', name: 'auth');
return const AuthState();
}
// On mobile or LAN, load from stored auth
return _loadStoredAuth();
}
/// Try to authenticate via NPM forward auth (web only).
///
/// Returns AuthState if authenticated, null if not.
Future<AuthState?> _tryWebAuth() async {
try {
developer.log('Attempting web auth via /auth/me', name: 'auth');
final authDatasource = ref.read(authDatasourceProvider);
final syncResponse = await authDatasource.getCurrentUser();
developer.log(
'Web auth successful: ${syncResponse.name} with ${syncResponse.roles.length} roles',
name: 'auth',
);
// Store auth data for offline/cached access
await _storeAuth(
accessToken: 'web-session', // Placeholder - web uses cookies
userId: syncResponse.userId,
authentikId: syncResponse.authentikId,
userName: syncResponse.name,
userEmail: syncResponse.email,
avatarUrl: syncResponse.avatarUrl,
roles: syncResponse.roles,
preferences: syncResponse.preferences,
);
return AuthState(
isAuthenticated: true,
accessToken: 'web-session',
userId: syncResponse.userId,
authentikId: syncResponse.authentikId,
userName: syncResponse.name,
userEmail: syncResponse.email,
avatarUrl: syncResponse.avatarUrl,
roles: syncResponse.roles,
preferences: syncResponse.preferences,
);
} on DioException catch (e) {
if (e.response?.statusCode == 401) {
developer.log('Web auth: not authenticated via proxy', name: 'auth');
return null;
}
developer.log('Web auth error: $e', name: 'auth');
return null;
} catch (e) {
developer.log('Web auth unexpected error: $e', name: 'auth');
return null;
}
}
Future<AuthState> _loadStoredAuth() async {
try {
final prefs = await SharedPreferences.getInstance();
@@ -167,7 +224,7 @@ class AuthNotifier extends _$AuthNotifier {
/// Sign in with the appropriate method for the platform.
///
/// - **Web**: Redirects to Authentik for OIDC authentication
/// - **Web**: Triggers page reload to go through NPM forward auth
/// - **Mobile**: Opens Authentik login via OIDC, then syncs with core-api
Future<void> signIn() async {
if (!AppConfig.requiresAuth) {
@@ -177,25 +234,25 @@ class AuthNotifier extends _$AuthNotifier {
return;
}
// Web: Use OIDC flow with browser redirect
// On web, auth is handled by NPM forward auth
// User needs to access via the authenticated proxy URL
if (kIsWeb) {
developer.log('Web sign-in: starting OIDC flow', name: 'auth');
developer.log('Web sign-in: user should access via authenticated proxy', name: 'auth');
// Try to refresh auth state from /auth/me
state = const AsyncLoading();
try {
final oidcService = OidcServiceWeb();
final authUrl = await oidcService.getAuthorizationUrl();
developer.log('Redirecting to: $authUrl', name: 'auth');
web_utils.redirectTo(authUrl);
// Browser will redirect, so we don't update state here
} catch (e, stack) {
developer.log('Failed to start OIDC flow: $e', name: 'auth');
state = AsyncError(e, stack);
final webAuth = await _tryWebAuth();
if (webAuth != null) {
state = AsyncData(webAuth);
} else {
state = AsyncError(
Exception('Not authenticated - please access via the authenticated URL'),
StackTrace.current,
);
}
return;
}
// Mobile: Use OIDC flow with flutter_appauth
// Mobile: Use OIDC flow
state = const AsyncLoading();
try {
@@ -250,97 +307,11 @@ class AuthNotifier extends _$AuthNotifier {
}
}
/// Handle OIDC callback after Authentik redirects back (web only).
///
/// [code] is the authorization code from the callback URL.
/// [state] is the state parameter for CSRF verification.
Future<void> handleOidcCallback(String code, String callbackState) async {
if (!kIsWeb) {
developer.log('handleOidcCallback called on non-web platform', name: 'auth');
return;
}
developer.log('Handling OIDC callback', name: 'auth');
state = const AsyncLoading();
try {
// Step 1: Exchange code for tokens
final oidcService = OidcServiceWeb();
final tokens = await oidcService.exchangeCode(code, callbackState);
// Step 2: Sync with core-api to get user profile and roles
developer.log('Syncing with core-api', name: 'auth');
final authDatasource = ref.read(authDatasourceProvider);
final syncResponse = await authDatasource.syncUser(tokens.accessToken);
developer.log(
'Synced user: ${syncResponse.name} with ${syncResponse.roles.length} roles',
name: 'auth',
);
// Step 3: Store credentials and user data from sync response
await _storeAuth(
accessToken: tokens.accessToken,
refreshToken: tokens.refreshToken,
expiresAt: tokens.expiresAt,
userId: syncResponse.userId,
authentikId: syncResponse.authentikId,
userName: syncResponse.name,
userEmail: syncResponse.email,
avatarUrl: syncResponse.avatarUrl,
roles: syncResponse.roles,
preferences: syncResponse.preferences,
);
state = AsyncData(AuthState(
isAuthenticated: true,
accessToken: tokens.accessToken,
refreshToken: tokens.refreshToken,
expiresAt: tokens.expiresAt,
userId: syncResponse.userId,
authentikId: syncResponse.authentikId,
userName: syncResponse.name,
userEmail: syncResponse.email,
avatarUrl: syncResponse.avatarUrl,
roles: syncResponse.roles,
preferences: syncResponse.preferences,
));
developer.log('Authenticated as ${syncResponse.name}', name: 'auth');
// Clean up the URL by removing the query parameters
web_utils.replaceUrl('/');
} on OidcException catch (e) {
developer.log('OIDC callback failed: $e', name: 'auth');
state = AsyncError(e, StackTrace.current);
} catch (e, stack) {
developer.log('Callback handling failed: $e', name: 'auth');
state = AsyncError(e, stack);
}
}
/// Sign out and clear stored credentials.
///
/// On web, also redirects to Authentik's logout endpoint to end the SSO session.
Future<void> signOut() async {
// Clear local storage first
await _clearStoredAuth();
state = const AsyncData(AuthState());
developer.log('Signed out locally', name: 'auth');
// On web, redirect to Authentik logout to end SSO session
if (kIsWeb && AppConfig.requiresAuth) {
try {
final oidcService = OidcServiceWeb();
final logoutUrl = await oidcService.getLogoutUrl();
developer.log('Redirecting to Authentik logout', name: 'auth');
web_utils.redirectTo(logoutUrl);
} catch (e) {
developer.log('Failed to get logout URL: $e', name: 'auth');
// Local logout already done, just reload to trigger re-auth
web_utils.redirectTo('/');
}
}
developer.log('Signed out', name: 'auth');
}
/// Update user preferences.
-245
View File
@@ -1,245 +0,0 @@
import 'dart:async';
import 'dart:convert';
import 'dart:developer' as developer;
import 'dart:math';
import 'package:crypto/crypto.dart';
import 'package:dio/dio.dart';
import '../config/app_config.dart';
import 'oidc_service.dart';
import 'web_utils.dart' as web_utils;
/// Web implementation of OIDC service using browser redirect flow.
///
/// Uses Authorization Code flow with PKCE for secure authentication.
/// On web, we can't use flutter_appauth, so we implement the flow manually
/// using browser redirects and URL parsing.
class OidcServiceWeb implements OidcService {
OidcServiceWeb({Dio? dio}) : _dio = dio ?? Dio();
final Dio _dio;
/// OIDC scopes to request.
static const _scopes = ['openid', 'profile', 'email', 'offline_access'];
/// Redirect URI for web.
static String get _redirectUri => '${AppConfig.webBaseUrl}/callback';
// SessionStorage keys for PKCE state (persists across redirect)
static const _codeVerifierKey = 'oidc_code_verifier';
static const _stateKey = 'oidc_state';
/// Get the authorization URL to redirect the browser to.
///
/// Returns a URL that the browser should navigate to for authentication.
/// The [codeVerifier] and [state] are stored for later verification.
///
/// If [silent] is true, adds `prompt=none` to skip login UI.
/// This is used when the user already has an Authentik session (via NPM).
/// Authentik will instantly redirect back with a code, or return an error
/// if there's no valid session.
Future<String> getAuthorizationUrl({bool silent = false}) async {
// Fetch OIDC discovery document
final discovery = await _fetchDiscovery();
final authEndpoint = discovery['authorization_endpoint'] as String;
// Generate PKCE code verifier and challenge
final codeVerifier = _generateCodeVerifier();
final codeChallenge = _generateCodeChallenge(codeVerifier);
// Generate state for CSRF protection
final state = _generateRandomString(32);
// Store PKCE state in sessionStorage (persists across redirect)
web_utils.setSessionStorage(_codeVerifierKey, codeVerifier);
web_utils.setSessionStorage(_stateKey, state);
// Build authorization URL
final params = {
'client_id': AppConfig.authClientId,
'redirect_uri': _redirectUri,
'response_type': 'code',
'scope': _scopes.join(' '),
'code_challenge': codeChallenge,
'code_challenge_method': 'S256',
'state': state,
if (silent) 'prompt': 'none', // Silent auth - no UI, instant redirect
};
final uri = Uri.parse(authEndpoint).replace(queryParameters: params);
developer.log('Authorization URL (silent=$silent): $uri', name: 'oidc_web');
return uri.toString();
}
/// Exchange authorization code for tokens.
///
/// Call this after the browser redirects back with the authorization code.
/// [code] is the authorization code from the callback URL.
/// [state] is the state parameter from the callback URL (verified for CSRF).
Future<OidcTokens> exchangeCode(String code, String state) async {
// Retrieve PKCE state from sessionStorage
final storedState = web_utils.getSessionStorage(_stateKey);
final codeVerifier = web_utils.getSessionStorage(_codeVerifierKey);
developer.log('Stored state: $storedState, received state: $state', name: 'oidc_web');
developer.log('Code verifier present: ${codeVerifier != null}', name: 'oidc_web');
// Verify state matches
if (storedState == null || state != storedState) {
_clearPkceState();
throw OidcException('State mismatch - possible CSRF attack');
}
if (codeVerifier == null) {
_clearPkceState();
throw OidcException('No code verifier - flow not started properly');
}
try {
// Fetch token endpoint from discovery
final discovery = await _fetchDiscovery();
final tokenEndpoint = discovery['token_endpoint'] as String;
developer.log('Exchanging code at: $tokenEndpoint', name: 'oidc_web');
// Exchange code for tokens
final response = await _dio.post<Map<String, dynamic>>(
tokenEndpoint,
data: {
'grant_type': 'authorization_code',
'client_id': AppConfig.authClientId,
'redirect_uri': _redirectUri,
'code': code,
'code_verifier': codeVerifier,
},
options: Options(
contentType: Headers.formUrlEncodedContentType,
),
);
final data = response.data!;
developer.log('Token exchange successful', name: 'oidc_web');
// Clear stored PKCE state
_clearPkceState();
return OidcTokens(
accessToken: data['access_token'] as String,
refreshToken: data['refresh_token'] as String?,
expiresAt: DateTime.now().add(
Duration(seconds: data['expires_in'] as int? ?? 3600),
),
idToken: data['id_token'] as String?,
);
} on DioException catch (e) {
developer.log('Token exchange failed: $e', name: 'oidc_web');
_clearPkceState();
throw OidcException('Token exchange failed: ${e.message}');
}
}
/// Clear PKCE state from sessionStorage.
void _clearPkceState() {
web_utils.removeSessionStorage(_codeVerifierKey);
web_utils.removeSessionStorage(_stateKey);
}
/// Not used on web - use [getAuthorizationUrl] and [exchangeCode] instead.
@override
Future<OidcTokens> signIn() async {
throw OidcException(
'signIn() not supported on web. Use getAuthorizationUrl() and exchangeCode() instead.',
);
}
/// Refresh the access token using a refresh token.
@override
Future<OidcTokens> refreshToken(String refreshToken) async {
try {
final discovery = await _fetchDiscovery();
final tokenEndpoint = discovery['token_endpoint'] as String;
final response = await _dio.post<Map<String, dynamic>>(
tokenEndpoint,
data: {
'grant_type': 'refresh_token',
'client_id': AppConfig.authClientId,
'refresh_token': refreshToken,
},
options: Options(
contentType: Headers.formUrlEncodedContentType,
),
);
final data = response.data!;
return OidcTokens(
accessToken: data['access_token'] as String,
refreshToken: data['refresh_token'] as String? ?? refreshToken,
expiresAt: DateTime.now().add(
Duration(seconds: data['expires_in'] as int? ?? 3600),
),
idToken: data['id_token'] as String?,
);
} on DioException catch (e) {
throw OidcException('Token refresh failed: ${e.message}');
}
}
/// Fetch OIDC discovery document.
Future<Map<String, dynamic>> _fetchDiscovery() async {
final response = await _dio.get<Map<String, dynamic>>(
AppConfig.authDiscoveryUrl,
);
return response.data!;
}
/// Generate a random code verifier for PKCE.
String _generateCodeVerifier() {
return _generateRandomString(64);
}
/// Generate code challenge from verifier using S256.
String _generateCodeChallenge(String verifier) {
final bytes = utf8.encode(verifier);
final digest = sha256.convert(bytes);
return base64Url.encode(digest.bytes).replaceAll('=', '');
}
/// Generate a random string of given length.
String _generateRandomString(int length) {
const chars =
'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~';
final random = Random.secure();
return List.generate(length, (_) => chars[random.nextInt(chars.length)])
.join();
}
/// Get the logout URL to redirect the browser to for SSO logout.
///
/// [idToken] is optional but recommended for logout verification.
/// After logout, Authentik redirects back to [postLogoutRedirectUri].
Future<String> getLogoutUrl({String? idToken}) async {
final discovery = await _fetchDiscovery();
final endSessionEndpoint = discovery['end_session_endpoint'] as String?;
if (endSessionEndpoint == null) {
// Fallback: just redirect to home, local state already cleared
developer.log('No end_session_endpoint in discovery', name: 'oidc_web');
return AppConfig.webBaseUrl;
}
final params = <String, String>{
'post_logout_redirect_uri': AppConfig.webBaseUrl,
};
if (idToken != null) {
params['id_token_hint'] = idToken;
}
final uri = Uri.parse(endSessionEndpoint).replace(queryParameters: params);
developer.log('Logout URL: $uri', name: 'oidc_web');
return uri.toString();
}
}
-7
View File
@@ -1,7 +0,0 @@
/// Web utilities with conditional imports.
///
/// Uses stub implementation on non-web platforms.
library;
export 'web_utils_stub.dart'
if (dart.library.js_interop) 'web_utils_web.dart';
-32
View File
@@ -1,32 +0,0 @@
/// Stub for non-web platforms.
library;
/// Redirect to a URL (no-op on non-web).
void redirectTo(String url) {
throw UnsupportedError('redirectTo is only supported on web');
}
/// Get current URL (no-op on non-web).
String getCurrentUrl() {
throw UnsupportedError('getCurrentUrl is only supported on web');
}
/// Replace current URL without navigation (no-op on non-web).
void replaceUrl(String url) {
throw UnsupportedError('replaceUrl is only supported on web');
}
/// Store a value in sessionStorage (no-op on non-web).
void setSessionStorage(String key, String value) {
throw UnsupportedError('setSessionStorage is only supported on web');
}
/// Get a value from sessionStorage (no-op on non-web).
String? getSessionStorage(String key) {
throw UnsupportedError('getSessionStorage is only supported on web');
}
/// Remove a value from sessionStorage (no-op on non-web).
void removeSessionStorage(String key) {
throw UnsupportedError('removeSessionStorage is only supported on web');
}
-34
View File
@@ -1,34 +0,0 @@
/// Web-specific utilities for browser operations.
library;
import 'package:web/web.dart' as web;
/// Redirect the browser to a URL.
void redirectTo(String url) {
web.window.location.href = url;
}
/// Get the current browser URL.
String getCurrentUrl() {
return web.window.location.href;
}
/// Replace the current URL in history without navigation.
void replaceUrl(String url) {
web.window.history.replaceState(null, '', url);
}
/// Store a value in sessionStorage.
void setSessionStorage(String key, String value) {
web.window.sessionStorage.setItem(key, value);
}
/// Get a value from sessionStorage.
String? getSessionStorage(String key) {
return web.window.sessionStorage.getItem(key);
}
/// Remove a value from sessionStorage.
void removeSessionStorage(String key) {
web.window.sessionStorage.removeItem(key);
}
+1 -7
View File
@@ -45,18 +45,12 @@ class AppConfig {
defaultValue: 'tatlock-ui',
);
/// Authentik redirect URI scheme (for mobile/native)
/// Authentik redirect URI scheme
static const authRedirectScheme = String.fromEnvironment(
'AUTH_REDIRECT_SCHEME',
defaultValue: 'net.schweitz.tatlock',
);
/// Web app base URL (for OIDC redirect URI on web)
static const webBaseUrl = String.fromEnvironment(
'WEB_BASE_URL',
defaultValue: 'https://home.schweitz.net',
);
/// Whether running in debug mode
static const isDebug = bool.fromEnvironment('DEBUG', defaultValue: false);
-5
View File
@@ -1,5 +0,0 @@
/// URL strategy with conditional imports for web/non-web platforms.
library;
export 'url_strategy_stub.dart'
if (dart.library.js_interop) 'url_strategy_web.dart';
-4
View File
@@ -1,4 +0,0 @@
/// Stub for non-web platforms - does nothing.
void configureUrlStrategy() {
// No-op on mobile/desktop
}
-10
View File
@@ -1,10 +0,0 @@
/// Web-specific URL strategy configuration.
library;
import 'package:flutter_web_plugins/url_strategy.dart';
void configureUrlStrategy() {
// Use path-based URLs instead of hash-based (e.g., /login instead of /#/login)
// Required for OIDC callback to work properly
usePathUrlStrategy();
}
-15
View File
@@ -1,15 +0,0 @@
import 'package:riverpod_annotation/riverpod_annotation.dart';
/// Riverpod annotation for providers that should persist for the app lifetime.
///
/// Use this instead of `@riverpod` when:
/// - The provider holds app-level state (theme, auth, config)
/// - The provider stores a Ref that must remain valid (API clients with interceptors)
/// - Disposing would cause flickering or re-initialization issues
///
/// Example:
/// ```dart
/// @persistentRiverpod
/// class ThemeNotifier extends _$ThemeNotifier { ... }
/// ```
const persistentRiverpod = Riverpod(keepAlive: true);
-125
View File
@@ -1,125 +0,0 @@
/// Semantic identifiers for UI automation and accessibility.
///
/// These IDs are exposed via Flutter's Semantics tree, making widgets
/// discoverable by automation tools (Appium, WebDriver, Puppeteer with
/// accessibility enabled).
///
/// Naming convention: `{area}_{component}_{identifier}`
/// - area: room or feature area (e.g., profile, nav, dataGrid)
/// - component: widget type (e.g., menu, button, row)
/// - identifier: specific item (e.g., light, containers, selectAll)
library;
/// Profile dropdown menu IDs.
abstract class ProfileSemantics {
static const button = 'profile_button';
static const menu = 'profile_menu';
static const settings = 'profile_menu_settings';
static const themeSystem = 'profile_menu_theme_system';
static const themeLight = 'profile_menu_theme_light';
static const themeDark = 'profile_menu_theme_dark';
static const logout = 'profile_menu_logout';
}
/// Room tab navigation IDs.
abstract class RoomTabSemantics {
static const frontHall = 'roomTab_frontHall';
static const controlRoom = 'roomTab_controlRoom';
static const security = 'roomTab_security';
static const parlor = 'roomTab_parlor';
/// Get semantic ID for room index.
static String forIndex(int index) => switch (index) {
0 => frontHall,
1 => controlRoom,
2 => security,
3 => parlor,
_ => 'roomTab_$index',
};
}
/// Navigation panel IDs.
abstract class NavSemantics {
static const panel = 'nav_panel';
static const refresh = 'nav_refresh';
/// Generate ID for a nav item.
static String item(String id) => 'nav_item_$id';
/// Generate ID for a nav section.
static String section(String id) => 'nav_section_$id';
}
/// DataGrid component IDs.
abstract class DataGridSemantics {
static const grid = 'dataGrid';
static const search = 'dataGrid_search';
static const searchClear = 'dataGrid_search_clear';
static const selectAll = 'dataGrid_selectAll';
static const loading = 'dataGrid_loading';
static const empty = 'dataGrid_empty';
static const error = 'dataGrid_error';
static const refresh = 'dataGrid_refresh';
/// Generate ID for a column header.
static String header(String columnId) => 'dataGrid_header_$columnId';
/// Generate ID for a row.
static String row(String itemId) => 'dataGrid_row_$itemId';
/// Generate ID for a row checkbox.
static String rowCheckbox(String itemId) => 'dataGrid_row_${itemId}_checkbox';
/// Generate ID for a row actions menu.
static String rowActions(String itemId) => 'dataGrid_row_${itemId}_actions';
/// Generate ID for a row action.
static String rowAction(String itemId, String actionId) =>
'dataGrid_row_${itemId}_action_$actionId';
/// Generate ID for a bulk action button.
static String bulkAction(String actionId) => 'dataGrid_bulk_$actionId';
static const bulkClear = 'dataGrid_bulk_clear';
}
/// Dialog/modal IDs.
abstract class DialogSemantics {
static const confirm = 'dialog_confirm';
static const cancel = 'dialog_cancel';
static const close = 'dialog_close';
/// Generate ID for a named dialog.
static String named(String name) => 'dialog_$name';
/// Generate ID for a dialog action button.
static String action(String dialogName, String actionId) =>
'dialog_${dialogName}_$actionId';
}
/// Settings page IDs.
abstract class SettingsSemantics {
static const themeDropdown = 'settings_theme';
static const defaultRoomDropdown = 'settings_defaultRoom';
}
/// Filter panel IDs.
abstract class FilterPanelSemantics {
static const panel = 'filterPanel';
static const search = 'filterPanel_search';
static const searchClear = 'filterPanel_search_clear';
static const refresh = 'filterPanel_refresh';
/// Generate ID for a filter item.
static String item(String id) => 'filterPanel_item_$id';
}
/// Loading/state indicator IDs.
abstract class StateSemantics {
static const authLoading = 'state_auth_loading';
static const authError = 'state_auth_error';
static const pageLoading = 'state_page_loading';
/// Generate ID for a snackbar.
static String snackbar(String type) => 'snackbar_$type';
}
-118
View File
@@ -1,118 +0,0 @@
import 'package:flutter/material.dart';
/// Wraps a widget with semantic information for accessibility and automation.
///
/// Usage:
/// ```dart
/// SemanticWidget(
/// id: ProfileSemantics.button,
/// label: 'Open profile menu',
/// child: IconButton(...),
/// )
/// ```
///
/// For buttons, use `button: true`. For other interactive elements,
/// set the appropriate semantic properties.
class SemanticWidget extends StatelessWidget {
const SemanticWidget({
super.key,
required this.id,
required this.child,
this.label,
this.hint,
this.button = false,
this.link = false,
this.header = false,
this.textField = false,
this.enabled = true,
this.selected,
this.checked,
this.value,
this.excludeSemantics = false,
});
/// Unique identifier for this widget, exposed via [SemanticsProperties.identifier].
final String id;
/// The widget to wrap.
final Widget child;
/// Accessibility label describing the widget.
final String? label;
/// Hint text for screen readers.
final String? hint;
/// Whether this widget represents a button.
final bool button;
/// Whether this widget represents a link.
final bool link;
/// Whether this widget represents a header.
final bool header;
/// Whether this widget represents a text field.
final bool textField;
/// Whether the widget is enabled.
final bool enabled;
/// Whether the widget is selected (for toggle buttons, tabs).
final bool? selected;
/// Whether the widget is checked (for checkboxes).
final bool? checked;
/// Current value (for sliders, progress indicators).
final String? value;
/// Whether to exclude child semantics.
final bool excludeSemantics;
@override
Widget build(BuildContext context) {
return Semantics(
identifier: id,
label: label,
hint: hint,
button: button,
link: link,
header: header,
textField: textField,
enabled: enabled,
selected: selected,
checked: checked,
value: value,
excludeSemantics: excludeSemantics,
child: child,
);
}
}
/// Extension to easily wrap any widget with semantic info.
extension SemanticExtension on Widget {
/// Wraps this widget with a semantic identifier.
Widget withSemantics({
required String id,
String? label,
String? hint,
bool button = false,
bool link = false,
bool enabled = true,
bool? selected,
bool? checked,
}) {
return SemanticWidget(
id: id,
label: label,
hint: hint,
button: button,
link: link,
enabled: enabled,
selected: selected,
checked: checked,
child: this,
);
}
}
+1 -43
View File
@@ -1,10 +1,6 @@
import 'dart:developer' as developer;
import 'package:flutter/material.dart';
import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:shared_preferences/shared_preferences.dart';
import 'package:tatlock_ui/core/auth/auth_provider.dart';
import 'package:tatlock_ui/core/providers/annotations.dart';
part 'theme_provider.g.dart';
@@ -21,21 +17,13 @@ enum ThemeSetting {
}
/// Provider for theme setting state.
///
/// Syncs with API preferences when user is authenticated. On login, the theme
/// from API preferences takes precedence over local storage.
@persistentRiverpod
@riverpod
class ThemeNotifier extends _$ThemeNotifier {
static const _prefsKey = 'theme_setting';
@override
ThemeSetting build() {
// Load local setting first for immediate UI
_loadSavedSetting();
// Listen for auth state changes to sync from API preferences
_syncFromAuthPreferences();
return ThemeSetting.system;
}
@@ -51,36 +39,6 @@ class ThemeNotifier extends _$ThemeNotifier {
}
}
/// Listen to auth state and sync theme from API preferences.
void _syncFromAuthPreferences() {
ref.listen(authProvider, (_, next) {
next.whenData((auth) {
final apiTheme = auth.preferences?.theme;
if (apiTheme != null && apiTheme.isNotEmpty) {
try {
final themeSetting = ThemeSetting.values.byName(apiTheme);
if (themeSetting != state) {
developer.log(
'Syncing theme from API: $apiTheme',
name: 'theme',
);
state = themeSetting;
// Also persist to local storage for offline use
_saveToLocalStorage(themeSetting);
}
} catch (_) {
// Invalid theme value from API, keep current
}
}
});
});
}
Future<void> _saveToLocalStorage(ThemeSetting setting) async {
final prefs = await SharedPreferences.getInstance();
await prefs.setString(_prefsKey, setting.name);
}
/// Update theme setting and persist to storage.
Future<void> setSetting(ThemeSetting setting) async {
state = setting;
@@ -1,13 +1,9 @@
import 'dart:async';
import 'package:flutter/material.dart' hide Container;
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:go_router/go_router.dart';
import 'package:tatlock_ui/core/api/api_client.dart';
import 'package:tatlock_ui/features/control_room/containers/presentation/providers/containers_provider.dart';
import 'package:tatlock_ui/features/control_room/containers/presentation/widgets/container_logs_viewer.dart';
import 'package:tatlock_ui/features/control_room/containers/presentation/widgets/container_status_badge.dart';
import 'package:tatlock_ui/routing/url_state.dart';
import 'package:tatlock_ui/shared/components/data_grid/adapters/core_api_source.dart';
import 'package:tatlock_ui/shared/components/data_grid/data_grid_exports.dart';
@@ -105,10 +101,7 @@ class ContainerPort {
/// Page displaying the list of containers using DataGrid.
class ContainersListPage extends ConsumerStatefulWidget {
const ContainersListPage({super.key, this.routerState});
/// Router state for URL deep-linking.
final GoRouterState? routerState;
const ContainersListPage({super.key});
@override
ConsumerState<ContainersListPage> createState() => _ContainersListPageState();
@@ -117,18 +110,10 @@ class ContainersListPage extends ConsumerStatefulWidget {
class _ContainersListPageState extends ConsumerState<ContainersListPage> {
late final StateNotifierProvider<DataGridController<ContainerData>,
DataGridState<ContainerData>> _gridProvider;
late PageUrlState _urlState;
Timer? _urlSyncTimer;
@override
void initState() {
super.initState();
// Parse URL state
_urlState = PageUrlState.fromQueryParams(
widget.routerState?.uri.queryParameters ?? {},
);
final dio = ref.read(coreApiClientProvider);
final source = CoreApiDataSource<ContainerData>(
dio: dio,
@@ -136,68 +121,17 @@ class _ContainersListPageState extends ConsumerState<ContainersListPage> {
fromJson: ContainerData.fromJson,
);
// Initialize grid with URL state
_gridProvider = dataGridProvider<ContainerData>(
source: source,
config: _buildConfig(),
idSelector: (c) => c.id,
initialSearch: _urlState.search,
initialSortColumnIndex: _columnIndexForId(_urlState.sortColumn),
initialSortDescending: _urlState.sortDescending,
);
}
@override
void dispose() {
_urlSyncTimer?.cancel();
super.dispose();
}
/// Find column index by column ID.
int? _columnIndexForId(String? columnId) {
if (columnId == null) return null;
final columns = _buildConfig().columns;
for (var i = 0; i < columns.length; i++) {
if (columns[i].id == columnId) return i;
}
return null;
}
/// Get column ID by index.
String? _columnIdForIndex(int index) {
final columns = _buildConfig().columns;
if (index >= 0 && index < columns.length) {
return columns[index].id;
}
return null;
}
/// Schedule URL sync with debounce.
void _scheduleUrlSync() {
_urlSyncTimer?.cancel();
_urlSyncTimer = Timer(const Duration(milliseconds: 500), _syncUrlParams);
}
/// Sync current state to URL.
void _syncUrlParams() {
final state = ref.read(_gridProvider);
final params = PageUrlState(
search: state.searchQuery.isEmpty ? null : state.searchQuery,
sortColumn: state.sortColumnIndex != null
? _columnIdForIndex(state.sortColumnIndex!)
: null,
sortDescending: state.sortDescending,
).toQueryParams();
updateBrowserUrlParams(params);
}
DataGridConfig<ContainerData> _buildConfig() {
return DataGridConfig<ContainerData>(
columns: [
DataGridColumn<ContainerData>(
id: 'container',
header: 'Container',
valueBuilder: (c) => '${c.name} ${c.image}',
sortable: true,
@@ -206,14 +140,12 @@ class _ContainersListPageState extends ConsumerState<ContainersListPage> {
cellBuilder: (context, c) => _ContainerCell(container: c),
),
DataGridColumn<ContainerData>(
id: 'ports',
header: 'Ports',
valueBuilder: (c) => c.ports.map((p) => p.formatted).join(', '),
width: const DataGridColumnWidth.flex(1),
cellBuilder: (context, c) => _PortsCell(ports: c.ports),
),
DataGridColumn<ContainerData>(
id: 'status',
header: 'Status',
valueBuilder: (c) => c.displayStatus,
width: const DataGridColumnWidth.fixed(160),
@@ -279,15 +211,6 @@ class _ContainersListPageState extends ConsumerState<ContainersListPage> {
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
// Listen for grid state changes to sync URL
ref.listen(_gridProvider, (previous, next) {
if (previous?.searchQuery != next.searchQuery ||
previous?.sortColumnIndex != next.sortColumnIndex ||
previous?.sortDescending != next.sortDescending) {
_scheduleUrlSync();
}
});
// Listen for container action results to show snackbars
ref.listen<AsyncValue<void>>(containerActionsProvider, (previous, next) {
if (previous?.isLoading == true && !next.isLoading) {
@@ -1,12 +1,8 @@
import 'dart:async';
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:go_router/go_router.dart';
import 'package:tatlock_ui/core/api/api_client.dart';
import 'package:tatlock_ui/features/control_room/npm/presentation/pages/proxy_host_page.dart';
import 'package:tatlock_ui/features/control_room/npm/presentation/providers/proxy_hosts_provider.dart';
import 'package:tatlock_ui/routing/url_state.dart';
import 'package:tatlock_ui/shared/components/data_grid/adapters/core_api_source.dart';
import 'package:tatlock_ui/shared/components/data_grid/data_grid_exports.dart';
@@ -37,10 +33,7 @@ class DomainData {
/// Page displaying the list of proxy hosts (domains) from NPM.
class ProxyHostsPage extends ConsumerStatefulWidget {
const ProxyHostsPage({super.key, this.routerState});
/// Router state for URL deep-linking.
final GoRouterState? routerState;
const ProxyHostsPage({super.key});
@override
ConsumerState<ProxyHostsPage> createState() => _ProxyHostsPageState();
@@ -49,18 +42,10 @@ class ProxyHostsPage extends ConsumerStatefulWidget {
class _ProxyHostsPageState extends ConsumerState<ProxyHostsPage> {
late final StateNotifierProvider<DataGridController<DomainData>,
DataGridState<DomainData>> _gridProvider;
late PageUrlState _urlState;
Timer? _urlSyncTimer;
@override
void initState() {
super.initState();
// Parse URL state
_urlState = PageUrlState.fromQueryParams(
widget.routerState?.uri.queryParameters ?? {},
);
final dio = ref.read(coreApiClientProvider);
final source = CoreApiDataSource<DomainData>(
dio: dio,
@@ -68,80 +53,17 @@ class _ProxyHostsPageState extends ConsumerState<ProxyHostsPage> {
fromJson: DomainData.fromJson,
);
// Initialize grid with URL state
_gridProvider = dataGridProvider<DomainData>(
source: source,
config: _buildConfig(),
idSelector: (d) => d.proxyHostId.toString(),
initialSearch: _urlState.search,
initialSortColumnIndex: _columnIndexForId(_urlState.sortColumn),
initialSortDescending: _urlState.sortDescending,
);
// Open document from URL if id present
if (_urlState.id != null) {
final id = int.tryParse(_urlState.id!);
if (id != null) {
WidgetsBinding.instance.addPostFrameCallback((_) {
ref.read(selectedProxyHostProvider.notifier).select(id);
});
}
}
}
@override
void dispose() {
_urlSyncTimer?.cancel();
super.dispose();
}
/// Find column index by column ID.
int? _columnIndexForId(String? columnId) {
if (columnId == null) return null;
final columns = _buildConfig().columns;
for (var i = 0; i < columns.length; i++) {
if (columns[i].id == columnId) return i;
}
return null;
}
/// Get column ID by index.
String? _columnIdForIndex(int index) {
final columns = _buildConfig().columns;
if (index >= 0 && index < columns.length) {
return columns[index].id;
}
return null;
}
/// Schedule URL sync with debounce.
void _scheduleUrlSync() {
_urlSyncTimer?.cancel();
_urlSyncTimer = Timer(const Duration(milliseconds: 500), _syncUrlParams);
}
/// Sync current state to URL.
void _syncUrlParams() {
final state = ref.read(_gridProvider);
final selectedId = ref.read(selectedProxyHostProvider);
final params = PageUrlState(
id: selectedId?.toString(),
search: state.searchQuery.isEmpty ? null : state.searchQuery,
sortColumn: state.sortColumnIndex != null
? _columnIdForIndex(state.sortColumnIndex!)
: null,
sortDescending: state.sortDescending,
).toQueryParams();
updateBrowserUrlParams(params);
}
DataGridConfig<DomainData> _buildConfig() {
return DataGridConfig<DomainData>(
columns: [
DataGridColumn<DomainData>(
id: 'domain',
header: 'Domain',
valueBuilder: (d) => d.domain,
sortable: true,
@@ -150,14 +72,12 @@ class _ProxyHostsPageState extends ConsumerState<ProxyHostsPage> {
cellBuilder: (context, d) => _DomainCell(domain: d),
),
DataGridColumn<DomainData>(
id: 'service',
header: 'Service',
valueBuilder: (d) => d.service,
width: const DataGridColumnWidth.flex(1),
cellBuilder: (context, d) => _ServiceCell(service: d.service),
),
DataGridColumn<DomainData>(
id: 'ssl',
header: 'SSL',
valueBuilder: (d) => d.sslEnabled ? 'Enabled' : 'Disabled',
width: const DataGridColumnWidth.fixed(100),
@@ -181,8 +101,6 @@ class _ProxyHostsPageState extends ConsumerState<ProxyHostsPage> {
void _viewDomain(DomainData domain) {
ref.read(selectedProxyHostProvider.notifier).select(domain.proxyHostId);
// Navigate with id to enable back button
context.go('/control-room/proxy-hosts?id=${domain.proxyHostId}');
}
void _createNew() {
@@ -194,15 +112,6 @@ class _ProxyHostsPageState extends ConsumerState<ProxyHostsPage> {
final selectedId = ref.watch(selectedProxyHostProvider);
final isCreating = ref.watch(creatingProxyHostProvider);
// Listen for grid state changes to sync URL
ref.listen(_gridProvider, (previous, next) {
if (previous?.searchQuery != next.searchQuery ||
previous?.sortColumnIndex != next.sortColumnIndex ||
previous?.sortDescending != next.sortDescending) {
_scheduleUrlSync();
}
});
// Show create page if creating new
if (isCreating) {
return ProxyHostPage.create(
@@ -219,8 +128,6 @@ class _ProxyHostsPageState extends ConsumerState<ProxyHostsPage> {
proxyHostId: selectedId,
onClose: () {
ref.read(selectedProxyHostProvider.notifier).clear();
// Clear id from URL
context.go('/control-room/proxy-hosts');
ref.read(_gridProvider.notifier).refresh();
},
);
@@ -17,15 +17,11 @@ class ControlRoomPage extends ConsumerWidget {
const ControlRoomPage({
super.key,
this.nav = ControlRoomNav.containers,
this.routerState,
});
/// The current nav item to display.
final ControlRoomNav nav;
/// Router state for URL deep-linking (query params).
final GoRouterState? routerState;
@override
Widget build(BuildContext context, WidgetRef ref) {
final colorScheme = Theme.of(context).colorScheme;
@@ -57,7 +53,7 @@ class ControlRoomPage extends ConsumerWidget {
),
// Section content
Expanded(
child: _SectionContent(nav: nav, routerState: routerState),
child: _SectionContent(nav: nav),
),
],
),
@@ -67,18 +63,50 @@ class ControlRoomPage extends ConsumerWidget {
/// Renders content for the selected nav item.
class _SectionContent extends ConsumerWidget {
const _SectionContent({required this.nav, this.routerState});
const _SectionContent({required this.nav});
final ControlRoomNav nav;
final GoRouterState? routerState;
@override
Widget build(BuildContext context, WidgetRef ref) {
return switch (nav) {
ControlRoomNav.containers => _ContainersSection(routerState: routerState),
ControlRoomNav.proxyHosts => ProxyHostsPage(routerState: routerState),
_ => _PlaceholderSection(nav: nav),
};
switch (nav) {
case ControlRoomNav.containers:
return const _ContainersSection();
case ControlRoomNav.proxyHosts:
return const ProxyHostsPage();
default:
return _PlaceholderSection(nav: nav);
}
}
}
/// Containers section with optional stack filter.
class _ContainersSection extends ConsumerWidget {
const _ContainersSection();
@override
Widget build(BuildContext context, WidgetRef ref) {
final selectedStack = ref.watch(selectedStackProvider);
final colorScheme = Theme.of(context).colorScheme;
return Row(
children: [
// Stacks filter panel
const _StacksFilterPanel(),
// Divider
VerticalDivider(
width: 1,
thickness: 1,
color: colorScheme.outlineVariant,
),
// Main content - containers list or stack detail
Expanded(
child: selectedStack == null
? const ContainersListPage()
: StackDetailPage(stackId: selectedStack),
),
],
);
}
}
@@ -122,43 +150,9 @@ class _PlaceholderSection extends StatelessWidget {
}
}
/// Containers section with optional stack filter.
class _ContainersSection extends ConsumerWidget {
const _ContainersSection({this.routerState});
final GoRouterState? routerState;
@override
Widget build(BuildContext context, WidgetRef ref) {
final selectedStack = ref.watch(selectedStackProvider);
final colorScheme = Theme.of(context).colorScheme;
return Row(
children: [
// Stacks filter panel
_StacksFilterPanel(routerState: routerState),
// Divider
VerticalDivider(
width: 1,
thickness: 1,
color: colorScheme.outlineVariant,
),
// Main content - containers list or stack detail
Expanded(
child: selectedStack == null
? ContainersListPage(routerState: routerState)
: StackDetailPage(stackId: selectedStack),
),
],
);
}
}
/// Stacks filter panel for Containers section (includes "All Containers" option).
class _StacksFilterPanel extends ConsumerWidget {
const _StacksFilterPanel({this.routerState});
final GoRouterState? routerState;
const _StacksFilterPanel();
@override
Widget build(BuildContext context, WidgetRef ref) {
@@ -216,7 +210,6 @@ class _StacksFilterPanel extends ConsumerWidget {
data: (stacks) => _StacksList(
stacks: stacks,
selectedStackId: selectedStack,
routerState: routerState,
onStackSelected: (id) =>
ref.read(selectedStackProvider.notifier).select(id),
onStackAction: (id, action) =>
@@ -291,14 +284,12 @@ class _StacksList extends StatefulWidget {
required this.selectedStackId,
required this.onStackSelected,
required this.onStackAction,
this.routerState,
});
final List<Stack> stacks;
final String? selectedStackId;
final void Function(String) onStackSelected;
final void Function(String, String) onStackAction;
final GoRouterState? routerState;
@override
State<_StacksList> createState() => _StacksListState();
+19 -37
View File
@@ -1,33 +1,35 @@
import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
import 'package:tatlock_ui/features/control_room/presentation/pages/control_room_page.dart';
import 'package:tatlock_ui/routing/app_router.dart';
import 'package:tatlock_ui/routing/room_registry.dart';
import 'package:tatlock_ui/shared/layouts/widgets/nav_panel.dart';
/// Route paths for Control Room.
abstract class ControlRoomRoutes {
static const base = '/control-room';
// Stack
// Portainer
static const containers = '/control-room/containers';
static const networks = '/control-room/networks';
static const volumes = '/control-room/volumes';
static const images = '/control-room/images';
// NPM
static const proxyHosts = '/control-room/proxy-hosts';
// Data Management
static const postgres = '/control-room/postgres';
static const redis = '/control-room/redis';
static const qdrant = '/control-room/qdrant';
static const neo4j = '/control-room/neo4j';
static const redirections = '/control-room/redirections';
static const streams = '/control-room/streams';
static const certificates = '/control-room/certificates';
}
/// Control Room navigation items with section grouping.
enum ControlRoomNav {
// Stack Management section - Docker containers and reverse proxy
containers('containers', 'Containers', Icons.dns, 'Stack Management'),
proxyHosts('proxy-hosts', 'Proxy Hosts', Icons.public, 'Stack Management'),
// Data Management section - Database browsers
postgres('postgres', 'PostgreSQL', Icons.table_chart, 'Data Management'),
redis('redis', 'Redis', Icons.memory, 'Data Management'),
qdrant('qdrant', 'Qdrant', Icons.scatter_plot, 'Data Management'),
neo4j('neo4j', 'Neo4j', Icons.hub, 'Data Management');
// Portainer section
containers('containers', 'Containers', Icons.dns, 'Portainer'),
networks('networks', 'Networks', Icons.hub, 'Portainer'),
volumes('volumes', 'Volumes', Icons.storage, 'Portainer'),
images('images', 'Images', Icons.photo_library, 'Portainer'),
// NPM section
proxyHosts('proxy-hosts', 'Proxy Hosts', Icons.public, 'NPM'),
redirections('redirections', 'Redirections', Icons.alt_route, 'NPM'),
streams('streams', 'Streams', Icons.stream, 'NPM'),
certificates('certificates', 'SSL Certificates', Icons.verified_user, 'NPM');
const ControlRoomNav(this.id, this.label, this.icon, this.section);
@@ -50,22 +52,6 @@ enum ControlRoomNav {
/// Get route path for a nav item.
String pathForNav(ControlRoomNav nav) => nav.path;
/// Control Room room definition.
final controlRoomRoom = RoomDefinition(
id: 'control-room',
label: 'Control Room',
icon: Icons.dns_outlined,
selectedIcon: Icons.dns,
defaultRoute: ControlRoomRoutes.containers,
routes: controlRoomRoutes,
// No permissions required - accessible to all authenticated users
);
/// Register Control Room with the room registry.
void registerControlRoom() {
roomRegistry.register(controlRoomRoom);
}
/// Control Room routes for go_router.
List<RouteBase> controlRoomRoutes() {
return [
@@ -80,11 +66,7 @@ List<RouteBase> controlRoomRoutes() {
GoRoute(
path: nav.path,
name: 'controlRoom${_capitalize(nav.id.replaceAll('-', '_'))}',
pageBuilder: (context, state) => noTransitionPage(
context,
state,
ControlRoomPage(nav: nav, routerState: state),
),
builder: (context, state) => ControlRoomPage(nav: nav),
),
];
}
@@ -1,38 +0,0 @@
import 'package:dio/dio.dart';
import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:tatlock_ui/core/api/api_client.dart';
import 'package:tatlock_ui/features/front_hall/data/models/environment_model.dart';
part 'environment_datasource.g.dart';
/// Data source for environment data operations.
///
/// Fetches weather, forecast, sun times, and air quality from Core API.
class EnvironmentDatasource {
EnvironmentDatasource(this._dio);
final Dio _dio;
static const _basePath = '/tools/environment';
/// Gets current environment data.
///
/// Returns weather, forecast, sun times, and optionally air quality.
Future<EnvironmentData> getEnvironment() async {
final response = await _dio.get<Map<String, dynamic>>(_basePath);
final data = response.data;
if (data == null) {
throw Exception('Failed to fetch environment data');
}
return EnvironmentData.fromJson(data);
}
}
/// Provides the environment datasource.
@riverpod
EnvironmentDatasource environmentDatasource(Ref ref) {
final dio = ref.watch(coreApiClientProvider);
return EnvironmentDatasource(dio);
}
@@ -1,91 +0,0 @@
import 'package:freezed_annotation/freezed_annotation.dart';
part 'environment_model.freezed.dart';
part 'environment_model.g.dart';
/// Environment data response from Core API.
/// Contains weather, forecast, sun times, and optionally air quality.
@freezed
sealed class EnvironmentData with _$EnvironmentData {
const factory EnvironmentData({
WeatherData? weather,
List<ForecastDay>? forecast,
@JsonKey(name: 'sun_times') SunTimesData? sunTimes,
@JsonKey(name: 'air_quality') AirQualityData? airQuality,
@JsonKey(name: 'updated_at') required DateTime updatedAt,
String? user,
}) = _EnvironmentData;
factory EnvironmentData.fromJson(Map<String, dynamic> json) =>
_$EnvironmentDataFromJson(json);
}
/// Current weather conditions.
@freezed
sealed class WeatherData with _$WeatherData {
const factory WeatherData({
double? temperature,
@JsonKey(name: 'feels_like') double? feelsLike,
String? conditions,
int? humidity,
@JsonKey(name: 'wind_speed') double? windSpeed,
@JsonKey(name: 'wind_direction') String? windDirection,
double? pressure,
double? visibility,
@JsonKey(name: 'uv_index') double? uvIndex,
String? location,
String? icon,
}) = _WeatherData;
factory WeatherData.fromJson(Map<String, dynamic> json) =>
_$WeatherDataFromJson(json);
}
/// Single day forecast data.
@freezed
sealed class ForecastDay with _$ForecastDay {
const factory ForecastDay({
required String date,
double? high,
double? low,
String? conditions,
@JsonKey(name: 'precipitation_chance') int? precipitationChance,
String? icon,
}) = _ForecastDay;
factory ForecastDay.fromJson(Map<String, dynamic> json) =>
_$ForecastDayFromJson(json);
}
/// Sunrise and sunset times.
@freezed
sealed class SunTimesData with _$SunTimesData {
const factory SunTimesData({
DateTime? sunrise,
DateTime? sunset,
@JsonKey(name: 'daylight_minutes') int? daylightMinutes,
@JsonKey(name: 'solar_noon') DateTime? solarNoon,
DateTime? dawn,
DateTime? dusk,
}) = _SunTimesData;
factory SunTimesData.fromJson(Map<String, dynamic> json) =>
_$SunTimesDataFromJson(json);
}
/// Air quality information.
@freezed
sealed class AirQualityData with _$AirQualityData {
const factory AirQualityData({
int? aqi,
String? quality,
double? pm25,
double? pm10,
double? o3,
double? no2,
String? location,
}) = _AirQualityData;
factory AirQualityData.fromJson(Map<String, dynamic> json) =>
_$AirQualityDataFromJson(json);
}
@@ -1,27 +0,0 @@
import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:tatlock_ui/features/front_hall/data/datasources/environment_datasource.dart';
import 'package:tatlock_ui/features/front_hall/data/models/environment_model.dart';
part 'environment_provider.g.dart';
/// Fetches environment data (weather, forecast, sun times) from Core API.
///
/// Auto-invalidates every 5 minutes to keep data fresh.
/// Weather data in Qdrant has 1-hour TTL, so 5-minute refresh is reasonable.
@riverpod
Future<EnvironmentData> environment(Ref ref) async {
final datasource = ref.watch(environmentDatasourceProvider);
return datasource.getEnvironment();
}
/// Provides whether air quality data is available.
///
/// Used for conditional rendering of AirQualityWidget.
@riverpod
bool hasAirQuality(Ref ref) {
final asyncValue = ref.watch(environmentProvider);
return asyncValue.maybeWhen(
data: (data) => data.airQuality != null,
orElse: () => false,
);
}
@@ -3,11 +3,8 @@ import 'dart:async';
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:tatlock_ui/features/front_hall/data/models/system_stats_model.dart';
import 'package:tatlock_ui/features/front_hall/presentation/providers/environment_provider.dart';
import 'package:tatlock_ui/features/front_hall/presentation/providers/system_stats_provider.dart';
import 'package:tatlock_ui/shared/theme/stoplight_colors.dart';
import 'package:tatlock_ui/shared/widgets/forecast_widget.dart';
import 'package:tatlock_ui/shared/widgets/sun_position_widget.dart';
import 'package:tatlock_ui/shared/widgets/widgets.dart';
import 'package:tatlock_ui/version.g.dart';
@@ -23,28 +20,20 @@ class DashboardContent extends ConsumerStatefulWidget {
}
class _DashboardContentState extends ConsumerState<DashboardContent> {
Timer? _systemStatsTimer;
Timer? _environmentTimer;
Timer? _refreshTimer;
@override
void initState() {
super.initState();
// Refresh system stats every 30 seconds
_systemStatsTimer = Timer.periodic(
_refreshTimer = Timer.periodic(
const Duration(seconds: 30),
(_) => ref.invalidate(systemStatsProvider),
);
// Refresh environment data every hour
_environmentTimer = Timer.periodic(
const Duration(hours: 1),
(_) => ref.invalidate(environmentProvider),
);
}
@override
void dispose() {
_systemStatsTimer?.cancel();
_environmentTimer?.cancel();
_refreshTimer?.cancel();
super.dispose();
}
@@ -52,7 +41,6 @@ class _DashboardContentState extends ConsumerState<DashboardContent> {
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final systemStatsAsync = ref.watch(systemStatsProvider);
final environmentAsync = ref.watch(environmentProvider);
return ListView(
padding: const EdgeInsets.all(16),
@@ -128,41 +116,31 @@ class _DashboardContentState extends ConsumerState<DashboardContent> {
),
const SizedBox(height: 24),
// Environment - Sun, Weather, Forecast, Air Quality
// Environment - Weather & Air Quality
_SectionHeader(title: 'Environment', icon: Icons.eco),
const SizedBox(height: 8),
environmentAsync.when(
data: (envData) => _EnvironmentSection(
envData: envData,
onRefresh: () => ref.invalidate(environmentProvider),
),
loading: () => const Card(
child: Padding(
padding: EdgeInsets.all(32),
child: Center(child: CircularProgressIndicator()),
),
),
error: (error, _) => Card(
child: Padding(
padding: const EdgeInsets.all(16),
child: Row(
LayoutBuilder(
builder: (context, constraints) {
// Responsive layout: side-by-side on wider screens
if (constraints.maxWidth > 500) {
return Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Icon(Icons.error_outline, color: colorScheme.error),
Expanded(child: WeatherWidget()),
const SizedBox(width: 12),
Expanded(
child: Text(
'Failed to load environment data',
style: TextStyle(color: colorScheme.error),
),
),
IconButton(
icon: const Icon(Icons.refresh),
onPressed: () => ref.invalidate(environmentProvider),
),
Expanded(child: AirQualityWidget()),
],
),
),
),
);
}
// Stack on narrow screens
return Column(
children: [
WeatherWidget(),
const SizedBox(height: 12),
AirQualityWidget(),
],
);
},
),
const SizedBox(height: 24),
@@ -278,94 +256,3 @@ class _SystemStatsCard extends StatelessWidget {
return parts.isNotEmpty ? parts.last : mount;
}
}
/// Environment section displaying sun position, weather, air quality, and forecast.
///
/// Layout:
/// - Desktop (>900px): 4 widgets in a row - Sun(30%) | Weather(20%) | AirQuality(20%) | Forecast(30%)
/// - Tablet (600-900px): 2x2 grid
/// - Mobile (<600px): Stacked vertically
class _EnvironmentSection extends StatelessWidget {
const _EnvironmentSection({
required this.envData,
required this.onRefresh,
});
final dynamic envData;
final VoidCallback onRefresh;
@override
Widget build(BuildContext context) {
return LayoutBuilder(
builder: (context, constraints) {
if (constraints.maxWidth > 900) {
// Desktop: 4 in a row (30/20/20/30) - wider widgets on outsides
return Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Expanded(
flex: 30,
child: SunPositionWidget(sunTimes: envData.sunTimes),
),
const SizedBox(width: 12),
Expanded(
flex: 20,
child: WeatherWidget(apiData: envData.weather),
),
const SizedBox(width: 12),
Expanded(
flex: 20,
child: AirQualityWidget(apiData: envData.airQuality),
),
const SizedBox(width: 12),
Expanded(
flex: 30,
child: ForecastWidget(forecast: envData.forecast),
),
],
);
} else if (constraints.maxWidth > 600) {
// Tablet: 2x2 grid
return Column(
children: [
Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Expanded(
child: SunPositionWidget(sunTimes: envData.sunTimes),
),
const SizedBox(width: 12),
Expanded(child: WeatherWidget(apiData: envData.weather)),
],
),
const SizedBox(height: 12),
Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Expanded(
child: AirQualityWidget(apiData: envData.airQuality),
),
const SizedBox(width: 12),
Expanded(child: ForecastWidget(forecast: envData.forecast)),
],
),
],
);
} else {
// Mobile: stacked vertically
return Column(
children: [
SunPositionWidget(sunTimes: envData.sunTimes),
const SizedBox(height: 12),
WeatherWidget(apiData: envData.weather),
const SizedBox(height: 12),
AirQualityWidget(apiData: envData.airQuality),
const SizedBox(height: 12),
ForecastWidget(forecast: envData.forecast),
],
);
}
},
);
}
}
@@ -1,8 +1,8 @@
import 'dart:html' as html;
import 'dart:ui_web' as ui_web;
import 'package:flutter/material.dart';
import 'package:url_launcher/url_launcher.dart';
import 'package:web/web.dart' as web;
/// Embedded iframe view for displaying external content (web only).
///
@@ -31,7 +31,7 @@ class IframeView extends StatefulWidget {
class _IframeViewState extends State<IframeView> {
late final String _viewType;
late web.HTMLIFrameElement _iframe;
late html.IFrameElement _iframe;
bool _isLoading = true;
@override
@@ -42,18 +42,17 @@ class _IframeViewState extends State<IframeView> {
}
void _createIframe() {
_iframe = web.document.createElement('iframe') as web.HTMLIFrameElement
_iframe = html.IFrameElement()
..src = widget.url
..style.border = 'none'
..style.width = '100%'
..style.height = '100%'
..allow = 'fullscreen';
_iframe.onLoad.listen((_) {
if (mounted) {
setState(() => _isLoading = false);
}
});
..allow = 'fullscreen'
..onLoad.listen((_) {
if (mounted) {
setState(() => _isLoading = false);
}
});
// Register the view factory
ui_web.platformViewRegistry.registerViewFactory(
-38
View File
@@ -1,38 +0,0 @@
import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
import 'package:tatlock_ui/features/front_hall/presentation/pages/front_hall_page.dart';
import 'package:tatlock_ui/routing/app_router.dart';
import 'package:tatlock_ui/routing/room_registry.dart';
/// Route paths for Front Hall.
abstract class FrontHallRoutes {
static const base = '/front-hall';
}
/// Front Hall room definition.
final frontHallRoom = RoomDefinition(
id: 'front-hall',
label: 'Front Hall',
icon: Icons.door_front_door_outlined,
selectedIcon: Icons.door_front_door,
defaultRoute: FrontHallRoutes.base,
routes: frontHallRoutes,
// No permissions required - accessible to all authenticated users
);
/// Register Front Hall with the room registry.
void registerFrontHall() {
roomRegistry.register(frontHallRoom);
}
/// Front Hall routes for go_router.
List<RouteBase> frontHallRoutes() {
return [
GoRoute(
path: FrontHallRoutes.base,
name: 'frontHall',
pageBuilder: (context, state) =>
noTransitionPage(context, state, const FrontHallPage()),
),
];
}
@@ -1,36 +0,0 @@
import 'package:flutter/material.dart';
/// Media Room - media management and playback.
///
/// Placeholder page for future implementation.
class MediaRoomPage extends StatelessWidget {
const MediaRoomPage({super.key});
@override
Widget build(BuildContext context) {
return Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
Icon(
Icons.movie,
size: 64,
color: Theme.of(context).colorScheme.outline,
),
const SizedBox(height: 16),
Text(
'Media Room',
style: Theme.of(context).textTheme.headlineMedium,
),
const SizedBox(height: 8),
Text(
'Media management and playback - coming soon',
style: Theme.of(context).textTheme.bodyLarge?.copyWith(
color: Theme.of(context).colorScheme.outline,
),
),
],
),
);
}
}
-38
View File
@@ -1,38 +0,0 @@
import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
import 'package:tatlock_ui/features/media_room/presentation/pages/media_room_page.dart';
import 'package:tatlock_ui/routing/app_router.dart';
import 'package:tatlock_ui/routing/room_registry.dart';
/// Route paths for Media Room.
abstract class MediaRoomRoutes {
static const base = '/media-room';
}
/// Media Room room definition.
final mediaRoomRoom = RoomDefinition(
id: 'media-room',
label: 'Media Room',
icon: Icons.movie_outlined,
selectedIcon: Icons.movie,
defaultRoute: MediaRoomRoutes.base,
routes: mediaRoomRoutes,
// No permissions required - accessible to all authenticated users
);
/// Register Media Room with the room registry.
void registerMediaRoom() {
roomRegistry.register(mediaRoomRoom);
}
/// Media Room routes for go_router.
List<RouteBase> mediaRoomRoutes() {
return [
GoRoute(
path: MediaRoomRoutes.base,
name: 'mediaRoom',
pageBuilder: (context, state) =>
noTransitionPage(context, state, const MediaRoomPage()),
),
];
}
@@ -1,36 +0,0 @@
import 'package:flutter/material.dart';
/// Parlor - AI chat and automation hub.
///
/// Placeholder page for future implementation.
class ParlorPage extends StatelessWidget {
const ParlorPage({super.key});
@override
Widget build(BuildContext context) {
return Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
Icon(
Icons.lightbulb,
size: 64,
color: Theme.of(context).colorScheme.outline,
),
const SizedBox(height: 16),
Text(
'Parlor',
style: Theme.of(context).textTheme.headlineMedium,
),
const SizedBox(height: 8),
Text(
'AI chat and automation hub - coming soon',
style: Theme.of(context).textTheme.bodyLarge?.copyWith(
color: Theme.of(context).colorScheme.outline,
),
),
],
),
);
}
}
-38
View File
@@ -1,38 +0,0 @@
import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
import 'package:tatlock_ui/features/parlor/presentation/pages/parlor_page.dart';
import 'package:tatlock_ui/routing/app_router.dart';
import 'package:tatlock_ui/routing/room_registry.dart';
/// Route paths for Parlor.
abstract class ParlorRoutes {
static const base = '/parlor';
}
/// Parlor room definition.
final parlorRoom = RoomDefinition(
id: 'parlor',
label: 'Parlor',
icon: Icons.lightbulb_outline,
selectedIcon: Icons.lightbulb,
defaultRoute: ParlorRoutes.base,
routes: parlorRoutes,
// No permissions required - accessible to all authenticated users
);
/// Register Parlor with the room registry.
void registerParlor() {
roomRegistry.register(parlorRoom);
}
/// Parlor routes for go_router.
List<RouteBase> parlorRoutes() {
return [
GoRoute(
path: ParlorRoutes.base,
name: 'parlor',
pageBuilder: (context, state) =>
noTransitionPage(context, state, const ParlorPage()),
),
];
}
@@ -1,10 +1,6 @@
import 'dart:async';
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:go_router/go_router.dart';
import 'package:tatlock_ui/core/api/api_client.dart';
import 'package:tatlock_ui/routing/url_state.dart';
import 'package:tatlock_ui/shared/components/data_grid/adapters/core_api_source.dart';
import 'package:tatlock_ui/shared/components/data_grid/data_grid_exports.dart';
@@ -35,10 +31,7 @@ class GroupData {
/// Groups list page using the shared DataGrid component.
class GroupsListPage extends ConsumerStatefulWidget {
const GroupsListPage({super.key, this.routerState});
/// Router state for URL deep-linking.
final GoRouterState? routerState;
const GroupsListPage({super.key});
@override
ConsumerState<GroupsListPage> createState() => _GroupsListPageState();
@@ -47,19 +40,11 @@ class GroupsListPage extends ConsumerStatefulWidget {
class _GroupsListPageState extends ConsumerState<GroupsListPage> {
late final StateNotifierProvider<DataGridController<GroupData>,
DataGridState<GroupData>> _gridProvider;
late PageUrlState _urlState;
Timer? _urlSyncTimer;
bool _isSyncing = false;
@override
void initState() {
super.initState();
// Parse URL state
_urlState = PageUrlState.fromQueryParams(
widget.routerState?.uri.queryParameters ?? {},
);
// Create provider in initState to ensure stable reference
final dio = ref.read(coreApiClientProvider);
final source = CoreApiDataSource<GroupData>(
@@ -68,63 +53,13 @@ class _GroupsListPageState extends ConsumerState<GroupsListPage> {
fromJson: GroupData.fromJson,
);
// Initialize grid with URL state
_gridProvider = dataGridProvider<GroupData>(
source: source,
config: _buildConfig(),
idSelector: (g) => g.id,
initialSearch: _urlState.search,
initialSortColumnIndex: _columnIndexForId(_urlState.sortColumn),
initialSortDescending: _urlState.sortDescending,
);
}
@override
void dispose() {
_urlSyncTimer?.cancel();
super.dispose();
}
/// Find column index by column ID.
int? _columnIndexForId(String? columnId) {
if (columnId == null) return null;
final columns = _buildConfig().columns;
for (var i = 0; i < columns.length; i++) {
if (columns[i].id == columnId) return i;
}
return null;
}
/// Get column ID by index.
String? _columnIdForIndex(int index) {
final columns = _buildConfig().columns;
if (index >= 0 && index < columns.length) {
return columns[index].id;
}
return null;
}
/// Schedule URL sync with debounce.
void _scheduleUrlSync() {
_urlSyncTimer?.cancel();
_urlSyncTimer = Timer(const Duration(milliseconds: 500), _syncUrlParams);
}
/// Sync current state to URL.
void _syncUrlParams() {
final state = ref.read(_gridProvider);
final params = PageUrlState(
search: state.searchQuery.isEmpty ? null : state.searchQuery,
sortColumn: state.sortColumnIndex != null
? _columnIdForIndex(state.sortColumnIndex!)
: null,
sortDescending: state.sortDescending,
).toQueryParams();
updateBrowserUrlParams(params);
}
Future<void> _syncFromAuthentik() async {
if (_isSyncing) return;
setState(() => _isSyncing = true);
@@ -161,7 +96,6 @@ class _GroupsListPageState extends ConsumerState<GroupsListPage> {
return DataGridConfig<GroupData>(
columns: [
DataGridColumn<GroupData>(
id: 'name',
header: 'Name',
valueBuilder: (g) => g.name,
sortable: true,
@@ -169,21 +103,18 @@ class _GroupsListPageState extends ConsumerState<GroupsListPage> {
width: const DataGridColumnWidth.flex(2),
),
DataGridColumn<GroupData>(
id: 'members',
header: 'Members',
valueBuilder: (g) => g.memberCount.toString(),
width: const DataGridColumnWidth.fixed(100),
alignment: DataGridColumnAlignment.end,
),
DataGridColumn<GroupData>(
id: 'type',
header: 'Type',
valueBuilder: (g) => g.isSuperuser ? 'Superuser' : 'Standard',
cellBuilder: (context, g) => _GroupTypeBadge(isSuperuser: g.isSuperuser),
width: const DataGridColumnWidth.fixed(120),
),
DataGridColumn<GroupData>(
id: 'parent',
header: 'Parent',
valueBuilder: (g) => g.parentName ?? '-',
width: const DataGridColumnWidth.flex(1),
@@ -198,15 +129,6 @@ class _GroupsListPageState extends ConsumerState<GroupsListPage> {
@override
Widget build(BuildContext context) {
// Listen for grid state changes to sync URL
ref.listen(_gridProvider, (previous, next) {
if (previous?.searchQuery != next.searchQuery ||
previous?.sortColumnIndex != next.sortColumnIndex ||
previous?.sortDescending != next.sortDescending) {
_scheduleUrlSync();
}
});
return DataGrid<GroupData>(
provider: _gridProvider,
config: _buildConfig(),
@@ -11,15 +11,11 @@ class SecurityPage extends ConsumerWidget {
const SecurityPage({
super.key,
this.nav = SecurityNav.users,
this.routerState,
});
/// The current nav item to display.
final SecurityNav nav;
/// Router state for URL deep-linking (query params).
final GoRouterState? routerState;
@override
Widget build(BuildContext context, WidgetRef ref) {
final colorScheme = Theme.of(context).colorScheme;
@@ -49,7 +45,7 @@ class SecurityPage extends ConsumerWidget {
),
// Section content
Expanded(
child: _SectionContent(nav: nav, routerState: routerState),
child: _SectionContent(nav: nav),
),
],
),
@@ -59,18 +55,17 @@ class SecurityPage extends ConsumerWidget {
/// Renders content for the selected nav item.
class _SectionContent extends StatelessWidget {
const _SectionContent({required this.nav, this.routerState});
const _SectionContent({required this.nav});
final SecurityNav nav;
final GoRouterState? routerState;
@override
Widget build(BuildContext context) {
switch (nav) {
case SecurityNav.users:
return UsersListPage(routerState: routerState);
return const UsersListPage();
case SecurityNav.groups:
return GroupsListPage(routerState: routerState);
return const GroupsListPage();
default:
return _PlaceholderSection(nav: nav);
}
+1 -23
View File
@@ -1,8 +1,6 @@
import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
import 'package:tatlock_ui/features/security/presentation/pages/security_page.dart';
import 'package:tatlock_ui/routing/app_router.dart';
import 'package:tatlock_ui/routing/room_registry.dart';
import 'package:tatlock_ui/shared/layouts/widgets/nav_panel.dart';
/// Route paths for Security room.
@@ -48,22 +46,6 @@ enum SecurityNav {
/// Get route path for a nav item.
String pathForSecurityNav(SecurityNav nav) => nav.path;
/// Security room definition.
final securityRoom = RoomDefinition(
id: 'security',
label: 'Security',
icon: Icons.security_outlined,
selectedIcon: Icons.security,
defaultRoute: SecurityRoutes.users,
routes: securityRoutes,
// No permissions required - accessible to all authenticated users
);
/// Register Security room with the room registry.
void registerSecurity() {
roomRegistry.register(securityRoom);
}
/// Security room routes for go_router.
List<RouteBase> securityRoutes() {
return [
@@ -78,11 +60,7 @@ List<RouteBase> securityRoutes() {
GoRoute(
path: nav.path,
name: 'security${_capitalize(nav.id.replaceAll('-', '_'))}',
pageBuilder: (context, state) => noTransitionPage(
context,
state,
SecurityPage(nav: nav, routerState: state),
),
builder: (context, state) => SecurityPage(nav: nav),
),
];
}
@@ -1,10 +1,6 @@
import 'dart:async';
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:go_router/go_router.dart';
import 'package:tatlock_ui/core/api/api_client.dart';
import 'package:tatlock_ui/routing/url_state.dart';
import 'package:tatlock_ui/shared/components/data_grid/adapters/core_api_source.dart';
import 'package:tatlock_ui/shared/components/data_grid/data_grid_exports.dart';
@@ -65,10 +61,7 @@ class UserData {
/// Users list page using the shared DataGrid component.
class UsersListPage extends ConsumerStatefulWidget {
const UsersListPage({super.key, this.routerState});
/// Router state for URL deep-linking.
final GoRouterState? routerState;
const UsersListPage({super.key});
@override
ConsumerState<UsersListPage> createState() => _UsersListPageState();
@@ -77,19 +70,11 @@ class UsersListPage extends ConsumerStatefulWidget {
class _UsersListPageState extends ConsumerState<UsersListPage> {
late final StateNotifierProvider<DataGridController<UserData>,
DataGridState<UserData>> _gridProvider;
late PageUrlState _urlState;
Timer? _urlSyncTimer;
bool _isSyncing = false;
@override
void initState() {
super.initState();
// Parse URL state
_urlState = PageUrlState.fromQueryParams(
widget.routerState?.uri.queryParameters ?? {},
);
final dio = ref.read(coreApiClientProvider);
final source = CoreApiDataSource<UserData>(
dio: dio,
@@ -97,63 +82,13 @@ class _UsersListPageState extends ConsumerState<UsersListPage> {
fromJson: UserData.fromJson,
);
// Initialize grid with URL state
_gridProvider = dataGridProvider<UserData>(
source: source,
config: _buildConfig(),
idSelector: (u) => u.id,
initialSearch: _urlState.search,
initialSortColumnIndex: _columnIndexForId(_urlState.sortColumn),
initialSortDescending: _urlState.sortDescending,
);
}
@override
void dispose() {
_urlSyncTimer?.cancel();
super.dispose();
}
/// Find column index by column ID.
int? _columnIndexForId(String? columnId) {
if (columnId == null) return null;
final columns = _buildConfig().columns;
for (var i = 0; i < columns.length; i++) {
if (columns[i].id == columnId) return i;
}
return null;
}
/// Get column ID by index.
String? _columnIdForIndex(int index) {
final columns = _buildConfig().columns;
if (index >= 0 && index < columns.length) {
return columns[index].id;
}
return null;
}
/// Schedule URL sync with debounce.
void _scheduleUrlSync() {
_urlSyncTimer?.cancel();
_urlSyncTimer = Timer(const Duration(milliseconds: 500), _syncUrlParams);
}
/// Sync current state to URL.
void _syncUrlParams() {
final state = ref.read(_gridProvider);
final params = PageUrlState(
search: state.searchQuery.isEmpty ? null : state.searchQuery,
sortColumn: state.sortColumnIndex != null
? _columnIdForIndex(state.sortColumnIndex!)
: null,
sortDescending: state.sortDescending,
).toQueryParams();
updateBrowserUrlParams(params);
}
Future<void> _syncFromAuthentik() async {
if (_isSyncing) return;
setState(() => _isSyncing = true);
@@ -190,7 +125,6 @@ class _UsersListPageState extends ConsumerState<UsersListPage> {
return DataGridConfig<UserData>(
columns: [
DataGridColumn<UserData>(
id: 'user',
header: 'User',
valueBuilder: (u) => u.name,
sortable: true,
@@ -199,14 +133,12 @@ class _UsersListPageState extends ConsumerState<UsersListPage> {
cellBuilder: (context, u) => _UserCell(user: u),
),
DataGridColumn<UserData>(
id: 'roles',
header: 'Roles',
valueBuilder: (u) => u.roles.join(', '),
width: const DataGridColumnWidth.flex(1),
cellBuilder: (context, u) => _RolesCell(roles: u.roles),
),
DataGridColumn<UserData>(
id: 'lastLogin',
header: 'Last Login',
valueBuilder: (u) => u.lastLoginFormatted,
width: const DataGridColumnWidth.fixed(120),
@@ -222,15 +154,6 @@ class _UsersListPageState extends ConsumerState<UsersListPage> {
@override
Widget build(BuildContext context) {
// Listen for grid state changes to sync URL
ref.listen(_gridProvider, (previous, next) {
if (previous?.searchQuery != next.searchQuery ||
previous?.sortColumnIndex != next.sortColumnIndex ||
previous?.sortDescending != next.sortDescending) {
_scheduleUrlSync();
}
});
return DataGrid<UserData>(
provider: _gridProvider,
config: _buildConfig(),
@@ -1,301 +0,0 @@
import 'dart:developer' as developer;
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:tatlock_ui/core/auth/auth_provider.dart';
import 'package:tatlock_ui/core/theme/theme_provider.dart';
import 'package:tatlock_ui/routing/room_registry.dart';
/// Settings page with user preferences.
class SettingsPage extends ConsumerWidget {
const SettingsPage({super.key});
@override
Widget build(BuildContext context, WidgetRef ref) {
final authState = ref.watch(authProvider);
final currentTheme = ref.watch(themeProvider);
final colorScheme = Theme.of(context).colorScheme;
final textTheme = Theme.of(context).textTheme;
return Scaffold(
body: authState.when(
data: (auth) => SingleChildScrollView(
padding: const EdgeInsets.all(24),
child: Center(
child: ConstrainedBox(
constraints: const BoxConstraints(maxWidth: 600),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
// Page header
Text(
'Settings',
style: textTheme.headlineMedium,
),
const SizedBox(height: 32),
// Appearance section
_SectionHeader(title: 'Appearance'),
const SizedBox(height: 8),
Card(
child: Padding(
padding: const EdgeInsets.all(16),
child: Row(
children: [
Icon(
_themeIcon(currentTheme),
color: colorScheme.onSurfaceVariant,
),
const SizedBox(width: 16),
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text('Theme', style: textTheme.titleMedium),
Text(
'Choose your preferred color scheme',
style: textTheme.bodySmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
],
),
),
DropdownButton<ThemeSetting>(
value: currentTheme,
underline: const SizedBox(),
onChanged: (value) {
if (value != null) {
_updateTheme(ref, value);
}
},
items: const [
DropdownMenuItem(
value: ThemeSetting.system,
child: Text('System'),
),
DropdownMenuItem(
value: ThemeSetting.light,
child: Text('Light'),
),
DropdownMenuItem(
value: ThemeSetting.dark,
child: Text('Dark'),
),
],
),
],
),
),
),
const SizedBox(height: 24),
// Navigation section
_SectionHeader(title: 'Navigation'),
const SizedBox(height: 8),
Card(
child: Padding(
padding: const EdgeInsets.all(16),
child: Row(
children: [
Icon(
Icons.home_outlined,
color: colorScheme.onSurfaceVariant,
),
const SizedBox(width: 16),
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
'Default Room',
style: textTheme.titleMedium,
),
Text(
'Room to show when app opens',
style: textTheme.bodySmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
],
),
),
DropdownButton<String>(
value:
auth.preferences?.defaultRoom ?? 'front-hall',
underline: const SizedBox(),
onChanged: (value) {
if (value != null) {
_updateDefaultRoom(ref, value);
}
},
items: roomRegistry.all
.map(
(room) => DropdownMenuItem(
value: room.id,
child: Text(room.label),
),
)
.toList(),
),
],
),
),
),
const SizedBox(height: 24),
// Account section
_SectionHeader(title: 'Account'),
const SizedBox(height: 8),
Card(
child: Column(
children: [
_AccountInfoTile(
icon: Icons.person_outline,
label: 'Name',
value: auth.userName ?? 'Not available',
),
const Divider(height: 1),
_AccountInfoTile(
icon: Icons.email_outlined,
label: 'Email',
value: auth.userEmail ?? 'Not available',
),
if (auth.roles.isNotEmpty) ...[
const Divider(height: 1),
_AccountInfoTile(
icon: Icons.shield_outlined,
label: 'Roles',
value: auth.roles.map((r) => r.name).join(', '),
),
],
],
),
),
],
),
),
),
),
loading: () => const Center(child: CircularProgressIndicator()),
error: (error, _) => Center(
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Icon(Icons.error_outline, size: 48, color: colorScheme.error),
const SizedBox(height: 16),
Text(
'Failed to load settings',
style: textTheme.titleMedium,
),
const SizedBox(height: 8),
Text(
error.toString(),
style: textTheme.bodySmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
],
),
),
),
);
}
IconData _themeIcon(ThemeSetting theme) {
return switch (theme) {
ThemeSetting.system => Icons.brightness_auto,
ThemeSetting.light => Icons.light_mode,
ThemeSetting.dark => Icons.dark_mode,
};
}
Future<void> _updateTheme(WidgetRef ref, ThemeSetting setting) async {
// Update local theme immediately for instant UI response
await ref.read(themeProvider.notifier).setSetting(setting);
// Sync to backend
try {
await ref.read(authProvider.notifier).updatePreferences(
theme: setting.name,
);
} catch (e) {
developer.log('Failed to sync theme preference: $e', name: 'settings');
}
}
Future<void> _updateDefaultRoom(WidgetRef ref, String room) async {
try {
await ref.read(authProvider.notifier).updatePreferences(
defaultRoom: room,
);
} catch (e) {
developer.log('Failed to sync default room: $e', name: 'settings');
}
}
}
/// Section header widget.
class _SectionHeader extends StatelessWidget {
const _SectionHeader({required this.title});
final String title;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final textTheme = Theme.of(context).textTheme;
return Text(
title.toUpperCase(),
style: textTheme.labelMedium?.copyWith(
color: colorScheme.primary,
letterSpacing: 1.0,
fontWeight: FontWeight.w600,
),
);
}
}
/// Account info tile widget.
class _AccountInfoTile extends StatelessWidget {
const _AccountInfoTile({
required this.icon,
required this.label,
required this.value,
});
final IconData icon;
final String label;
final String value;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final textTheme = Theme.of(context).textTheme;
return Padding(
padding: const EdgeInsets.all(16),
child: Row(
children: [
Icon(icon, color: colorScheme.onSurfaceVariant),
const SizedBox(width: 16),
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(label, style: textTheme.bodySmall?.copyWith(
color: colorScheme.onSurfaceVariant,
)),
const SizedBox(height: 2),
Text(value, style: textTheme.titleMedium),
],
),
),
],
),
);
}
}
+10 -25
View File
@@ -1,37 +1,22 @@
import 'dart:developer' as developer;
import 'package:flutter/foundation.dart' show kIsWeb;
import 'package:flutter/material.dart';
import 'package:flutter/rendering.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'app.dart';
import 'core/auth/auth_controller.dart';
import 'core/config/url_strategy.dart';
import 'version.g.dart';
void main() async {
void main() {
WidgetsFlutterBinding.ensureInitialized();
// Enable semantics tree on web for accessibility and automation tools.
// This exposes widget identifiers to browser automation (Puppeteer, etc.)
if (kIsWeb) {
SemanticsBinding.instance.ensureSemantics();
}
developer.log(
'${AppVersion.name} v${AppVersion.fullVersion}',
name: 'tatlock_ui',
);
// Use path-based URLs on web (no-op on mobile/desktop)
configureUrlStrategy();
debugPrint('🪣 ${AppVersion.name} v${AppVersion.fullVersion}');
// Initialize auth before starting the app.
// This handles OIDC callback and silent auth on web.
// If it returns false, we're redirecting and shouldn't continue.
final authReady = await AuthController.initialize();
if (!authReady) {
developer.log('Auth redirecting, not starting app', name: 'tatlock_ui');
return; // Don't run the app - browser is redirecting
}
runApp(const ProviderScope(child: TatlockApp()));
runApp(
const ProviderScope(
child: TatlockApp(),
),
);
}
+230 -59
View File
@@ -1,98 +1,83 @@
import 'package:flutter/foundation.dart' show kIsWeb;
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:go_router/go_router.dart';
import 'package:riverpod_annotation/riverpod_annotation.dart';
import 'package:tatlock_ui/core/auth/auth_provider.dart';
import 'package:tatlock_ui/core/config/app_config.dart';
import 'package:tatlock_ui/features/control_room/router.dart';
import 'package:tatlock_ui/features/front_hall/router.dart';
import 'package:tatlock_ui/features/media_room/router.dart';
import 'package:tatlock_ui/features/parlor/router.dart';
import 'package:tatlock_ui/features/front_hall/presentation/pages/front_hall_page.dart';
import 'package:tatlock_ui/features/security/router.dart';
import 'package:tatlock_ui/features/settings/presentation/pages/settings_page.dart';
import 'package:tatlock_ui/routing/room_registry.dart';
import 'package:tatlock_ui/shared/layouts/app_scaffold.dart';
part 'app_router.g.dart';
/// Initialize room registry with all rooms.
///
/// Called once before creating the router.
/// Order of registration determines tab order in UI.
void _initializeRoomRegistry() {
// Skip if already initialized
if (roomRegistry.all.isNotEmpty) return;
// Register rooms in display order
registerFrontHall();
registerControlRoom();
registerSecurity();
registerParlor();
registerMediaRoom();
}
/// No-animation page builder for instant transitions
Page<void> noTransitionPage(BuildContext context, GoRouterState state, Widget child) {
return NoTransitionPage<void>(
key: state.pageKey,
child: child,
);
}
/// Route paths as constants.
abstract class AppRoutes {
static const root = '/';
static const frontHall = '/';
static const parlor = '/parlor';
static const settings = '/settings';
}
/// Maps defaultRoom preference value to route path.
String _routeForDefaultRoom(String? defaultRoom) {
// Look up room in registry, fall back to first room's default route
final room = roomRegistry.byId(defaultRoom ?? '');
if (room != null) {
return room.defaultRoute;
}
// Default to first registered room (Front Hall)
return roomRegistry.all.isNotEmpty
? roomRegistry.all.first.defaultRoute
: FrontHallRoutes.base;
static const login = '/login';
}
/// Provides the GoRouter instance.
@riverpod
GoRouter appRouter(Ref ref) {
// Initialize room registry on first access
_initializeRoomRegistry();
final authState = ref.watch(authProvider);
return GoRouter(
initialLocation: AppRoutes.root,
initialLocation: AppRoutes.frontHall,
debugLogDiagnostics: true,
redirect: (context, state) {
// Redirect from root to user's default room preference
if (state.matchedLocation == AppRoutes.root) {
final defaultRoom = authState.value?.preferences?.defaultRoom;
return _routeForDefaultRoom(defaultRoom);
// No auth required in LAN mode
if (!AppConfig.requiresAuth) {
return null;
}
final isAuthenticated = authState.value?.isAuthenticated ?? false;
final isLoginRoute = state.matchedLocation == AppRoutes.login;
// If not authenticated, redirect to login (except if already on login)
if (!isAuthenticated && !isLoginRoute) {
return AppRoutes.login;
}
// If authenticated and on login page, redirect to home
if (isAuthenticated && isLoginRoute) {
return AppRoutes.frontHall;
}
return null;
},
routes: [
// Root redirects to default room (handled by redirect callback above)
// Login route (outside shell - no app scaffold)
GoRoute(
path: AppRoutes.root,
redirect: (context, state) => _routeForDefaultRoom(null),
path: AppRoutes.login,
name: 'login',
builder: (context, state) => const _LoginPage(),
),
// Main app routes (inside shell with app scaffold)
ShellRoute(
builder: (context, state, child) => AppScaffold(child: child),
routes: [
// All room routes from registry
...roomRegistry.allRoutes(),
// Settings page (not a room, just a page)
GoRoute(
path: AppRoutes.frontHall,
name: 'frontHall',
builder: (context, state) => const FrontHallPage(),
),
...controlRoomRoutes(),
...securityRoutes(),
GoRoute(
path: AppRoutes.parlor,
name: 'parlor',
builder: (context, state) =>
const _PlaceholderPage(title: 'Parlor'),
),
GoRoute(
path: AppRoutes.settings,
name: 'settings',
pageBuilder: (context, state) =>
noTransitionPage(context, state, const SettingsPage()),
builder: (context, state) =>
const _PlaceholderPage(title: 'Settings'),
),
],
),
@@ -100,4 +85,190 @@ GoRouter appRouter(Ref ref) {
);
}
/// Placeholder page for routes not yet implemented.
class _PlaceholderPage extends StatelessWidget {
const _PlaceholderPage({required this.title});
final String title;
@override
Widget build(BuildContext context) {
return Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
Icon(
Icons.construction,
size: 64,
color: Theme.of(context).colorScheme.outline,
),
const SizedBox(height: 16),
Text(
title,
style: Theme.of(context).textTheme.headlineMedium,
),
const SizedBox(height: 8),
Text(
'Coming soon',
style: Theme.of(context).textTheme.bodyLarge?.copyWith(
color: Theme.of(context).colorScheme.outline,
),
),
],
),
);
}
}
/// Login page displayed when user is not authenticated.
class _LoginPage extends ConsumerWidget {
const _LoginPage();
@override
Widget build(BuildContext context, WidgetRef ref) {
final authAsync = ref.watch(authProvider);
final colorScheme = Theme.of(context).colorScheme;
return Scaffold(
body: Center(
child: ConstrainedBox(
constraints: const BoxConstraints(maxWidth: 400),
child: Card(
child: Padding(
padding: const EdgeInsets.all(32),
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Icon(
Icons.home_work_outlined,
size: 64,
color: colorScheme.primary,
),
const SizedBox(height: 24),
Text(
'Tatlock Estate',
style: Theme.of(context).textTheme.headlineMedium?.copyWith(
fontWeight: FontWeight.w600,
),
),
const SizedBox(height: 8),
Text(
'Sign in to access the estate management system',
style: Theme.of(context).textTheme.bodyMedium?.copyWith(
color: colorScheme.onSurfaceVariant,
),
textAlign: TextAlign.center,
),
const SizedBox(height: 32),
authAsync.when(
data: (_) => _buildSignInContent(context, ref),
loading: () => const Column(
children: [
SizedBox(
width: 24,
height: 24,
child: CircularProgressIndicator(strokeWidth: 2),
),
SizedBox(height: 16),
Text('Checking authentication...'),
],
),
error: (error, _) => _buildErrorContent(context, ref, error),
),
],
),
),
),
),
),
);
}
Widget _buildSignInContent(BuildContext context, WidgetRef ref) {
if (kIsWeb) {
// Web: User needs to access via authenticated proxy
return Column(
children: [
Text(
'Please access Tatlock via the authenticated URL.\n'
'If you see this page, the proxy authentication may not be configured.',
style: Theme.of(context).textTheme.bodyMedium?.copyWith(
color: Theme.of(context).colorScheme.onSurfaceVariant,
),
textAlign: TextAlign.center,
),
const SizedBox(height: 16),
OutlinedButton.icon(
onPressed: () => ref.read(authProvider.notifier).signIn(),
icon: const Icon(Icons.refresh),
label: const Text('Retry'),
style: OutlinedButton.styleFrom(
minimumSize: const Size(double.infinity, 48),
),
),
],
);
}
// Mobile: Show sign in button
return FilledButton.icon(
onPressed: () => ref.read(authProvider.notifier).signIn(),
icon: const Icon(Icons.login),
label: const Text('Sign in with Authentik'),
style: FilledButton.styleFrom(
minimumSize: const Size(double.infinity, 48),
),
);
}
Widget _buildErrorContent(BuildContext context, WidgetRef ref, Object error) {
final colorScheme = Theme.of(context).colorScheme;
return Column(
children: [
Container(
padding: const EdgeInsets.all(12),
decoration: BoxDecoration(
color: colorScheme.errorContainer,
borderRadius: BorderRadius.circular(8),
),
child: Row(
children: [
Icon(Icons.error_outline, color: colorScheme.onErrorContainer),
const SizedBox(width: 12),
Expanded(
child: Text(
_formatError(error),
style: TextStyle(color: colorScheme.onErrorContainer),
),
),
],
),
),
const SizedBox(height: 16),
OutlinedButton.icon(
onPressed: () => ref.read(authProvider.notifier).signIn(),
icon: const Icon(Icons.refresh),
label: const Text('Try again'),
style: OutlinedButton.styleFrom(
minimumSize: const Size(double.infinity, 48),
),
),
],
);
}
String _formatError(Object error) {
final message = error.toString();
if (message.contains('user_cancelled')) {
return 'Sign in was cancelled';
}
if (message.contains('network')) {
return 'Network error. Please check your connection.';
}
if (message.contains('authenticated URL')) {
return 'Not authenticated - please access via the authenticated URL';
}
return 'Authentication failed. Please try again.';
}
}
-113
View File
@@ -1,113 +0,0 @@
import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
/// Defines a room in the application.
///
/// Each feature/room registers itself with metadata for navigation,
/// routing, and permission-based access control.
class RoomDefinition {
const RoomDefinition({
required this.id,
required this.label,
required this.icon,
required this.selectedIcon,
required this.defaultRoute,
required this.routes,
this.requiredPermissions = const [],
});
/// Unique identifier used in preferences (e.g., 'front-hall', 'control-room').
final String id;
/// Display label for UI.
final String label;
/// Icon when not selected.
final IconData icon;
/// Icon when selected.
final IconData selectedIcon;
/// Default route path when room is selected.
final String defaultRoute;
/// All routes this room provides to go_router.
final List<RouteBase> Function() routes;
/// Permissions required to access this room (empty = accessible to all).
/// User must have ALL listed permissions.
final List<String> requiredPermissions;
}
/// Central registry of all rooms in the application.
///
/// Each room's router.dart file registers itself here.
/// UI components query this registry to build navigation.
class RoomRegistry {
RoomRegistry._();
static final RoomRegistry instance = RoomRegistry._();
final List<RoomDefinition> _rooms = [];
/// Register a room. Called by each room's router.dart.
void register(RoomDefinition room) {
// Avoid duplicate registration
if (!_rooms.any((r) => r.id == room.id)) {
_rooms.add(room);
}
}
/// Get all registered rooms.
List<RoomDefinition> get all => List.unmodifiable(_rooms);
/// Get rooms filtered by user permissions.
///
/// [userPermissions] is the set of permissions the user has.
/// Returns rooms where the user has ALL required permissions.
List<RoomDefinition> accessibleTo(Set<String> userPermissions) {
return _rooms.where((room) {
if (room.requiredPermissions.isEmpty) return true;
return room.requiredPermissions.every(userPermissions.contains);
}).toList();
}
/// Get a room by its ID.
RoomDefinition? byId(String id) {
try {
return _rooms.firstWhere((r) => r.id == id);
} catch (_) {
return null;
}
}
/// Get the index of a room by its ID.
int indexOfId(String id) {
return _rooms.indexWhere((r) => r.id == id);
}
/// Get the index of a room by route path.
int indexOfRoute(String path) {
// Find room whose defaultRoute matches or whose routes start with path
for (var i = 0; i < _rooms.length; i++) {
final room = _rooms[i];
if (path == room.defaultRoute || path.startsWith('/${room.id}')) {
return i;
}
}
return 0; // Default to first room
}
/// Get all routes from all registered rooms.
List<RouteBase> allRoutes() {
return _rooms.expand((room) => room.routes()).toList();
}
/// Clear registry (useful for testing).
void clear() {
_rooms.clear();
}
}
/// Global registry instance.
final roomRegistry = RoomRegistry.instance;
-98
View File
@@ -1,98 +0,0 @@
import 'package:flutter/foundation.dart' show kIsWeb;
// Conditional import for web-only functionality
import 'url_state_stub.dart' if (dart.library.js_interop) 'url_state_web.dart'
as platform;
/// Parses and builds URL query parameters for page state.
///
/// Used to enable deep-linking for DataGrid and filter panel state.
/// Query params are read once on page load and updated via browser
/// replaceState to avoid GoRouter rebuild loops.
class PageUrlState {
const PageUrlState({
this.id,
this.filter,
this.search,
this.sortColumn,
this.sortDescending = false,
});
/// Opened document ID (view/edit mode).
final String? id;
/// Filter panel search value.
final String? filter;
/// DataGrid search value.
final String? search;
/// Column ID for sorting.
final String? sortColumn;
/// Sort direction (true = descending).
final bool sortDescending;
/// Parse from query parameters map.
factory PageUrlState.fromQueryParams(Map<String, String> params) {
return PageUrlState(
id: params['id'],
filter: params['filter'],
search: params['search'],
sortColumn: params['sort'],
sortDescending: params['order'] == 'desc',
);
}
/// Convert to query parameter map (omits empty/default values).
Map<String, String> toQueryParams() {
return {
if (id != null && id!.isNotEmpty) 'id': id!,
if (filter != null && filter!.isNotEmpty) 'filter': filter!,
if (search != null && search!.isNotEmpty) 'search': search!,
if (sortColumn != null && sortColumn!.isNotEmpty) 'sort': sortColumn!,
if (sortDescending) 'order': 'desc',
};
}
/// Create a copy with modified values.
PageUrlState copyWith({
String? id,
String? filter,
String? search,
String? sortColumn,
bool? sortDescending,
bool clearId = false,
}) {
return PageUrlState(
id: clearId ? null : (id ?? this.id),
filter: filter ?? this.filter,
search: search ?? this.search,
sortColumn: sortColumn ?? this.sortColumn,
sortDescending: sortDescending ?? this.sortDescending,
);
}
/// Whether any state is present.
bool get isEmpty =>
id == null &&
(filter == null || filter!.isEmpty) &&
(search == null || search!.isEmpty) &&
sortColumn == null;
@override
String toString() =>
'PageUrlState(id: $id, filter: $filter, search: $search, '
'sort: $sortColumn, desc: $sortDescending)';
}
/// Updates browser URL with query parameters without triggering navigation.
///
/// Uses browser's replaceState API on web, no-op on other platforms.
/// This allows the URL to stay in sync for bookmarking/sharing without
/// causing Flutter to rebuild.
void updateBrowserUrlParams(Map<String, String> params) {
if (kIsWeb) {
platform.updateBrowserUrlParams(params);
}
}
-4
View File
@@ -1,4 +0,0 @@
/// Stub implementation for non-web platforms.
void updateBrowserUrlParams(Map<String, String> params) {
// No-op on non-web platforms
}
-13
View File
@@ -1,13 +0,0 @@
import 'package:web/web.dart' as web;
/// Updates browser URL with query parameters without triggering navigation.
///
/// Uses browser's replaceState API to update the URL bar for bookmarking
/// without causing Flutter/GoRouter to rebuild the page.
void updateBrowserUrlParams(Map<String, String> params) {
final currentUri = Uri.parse(web.window.location.href);
final newUri = currentUri.replace(
queryParameters: params.isEmpty ? null : params,
);
web.window.history.replaceState(null, '', newUri.toString());
}
@@ -45,7 +45,6 @@ enum DataGridColumnAlignment {
/// Column definition for DataGrid.
class DataGridColumn<T> {
const DataGridColumn({
required this.id,
required this.header,
required this.valueBuilder,
this.cellBuilder,
@@ -59,9 +58,6 @@ class DataGridColumn<T> {
this.tooltip,
});
/// Unique identifier for this column (used in URL deep-linking).
final String id;
/// Column header text.
final String header;
@@ -15,15 +15,9 @@ class DataGridController<T> extends StateNotifier<DataGridState<T>> {
required this.source,
required this.config,
required this.idSelector,
String? initialSearch,
int? initialSortColumnIndex,
bool? initialSortDescending,
}) : super(DataGridState<T>(
searchQuery: initialSearch ?? '',
sortColumnIndex:
initialSortColumnIndex ?? config.defaultSortColumn,
sortDescending:
initialSortDescending ?? config.defaultSortDescending,
sortColumnIndex: config.defaultSortColumn,
sortDescending: config.defaultSortDescending,
)) {
// Initial load
_load();
@@ -35,13 +29,8 @@ class DataGridController<T> extends StateNotifier<DataGridState<T>> {
/// Grid configuration.
final DataGridConfig<T> config;
/// Function to extract unique ID from an item (used for selection and URL deep-linking).
///
/// Returns a unique string identifier for each row. Can be:
/// - A simple ID field: `(item) => item.id.toString()`
/// - A combination of fields: `(item) => '${item.name}_${item.type}'`
/// - Any unique identifier suitable for URLs
final String Function(T item) idSelector;
/// Function to extract unique ID from an item.
final Object Function(T item) idSelector;
/// Debounce timer for search.
Timer? _searchDebounce;
@@ -196,7 +185,7 @@ class DataGridController<T> extends StateNotifier<DataGridState<T>> {
if (!config.rowsSelectable) return;
final id = idSelector(item);
final newSelection = Set<String>.from(state.selectedIds);
final newSelection = Set<Object>.from(state.selectedIds);
if (newSelection.contains(id)) {
newSelection.remove(id);
@@ -298,35 +287,17 @@ class DataGridController<T> extends StateNotifier<DataGridState<T>> {
/// idSelector: (c) => c.id,
/// );
/// ```
///
/// For URL deep-linking, pass initial state from URL params:
/// ```dart
/// final gridProvider = dataGridProvider<Container>(
/// source: source,
/// config: config,
/// idSelector: (c) => c.id,
/// initialSearch: urlState.search,
/// initialSortColumnIndex: _columnIndexForId(urlState.sortColumn),
/// initialSortDescending: urlState.sortDescending,
/// );
/// ```
StateNotifierProvider<DataGridController<T>, DataGridState<T>>
dataGridProvider<T>({
required DataGridSource<T> source,
required DataGridConfig<T> config,
required String Function(T) idSelector,
String? initialSearch,
int? initialSortColumnIndex,
bool? initialSortDescending,
required Object Function(T) idSelector,
}) {
return StateNotifierProvider<DataGridController<T>, DataGridState<T>>(
(ref) => DataGridController<T>(
source: source,
config: config,
idSelector: idSelector,
initialSearch: initialSearch,
initialSortColumnIndex: initialSortColumnIndex,
initialSortDescending: initialSortDescending,
),
);
}
@@ -31,7 +31,7 @@ sealed class DataGridState<T> with _$DataGridState<T> {
@Default(false) bool sortDescending,
/// Currently selected item IDs (if selectable).
@Default({}) Set<String> selectedIds,
@Default({}) Set<Object> selectedIds,
/// Current page (for paginated mode).
@Default(0) int currentPage,
+19 -172
View File
@@ -1,19 +1,12 @@
import 'package:flutter/foundation.dart' show kIsWeb;
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:go_router/go_router.dart';
import 'package:tatlock_ui/core/auth/auth_provider.dart';
import 'package:tatlock_ui/core/config/app_config.dart';
import 'package:tatlock_ui/routing/room_registry.dart';
import 'package:tatlock_ui/features/control_room/router.dart';
import 'package:tatlock_ui/features/security/router.dart';
import 'package:tatlock_ui/routing/app_router.dart';
import 'package:tatlock_ui/shared/layouts/widgets/top_header_bar.dart';
/// Main application scaffold with top header navigation.
///
/// Handles authentication automatically:
/// - If not authenticated, auto-initiates OIDC flow
/// - Shows loading state during authentication
/// - Shows error state if auth fails (with retry)
///
/// Layout structure per UI_LAYOUT.md:
/// ```
/// ┌─────────────────────────────────────────────────────────────────┐
@@ -22,62 +15,16 @@ import 'package:tatlock_ui/shared/layouts/widgets/top_header_bar.dart';
/// │ BODY: Room page content (may include room-specific sidebar) │
/// └─────────────────────────────────────────────────────────────────┘
/// ```
class AppScaffold extends ConsumerStatefulWidget {
class AppScaffold extends StatelessWidget {
const AppScaffold({super.key, required this.child});
final Widget child;
@override
ConsumerState<AppScaffold> createState() => _AppScaffoldState();
}
class _AppScaffoldState extends ConsumerState<AppScaffold> {
// Header height must match TopHeaderBar._headerHeight
static const double _headerHeight = 56.0;
bool _authInitiated = false;
@override
Widget build(BuildContext context) {
// No auth required in LAN mode - show content directly
if (!AppConfig.requiresAuth) {
return _buildScaffold(context);
}
// Watch auth state (works for both web and mobile)
final authAsync = ref.watch(authProvider);
return authAsync.when(
data: (authState) {
if (authState.isAuthenticated) {
// Authenticated - show the app
_authInitiated = false; // Reset for next time
return _buildScaffold(context);
}
// On web, NPM handles auth - if we're here without auth, something is wrong
// (NPM should have redirected to Authentik before we loaded)
if (kIsWeb) {
return _buildAuthErrorScreen(context, 'Authentication required');
}
// Mobile: Not authenticated - auto-initiate OIDC
if (!_authInitiated) {
_authInitiated = true;
WidgetsBinding.instance.addPostFrameCallback((_) {
ref.read(authProvider.notifier).signIn();
});
}
// Show loading while redirecting to Authentik
return _buildAuthLoadingScreen(context, 'Redirecting to sign in...');
},
loading: () => _buildAuthLoadingScreen(context, 'Loading user info...'),
error: (error, _) => _buildAuthErrorScreen(context, error),
);
}
Widget _buildScaffold(BuildContext context) {
return Scaffold(
body: Stack(
children: [
@@ -85,7 +32,7 @@ class _AppScaffoldState extends ConsumerState<AppScaffold> {
Positioned.fill(
child: Padding(
padding: const EdgeInsets.only(top: _headerHeight),
child: widget.child,
child: child,
),
),
@@ -104,124 +51,24 @@ class _AppScaffoldState extends ConsumerState<AppScaffold> {
);
}
Widget _buildAuthLoadingScreen(BuildContext context, String message) {
final colorScheme = Theme.of(context).colorScheme;
return Scaffold(
body: Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
Icon(
Icons.home_work_outlined,
size: 64,
color: colorScheme.primary,
),
const SizedBox(height: 24),
Text(
'Tatlock Estate',
style: Theme.of(context).textTheme.headlineMedium?.copyWith(
fontWeight: FontWeight.w600,
),
),
const SizedBox(height: 32),
const SizedBox(
width: 24,
height: 24,
child: CircularProgressIndicator(strokeWidth: 2),
),
const SizedBox(height: 16),
Text(
message,
style: Theme.of(context).textTheme.bodyMedium?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
],
),
),
);
}
Widget _buildAuthErrorScreen(BuildContext context, Object error) {
final colorScheme = Theme.of(context).colorScheme;
return Scaffold(
body: Center(
child: ConstrainedBox(
constraints: const BoxConstraints(maxWidth: 400),
child: Card(
child: Padding(
padding: const EdgeInsets.all(32),
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Icon(
Icons.error_outline,
size: 64,
color: colorScheme.error,
),
const SizedBox(height: 24),
Text(
'Authentication Failed',
style: Theme.of(context).textTheme.headlineMedium?.copyWith(
fontWeight: FontWeight.w600,
),
),
const SizedBox(height: 16),
Container(
padding: const EdgeInsets.all(12),
decoration: BoxDecoration(
color: colorScheme.errorContainer,
borderRadius: BorderRadius.circular(8),
),
child: Text(
_formatError(error),
style: TextStyle(color: colorScheme.onErrorContainer),
textAlign: TextAlign.center,
),
),
const SizedBox(height: 24),
FilledButton.icon(
onPressed: () {
_authInitiated = false;
ref.read(authProvider.notifier).signIn();
},
icon: const Icon(Icons.refresh),
label: const Text('Try again'),
style: FilledButton.styleFrom(
minimumSize: const Size(double.infinity, 48),
),
),
],
),
),
),
),
),
);
}
String _formatError(Object error) {
final message = error.toString();
if (message.contains('user_cancelled')) {
return 'Sign in was cancelled';
}
if (message.contains('network')) {
return 'Network error. Please check your connection.';
}
return 'Authentication failed. Please try again.';
}
int _selectedIndex(BuildContext context) {
final location = GoRouterState.of(context).matchedLocation;
return roomRegistry.indexOfRoute(location);
if (location.startsWith(ControlRoomRoutes.base)) return 1;
if (location.startsWith(SecurityRoutes.base)) return 2;
if (location.startsWith(AppRoutes.parlor)) return 3;
// Settings is no longer in main nav (accessed via Profile dropdown)
return 0; // Front Hall
}
void _onNavSelected(BuildContext context, int index) {
final rooms = roomRegistry.all;
if (index >= 0 && index < rooms.length) {
context.go(rooms[index].defaultRoute);
}
final route = switch (index) {
0 => AppRoutes.frontHall,
1 => ControlRoomRoutes.containers,
2 => SecurityRoutes.users,
3 => AppRoutes.parlor,
_ => AppRoutes.frontHall,
};
context.go(route);
}
}
+10 -17
View File
@@ -1,5 +1,4 @@
import 'package:flutter/material.dart';
import 'package:tatlock_ui/core/semantics/semantic_ids.dart';
import 'panel_header.dart';
@@ -200,22 +199,17 @@ class _NavTile extends StatelessWidget {
final colorScheme = Theme.of(context).colorScheme;
final textTheme = Theme.of(context).textTheme;
return Semantics(
identifier: NavSemantics.item(item.id),
label: item.label,
button: true,
selected: isSelected,
child: Padding(
padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 2),
child: Material(
color: isSelected
? colorScheme.primaryContainer.withValues(alpha: 0.4)
: Colors.transparent,
return Padding(
padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 2),
child: Material(
color: isSelected
? colorScheme.primaryContainer.withValues(alpha: 0.4)
: Colors.transparent,
borderRadius: BorderRadius.circular(8),
child: InkWell(
onTap: onTap,
borderRadius: BorderRadius.circular(8),
child: InkWell(
onTap: onTap,
borderRadius: BorderRadius.circular(8),
child: Padding(
child: Padding(
padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 10),
child: Row(
children: [
@@ -264,7 +258,6 @@ class _NavTile extends StatelessWidget {
),
),
),
),
);
}
}
+73 -216
View File
@@ -1,11 +1,7 @@
import 'dart:developer' as developer;
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:go_router/go_router.dart';
import 'package:tatlock_ui/core/auth/auth_provider.dart';
import 'package:tatlock_ui/core/semantics/semantic_ids.dart';
import 'package:tatlock_ui/core/theme/theme_provider.dart';
import 'package:tatlock_ui/routing/app_router.dart';
/// Profile dropdown menu in the header.
@@ -17,213 +13,90 @@ class ProfileDropdown extends ConsumerWidget {
@override
Widget build(BuildContext context, WidgetRef ref) {
final authState = ref.watch(authProvider);
final currentTheme = ref.watch(themeProvider);
final colorScheme = Theme.of(context).colorScheme;
return authState.when(
data: (auth) => Semantics(
identifier: ProfileSemantics.button,
label: 'Profile menu',
button: true,
child: PopupMenuButton<String>(
offset: const Offset(0, 48),
shape: RoundedRectangleBorder(
borderRadius: BorderRadius.circular(8),
),
child: Tooltip(
message: auth.isAuthenticated ? auth.userName ?? 'User' : 'Guest',
child: CircleAvatar(
radius: 18,
backgroundColor: colorScheme.primaryContainer,
child: auth.isAuthenticated
? Text(
_getInitials(auth.userName),
style: TextStyle(
color: colorScheme.onPrimaryContainer,
fontWeight: FontWeight.w500,
),
)
: Icon(
Icons.person_outline,
size: 20,
data: (auth) => PopupMenuButton<String>(
offset: const Offset(0, 48),
shape: RoundedRectangleBorder(
borderRadius: BorderRadius.circular(8),
),
child: Tooltip(
message: auth.isAuthenticated ? auth.userName ?? 'User' : 'Guest',
child: CircleAvatar(
radius: 18,
backgroundColor: colorScheme.primaryContainer,
child: auth.isAuthenticated
? Text(
_getInitials(auth.userName),
style: TextStyle(
color: colorScheme.onPrimaryContainer,
fontWeight: FontWeight.w500,
),
)
: Icon(
Icons.person_outline,
size: 20,
color: colorScheme.onPrimaryContainer,
),
),
),
itemBuilder: (context) => [
// User info header (non-selectable)
PopupMenuItem<String>(
enabled: false,
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
auth.isAuthenticated ? auth.userName ?? 'User' : 'Guest',
style: Theme.of(context).textTheme.titleSmall,
),
if (auth.userEmail != null)
Text(
auth.userEmail!,
style: Theme.of(context).textTheme.bodySmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
],
),
),
itemBuilder: (context) => [
// User info header (non-selectable)
PopupMenuItem<String>(
enabled: false,
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
const PopupMenuDivider(),
// Settings
const PopupMenuItem<String>(
value: 'settings',
child: Row(
children: [
Icon(Icons.settings_outlined, size: 20),
SizedBox(width: 12),
Text('Settings'),
],
),
),
// Logout (only if authenticated)
if (auth.isAuthenticated)
const PopupMenuItem<String>(
value: 'logout',
child: Row(
children: [
Text(
auth.isAuthenticated ? auth.userName ?? 'User' : 'Guest',
style: Theme.of(context).textTheme.titleSmall,
),
if (auth.userEmail != null)
Text(
auth.userEmail!,
style: Theme.of(context).textTheme.bodySmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
Icon(Icons.logout, size: 20),
SizedBox(width: 12),
Text('Logout'),
],
),
),
const PopupMenuDivider(),
// Settings
PopupMenuItem<String>(
value: 'settings',
child: Semantics(
identifier: ProfileSemantics.settings,
child: const Row(
children: [
Icon(Icons.settings_outlined, size: 20),
SizedBox(width: 12),
Text('Settings'),
],
),
),
),
// Theme submenu header
PopupMenuItem<String>(
enabled: false,
height: 32,
child: Text(
'THEME',
style: Theme.of(context).textTheme.labelSmall?.copyWith(
color: colorScheme.onSurfaceVariant,
letterSpacing: 0.5,
),
),
),
// Theme: System
PopupMenuItem<String>(
value: 'theme_system',
height: 40,
child: Semantics(
identifier: ProfileSemantics.themeSystem,
child: Row(
children: [
Icon(
Icons.brightness_auto,
size: 18,
color: currentTheme == ThemeSetting.system
? colorScheme.primary
: null,
),
const SizedBox(width: 12),
Text(
'System',
style: currentTheme == ThemeSetting.system
? TextStyle(color: colorScheme.primary)
: null,
),
const Spacer(),
if (currentTheme == ThemeSetting.system)
Icon(Icons.check, size: 16, color: colorScheme.primary),
],
),
),
),
// Theme: Light
PopupMenuItem<String>(
value: 'theme_light',
height: 40,
child: Semantics(
identifier: ProfileSemantics.themeLight,
child: Row(
children: [
Icon(
Icons.light_mode,
size: 18,
color: currentTheme == ThemeSetting.light
? colorScheme.primary
: null,
),
const SizedBox(width: 12),
Text(
'Light',
style: currentTheme == ThemeSetting.light
? TextStyle(color: colorScheme.primary)
: null,
),
const Spacer(),
if (currentTheme == ThemeSetting.light)
Icon(Icons.check, size: 16, color: colorScheme.primary),
],
),
),
),
// Theme: Dark
PopupMenuItem<String>(
value: 'theme_dark',
height: 40,
child: Semantics(
identifier: ProfileSemantics.themeDark,
child: Row(
children: [
Icon(
Icons.dark_mode,
size: 18,
color: currentTheme == ThemeSetting.dark
? colorScheme.primary
: null,
),
const SizedBox(width: 12),
Text(
'Dark',
style: currentTheme == ThemeSetting.dark
? TextStyle(color: colorScheme.primary)
: null,
),
const Spacer(),
if (currentTheme == ThemeSetting.dark)
Icon(Icons.check, size: 16, color: colorScheme.primary),
],
),
),
),
const PopupMenuDivider(),
// Logout (only if authenticated)
if (auth.isAuthenticated)
PopupMenuItem<String>(
value: 'logout',
child: Semantics(
identifier: ProfileSemantics.logout,
child: const Row(
children: [
Icon(Icons.logout, size: 20),
SizedBox(width: 12),
Text('Logout'),
],
),
),
),
],
onSelected: (value) {
switch (value) {
case 'settings':
context.go(AppRoutes.settings);
case 'theme_system':
_updateTheme(ref, ThemeSetting.system);
case 'theme_light':
_updateTheme(ref, ThemeSetting.light);
case 'theme_dark':
_updateTheme(ref, ThemeSetting.dark);
case 'logout':
ref.read(authProvider.notifier).signOut();
}
},
),
],
onSelected: (value) {
switch (value) {
case 'settings':
context.go(AppRoutes.settings);
case 'logout':
ref.read(authProvider.notifier).signOut();
}
},
),
loading: () => const CircleAvatar(
radius: 18,
@@ -253,20 +126,4 @@ class ProfileDropdown extends ConsumerWidget {
}
return name[0].toUpperCase();
}
/// Update theme locally and sync to API.
Future<void> _updateTheme(WidgetRef ref, ThemeSetting setting) async {
// Update local theme immediately for instant UI response
await ref.read(themeProvider.notifier).setSetting(setting);
// Sync to backend (fire-and-forget, errors logged not shown)
try {
await ref.read(authProvider.notifier).updatePreferences(
theme: setting.name,
);
} catch (e) {
// Theme still works locally even if API sync fails
developer.log('Failed to sync theme preference: $e', name: 'profile');
}
}
}
+46 -24
View File
@@ -1,8 +1,6 @@
import 'dart:math';
import 'package:flutter/material.dart';
import 'package:tatlock_ui/core/semantics/semantic_ids.dart';
import 'package:tatlock_ui/routing/room_registry.dart';
import 'profile_dropdown.dart';
@@ -25,8 +23,28 @@ class TopHeaderBar extends StatelessWidget {
static const double _logoCircleRadius = (_logoSize + _logoMargin * 2) / 2; // 64px
static const double _bulgeFraction = 0.20; // 20% of circle below header line
/// Get rooms from the registry.
List<RoomDefinition> get _rooms => roomRegistry.all;
static const _rooms = [
_RoomDestination(
icon: Icons.door_front_door_outlined,
selectedIcon: Icons.door_front_door,
label: 'Front Hall',
),
_RoomDestination(
icon: Icons.dns_outlined,
selectedIcon: Icons.dns,
label: 'Control Room',
),
_RoomDestination(
icon: Icons.security_outlined,
selectedIcon: Icons.security,
label: 'Security',
),
_RoomDestination(
icon: Icons.lightbulb_outline,
selectedIcon: Icons.lightbulb,
label: 'Parlor',
),
];
@override
Widget build(BuildContext context) {
@@ -102,31 +120,24 @@ class TopHeaderBar extends StatelessWidget {
List<Widget> _buildRoomTabs(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final rooms = _rooms;
return List.generate(rooms.length, (index) {
final room = rooms[index];
return List.generate(_rooms.length, (index) {
final room = _rooms[index];
final isSelected = index == selectedIndex;
return Padding(
padding: const EdgeInsets.symmetric(horizontal: 4),
child: Semantics(
identifier: RoomTabSemantics.forIndex(index),
label: room.label,
button: true,
selected: isSelected,
child: Tooltip(
message: room.label,
child: IconButton(
icon: Icon(
isSelected ? room.selectedIcon : room.icon,
color: isSelected ? colorScheme.primary : colorScheme.onSurface,
),
onPressed: () => onRoomSelected(index),
style: IconButton.styleFrom(
backgroundColor:
isSelected ? colorScheme.primaryContainer : null,
),
child: Tooltip(
message: room.label,
child: IconButton(
icon: Icon(
isSelected ? room.selectedIcon : room.icon,
color: isSelected ? colorScheme.primary : colorScheme.onSurface,
),
onPressed: () => onRoomSelected(index),
style: IconButton.styleFrom(
backgroundColor:
isSelected ? colorScheme.primaryContainer : null,
),
),
),
@@ -239,3 +250,14 @@ class _HeaderPainter extends CustomPainter {
}
}
class _RoomDestination {
const _RoomDestination({
required this.icon,
required this.selectedIcon,
required this.label,
});
final IconData icon;
final IconData selectedIcon;
final String label;
}
+3 -132
View File
@@ -1,24 +1,17 @@
import 'package:flutter/material.dart';
import 'package:tatlock_ui/features/front_hall/data/models/environment_model.dart'
as api;
import 'package:tatlock_ui/shared/theme/stoplight_colors.dart';
/// Air Quality Index widget displaying current AQI.
///
/// Displays air quality data from the Core API environment endpoint.
/// Only render this widget when air quality data is available.
/// Currently uses mock data. Will be connected to air quality API in future.
class AirQualityWidget extends StatelessWidget {
const AirQualityWidget({
super.key,
this.apiData,
this.data,
this.compact = false,
});
/// Air quality data from API. Takes priority over legacy data.
final api.AirQualityData? apiData;
/// Legacy air quality data to display. Uses mock data if null.
/// Air quality data to display. Uses mock data if null.
final AirQualityData? data;
/// Whether to use compact layout.
@@ -27,17 +20,7 @@ class AirQualityWidget extends StatelessWidget {
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
// Show "no data" state when no API data and no legacy data
if (apiData == null && data == null) {
if (compact) {
return _buildCompactNoData(context, colorScheme);
}
return _buildNoData(context, colorScheme);
}
// Convert API data to local model, or use legacy data
final aqi = apiData != null ? _fromApiData(apiData!) : data!;
final aqi = data ?? AirQualityData.mock();
if (compact) {
return _buildCompact(context, colorScheme, aqi);
@@ -184,93 +167,6 @@ class AirQualityWidget extends StatelessWidget {
),
);
}
Widget _buildNoData(BuildContext context, ColorScheme colorScheme) {
return Card(
child: Padding(
padding: const EdgeInsets.all(16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
// Header
Row(
children: [
Icon(
Icons.air,
size: 20,
color: colorScheme.onSurfaceVariant,
),
const SizedBox(width: 8),
Text(
'Air Quality',
style: Theme.of(context).textTheme.titleSmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
],
),
const SizedBox(height: 24),
Center(
child: Column(
children: [
Icon(
Icons.air_outlined,
size: 32,
color: colorScheme.outline,
),
const SizedBox(height: 8),
Text(
'No data available',
style: Theme.of(context).textTheme.bodyMedium?.copyWith(
color: colorScheme.outline,
),
),
],
),
),
const SizedBox(height: 16),
],
),
),
);
}
Widget _buildCompactNoData(BuildContext context, ColorScheme colorScheme) {
return Card(
child: Padding(
padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
child: Row(
mainAxisSize: MainAxisSize.min,
children: [
Container(
width: 32,
height: 32,
decoration: BoxDecoration(
color: colorScheme.outline.withValues(alpha: 0.15),
borderRadius: BorderRadius.circular(6),
),
child: Center(
child: Text(
'--',
style: Theme.of(context).textTheme.titleSmall?.copyWith(
color: colorScheme.outline,
),
),
),
),
const SizedBox(width: 8),
Text(
'AQI',
style: Theme.of(context).textTheme.bodySmall?.copyWith(
color: colorScheme.outline,
),
),
],
),
),
);
}
}
class _PollutantChip extends StatelessWidget {
@@ -303,31 +199,6 @@ class _PollutantChip extends StatelessWidget {
}
}
/// Converts API air quality data to local AirQualityData model.
AirQualityData _fromApiData(api.AirQualityData data) {
final index = data.aqi ?? 0;
final pollutants = <Pollutant>[];
if (data.pm25 != null) {
pollutants.add(Pollutant(name: 'PM2.5', value: data.pm25!, unit: 'µg/m³'));
}
if (data.pm10 != null) {
pollutants.add(Pollutant(name: 'PM10', value: data.pm10!, unit: 'µg/m³'));
}
if (data.o3 != null) {
pollutants.add(Pollutant(name: 'O₃', value: data.o3!, unit: 'ppb'));
}
if (data.no2 != null) {
pollutants.add(Pollutant(name: 'NO₂', value: data.no2!, unit: 'ppb'));
}
return AirQualityData(
index: index,
level: AqiLevel.fromIndex(index),
pollutants: pollutants,
);
}
/// Air Quality Index levels based on US EPA standard.
enum AqiLevel {
good(
-305
View File
@@ -1,305 +0,0 @@
import 'package:flutter/material.dart';
import 'package:intl/intl.dart';
import 'package:tatlock_ui/features/front_hall/data/models/environment_model.dart';
/// Forecast widget displaying multi-day weather outlook.
///
/// Shows a horizontal scrollable list of forecast days with
/// high/low temperatures and weather icons.
class ForecastWidget extends StatelessWidget {
const ForecastWidget({
super.key,
this.forecast,
this.compact = false,
});
/// Forecast data to display.
final List<ForecastDay>? forecast;
/// Whether to use compact layout.
final bool compact;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
if (forecast == null || forecast!.isEmpty) {
return Card(
child: Padding(
padding: const EdgeInsets.all(16),
child: Center(
child: Text(
'No forecast data available',
style: Theme.of(context).textTheme.bodyMedium?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
),
),
);
}
if (compact) {
return _buildCompact(context, colorScheme);
}
return Card(
child: Padding(
padding: const EdgeInsets.all(16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
// Header
Row(
children: [
Icon(
Icons.calendar_today,
size: 20,
color: colorScheme.onSurfaceVariant,
),
const SizedBox(width: 8),
Text(
'Forecast',
style: Theme.of(context).textTheme.titleSmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
],
),
const SizedBox(height: 16),
// Forecast days - horizontal scroll
SizedBox(
height: 100,
child: ListView.separated(
scrollDirection: Axis.horizontal,
itemCount: forecast!.length,
separatorBuilder: (_, i) => const SizedBox(width: 12),
itemBuilder: (context, index) {
return _ForecastDayCard(day: forecast![index]);
},
),
),
],
),
),
);
}
Widget _buildCompact(BuildContext context, ColorScheme colorScheme) {
// Show just first 3 days in compact mode
final days = forecast!.take(3).toList();
return Card(
child: Padding(
padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
child: Row(
mainAxisSize: MainAxisSize.min,
children: [
Icon(
Icons.calendar_today,
size: 20,
color: colorScheme.onSurfaceVariant,
),
const SizedBox(width: 8),
...days.map((day) => Padding(
padding: const EdgeInsets.symmetric(horizontal: 4),
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Text(
_getDayName(day.date),
style: Theme.of(context).textTheme.labelSmall,
),
Icon(
_getWeatherIcon(day.conditions),
size: 16,
color: _getWeatherColor(day.conditions),
),
Text(
'${day.high?.round() ?? '--'}°',
style: Theme.of(context).textTheme.labelSmall,
),
],
),
)),
],
),
),
);
}
String _getDayName(String dateStr) {
try {
final date = DateTime.parse(dateStr);
final now = DateTime.now();
if (date.day == now.day &&
date.month == now.month &&
date.year == now.year) {
return 'Today';
}
final tomorrow = now.add(const Duration(days: 1));
if (date.day == tomorrow.day &&
date.month == tomorrow.month &&
date.year == tomorrow.year) {
return 'Tmrw';
}
return DateFormat('E').format(date);
} catch (_) {
return dateStr.length > 3 ? dateStr.substring(0, 3) : dateStr;
}
}
IconData _getWeatherIcon(String? conditions) {
final condition = conditions?.toLowerCase() ?? '';
if (condition.contains('clear') || condition.contains('sunny')) {
return Icons.wb_sunny;
} else if (condition.contains('cloud') || condition.contains('overcast')) {
return Icons.cloud;
} else if (condition.contains('rain') || condition.contains('drizzle')) {
return Icons.grain;
} else if (condition.contains('storm') || condition.contains('thunder')) {
return Icons.thunderstorm;
} else if (condition.contains('snow') || condition.contains('sleet')) {
return Icons.ac_unit;
} else if (condition.contains('fog') || condition.contains('mist')) {
return Icons.blur_on;
}
return Icons.cloud;
}
Color? _getWeatherColor(String? conditions) {
final condition = conditions?.toLowerCase() ?? '';
if (condition.contains('clear') || condition.contains('sunny')) {
return Colors.amber;
} else if (condition.contains('cloud')) {
return Colors.blueGrey;
} else if (condition.contains('rain')) {
return Colors.blue;
} else if (condition.contains('storm')) {
return Colors.deepPurple;
} else if (condition.contains('snow')) {
return Colors.lightBlue;
}
return null;
}
}
class _ForecastDayCard extends StatelessWidget {
const _ForecastDayCard({required this.day});
final ForecastDay day;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final icon = _getWeatherIcon(day.conditions);
final color = _getWeatherColor(day.conditions) ?? colorScheme.primary;
return Container(
width: 72,
padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 12),
decoration: BoxDecoration(
color: colorScheme.surfaceContainerHighest,
borderRadius: BorderRadius.circular(12),
),
child: Column(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
// Day name
Text(
_getDayName(day.date),
style: Theme.of(context).textTheme.labelMedium?.copyWith(
fontWeight: FontWeight.w600,
),
),
// Weather icon
Icon(
icon,
size: 24,
color: color,
),
// High/Low temps
Column(
children: [
Text(
'${day.high?.round() ?? '--'}°',
style: Theme.of(context).textTheme.bodyMedium?.copyWith(
fontWeight: FontWeight.bold,
),
),
Text(
'${day.low?.round() ?? '--'}°',
style: Theme.of(context).textTheme.labelSmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
],
),
],
),
);
}
String _getDayName(String dateStr) {
try {
final date = DateTime.parse(dateStr);
final now = DateTime.now();
if (date.day == now.day &&
date.month == now.month &&
date.year == now.year) {
return 'Today';
}
final tomorrow = now.add(const Duration(days: 1));
if (date.day == tomorrow.day &&
date.month == tomorrow.month &&
date.year == tomorrow.year) {
return 'Tmrw';
}
return DateFormat('EEE').format(date);
} catch (_) {
return dateStr.length > 3 ? dateStr.substring(0, 3) : dateStr;
}
}
IconData _getWeatherIcon(String? conditions) {
final condition = conditions?.toLowerCase() ?? '';
if (condition.contains('clear') || condition.contains('sunny')) {
return Icons.wb_sunny;
} else if (condition.contains('cloud') || condition.contains('overcast')) {
return Icons.cloud;
} else if (condition.contains('rain') || condition.contains('drizzle')) {
return Icons.grain;
} else if (condition.contains('storm') || condition.contains('thunder')) {
return Icons.thunderstorm;
} else if (condition.contains('snow') || condition.contains('sleet')) {
return Icons.ac_unit;
} else if (condition.contains('fog') || condition.contains('mist')) {
return Icons.blur_on;
}
return Icons.cloud;
}
Color? _getWeatherColor(String? conditions) {
final condition = conditions?.toLowerCase() ?? '';
if (condition.contains('clear') || condition.contains('sunny')) {
return Colors.amber;
} else if (condition.contains('cloud')) {
return Colors.blueGrey;
} else if (condition.contains('rain')) {
return Colors.blue;
} else if (condition.contains('storm')) {
return Colors.deepPurple;
} else if (condition.contains('snow')) {
return Colors.lightBlue;
}
return null;
}
}
-445
View File
@@ -1,445 +0,0 @@
import 'dart:math' as math;
import 'package:flutter/material.dart';
import 'package:tatlock_ui/features/front_hall/data/models/environment_model.dart';
/// Sun position widget displaying sunrise/sunset with animated arc.
///
/// Shows a semicircle arc representing the day, with sun/moon icon
/// moving along based on current time. Uses color gradients:
/// - Blue tones for night
/// - Orange tones for sunrise/sunset
/// - Yellow tones for daytime
class SunPositionWidget extends StatelessWidget {
const SunPositionWidget({
super.key,
this.sunTimes,
this.compact = false,
});
/// Sun times data to display.
final SunTimesData? sunTimes;
/// Whether to use compact layout.
final bool compact;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
if (compact) {
return _buildCompact(context, colorScheme);
}
return Card(
child: Padding(
padding: const EdgeInsets.all(16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
// Header
Row(
children: [
Icon(
_isDaytime ? Icons.wb_sunny : Icons.nightlight_round,
size: 20,
color: colorScheme.onSurfaceVariant,
),
const SizedBox(width: 8),
Text(
'Sun Position',
style: Theme.of(context).textTheme.titleSmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
],
),
const SizedBox(height: 16),
// Arc visualization
SizedBox(
height: 120,
child: CustomPaint(
size: const Size(double.infinity, 120),
painter: _SunArcPainter(
sunTimes: sunTimes,
isDark: colorScheme.brightness == Brightness.dark,
),
),
),
const SizedBox(height: 12),
// Sunrise/Sunset times
Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
_TimeDisplay(
icon: Icons.wb_twilight,
label: 'Sunrise',
time: sunTimes?.sunrise,
iconColor: Colors.orange,
),
if (sunTimes?.daylightMinutes != null)
_DaylightDisplay(minutes: sunTimes!.daylightMinutes!),
_TimeDisplay(
icon: Icons.nights_stay,
label: 'Sunset',
time: sunTimes?.sunset,
iconColor: Colors.deepOrange,
),
],
),
],
),
),
);
}
Widget _buildCompact(BuildContext context, ColorScheme colorScheme) {
return Card(
child: Padding(
padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
child: Row(
mainAxisSize: MainAxisSize.min,
children: [
Icon(
_isDaytime ? Icons.wb_sunny : Icons.nightlight_round,
size: 24,
color: _isDaytime ? Colors.amber : Colors.indigo,
),
const SizedBox(width: 8),
Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
Text(
_formatTime(sunTimes?.sunrise),
style: Theme.of(context).textTheme.labelSmall,
),
Text(
_formatTime(sunTimes?.sunset),
style: Theme.of(context).textTheme.labelSmall,
),
],
),
],
),
),
);
}
bool get _isDaytime {
final now = DateTime.now();
// Use actual sun times if available, otherwise default to 6am/6pm
final sunrise = sunTimes?.sunrise ??
DateTime(now.year, now.month, now.day, 6, 0);
final sunset = sunTimes?.sunset ??
DateTime(now.year, now.month, now.day, 18, 0);
return now.isAfter(sunrise) && now.isBefore(sunset);
}
String _formatTime(DateTime? time) {
if (time == null) return '--:--';
return '${time.hour.toString().padLeft(2, '0')}:${time.minute.toString().padLeft(2, '0')}';
}
}
class _TimeDisplay extends StatelessWidget {
const _TimeDisplay({
required this.icon,
required this.label,
required this.time,
this.iconColor,
});
final IconData icon;
final String label;
final DateTime? time;
final Color? iconColor;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
return Column(
children: [
Icon(
icon,
size: 20,
color: iconColor ?? colorScheme.primary,
),
const SizedBox(height: 4),
Text(
_formatTime(time),
style: Theme.of(context).textTheme.titleSmall?.copyWith(
fontWeight: FontWeight.w600,
),
),
Text(
label,
style: Theme.of(context).textTheme.labelSmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
],
);
}
String _formatTime(DateTime? time) {
if (time == null) return '--:--';
return '${time.hour.toString().padLeft(2, '0')}:${time.minute.toString().padLeft(2, '0')}';
}
}
class _DaylightDisplay extends StatelessWidget {
const _DaylightDisplay({required this.minutes});
final int minutes;
@override
Widget build(BuildContext context) {
final hours = minutes ~/ 60;
final mins = minutes % 60;
return Column(
children: [
Icon(
Icons.access_time,
size: 16,
color: Theme.of(context).colorScheme.outline,
),
const SizedBox(height: 4),
Text(
'${hours}h ${mins}m',
style: Theme.of(context).textTheme.bodySmall?.copyWith(
fontWeight: FontWeight.w500,
),
),
Text(
'Daylight',
style: Theme.of(context).textTheme.labelSmall?.copyWith(
color: Theme.of(context).colorScheme.onSurfaceVariant,
),
),
],
);
}
}
/// Custom painter for the sun arc visualization.
class _SunArcPainter extends CustomPainter {
_SunArcPainter({
this.sunTimes,
this.isDark = false,
});
final SunTimesData? sunTimes;
final bool isDark;
// Color palette
static const _nightBlue = Color(0xFF1a237e);
static const _dawnOrange = Color(0xFFff6f00);
static const _sunriseOrange = Color(0xFFffa000);
static const _dayYellow = Color(0xFFffc107);
static const _dayGold = Color(0xFFffb300);
static const _duskOrange = Color(0xFFef6c00);
static const _nightIndigo = Color(0xFF283593);
@override
void paint(Canvas canvas, Size size) {
final center = Offset(size.width / 2, size.height - 10);
final radius = math.min(size.width / 2 - 20, size.height - 30);
// Draw horizon line
final horizonPaint = Paint()
..color = isDark ? Colors.white24 : Colors.black12
..strokeWidth = 1;
canvas.drawLine(
Offset(center.dx - radius - 10, center.dy),
Offset(center.dx + radius + 10, center.dy),
horizonPaint,
);
// Create gradient for arc background
final arcRect = Rect.fromCenter(
center: center,
width: radius * 2,
height: radius * 2,
);
// Draw arc background (night portion below horizon implied)
final arcBgPaint = Paint()
..style = PaintingStyle.stroke
..strokeWidth = 8
..strokeCap = StrokeCap.round;
// Create gradient that transitions through time of day colors
arcBgPaint.shader = SweepGradient(
center: Alignment.bottomCenter,
startAngle: math.pi,
endAngle: 2 * math.pi,
colors: [
_nightBlue.withValues(alpha: 0.3),
_dawnOrange.withValues(alpha: 0.5),
_sunriseOrange.withValues(alpha: 0.6),
_dayYellow.withValues(alpha: 0.7),
_dayGold.withValues(alpha: 0.7),
_dayYellow.withValues(alpha: 0.6),
_duskOrange.withValues(alpha: 0.5),
_nightIndigo.withValues(alpha: 0.3),
],
stops: const [0.0, 0.1, 0.2, 0.4, 0.5, 0.6, 0.8, 1.0],
transform: const GradientRotation(-math.pi / 2),
).createShader(arcRect);
// Draw the arc (semicircle from left to right)
canvas.drawArc(
arcRect,
math.pi, // Start at left (180 degrees)
math.pi, // Sweep 180 degrees (semicircle)
false,
arcBgPaint,
);
// Calculate sun position
final sunPosition = _calculateSunPosition();
// Draw sun/moon indicator
final angle = math.pi + (sunPosition * math.pi); // Map 0-1 to pi-2pi
final sunX = center.dx + radius * math.cos(angle);
final sunY = center.dy + radius * math.sin(angle);
// Determine if day or night for icon/color
final isDaytime = sunPosition > 0 && sunPosition < 1;
final isNearHorizon = sunPosition < 0.15 || sunPosition > 0.85;
// Sun/moon glow
if (isDaytime) {
final glowColor = isNearHorizon ? _dawnOrange : _dayYellow;
final glowPaint = Paint()
..shader = RadialGradient(
colors: [
glowColor.withValues(alpha: 0.6),
glowColor.withValues(alpha: 0.0),
],
).createShader(
Rect.fromCircle(center: Offset(sunX, sunY), radius: 24),
);
canvas.drawCircle(Offset(sunX, sunY), 24, glowPaint);
}
// Sun/moon circle
final sunPaint = Paint()
..style = PaintingStyle.fill
..color = isDaytime
? (isNearHorizon ? _sunriseOrange : _dayYellow)
: _nightIndigo;
canvas.drawCircle(Offset(sunX, sunY), 12, sunPaint);
// Sun rays or moon craters
if (isDaytime) {
final rayPaint = Paint()
..style = PaintingStyle.stroke
..strokeWidth = 2
..color = (isNearHorizon ? _dawnOrange : _dayGold).withValues(alpha: 0.8);
for (var i = 0; i < 8; i++) {
final rayAngle = (i * math.pi / 4);
final innerRadius = 14.0;
final outerRadius = 18.0;
canvas.drawLine(
Offset(
sunX + innerRadius * math.cos(rayAngle),
sunY + innerRadius * math.sin(rayAngle),
),
Offset(
sunX + outerRadius * math.cos(rayAngle),
sunY + outerRadius * math.sin(rayAngle),
),
rayPaint,
);
}
} else {
// Moon highlight
final moonHighlight = Paint()
..style = PaintingStyle.fill
..color = Colors.white24;
canvas.drawCircle(Offset(sunX - 3, sunY - 3), 4, moonHighlight);
}
// Draw time markers on arc
_drawTimeMarkers(canvas, center, radius);
}
double _calculateSunPosition() {
final now = DateTime.now();
// Use actual sun times if available, otherwise default to 6am/6pm (12-hour cycles)
final sunrise = sunTimes?.sunrise ??
DateTime(now.year, now.month, now.day, 6, 0);
final sunset = sunTimes?.sunset ??
DateTime(now.year, now.month, now.day, 18, 0);
// Before sunrise
if (now.isBefore(sunrise)) {
// Calculate position in pre-dawn (negative values = below horizon)
final midnight = DateTime(now.year, now.month, now.day);
final minutesSinceMidnight = now.difference(midnight).inMinutes;
final minutesToSunrise = sunrise.difference(midnight).inMinutes;
// Map to 0 at sunrise, negative before
return (minutesSinceMidnight / minutesToSunrise) * 0.15 - 0.1;
}
// After sunset
if (now.isAfter(sunset)) {
// Calculate position in post-dusk
final minutesSinceSunset = now.difference(sunset).inMinutes;
final nextMidnight = DateTime(now.year, now.month, now.day + 1);
final minutesToMidnight = nextMidnight.difference(sunset).inMinutes;
// Map to 1 at sunset, going towards negative
return 1.0 + (minutesSinceSunset / minutesToMidnight) * 0.1;
}
// During daylight hours
final totalDaylight = sunset.difference(sunrise).inMinutes;
final minutesSinceSunrise = now.difference(sunrise).inMinutes;
return minutesSinceSunrise / totalDaylight;
}
void _drawTimeMarkers(Canvas canvas, Offset center, double radius) {
final textPainter = TextPainter(
textDirection: TextDirection.ltr,
textAlign: TextAlign.center,
);
final markerStyle = TextStyle(
fontSize: 10,
color: isDark ? Colors.white38 : Colors.black38,
);
// Draw quarter markers (6am, 12pm, 6pm positions conceptually)
final markers = ['6:00', '12:00', '18:00'];
final positions = [0.25, 0.5, 0.75];
for (var i = 0; i < markers.length; i++) {
final angle = math.pi + (positions[i] * math.pi);
final markerRadius = radius + 15;
final x = center.dx + markerRadius * math.cos(angle);
final y = center.dy + markerRadius * math.sin(angle);
textPainter.text = TextSpan(text: markers[i], style: markerStyle);
textPainter.layout();
textPainter.paint(
canvas,
Offset(x - textPainter.width / 2, y - textPainter.height / 2),
);
}
}
@override
bool shouldRepaint(covariant _SunArcPainter oldDelegate) {
return oldDelegate.sunTimes != sunTimes || oldDelegate.isDark != isDark;
}
}
+3 -149
View File
@@ -1,22 +1,16 @@
import 'package:flutter/material.dart';
import 'package:tatlock_ui/features/front_hall/data/models/environment_model.dart'
as api;
/// Weather widget displaying current conditions.
///
/// Displays weather data from the Core API environment endpoint.
/// Currently uses mock data. Will be connected to weather API in future.
class WeatherWidget extends StatelessWidget {
const WeatherWidget({
super.key,
this.apiData,
this.data,
this.compact = false,
});
/// Weather data from API. Takes priority over legacy data.
final api.WeatherData? apiData;
/// Legacy weather data to display. Uses mock data if null.
/// Weather data to display. Uses mock data if null.
final WeatherData? data;
/// Whether to use compact layout.
@@ -25,17 +19,7 @@ class WeatherWidget extends StatelessWidget {
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
// Show "no data" state when no API data and no legacy data
if (apiData == null && data == null) {
if (compact) {
return _buildCompactNoData(context, colorScheme);
}
return _buildNoData(context, colorScheme);
}
// Convert API data to local model, or use legacy data
final weather = apiData != null ? _fromApiData(apiData!) : data!;
final weather = data ?? WeatherData.mock();
if (compact) {
return _buildCompact(context, colorScheme, weather);
@@ -186,82 +170,6 @@ class WeatherWidget extends StatelessWidget {
),
);
}
Widget _buildNoData(BuildContext context, ColorScheme colorScheme) {
return Card(
child: Padding(
padding: const EdgeInsets.all(16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
// Header
Row(
children: [
Icon(
Icons.wb_sunny_outlined,
size: 20,
color: colorScheme.onSurfaceVariant,
),
const SizedBox(width: 8),
Text(
'Weather',
style: Theme.of(context).textTheme.titleSmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
],
),
const SizedBox(height: 24),
Center(
child: Column(
children: [
Icon(
Icons.cloud_off_outlined,
size: 32,
color: colorScheme.outline,
),
const SizedBox(height: 8),
Text(
'No data available',
style: Theme.of(context).textTheme.bodyMedium?.copyWith(
color: colorScheme.outline,
),
),
],
),
),
const SizedBox(height: 16),
],
),
),
);
}
Widget _buildCompactNoData(BuildContext context, ColorScheme colorScheme) {
return Card(
child: Padding(
padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
child: Row(
mainAxisSize: MainAxisSize.min,
children: [
Icon(
Icons.cloud_off_outlined,
size: 24,
color: colorScheme.outline,
),
const SizedBox(width: 8),
Text(
'--',
style: Theme.of(context).textTheme.titleMedium?.copyWith(
color: colorScheme.outline,
),
),
],
),
),
);
}
}
class _DetailChip extends StatelessWidget {
@@ -298,60 +206,6 @@ class _DetailChip extends StatelessWidget {
}
}
/// Converts API weather data to local WeatherData model.
WeatherData _fromApiData(api.WeatherData data) {
return WeatherData(
location: data.location ?? 'Unknown',
temperature: data.temperature ?? 0,
condition: data.conditions ?? 'Unknown',
icon: _getWeatherIcon(data.conditions, data.icon),
humidity: data.humidity,
windSpeed: data.windSpeed,
feelsLike: data.feelsLike,
iconColor: _getWeatherColor(data.conditions),
);
}
/// Maps weather condition to icon.
IconData _getWeatherIcon(String? conditions, String? iconCode) {
final condition = conditions?.toLowerCase() ?? '';
if (condition.contains('clear') || condition.contains('sunny')) {
return Icons.wb_sunny;
} else if (condition.contains('cloud') || condition.contains('overcast')) {
return Icons.cloud;
} else if (condition.contains('rain') || condition.contains('drizzle')) {
return Icons.grain;
} else if (condition.contains('storm') || condition.contains('thunder')) {
return Icons.thunderstorm;
} else if (condition.contains('snow') || condition.contains('sleet')) {
return Icons.ac_unit;
} else if (condition.contains('fog') || condition.contains('mist')) {
return Icons.blur_on;
} else if (condition.contains('wind')) {
return Icons.air;
}
return Icons.cloud;
}
/// Maps weather condition to color.
Color? _getWeatherColor(String? conditions) {
final condition = conditions?.toLowerCase() ?? '';
if (condition.contains('clear') || condition.contains('sunny')) {
return Colors.amber;
} else if (condition.contains('cloud')) {
return Colors.blueGrey;
} else if (condition.contains('rain')) {
return Colors.blue;
} else if (condition.contains('storm')) {
return Colors.deepPurple;
} else if (condition.contains('snow')) {
return Colors.lightBlue;
}
return null;
}
/// Temperature unit for weather display.
enum TemperatureUnit {
celsius('C'),
+13
View File
@@ -0,0 +1,13 @@
// GENERATED FILE - DO NOT EDIT
// Generated by build_runner from pubspec.yaml
/// Application version information from pubspec.yaml
class AppVersion {
AppVersion._();
static const String name = 'tatlock_ui';
static const String description = 'Tatlock - a Home Lab AI';
static const String version = '0.3.3';
static const int buildNumber = 1;
static const String fullVersion = '0.3.3+1';
}
-53
View File
@@ -1,53 +0,0 @@
# Increase buffer size for large headers from Authentik
proxy_buffers 8 16k;
proxy_buffer_size 32k;
# Exclude static assets from forward auth
# These paths bypass auth_request but still proxy to upstream
location ~ ^/(manifest\.json|favicon\.(ico|png)|health|icons|assets) {
auth_request off;
proxy_pass $forward_scheme://$server:$port;
}
# Forward authentication via standalone outpost
auth_request /outpost.goauthentik.io/auth/nginx;
error_page 401 = @goauthentik_proxy_signin;
# Capture auth response headers
auth_request_set $auth_cookie $upstream_http_set_cookie;
auth_request_set $authentik_username $upstream_http_x_authentik_username;
auth_request_set $authentik_groups $upstream_http_x_authentik_groups;
auth_request_set $authentik_email $upstream_http_x_authentik_email;
auth_request_set $authentik_name $upstream_http_x_authentik_name;
auth_request_set $authentik_uid $upstream_http_x_authentik_uid;
# Forward auth headers to application
add_header Set-Cookie $auth_cookie;
proxy_set_header X-authentik-username $authentik_username;
proxy_set_header X-authentik-groups $authentik_groups;
proxy_set_header X-authentik-email $authentik_email;
proxy_set_header X-authentik-name $authentik_name;
proxy_set_header X-authentik-uid $authentik_uid;
# Outpost proxy location
location /outpost.goauthentik.io {
proxy_pass https://localhost:9444/outpost.goauthentik.io;
proxy_set_header Host $host;
proxy_set_header X-Original-URL $scheme://$http_host$request_uri;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $http_host;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_pass_request_body off;
proxy_set_header Content-Length "";
# WebSocket support
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
}
# Signin redirect handler
location @goauthentik_proxy_signin {
internal;
return 302 /outpost.goauthentik.io/start?rd=$request_uri;
}
+1 -8
View File
@@ -16,7 +16,7 @@ publish_to: 'none' # Remove this line if you wish to publish to pub.dev
# https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
# In Windows, build-name is used as the major, minor, and patch parts
# of the product and file versions while build-number is used as the build suffix.
version: 1.5.1+1
version: 1.0.3+1
environment:
sdk: ^3.10.4
@@ -30,8 +30,6 @@ environment:
dependencies:
flutter:
sdk: flutter
flutter_web_plugins:
sdk: flutter
# State Management
flutter_riverpod: ^3.0.0
@@ -54,11 +52,6 @@ dependencies:
# Authentication (OIDC/OAuth2)
flutter_appauth: ^8.0.0
crypto: ^3.0.3
web: ^1.1.0
# Internationalization
intl: ^0.19.0
# UI
flex_color_scheme: ^8.1.0
@@ -1,365 +0,0 @@
import 'package:flutter/material.dart' hide Container;
import 'package:flutter_test/flutter_test.dart';
import 'package:tatlock_ui/features/control_room/containers/presentation/pages/containers_list_page.dart';
import '../../../../../harness/screen_sizes.dart';
import '../../../../../harness/test_harness.dart';
void main() {
final harness = TestHarness();
setUp(() => harness.setUp());
tearDown(() => harness.tearDown());
group('ContainersListPage', () {
testWidgets('displays loading state initially', (tester) async {
harness.givenAuthenticatedUser();
harness.givenContainers(); // Need response to avoid timeout
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
// Just pump once without settling to catch loading state
await tester.pump();
// Should show loading indicator (before data loads)
expect(find.byType(CircularProgressIndicator), findsOneWidget);
// Now settle to complete the test cleanly
await tester.pumpAndSettle();
});
testWidgets('displays containers from API', (tester) async {
harness.givenAuthenticatedUser();
harness.givenContainers();
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
await tester.pumpAndSettle();
// Should display container names from fixtures
expect(find.text('nginx-proxy'), findsOneWidget);
expect(find.text('postgres-db'), findsOneWidget);
expect(find.text('redis-cache'), findsOneWidget);
});
testWidgets('displays container images', (tester) async {
harness.givenAuthenticatedUser();
harness.givenContainers();
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
await tester.pumpAndSettle();
// Should display container images from fixtures
expect(find.text('nginx:latest'), findsOneWidget);
expect(find.text('postgres:15'), findsOneWidget);
expect(find.text('redis:7-alpine'), findsOneWidget);
});
testWidgets('displays search input', (tester) async {
harness.givenAuthenticatedUser();
harness.givenContainers();
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
await tester.pumpAndSettle();
// Should have search field
expect(find.byType(TextField), findsOneWidget);
expect(find.text('Search containers...'), findsOneWidget);
});
testWidgets('displays refresh button', (tester) async {
harness.givenAuthenticatedUser();
harness.givenContainers();
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
await tester.pumpAndSettle();
// Should have refresh button
expect(find.byIcon(Icons.refresh), findsOneWidget);
});
testWidgets('displays port information', (tester) async {
harness.givenAuthenticatedUser();
harness.givenContainers();
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
await tester.pumpAndSettle();
// Should display port mappings from fixtures
expect(find.textContaining('80:80'), findsOneWidget);
expect(find.textContaining('443:443'), findsOneWidget);
expect(find.textContaining('5432:5432'), findsOneWidget);
});
testWidgets('displays status information', (tester) async {
harness.givenAuthenticatedUser();
harness.givenContainers();
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
await tester.pumpAndSettle();
// Should display status from fixtures (health indicator stripped)
expect(find.textContaining('Up 3 days'), findsOneWidget);
expect(find.textContaining('Up 5 days'), findsOneWidget);
});
testWidgets('search filters containers', (tester) async {
harness.givenAuthenticatedUser();
harness.givenContainers();
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
await tester.pumpAndSettle();
// Find search field and enter text
final searchField = find.byType(TextField);
await tester.enterText(searchField, 'nginx');
await tester.pumpAndSettle();
// Should show nginx container
expect(find.text('nginx-proxy'), findsOneWidget);
// Other containers should be filtered out
expect(find.text('postgres-db'), findsNothing);
expect(find.text('redis-cache'), findsNothing);
});
testWidgets('displays empty state when no containers match search',
(tester) async {
harness.givenAuthenticatedUser();
harness.givenContainers();
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
await tester.pumpAndSettle();
// Search for non-existent container
final searchField = find.byType(TextField);
await tester.enterText(searchField, 'nonexistent');
await tester.pumpAndSettle();
// No containers should be visible
expect(find.text('nginx-proxy'), findsNothing);
expect(find.text('postgres-db'), findsNothing);
});
testWidgets('displays error state on API failure', (tester) async {
harness.givenAuthenticatedUser();
harness.givenApiError(
method: 'GET',
path: '/infrastructure/containers',
statusCode: 500,
message: 'Internal server error',
);
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
// Pump a few frames to allow error to propagate
await tester.pump();
await tester.pump(const Duration(milliseconds: 100));
// Should show error state (check for error icon or text)
expect(
find.byIcon(Icons.error_outline).evaluate().isNotEmpty ||
find.textContaining('error').evaluate().isNotEmpty ||
find.textContaining('Error').evaluate().isNotEmpty,
isTrue,
reason: 'Should display an error indicator',
);
});
testWidgets('calls API on mount', (tester) async {
harness.givenAuthenticatedUser();
harness.givenContainers();
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
await tester.pumpAndSettle();
// Verify API was called
harness.verifyApiCalled('GET', '/infrastructure/containers');
});
});
group('ContainerData', () {
test('parses JSON correctly', () {
final json = Fixtures.containers[0];
final container = ContainerData.fromJson(json);
expect(container.name, 'nginx-proxy');
expect(container.image, 'nginx:latest');
expect(container.state, 'running');
expect(container.ports.length, 2);
expect(container.health, ContainerHealth.healthy);
});
test('strips leading slash from name', () {
final json = {
'Id': 'abc123',
'Names': ['/my-container'],
'Image': 'test:latest',
'State': 'running',
'Status': 'Up 1 day',
'Ports': [],
};
final container = ContainerData.fromJson(json);
expect(container.name, 'my-container');
});
test('truncates ID to 12 characters', () {
final json = {
'Id': 'abcdef123456789',
'Names': ['/test'],
'Image': 'test:latest',
'State': 'running',
'Status': 'Up 1 day',
'Ports': [],
};
final container = ContainerData.fromJson(json);
expect(container.id, 'abcdef123456');
expect(container.fullId, 'abcdef123456789');
});
test('parses health status correctly', () {
expect(
ContainerData.fromJson({
...Fixtures.containers[0],
'Status': 'Up 1 day (healthy)',
}).health,
ContainerHealth.healthy,
);
expect(
ContainerData.fromJson({
...Fixtures.containers[0],
'Status': 'Up 1 day (unhealthy)',
}).health,
ContainerHealth.unhealthy,
);
expect(
ContainerData.fromJson({
...Fixtures.containers[0],
'Status': 'Up 1 day (health: starting)',
}).health,
ContainerHealth.starting,
);
expect(
ContainerData.fromJson({
...Fixtures.containers[0],
'Status': 'Up 1 day',
}).health,
ContainerHealth.none,
);
});
test('displayStatus strips health indicator', () {
final container = ContainerData.fromJson({
...Fixtures.containers[0],
'Status': 'Up 3 days (healthy)',
});
expect(container.displayStatus, 'Up 3 days');
});
test('canStart is true for exited containers', () {
final container = ContainerData.fromJson({
...Fixtures.containers[0],
'State': 'exited',
});
expect(container.canStart, isTrue);
expect(container.canStop, isFalse);
expect(container.canRestart, isFalse);
});
test('canStop and canRestart are true for running containers', () {
final container = ContainerData.fromJson({
...Fixtures.containers[0],
'State': 'running',
});
expect(container.canStart, isFalse);
expect(container.canStop, isTrue);
expect(container.canRestart, isTrue);
});
});
group('ContainerPort', () {
test('parses JSON correctly', () {
final port = ContainerPort.fromJson({
'PrivatePort': 80,
'PublicPort': 8080,
'Type': 'tcp',
});
expect(port.privatePort, 80);
expect(port.publicPort, 8080);
expect(port.type, 'tcp');
});
test('formatted shows port mapping', () {
final port = ContainerPort(privatePort: 80, publicPort: 8080);
expect(port.formatted, '8080:80');
});
test('formatted shows only private port when no public port', () {
final port = ContainerPort(privatePort: 6379);
expect(port.formatted, '6379');
});
});
group('ContainersListPage Responsive', () {
testWidgets('renders at desktop size (1920x1080)', (tester) async {
configureScreenSize(tester, ScreenSizes.desktopLarge);
harness.givenAuthenticatedUser();
harness.givenContainers();
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
await tester.pumpAndSettle();
expect(find.text('nginx-proxy'), findsOneWidget);
expect(find.byType(TextField), findsOneWidget);
});
testWidgets('renders at tablet landscape (1024x768)', (tester) async {
configureScreenSize(tester, ScreenSizes.tabletLandscape);
harness.givenAuthenticatedUser();
harness.givenContainers();
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
await tester.pumpAndSettle();
expect(find.text('nginx-proxy'), findsOneWidget);
});
testWidgets('renders at tablet portrait (768x1024)', (tester) async {
configureScreenSize(tester, ScreenSizes.tabletPortrait);
harness.givenAuthenticatedUser();
harness.givenContainers();
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
await tester.pumpAndSettle();
expect(find.byType(ContainersListPage), findsOneWidget);
});
testWidgets('renders at mobile size (375x812)', (tester) async {
configureScreenSize(tester, ScreenSizes.mobile);
harness.givenAuthenticatedUser();
harness.givenContainers();
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
await tester.pumpAndSettle();
expect(find.byType(ContainersListPage), findsOneWidget);
});
testWidgets('renders at small mobile size (320x568)', (tester) async {
configureScreenSize(tester, ScreenSizes.mobileSmall);
harness.givenAuthenticatedUser();
harness.givenContainers();
await tester.pumpWidget(harness.wrap(const ContainersListPage()));
await tester.pumpAndSettle();
expect(find.byType(ContainersListPage), findsOneWidget);
});
});
}
@@ -1,276 +0,0 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:tatlock_ui/features/control_room/npm/presentation/pages/proxy_hosts_page.dart';
import '../../../../../harness/screen_sizes.dart';
import '../../../../../harness/test_harness.dart';
void main() {
final harness = TestHarness();
setUp(() => harness.setUp());
tearDown(() => harness.tearDown());
group('ProxyHostsPage', () {
testWidgets('displays loading state initially', (tester) async {
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pump();
expect(find.byType(CircularProgressIndicator), findsOneWidget);
await tester.pumpAndSettle();
});
testWidgets('displays domains from API', (tester) async {
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pumpAndSettle();
expect(find.text('home.schweitz.net'), findsOneWidget);
expect(find.text('api.schweitz.net'), findsOneWidget);
expect(find.text('git.schweitz.net'), findsOneWidget);
});
testWidgets('displays service information', (tester) async {
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pumpAndSettle();
expect(find.text('192.168.86.149:8092'), findsOneWidget);
expect(find.text('192.168.86.149:8083'), findsOneWidget);
expect(find.text('192.168.86.149:3000'), findsOneWidget);
});
testWidgets('displays SSL badges', (tester) async {
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pumpAndSettle();
// Should show SSL badges for enabled domains
expect(find.text('SSL'), findsWidgets);
// Should show HTTP badge for non-SSL domain
expect(find.text('HTTP'), findsOneWidget);
});
testWidgets('displays lock icons for SSL status', (tester) async {
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pumpAndSettle();
// Should have lock icons for SSL-enabled domains
expect(find.byIcon(Icons.lock), findsWidgets);
// Should have open lock for non-SSL domain
expect(find.byIcon(Icons.lock_open), findsOneWidget);
});
testWidgets('displays search input', (tester) async {
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pumpAndSettle();
expect(find.byType(TextField), findsOneWidget);
expect(find.text('Search domains...'), findsOneWidget);
});
testWidgets('displays refresh button', (tester) async {
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pumpAndSettle();
expect(find.byIcon(Icons.refresh), findsOneWidget);
});
testWidgets('displays New button', (tester) async {
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pumpAndSettle();
expect(find.text('New'), findsOneWidget);
expect(find.byIcon(Icons.add), findsOneWidget);
});
testWidgets('search filters domains', (tester) async {
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pumpAndSettle();
final searchField = find.byType(TextField);
await tester.enterText(searchField, 'api');
await tester.pumpAndSettle();
expect(find.text('api.schweitz.net'), findsOneWidget);
expect(find.text('home.schweitz.net'), findsNothing);
expect(find.text('git.schweitz.net'), findsNothing);
});
testWidgets('displays empty state when no domains match search',
(tester) async {
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pumpAndSettle();
final searchField = find.byType(TextField);
await tester.enterText(searchField, 'nonexistent');
await tester.pumpAndSettle();
expect(find.text('home.schweitz.net'), findsNothing);
expect(find.text('api.schweitz.net'), findsNothing);
});
testWidgets('displays error state on API failure', (tester) async {
harness.givenAuthenticatedUser();
harness.givenApiError(
method: 'GET',
path: '/infrastructure/domains',
statusCode: 500,
message: 'Internal server error',
);
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pump();
await tester.pump(const Duration(milliseconds: 100));
expect(
find.byIcon(Icons.error_outline).evaluate().isNotEmpty ||
find.textContaining('error').evaluate().isNotEmpty ||
find.textContaining('Error').evaluate().isNotEmpty,
isTrue,
reason: 'Should display an error indicator',
);
});
testWidgets('calls API on mount', (tester) async {
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pumpAndSettle();
harness.verifyApiCalled('GET', '/infrastructure/domains');
});
});
group('DomainData', () {
test('parses JSON correctly', () {
final json = Fixtures.domains[0];
final domain = DomainData.fromJson(json);
expect(domain.domain, 'home.schweitz.net');
expect(domain.service, '192.168.86.149:8092');
expect(domain.proxyHostId, 1);
expect(domain.sslEnabled, isTrue);
expect(domain.certificateId, 1);
});
test('handles missing certificate_id', () {
final json = {
'domain': 'test.example.com',
'service': '192.168.1.1:80',
'proxy_host_id': 99,
'ssl_enabled': false,
};
final domain = DomainData.fromJson(json);
expect(domain.certificateId, isNull);
});
test('defaults ssl_enabled to false when missing', () {
final json = {
'domain': 'test.example.com',
'service': '192.168.1.1:80',
'proxy_host_id': 99,
};
final domain = DomainData.fromJson(json);
expect(domain.sslEnabled, isFalse);
});
test('parses all fixture domains correctly', () {
for (final json in Fixtures.domains) {
final domain = DomainData.fromJson(json);
expect(domain.domain, isNotEmpty);
expect(domain.service, isNotEmpty);
expect(domain.proxyHostId, isPositive);
}
});
});
group('ProxyHostsPage Responsive', () {
testWidgets('renders at desktop size (1920x1080)', (tester) async {
configureScreenSize(tester, ScreenSizes.desktopLarge);
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pumpAndSettle();
expect(find.text('home.schweitz.net'), findsOneWidget);
expect(find.byType(TextField), findsOneWidget);
});
testWidgets('renders at tablet landscape (1024x768)', (tester) async {
configureScreenSize(tester, ScreenSizes.tabletLandscape);
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pumpAndSettle();
expect(find.text('home.schweitz.net'), findsOneWidget);
});
testWidgets('renders at tablet portrait (768x1024)', (tester) async {
configureScreenSize(tester, ScreenSizes.tabletPortrait);
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pumpAndSettle();
expect(find.byType(ProxyHostsPage), findsOneWidget);
});
testWidgets('renders at mobile size (375x812)', (tester) async {
configureScreenSize(tester, ScreenSizes.mobile);
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pumpAndSettle();
expect(find.byType(ProxyHostsPage), findsOneWidget);
});
testWidgets('renders at small mobile size (320x568)', (tester) async {
configureScreenSize(tester, ScreenSizes.mobileSmall);
harness.givenAuthenticatedUser();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ProxyHostsPage()));
await tester.pumpAndSettle();
expect(find.byType(ProxyHostsPage), findsOneWidget);
});
});
}
@@ -1,322 +0,0 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:tatlock_ui/features/control_room/presentation/pages/control_room_page.dart';
import 'package:tatlock_ui/features/control_room/router.dart';
import '../../../../harness/screen_sizes.dart';
import '../../../../harness/test_harness.dart';
void main() {
final harness = TestHarness();
setUp(() => harness.setUp());
tearDown(() => harness.tearDown());
// Set larger window size and suppress overflow errors
Future<void> setLargeWindowSize(WidgetTester tester) async {
tester.view.physicalSize = const Size(1600, 900);
tester.view.devicePixelRatio = 1.0;
addTearDown(() => tester.view.resetPhysicalSize());
// Suppress overflow errors - not what we're testing
final originalOnError = FlutterError.onError;
FlutterError.onError = (details) {
if (details.exceptionAsString().contains('overflowed')) {
return; // Ignore overflow errors
}
originalOnError?.call(details);
};
addTearDown(() => FlutterError.onError = originalOnError);
}
group('ControlRoomPage', () {
testWidgets('displays Sections nav panel header', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pumpAndSettle();
expect(find.text('Sections'), findsOneWidget);
expect(find.byIcon(Icons.dns_outlined), findsWidgets);
});
testWidgets('displays Stack Management section items', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pumpAndSettle();
expect(find.text('STACK MANAGEMENT'), findsOneWidget);
expect(find.text('Containers'), findsOneWidget);
expect(find.text('Proxy Hosts'), findsOneWidget);
});
testWidgets('displays Data Management section items', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pumpAndSettle();
expect(find.text('DATA MANAGEMENT'), findsOneWidget);
expect(find.text('PostgreSQL'), findsOneWidget);
expect(find.text('Redis'), findsOneWidget);
expect(find.text('Qdrant'), findsOneWidget);
expect(find.text('Neo4j'), findsOneWidget);
});
testWidgets('displays Containers section by default', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pumpAndSettle();
// Default nav is containers - should show stacks filter and containers
expect(find.text('Stacks'), findsOneWidget);
expect(find.text('All Containers'), findsOneWidget);
});
testWidgets('displays Stacks filter panel in Containers section',
(tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pumpAndSettle();
// Stacks filter panel elements
expect(find.text('Stacks'), findsOneWidget);
expect(find.byIcon(Icons.layers), findsOneWidget);
expect(find.text('All Containers'), findsOneWidget);
expect(find.byIcon(Icons.all_inbox), findsOneWidget);
});
testWidgets('displays containers list in main content', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pumpAndSettle();
// Should show container names from fixtures
expect(find.text('nginx-proxy'), findsOneWidget);
expect(find.text('postgres-db'), findsOneWidget);
expect(find.text('redis-cache'), findsOneWidget);
});
testWidgets('displays Proxy Hosts section when nav selected',
(tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(
harness.wrap(const ControlRoomPage(nav: ControlRoomNav.proxyHosts)),
);
await tester.pumpAndSettle();
// Should show domain names from fixtures
expect(find.text('home.schweitz.net'), findsOneWidget);
expect(find.text('api.schweitz.net'), findsOneWidget);
});
testWidgets('displays placeholder for unimplemented sections',
(tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenContainers();
await tester.pumpWidget(
harness.wrap(const ControlRoomPage(nav: ControlRoomNav.postgres)),
);
await tester.pumpAndSettle();
// Should show placeholder with "Coming soon"
expect(find.text('PostgreSQL'), findsWidgets);
expect(find.text('Data Management • Coming soon'), findsOneWidget);
});
testWidgets('displays search field for stacks', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pumpAndSettle();
expect(find.text('Search stacks...'), findsOneWidget);
});
testWidgets('displays refresh button in stacks panel', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pumpAndSettle();
expect(find.byIcon(Icons.refresh), findsWidgets);
});
testWidgets('displays nav icons for all sections', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pumpAndSettle();
// Stack Management icons
expect(find.byIcon(Icons.dns), findsWidgets);
expect(find.byIcon(Icons.public), findsOneWidget);
// Data Management icons
expect(find.byIcon(Icons.table_chart), findsOneWidget);
expect(find.byIcon(Icons.memory), findsOneWidget);
expect(find.byIcon(Icons.scatter_plot), findsOneWidget);
expect(find.byIcon(Icons.hub), findsOneWidget);
});
testWidgets('displays empty stacks state when no stacks found',
(tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenContainers(); // Fixtures have no stack labels
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pumpAndSettle();
// Stacks are derived from container labels - fixtures have none
expect(find.text('No stacks found'), findsOneWidget);
});
testWidgets('displays loading state for containers initially',
(tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pump();
expect(find.byType(CircularProgressIndicator), findsWidgets);
await tester.pumpAndSettle();
});
});
group('ControlRoomNav', () {
test('all nav items have unique IDs', () {
final ids = ControlRoomNav.values.map((n) => n.id).toSet();
expect(ids.length, ControlRoomNav.values.length);
});
test('all nav items have labels', () {
for (final nav in ControlRoomNav.values) {
expect(nav.label, isNotEmpty);
}
});
test('all nav items have sections', () {
for (final nav in ControlRoomNav.values) {
expect(nav.section, isNotEmpty);
}
});
test('path returns correct route', () {
expect(ControlRoomNav.containers.path, '/control-room/containers');
expect(ControlRoomNav.proxyHosts.path, '/control-room/proxy-hosts');
expect(ControlRoomNav.postgres.path, '/control-room/postgres');
});
test('toNavItem creates valid NavItem', () {
final navItem = ControlRoomNav.containers.toNavItem();
expect(navItem.id, 'containers');
expect(navItem.label, 'Containers');
expect(navItem.section, 'Stack Management');
});
});
group('ControlRoomPage Responsive', () {
testWidgets('renders at desktop size (1920x1080)', (tester) async {
configureScreenSize(tester, ScreenSizes.desktopLarge);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pumpAndSettle();
expect(find.text('Sections'), findsOneWidget);
expect(find.text('Containers'), findsOneWidget);
});
testWidgets('renders at tablet landscape (1024x768)', (tester) async {
configureScreenSize(tester, ScreenSizes.tabletLandscape);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pumpAndSettle();
expect(find.text('Sections'), findsOneWidget);
});
testWidgets('renders at tablet portrait (768x1024)', (tester) async {
configureScreenSize(tester, ScreenSizes.tabletPortrait);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pumpAndSettle();
expect(find.byType(ControlRoomPage), findsOneWidget);
});
testWidgets('renders at mobile size (375x812)', (tester) async {
configureScreenSize(tester, ScreenSizes.mobile);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pumpAndSettle();
expect(find.byType(ControlRoomPage), findsOneWidget);
});
testWidgets('renders at small mobile size (320x568)', (tester) async {
configureScreenSize(tester, ScreenSizes.mobileSmall);
harness.givenAuthenticatedUser();
harness.givenContainers();
harness.givenDomains();
await tester.pumpWidget(harness.wrap(const ControlRoomPage()));
await tester.pumpAndSettle();
expect(find.byType(ControlRoomPage), findsOneWidget);
});
});
}
@@ -1,221 +0,0 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:tatlock_ui/features/front_hall/presentation/pages/front_hall_page.dart';
import 'package:tatlock_ui/shared/widgets/air_quality_widget.dart';
import 'package:tatlock_ui/shared/widgets/forecast_widget.dart';
import 'package:tatlock_ui/shared/widgets/sun_position_widget.dart';
import 'package:tatlock_ui/shared/widgets/weather_widget.dart';
import '../../harness/screen_sizes.dart';
import '../../harness/test_harness.dart';
void main() {
final harness = TestHarness();
setUp(() => harness.setUp());
tearDown(() => harness.tearDown());
// Set larger window size and suppress overflow errors
Future<void> setLargeWindowSize(WidgetTester tester) async {
tester.view.physicalSize = const Size(1400, 900);
tester.view.devicePixelRatio = 1.0;
addTearDown(() => tester.view.resetPhysicalSize());
// Suppress overflow errors - not what we're testing
final originalOnError = FlutterError.onError;
FlutterError.onError = (details) {
if (details.exceptionAsString().contains('overflowed')) {
return;
}
originalOnError?.call(details);
};
addTearDown(() => FlutterError.onError = originalOnError);
}
group('Environment Widgets', () {
testWidgets('displays Sun Position widget', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
expect(find.byType(SunPositionWidget), findsOneWidget);
expect(find.text('Sun Position'), findsOneWidget);
});
testWidgets('displays Weather widget', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
expect(find.byType(WeatherWidget), findsOneWidget);
});
testWidgets('displays Forecast widget', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
expect(find.byType(ForecastWidget), findsOneWidget);
expect(find.text('Forecast'), findsOneWidget);
});
testWidgets('displays Air Quality widget when data available',
(tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment(); // Has air quality data
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
expect(find.byType(AirQualityWidget), findsOneWidget);
expect(find.text('Air Quality'), findsOneWidget);
});
testWidgets('shows Air Quality widget with no data state when data unavailable',
(tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironmentNoAirQuality(); // No air quality data
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
// Air Quality widget should still be present, showing "no data" state
expect(find.byType(AirQualityWidget), findsOneWidget);
expect(find.text('Air Quality'), findsOneWidget);
});
testWidgets('calls environment API on mount', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
harness.verifyApiCalled('GET', '/tools/environment');
});
testWidgets('displays error state when environment fails', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenApiError(
method: 'GET',
path: '/tools/environment',
statusCode: 500,
message: 'Internal server error',
);
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
// Should show environment error message or error indicator
expect(
find.text('Failed to load environment data').evaluate().isNotEmpty ||
find.byIcon(Icons.error_outline).evaluate().isNotEmpty,
isTrue,
reason: 'Should display environment error',
);
});
testWidgets('displays sunrise and sunset times', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
// Should display sunrise/sunset labels
expect(find.text('Sunrise'), findsOneWidget);
expect(find.text('Sunset'), findsOneWidget);
});
testWidgets('displays daylight duration', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
// Should display daylight label
expect(find.text('Daylight'), findsOneWidget);
});
});
group('Environment Widgets Responsive', () {
testWidgets('renders environment widgets at desktop size', (tester) async {
configureScreenSize(tester, ScreenSizes.desktopLarge);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
expect(find.byType(SunPositionWidget), findsOneWidget);
expect(find.byType(WeatherWidget), findsOneWidget);
expect(find.byType(ForecastWidget), findsOneWidget);
});
testWidgets('renders environment widgets at tablet size', (tester) async {
configureScreenSize(tester, ScreenSizes.tabletLandscape);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
expect(find.byType(SunPositionWidget), findsOneWidget);
expect(find.byType(WeatherWidget), findsOneWidget);
expect(find.byType(ForecastWidget), findsOneWidget);
});
testWidgets('renders environment widgets at mobile size', (tester) async {
configureScreenSize(tester, ScreenSizes.mobile);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
// Page should render without crashing at mobile size
// Widgets may be below the fold due to scrolling
expect(find.byType(FrontHallPage), findsOneWidget);
});
});
}
@@ -1,316 +0,0 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:tatlock_ui/features/front_hall/presentation/pages/front_hall_page.dart';
import '../../../../harness/screen_sizes.dart';
import '../../../../harness/test_harness.dart';
void main() {
final harness = TestHarness();
setUp(() => harness.setUp());
tearDown(() => harness.tearDown());
// Set larger window size and suppress overflow errors
Future<void> setLargeWindowSize(WidgetTester tester) async {
tester.view.physicalSize = const Size(1400, 900);
tester.view.devicePixelRatio = 1.0;
addTearDown(() => tester.view.resetPhysicalSize());
// Suppress overflow errors - not what we're testing
final originalOnError = FlutterError.onError;
FlutterError.onError = (details) {
if (details.exceptionAsString().contains('overflowed')) {
return; // Ignore overflow errors
}
originalOnError?.call(details);
};
addTearDown(() => FlutterError.onError = originalOnError);
}
group('FrontHallPage', () {
testWidgets('displays welcome message', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
expect(find.text('Welcome to Tatlock'), findsOneWidget);
expect(find.text('Your homelab dashboard is ready.'), findsOneWidget);
});
testWidgets('displays Quick Links panel header', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
expect(find.text('Quick Links'), findsOneWidget);
expect(find.byIcon(Icons.link), findsOneWidget);
});
testWidgets('displays quick links from API', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
// Should display quick link names from fixtures
expect(find.text('Portainer'), findsOneWidget);
expect(find.text('Gitea'), findsOneWidget);
expect(find.text('Jellyfin'), findsOneWidget);
});
testWidgets('displays System Stats section header', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
expect(find.text('System Stats'), findsOneWidget);
expect(find.byIcon(Icons.monitor_heart), findsWidgets);
});
testWidgets('displays Environment section header', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
expect(find.text('Environment'), findsOneWidget);
expect(find.byIcon(Icons.eco), findsOneWidget);
});
testWidgets('displays Settings button', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
expect(find.text('Settings'), findsOneWidget);
expect(find.byIcon(Icons.settings), findsOneWidget);
});
testWidgets('displays refresh button in Quick Links panel', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
expect(find.byIcon(Icons.refresh), findsWidgets);
});
testWidgets('displays loading state for system stats initially',
(tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pump();
// Should show loading indicator before data loads
expect(find.byType(CircularProgressIndicator), findsWidgets);
await tester.pumpAndSettle();
});
testWidgets('displays system stats gauges after loading', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
// Should display gauge labels
expect(find.text('CPU'), findsOneWidget);
expect(find.text('RAM'), findsOneWidget);
});
testWidgets('displays error state when system stats fails', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenEnvironment();
harness.givenApiError(
method: 'GET',
path: '/tools/system/stats',
statusCode: 500,
message: 'Internal server error',
);
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
// Should show system stats error message or error indicator
expect(
find.text('Failed to load system stats').evaluate().isNotEmpty ||
find.byIcon(Icons.error_outline).evaluate().isNotEmpty,
isTrue,
reason: 'Should display system stats error',
);
});
testWidgets('calls quick links API on mount', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
harness.verifyApiCalled('GET', '/dashboard/quick-links');
});
testWidgets('calls system stats API on mount', (tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
harness.verifyApiCalled('GET', '/tools/system/stats');
});
testWidgets('uses default links when API returns empty list',
(tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks([]); // Empty list triggers fallback
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
// Should display default links (from getDefaultQuickLinks)
expect(find.text('Jellyfin'), findsOneWidget);
expect(find.text('Open WebUI'), findsOneWidget);
});
testWidgets('displays category headers when multiple categories present',
(tester) async {
await setLargeWindowSize(tester);
harness.givenAuthenticatedUser();
harness.givenQuickLinks(); // Fixtures have Infrastructure, Development, Home
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
// Should display category headers (uppercase)
// At least INFRASTRUCTURE should be visible since Portainer is first
expect(find.text('INFRASTRUCTURE'), findsOneWidget);
});
});
group('FrontHallPage Responsive', () {
testWidgets('renders at desktop size (1920x1080)', (tester) async {
configureScreenSize(tester, ScreenSizes.desktopLarge);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
expect(find.text('Welcome to Tatlock'), findsOneWidget);
expect(find.text('Quick Links'), findsOneWidget);
});
testWidgets('renders at tablet landscape (1024x768)', (tester) async {
configureScreenSize(tester, ScreenSizes.tabletLandscape);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
expect(find.text('Welcome to Tatlock'), findsOneWidget);
expect(find.text('Quick Links'), findsOneWidget);
});
testWidgets('renders at tablet portrait (768x1024)', (tester) async {
configureScreenSize(tester, ScreenSizes.tabletPortrait);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
expect(find.text('Welcome to Tatlock'), findsOneWidget);
});
testWidgets('renders at mobile size (375x812)', (tester) async {
configureScreenSize(tester, ScreenSizes.mobile);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
// Core content should still be accessible
expect(find.byType(FrontHallPage), findsOneWidget);
});
testWidgets('renders at small mobile size (320x568)', (tester) async {
configureScreenSize(tester, ScreenSizes.mobileSmall);
harness.givenAuthenticatedUser();
harness.givenQuickLinks();
harness.givenSystemStats();
harness.givenEnvironment();
await tester.pumpWidget(harness.wrap(const FrontHallPage()));
await tester.pumpAndSettle();
// Should render without crashing
expect(find.byType(FrontHallPage), findsOneWidget);
});
});
}
@@ -1,291 +0,0 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:tatlock_ui/features/security/groups/groups_list_page.dart';
import '../../../harness/screen_sizes.dart';
import '../../../harness/test_harness.dart';
void main() {
final harness = TestHarness();
setUp(() => harness.setUp());
tearDown(() => harness.tearDown());
group('GroupsListPage', () {
testWidgets('displays loading state initially', (tester) async {
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pump();
expect(find.byType(CircularProgressIndicator), findsOneWidget);
await tester.pumpAndSettle();
});
testWidgets('displays groups from API', (tester) async {
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
expect(find.text('admins'), findsOneWidget);
// 'users' appears twice: as group name and as parent of developers
expect(find.text('users'), findsNWidgets(2));
expect(find.text('developers'), findsOneWidget);
});
testWidgets('displays member counts', (tester) async {
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
// Member counts from fixtures: admins=1, users=3, developers=1
expect(find.text('1'), findsNWidgets(2)); // admins and developers
expect(find.text('3'), findsOneWidget); // users
});
testWidgets('displays Superuser badge for superuser groups', (tester) async {
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
// admins group is superuser
expect(find.text('Superuser'), findsOneWidget);
// users and developers are standard
expect(find.text('Standard'), findsNWidgets(2));
});
testWidgets('displays parent group name', (tester) async {
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
// developers has parent_name = 'users'
// Find 'users' appearing twice: once as group name, once as parent
expect(find.text('users'), findsNWidgets(2));
});
testWidgets('displays dash for groups without parent', (tester) async {
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
// admins and users have null parent_name, shown as '-'
expect(find.text('-'), findsNWidgets(2));
});
testWidgets('displays search input', (tester) async {
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
expect(find.byType(TextField), findsOneWidget);
expect(find.text('Search groups...'), findsOneWidget);
});
testWidgets('displays refresh button', (tester) async {
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
expect(find.byIcon(Icons.refresh), findsOneWidget);
});
testWidgets('displays Sync from Authentik button', (tester) async {
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
expect(find.text('Sync from Authentik'), findsOneWidget);
expect(find.byIcon(Icons.sync), findsOneWidget);
});
testWidgets('search filters groups', (tester) async {
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
final searchField = find.byType(TextField);
await tester.enterText(searchField, 'admin');
await tester.pumpAndSettle();
expect(find.text('admins'), findsOneWidget);
expect(find.text('users'), findsNothing);
expect(find.text('developers'), findsNothing);
});
testWidgets('displays empty state when no groups match search',
(tester) async {
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
final searchField = find.byType(TextField);
await tester.enterText(searchField, 'nonexistent');
await tester.pumpAndSettle();
expect(find.text('admins'), findsNothing);
expect(find.text('users'), findsNothing);
});
testWidgets('displays error state on API failure', (tester) async {
harness.givenAuthenticatedUser();
harness.givenApiError(
method: 'GET',
path: '/auth/groups',
statusCode: 500,
message: 'Internal server error',
);
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pump();
await tester.pump(const Duration(milliseconds: 100));
expect(
find.byIcon(Icons.error_outline).evaluate().isNotEmpty ||
find.textContaining('error').evaluate().isNotEmpty ||
find.textContaining('Error').evaluate().isNotEmpty,
isTrue,
reason: 'Should display an error indicator',
);
});
testWidgets('calls API on mount', (tester) async {
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
harness.verifyApiCalled('GET', '/auth/groups');
});
});
group('GroupData', () {
test('parses JSON correctly', () {
final json = Fixtures.groups[0];
final group = GroupData.fromJson(json);
expect(group.id, 'group-001');
expect(group.name, 'admins');
expect(group.isSuperuser, isTrue);
expect(group.memberCount, 1);
expect(group.parentName, isNull);
});
test('parses group with parent correctly', () {
final json = Fixtures.groups[2]; // developers with parent
final group = GroupData.fromJson(json);
expect(group.name, 'developers');
expect(group.parentName, 'users');
});
test('defaults isSuperuser to false when missing', () {
final json = {
'id': 'test',
'name': 'test-group',
'member_count': 5,
};
final group = GroupData.fromJson(json);
expect(group.isSuperuser, isFalse);
});
test('defaults memberCount to 0 when missing', () {
final json = {
'id': 'test',
'name': 'test-group',
'is_superuser': false,
};
final group = GroupData.fromJson(json);
expect(group.memberCount, 0);
});
test('parses all fixture groups correctly', () {
for (final json in Fixtures.groups) {
final group = GroupData.fromJson(json);
expect(group.id, isNotEmpty);
expect(group.name, isNotEmpty);
}
});
});
group('GroupsListPage Responsive', () {
testWidgets('renders at desktop size (1920x1080)', (tester) async {
configureScreenSize(tester, ScreenSizes.desktopLarge);
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
expect(find.text('admins'), findsOneWidget);
expect(find.byType(TextField), findsOneWidget);
});
testWidgets('renders at tablet landscape (1024x768)', (tester) async {
configureScreenSize(tester, ScreenSizes.tabletLandscape);
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
expect(find.text('admins'), findsOneWidget);
});
testWidgets('renders at tablet portrait (768x1024)', (tester) async {
configureScreenSize(tester, ScreenSizes.tabletPortrait);
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
expect(find.byType(GroupsListPage), findsOneWidget);
});
testWidgets('renders at mobile size (375x812)', (tester) async {
configureScreenSize(tester, ScreenSizes.mobile);
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
expect(find.byType(GroupsListPage), findsOneWidget);
});
testWidgets('renders at small mobile size (320x568)', (tester) async {
configureScreenSize(tester, ScreenSizes.mobileSmall);
harness.givenAuthenticatedUser();
harness.givenGroups();
await tester.pumpWidget(harness.wrap(const GroupsListPage()));
await tester.pumpAndSettle();
expect(find.byType(GroupsListPage), findsOneWidget);
});
});
}
@@ -1,315 +0,0 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:tatlock_ui/features/security/users/users_list_page.dart';
import '../../../harness/screen_sizes.dart';
import '../../../harness/test_harness.dart';
void main() {
final harness = TestHarness();
setUp(() => harness.setUp());
tearDown(() => harness.tearDown());
group('UsersListPage', () {
testWidgets('displays loading state initially', (tester) async {
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pump();
expect(find.byType(CircularProgressIndicator), findsOneWidget);
await tester.pumpAndSettle();
});
testWidgets('displays users from API', (tester) async {
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
expect(find.text('Admin User'), findsOneWidget);
expect(find.text('John Doe'), findsOneWidget);
expect(find.text('Jane Smith'), findsOneWidget);
});
testWidgets('displays user emails', (tester) async {
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
expect(find.text('admin@example.com'), findsOneWidget);
expect(find.text('john@example.com'), findsOneWidget);
expect(find.text('jane@example.com'), findsOneWidget);
});
testWidgets('displays Admin badge for admin users', (tester) async {
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
// Admin User should have Admin badge
expect(find.text('Admin'), findsOneWidget);
});
testWidgets('displays user initials in avatar', (tester) async {
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
// Should display initials for users without avatar
expect(find.text('AU'), findsOneWidget); // Admin User
expect(find.text('JD'), findsOneWidget); // John Doe
expect(find.text('JS'), findsOneWidget); // Jane Smith
});
testWidgets('displays search input', (tester) async {
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
expect(find.byType(TextField), findsOneWidget);
expect(find.text('Search users...'), findsOneWidget);
});
testWidgets('displays refresh button', (tester) async {
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
expect(find.byIcon(Icons.refresh), findsOneWidget);
});
testWidgets('displays Sync from Authentik button', (tester) async {
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
expect(find.text('Sync from Authentik'), findsOneWidget);
expect(find.byIcon(Icons.sync), findsOneWidget);
});
testWidgets('search filters users', (tester) async {
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
final searchField = find.byType(TextField);
await tester.enterText(searchField, 'Admin');
await tester.pumpAndSettle();
expect(find.text('Admin User'), findsOneWidget);
expect(find.text('John Doe'), findsNothing);
expect(find.text('Jane Smith'), findsNothing);
});
testWidgets('displays empty state when no users match search',
(tester) async {
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
final searchField = find.byType(TextField);
await tester.enterText(searchField, 'nonexistent');
await tester.pumpAndSettle();
expect(find.text('Admin User'), findsNothing);
expect(find.text('John Doe'), findsNothing);
});
testWidgets('displays "No roles" for users without roles', (tester) async {
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
// Jane Smith has no roles
expect(find.text('No roles'), findsOneWidget);
});
testWidgets('displays role badges', (tester) async {
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
// Should display role names (last part after colon)
expect(find.text('admin'), findsOneWidget);
expect(find.text('viewer'), findsOneWidget);
});
testWidgets('displays error state on API failure', (tester) async {
harness.givenAuthenticatedUser();
harness.givenApiError(
method: 'GET',
path: '/auth/users',
statusCode: 500,
message: 'Internal server error',
);
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pump();
await tester.pump(const Duration(milliseconds: 100));
expect(
find.byIcon(Icons.error_outline).evaluate().isNotEmpty ||
find.textContaining('error').evaluate().isNotEmpty ||
find.textContaining('Error').evaluate().isNotEmpty,
isTrue,
reason: 'Should display an error indicator',
);
});
testWidgets('calls API on mount', (tester) async {
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
harness.verifyApiCalled('GET', '/auth/users');
});
});
group('UserData', () {
test('parses JSON correctly', () {
final json = Fixtures.users[0];
final user = UserData.fromJson(json);
expect(user.id, 'user-001');
expect(user.email, 'admin@example.com');
expect(user.name, 'Admin User');
expect(user.roles, contains('admin.general:admin'));
expect(user.isAdmin, isTrue);
});
test('isAdmin returns false for non-admin users', () {
final json = Fixtures.users[1];
final user = UserData.fromJson(json);
expect(user.isAdmin, isFalse);
});
test('initials returns correct value for two-word names', () {
final user = UserData.fromJson(Fixtures.users[0]);
expect(user.initials, 'AU'); // Admin User
});
test('initials returns correct value for single-word names', () {
final json = {
'id': 'test',
'email': 'test@test.com',
'name': 'Madonna',
'created_at': '2024-01-01T00:00:00Z',
'roles': [],
};
final user = UserData.fromJson(json);
expect(user.initials, 'MA');
});
test('lastLoginFormatted returns "Never" for null lastLogin', () {
final json = Fixtures.users[2]; // Jane Smith has null last_login
final user = UserData.fromJson(json);
expect(user.lastLoginFormatted, 'Never');
});
test('handles missing roles gracefully', () {
final json = {
'id': 'test',
'email': 'test@test.com',
'name': 'Test User',
'created_at': '2024-01-01T00:00:00Z',
};
final user = UserData.fromJson(json);
expect(user.roles, isEmpty);
});
test('parses all fixture users correctly', () {
for (final json in Fixtures.users) {
final user = UserData.fromJson(json);
expect(user.id, isNotEmpty);
expect(user.email, isNotEmpty);
expect(user.name, isNotEmpty);
}
});
});
group('UsersListPage Responsive', () {
testWidgets('renders at desktop size (1920x1080)', (tester) async {
configureScreenSize(tester, ScreenSizes.desktopLarge);
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
expect(find.text('Admin User'), findsOneWidget);
expect(find.byType(TextField), findsOneWidget);
});
testWidgets('renders at tablet landscape (1024x768)', (tester) async {
configureScreenSize(tester, ScreenSizes.tabletLandscape);
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
expect(find.text('Admin User'), findsOneWidget);
});
testWidgets('renders at tablet portrait (768x1024)', (tester) async {
configureScreenSize(tester, ScreenSizes.tabletPortrait);
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
expect(find.byType(UsersListPage), findsOneWidget);
});
testWidgets('renders at mobile size (375x812)', (tester) async {
configureScreenSize(tester, ScreenSizes.mobile);
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
expect(find.byType(UsersListPage), findsOneWidget);
});
testWidgets('renders at small mobile size (320x568)', (tester) async {
configureScreenSize(tester, ScreenSizes.mobileSmall);
harness.givenAuthenticatedUser();
harness.givenUsers();
await tester.pumpWidget(harness.wrap(const UsersListPage()));
await tester.pumpAndSettle();
expect(find.byType(UsersListPage), findsOneWidget);
});
});
}
@@ -1,227 +0,0 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:tatlock_ui/core/theme/theme_provider.dart';
import 'package:tatlock_ui/features/settings/presentation/pages/settings_page.dart';
import '../../../../harness/screen_sizes.dart';
import '../../../../harness/test_harness.dart';
void main() {
final harness = TestHarness();
setUp(() => harness.setUp());
tearDown(() => harness.tearDown());
group('SettingsPage', () {
testWidgets('displays Settings header', (tester) async {
harness.givenAuthenticatedUser();
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.text('Settings'), findsOneWidget);
});
testWidgets('displays Appearance section', (tester) async {
harness.givenAuthenticatedUser();
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.text('APPEARANCE'), findsOneWidget);
expect(find.text('Theme'), findsOneWidget);
expect(find.text('Choose your preferred color scheme'), findsOneWidget);
});
testWidgets('displays theme dropdown with options', (tester) async {
harness.givenAuthenticatedUser();
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
// Find and tap the theme dropdown
final dropdown = find.byType(DropdownButton<ThemeSetting>);
expect(dropdown, findsOneWidget);
await tester.tap(dropdown);
await tester.pumpAndSettle();
// Should show all theme options (may appear twice: selected + menu item)
expect(find.text('System'), findsWidgets);
expect(find.text('Light'), findsWidgets);
expect(find.text('Dark'), findsWidgets);
});
testWidgets('displays Navigation section', (tester) async {
harness.givenAuthenticatedUser();
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.text('NAVIGATION'), findsOneWidget);
expect(find.text('Default Room'), findsOneWidget);
expect(find.text('Room to show when app opens'), findsOneWidget);
});
testWidgets('displays room dropdown with options', (tester) async {
harness.givenAuthenticatedUser();
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
// Find the room dropdown (second DropdownButton)
final dropdowns = find.byType(DropdownButton<String>);
expect(dropdowns, findsOneWidget);
await tester.tap(dropdowns);
await tester.pumpAndSettle();
// Should show room options from registry
expect(find.text('Front Hall'), findsWidgets);
});
testWidgets('displays Account section', (tester) async {
harness.givenAuthenticatedUser();
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.text('ACCOUNT'), findsOneWidget);
expect(find.text('Name'), findsOneWidget);
expect(find.text('Email'), findsOneWidget);
});
testWidgets('displays user name from auth state', (tester) async {
harness.givenAuthenticatedUser(name: 'John Doe');
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.text('John Doe'), findsOneWidget);
});
testWidgets('displays user email from auth state', (tester) async {
harness.givenAuthenticatedUser(email: 'john@example.com');
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.text('john@example.com'), findsOneWidget);
});
testWidgets('displays admin role for admin user', (tester) async {
harness.givenAdminUser();
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.text('Roles'), findsOneWidget);
expect(find.textContaining('admin.general:admin'), findsOneWidget);
});
testWidgets('displays theme icon for system theme', (tester) async {
harness.givenAuthenticatedUser();
harness.givenThemeMode(ThemeMode.system);
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.byIcon(Icons.brightness_auto), findsOneWidget);
});
testWidgets('displays theme icon for light theme', (tester) async {
harness.givenAuthenticatedUser();
harness.givenThemeMode(ThemeMode.light);
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.byIcon(Icons.light_mode), findsOneWidget);
});
testWidgets('displays theme icon for dark theme', (tester) async {
harness.givenAuthenticatedUser();
harness.givenThemeMode(ThemeMode.dark);
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.byIcon(Icons.dark_mode), findsOneWidget);
});
testWidgets('displays account icons', (tester) async {
harness.givenAuthenticatedUser();
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.byIcon(Icons.person_outline), findsOneWidget);
expect(find.byIcon(Icons.email_outlined), findsOneWidget);
expect(find.byIcon(Icons.home_outlined), findsOneWidget);
});
testWidgets('displays all three section cards', (tester) async {
harness.givenAuthenticatedUser();
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
// Should have 3 cards: Appearance, Navigation, Account
expect(find.byType(Card), findsNWidgets(3));
});
});
group('SettingsPage Responsive', () {
testWidgets('renders at desktop size (1920x1080)', (tester) async {
configureScreenSize(tester, ScreenSizes.desktopLarge);
harness.givenAuthenticatedUser();
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.text('Settings'), findsOneWidget);
expect(find.byType(Card), findsNWidgets(3));
});
testWidgets('renders at tablet landscape (1024x768)', (tester) async {
configureScreenSize(tester, ScreenSizes.tabletLandscape);
harness.givenAuthenticatedUser();
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.text('Settings'), findsOneWidget);
expect(find.text('APPEARANCE'), findsOneWidget);
});
testWidgets('renders at tablet portrait (768x1024)', (tester) async {
configureScreenSize(tester, ScreenSizes.tabletPortrait);
harness.givenAuthenticatedUser();
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.text('Settings'), findsOneWidget);
});
testWidgets('renders at mobile size (375x812)', (tester) async {
configureScreenSize(tester, ScreenSizes.mobile);
harness.givenAuthenticatedUser();
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.byType(SettingsPage), findsOneWidget);
});
testWidgets('renders at small mobile size (320x568)', (tester) async {
configureScreenSize(tester, ScreenSizes.mobileSmall);
harness.givenAuthenticatedUser();
await tester.pumpWidget(harness.wrap(const SettingsPage()));
await tester.pumpAndSettle();
expect(find.byType(SettingsPage), findsOneWidget);
});
});
}
-410
View File
@@ -1,410 +0,0 @@
/// Test fixtures for mock API responses.
///
/// Provides realistic test data for various API endpoints.
class Fixtures {
Fixtures._();
// ============================================================
// Containers
// ============================================================
static const containers = [
{
'Id': 'abc123def456',
'Names': ['/nginx-proxy'],
'Image': 'nginx:latest',
'State': 'running',
'Status': 'Up 3 days (healthy)',
'Created': 1704067200,
'Ports': [
{'PrivatePort': 80, 'PublicPort': 80, 'Type': 'tcp'},
{'PrivatePort': 443, 'PublicPort': 443, 'Type': 'tcp'},
],
},
{
'Id': 'def456ghi789',
'Names': ['/postgres-db'],
'Image': 'postgres:15',
'State': 'running',
'Status': 'Up 5 days',
'Created': 1703894400,
'Ports': [
{'PrivatePort': 5432, 'PublicPort': 5432, 'Type': 'tcp'},
],
},
{
'Id': 'ghi789jkl012',
'Names': ['/redis-cache'],
'Image': 'redis:7-alpine',
'State': 'running',
'Status': 'Up 2 days',
'Created': 1704153600,
'Ports': [
{'PrivatePort': 6379, 'Type': 'tcp'},
],
},
{
'Id': 'jkl012mno345',
'Names': ['/stopped-service'],
'Image': 'myapp:latest',
'State': 'exited',
'Status': 'Exited (0) 12 hours ago',
'Created': 1704067200,
'Ports': [],
},
];
static Map<String, dynamic> container(int index) => containers[index];
// ============================================================
// Domains (for ProxyHostsPage DataGrid)
// ============================================================
static const domains = [
{
'domain': 'home.schweitz.net',
'service': '192.168.86.149:8092',
'proxy_host_id': 1,
'ssl_enabled': true,
'certificate_id': 1,
},
{
'domain': 'api.schweitz.net',
'service': '192.168.86.149:8083',
'proxy_host_id': 2,
'ssl_enabled': true,
'certificate_id': 2,
},
{
'domain': 'git.schweitz.net',
'service': '192.168.86.149:3000',
'proxy_host_id': 3,
'ssl_enabled': true,
'certificate_id': 3,
},
{
'domain': 'internal.schweitz.net',
'service': '192.168.86.100:80',
'proxy_host_id': 4,
'ssl_enabled': false,
'certificate_id': null,
},
];
static Map<String, dynamic> domain(int index) =>
Map<String, dynamic>.from(domains[index]);
// ============================================================
// Proxy Hosts (raw NPM format)
// ============================================================
static const proxyHosts = [
{
'id': 1,
'domain_names': ['home.schweitz.net'],
'forward_host': '192.168.86.149',
'forward_port': 8092,
'forward_scheme': 'http',
'ssl_forced': true,
'enabled': 1,
'meta': {'nginx_online': true},
},
{
'id': 2,
'domain_names': ['api.schweitz.net'],
'forward_host': '192.168.86.149',
'forward_port': 8083,
'forward_scheme': 'http',
'ssl_forced': true,
'enabled': 1,
'meta': {'nginx_online': true},
},
{
'id': 3,
'domain_names': ['git.schweitz.net'],
'forward_host': '192.168.86.149',
'forward_port': 3000,
'forward_scheme': 'http',
'ssl_forced': true,
'enabled': 1,
'meta': {'nginx_online': true},
},
];
static Map<String, dynamic> proxyHost(int index) =>
Map<String, dynamic>.from(proxyHosts[index]);
// ============================================================
// Users (for UsersListPage DataGrid)
// ============================================================
static const users = [
{
'id': 'user-001',
'email': 'admin@example.com',
'name': 'Admin User',
'avatar_url': null,
'created_at': '2024-01-01T00:00:00Z',
'last_login': '2024-01-15T10:30:00Z',
'roles': ['admin.general:admin'],
},
{
'id': 'user-002',
'email': 'john@example.com',
'name': 'John Doe',
'avatar_url': null,
'created_at': '2024-01-05T00:00:00Z',
'last_login': '2024-01-14T08:00:00Z',
'roles': ['security.users:viewer'],
},
{
'id': 'user-003',
'email': 'jane@example.com',
'name': 'Jane Smith',
'avatar_url': null,
'created_at': '2024-01-10T00:00:00Z',
'last_login': null,
'roles': [],
},
];
static Map<String, dynamic> user(int index) =>
Map<String, dynamic>.from(users[index]);
// ============================================================
// Groups
// ============================================================
static const groups = [
{
'id': 'group-001',
'name': 'admins',
'is_superuser': true,
'member_count': 1,
'parent_name': null,
},
{
'id': 'group-002',
'name': 'users',
'is_superuser': false,
'member_count': 3,
'parent_name': null,
},
{
'id': 'group-003',
'name': 'developers',
'is_superuser': false,
'member_count': 1,
'parent_name': 'users',
},
];
static Map<String, dynamic> group(int index) =>
Map<String, dynamic>.from(groups[index]);
// ============================================================
// Auth Sync Response
// ============================================================
static Map<String, dynamic> authSyncResponse({
String userId = 'user-001',
String authentikId = 'ak-001',
String name = 'Test User',
String email = 'test@example.com',
bool isAdmin = false,
}) {
return {
'user_id': userId,
'authentik_id': authentikId,
'name': name,
'email': email,
'avatar_url': null,
'roles': isAdmin
? [
{
'id': 'admin-role',
'name': 'admin.general:admin',
'domain': 'admin',
'category': 'general',
'action': 'admin',
}
]
: [],
'preferences': {
'theme': 'system',
'default_room': 'front-hall',
'preferences_json': {},
},
};
}
// ============================================================
// System Stats (for DashboardContent)
// ============================================================
static const systemStats = {
'cpu': {
'usage_percent': 23.5,
'cores': 8,
'load_1m': 1.2,
'load_5m': 1.5,
'load_15m': 1.3,
},
'memory': {
'usage_percent': 45.2,
'total_bytes': 17179869184,
'used_bytes': 7771729306,
'available_bytes': 9408139878,
},
'disks': [
{
'mount_point': '/',
'device': '/dev/sda1',
'fstype': 'ext4',
'usage_percent': 67.8,
'total_bytes': 500000000000,
'used_bytes': 339000000000,
'free_bytes': 161000000000,
},
],
'network': {
'bytes_sent': 1234567890,
'bytes_recv': 9876543210,
'bytes_total': 11111111100,
},
'gpu': {
'available': false,
},
'hostname': 'test-server',
'queried_at': '2024-01-15T10:30:00Z',
};
// ============================================================
// Quick Links
// ============================================================
static const quickLinks = [
{
'id': 1,
'title': 'Portainer',
'url': 'https://portainer.example.com',
'icon': 'dns',
'category': 'Infrastructure',
'position': 0,
'is_visible': true,
'link_type': 'iframe',
},
{
'id': 2,
'title': 'Gitea',
'url': 'https://git.example.com',
'icon': 'code',
'category': 'Development',
'position': 1,
'is_visible': true,
'link_type': 'new_tab',
},
{
'id': 3,
'title': 'Jellyfin',
'url': 'https://media.example.com',
'icon': 'movie',
'category': 'Home',
'position': 2,
'is_visible': true,
'link_type': 'iframe',
},
];
static Map<String, dynamic> quickLink(int index) =>
Map<String, dynamic>.from(quickLinks[index]);
// ============================================================
// Environment Data
// ============================================================
static const environment = {
'weather': {
'temperature': 8.5,
'feels_like': 5.0,
'conditions': 'Partly Cloudy',
'humidity': 72,
'wind_speed': 18.5,
'wind_direction': 'SW',
'location': 'Rotterdam, NL',
'icon': '03d',
},
'forecast': [
{
'date': '2026-01-06',
'high': 10.0,
'low': 4.0,
'conditions': 'Cloudy',
'precipitation_chance': 20,
},
{
'date': '2026-01-07',
'high': 12.0,
'low': 5.0,
'conditions': 'Partly Cloudy',
'precipitation_chance': 10,
},
{
'date': '2026-01-08',
'high': 9.0,
'low': 3.0,
'conditions': 'Rain',
'precipitation_chance': 80,
},
{
'date': '2026-01-09',
'high': 11.0,
'low': 6.0,
'conditions': 'Sunny',
'precipitation_chance': 0,
},
],
'sun_times': {
'sunrise': '2026-01-06T08:45:00Z',
'sunset': '2026-01-06T16:50:00Z',
'daylight_minutes': 485,
'solar_noon': '2026-01-06T12:47:30Z',
},
'air_quality': {
'aqi': 42,
'quality': 'Good',
'pm25': 8.5,
'pm10': 15.0,
'o3': 32.0,
},
'updated_at': '2026-01-06T10:30:00Z',
'user': 'default',
};
/// Environment data without air quality (for conditional rendering test).
static const environmentNoAirQuality = {
'weather': {
'temperature': 8.5,
'conditions': 'Partly Cloudy',
'humidity': 72,
'wind_speed': 18.5,
'location': 'Rotterdam, NL',
},
'forecast': [
{
'date': '2026-01-06',
'high': 10.0,
'low': 4.0,
'conditions': 'Cloudy',
},
],
'sun_times': {
'sunrise': '2026-01-06T08:45:00Z',
'sunset': '2026-01-06T16:50:00Z',
'daylight_minutes': 485,
},
'air_quality': null,
'updated_at': '2026-01-06T10:30:00Z',
'user': 'default',
};
}
-185
View File
@@ -1,185 +0,0 @@
import 'package:dio/dio.dart';
/// Mock Dio client for testing API interactions.
///
/// Allows registering canned responses for specific endpoints.
class MockApiClient {
MockApiClient() {
_dio = Dio(BaseOptions(baseUrl: 'https://test.api'))
..interceptors.add(_MockInterceptor(this));
}
late final Dio _dio;
final Map<String, _MockResponse> _responses = {};
final List<RequestOptions> _requests = [];
/// Get the mock Dio instance.
Dio get dio => _dio;
/// Get all recorded requests.
List<RequestOptions> get requests => List.unmodifiable(_requests);
/// Get the last request made.
RequestOptions? get lastRequest => _requests.isEmpty ? null : _requests.last;
/// Clear all recorded requests.
void clearRequests() => _requests.clear();
/// Register a mock response for an endpoint.
///
/// [method] is the HTTP method (GET, POST, PUT, DELETE).
/// [path] is the endpoint path (can include wildcards like /users/*).
/// [response] is the response data.
/// [statusCode] is the HTTP status code (default 200).
void when({
required String method,
required String path,
required dynamic response,
int statusCode = 200,
Map<String, dynamic>? headers,
}) {
final key = '${method.toUpperCase()}:$path';
_responses[key] = _MockResponse(
data: response,
statusCode: statusCode,
headers: headers ?? {},
);
}
/// Register a GET response.
void whenGet(String path, dynamic response, {int statusCode = 200}) {
when(method: 'GET', path: path, response: response, statusCode: statusCode);
}
/// Register a POST response.
void whenPost(String path, dynamic response, {int statusCode = 200}) {
when(method: 'POST', path: path, response: response, statusCode: statusCode);
}
/// Register a PUT response.
void whenPut(String path, dynamic response, {int statusCode = 200}) {
when(method: 'PUT', path: path, response: response, statusCode: statusCode);
}
/// Register a DELETE response.
void whenDelete(String path, dynamic response, {int statusCode = 200}) {
when(method: 'DELETE', path: path, response: response, statusCode: statusCode);
}
/// Register an error response.
void whenError({
required String method,
required String path,
required int statusCode,
String? message,
}) {
when(
method: method,
path: path,
response: {'error': message ?? 'Mock error'},
statusCode: statusCode,
);
}
/// Find a mock response for the given request.
_MockResponse? _findResponse(String method, String path) {
// Try exact match first
final exactKey = '${method.toUpperCase()}:$path';
if (_responses.containsKey(exactKey)) {
return _responses[exactKey];
}
// Try wildcard matches
for (final entry in _responses.entries) {
final pattern = entry.key;
if (_matchesPattern(pattern, exactKey)) {
return entry.value;
}
}
return null;
}
bool _matchesPattern(String pattern, String key) {
// Simple wildcard matching: /users/* matches /users/123
if (!pattern.contains('*')) return false;
final patternParts = pattern.split('/');
final keyParts = key.split('/');
if (patternParts.length != keyParts.length) return false;
for (var i = 0; i < patternParts.length; i++) {
if (patternParts[i] == '*') continue;
if (patternParts[i] != keyParts[i]) return false;
}
return true;
}
/// Reset all mock responses and requests.
void reset() {
_responses.clear();
_requests.clear();
}
}
class _MockResponse {
_MockResponse({
required this.data,
required this.statusCode,
required this.headers,
});
final dynamic data;
final int statusCode;
final Map<String, dynamic> headers;
}
class _MockInterceptor extends Interceptor {
_MockInterceptor(this._client);
final MockApiClient _client;
@override
void onRequest(RequestOptions options, RequestInterceptorHandler handler) {
_client._requests.add(options);
final response = _client._findResponse(options.method, options.path);
if (response != null) {
if (response.statusCode >= 200 && response.statusCode < 300) {
handler.resolve(Response(
requestOptions: options,
data: response.data,
statusCode: response.statusCode,
headers: Headers.fromMap(
response.headers.map((k, v) => MapEntry(k, [v.toString()])),
),
));
} else {
handler.reject(DioException(
requestOptions: options,
response: Response(
requestOptions: options,
data: response.data,
statusCode: response.statusCode,
),
type: DioExceptionType.badResponse,
));
}
} else {
// No mock registered - return 404
handler.reject(DioException(
requestOptions: options,
response: Response(
requestOptions: options,
data: {'error': 'No mock registered for ${options.method} ${options.path}'},
statusCode: 404,
),
type: DioExceptionType.badResponse,
message: 'No mock registered for ${options.method} ${options.path}',
));
}
}
}
-118
View File
@@ -1,118 +0,0 @@
import 'package:tatlock_ui/core/auth/auth_state.dart';
import 'package:tatlock_ui/core/auth/permissions.dart';
import 'package:tatlock_ui/core/auth/user_preferences.dart';
/// Mock authentication states for testing.
class MockAuth {
MockAuth._();
/// Unauthenticated state.
static const guest = AuthState();
/// Basic authenticated user with no special permissions.
static AuthState user({
String id = 'test-user-id',
String name = 'Test User',
String email = 'test@example.com',
String defaultRoom = 'front-hall',
String theme = 'system',
}) {
return AuthState(
isAuthenticated: true,
accessToken: 'mock-access-token-${DateTime.now().millisecondsSinceEpoch}',
refreshToken: 'mock-refresh-token',
expiresAt: DateTime.now().add(const Duration(hours: 1)),
userId: id,
authentikId: 'authentik-$id',
userName: name,
userEmail: email,
roles: [],
preferences: UserPreferences(
defaultRoom: defaultRoom,
theme: theme,
),
);
}
/// Admin user with full permissions.
static AuthState admin({
String id = 'admin-user-id',
String name = 'Admin User',
String email = 'admin@example.com',
}) {
return AuthState(
isAuthenticated: true,
accessToken: 'mock-admin-token-${DateTime.now().millisecondsSinceEpoch}',
refreshToken: 'mock-admin-refresh-token',
expiresAt: DateTime.now().add(const Duration(hours: 1)),
userId: id,
authentikId: 'authentik-$id',
userName: name,
userEmail: email,
roles: [
Role(
id: 'admin-role',
name: 'admin.general:admin',
domain: Domain.admin,
category: 'general',
action: Action.admin,
),
],
preferences: const UserPreferences(),
);
}
/// User with specific permissions.
static AuthState withPermissions({
String id = 'perm-user-id',
String name = 'Permission User',
String email = 'perm@example.com',
required List<Role> roles,
}) {
return AuthState(
isAuthenticated: true,
accessToken: 'mock-perm-token-${DateTime.now().millisecondsSinceEpoch}',
refreshToken: 'mock-perm-refresh-token',
expiresAt: DateTime.now().add(const Duration(hours: 1)),
userId: id,
authentikId: 'authentik-$id',
userName: name,
userEmail: email,
roles: roles,
preferences: const UserPreferences(),
);
}
/// User with expired token (for refresh testing).
static AuthState expired({
String id = 'expired-user-id',
String name = 'Expired User',
}) {
return AuthState(
isAuthenticated: true,
accessToken: 'mock-expired-token',
refreshToken: 'mock-refresh-token',
expiresAt: DateTime.now().subtract(const Duration(hours: 1)),
userId: id,
userName: name,
roles: [],
preferences: const UserPreferences(),
);
}
/// Create a role for testing.
static Role role({
String id = 'test-role',
required Domain domain,
String category = 'general',
required Action action,
}) {
return Role(
id: id,
name: '${domain.value}.$category:${action.name}',
domain: domain,
category: category,
action: action,
);
}
}
-92
View File
@@ -1,92 +0,0 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
/// Standard screen sizes for responsive testing.
abstract class ScreenSizes {
// Desktop sizes
static const desktopLarge = Size(1920, 1080);
static const desktop = Size(1440, 900);
static const desktopSmall = Size(1280, 800);
// Tablet sizes
static const tabletLandscape = Size(1024, 768);
static const tabletPortrait = Size(768, 1024);
// Mobile sizes
static const mobileLarge = Size(428, 926); // iPhone 14 Pro Max
static const mobile = Size(375, 812); // iPhone X/11/12/13
static const mobileSmall = Size(320, 568); // iPhone SE
/// All sizes for comprehensive testing.
static const all = [
desktopLarge,
desktop,
tabletLandscape,
tabletPortrait,
mobileLarge,
mobile,
];
/// Desktop-only sizes.
static const desktopSizes = [desktopLarge, desktop, desktopSmall];
/// Tablet sizes.
static const tabletSizes = [tabletLandscape, tabletPortrait];
/// Mobile sizes.
static const mobileSizes = [mobileLarge, mobile, mobileSmall];
}
/// Extension to easily set screen size in widget tests.
extension ScreenSizeExtension on WidgetTester {
/// Sets the screen size for the test.
///
/// Remember to call `addTearDown(() => view.resetPhysicalSize())` after.
void setScreenSize(Size size) {
view.physicalSize = size;
view.devicePixelRatio = 1.0;
}
/// Resets the screen size to default.
void resetScreenSize() {
view.resetPhysicalSize();
}
}
/// Configures a widget test for a specific screen size with overflow suppression.
///
/// Usage:
/// ```dart
/// testWidgets('renders on mobile', (tester) async {
/// configureScreenSize(tester, ScreenSizes.mobile);
/// // ... test code
/// });
/// ```
void configureScreenSize(WidgetTester tester, Size size) {
tester.view.physicalSize = size;
tester.view.devicePixelRatio = 1.0;
addTearDown(() => tester.view.resetPhysicalSize());
// Suppress overflow errors for responsive tests
final originalOnError = FlutterError.onError;
FlutterError.onError = (details) {
if (details.exceptionAsString().contains('overflowed')) {
return; // Ignore overflow errors
}
originalOnError?.call(details);
};
addTearDown(() => FlutterError.onError = originalOnError);
}
/// Returns a descriptive name for a screen size.
String screenSizeName(Size size) {
if (size == ScreenSizes.desktopLarge) return 'desktop-large';
if (size == ScreenSizes.desktop) return 'desktop';
if (size == ScreenSizes.desktopSmall) return 'desktop-small';
if (size == ScreenSizes.tabletLandscape) return 'tablet-landscape';
if (size == ScreenSizes.tabletPortrait) return 'tablet-portrait';
if (size == ScreenSizes.mobileLarge) return 'mobile-large';
if (size == ScreenSizes.mobile) return 'mobile';
if (size == ScreenSizes.mobileSmall) return 'mobile-small';
return '${size.width.toInt()}x${size.height.toInt()}';
}
-298
View File
@@ -1,298 +0,0 @@
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:shared_preferences/shared_preferences.dart';
import 'package:tatlock_ui/core/api/api_client.dart';
import 'package:tatlock_ui/core/auth/auth_provider.dart';
import 'package:tatlock_ui/core/auth/auth_state.dart';
import 'package:tatlock_ui/core/theme/theme_provider.dart';
import 'package:tatlock_ui/routing/room_registry.dart';
// Import room routers for registry initialization
import 'package:tatlock_ui/features/front_hall/router.dart';
import 'package:tatlock_ui/features/control_room/router.dart';
import 'package:tatlock_ui/features/security/router.dart';
import 'package:tatlock_ui/features/parlor/router.dart';
import 'package:tatlock_ui/features/media_room/router.dart';
import 'fixtures.dart';
import 'mock_api_client.dart';
import 'mock_auth.dart';
export 'fixtures.dart';
export 'mock_api_client.dart';
export 'mock_auth.dart';
/// Test harness for widget and integration tests.
///
/// Provides a consistent testing environment with:
/// - Mock authentication state
/// - Mock API client with fixtures
/// - Room registry initialization
/// - Provider overrides
///
/// Usage:
/// ```dart
/// void main() {
/// final harness = TestHarness();
///
/// setUp(() => harness.setUp());
/// tearDown(() => harness.tearDown());
///
/// testWidgets('example test', (tester) async {
/// harness.givenAuthenticatedUser();
/// harness.givenContainers(Fixtures.containers);
///
/// await tester.pumpWidget(harness.wrap(MyWidget()));
/// // assertions...
/// });
/// }
/// ```
class TestHarness {
TestHarness();
/// Mock API client for registering responses.
final api = MockApiClient();
/// Current auth state for the test.
AuthState _authState = MockAuth.guest;
/// Current theme mode for the test.
ThemeMode _themeMode = ThemeMode.light;
/// Set up the test environment.
///
/// Call this in setUp() for each test.
Future<void> setUp() async {
// Initialize SharedPreferences with empty values
SharedPreferences.setMockInitialValues({});
// Initialize room registry if needed
_initializeRoomRegistry();
// Reset state
_authState = MockAuth.guest;
_themeMode = ThemeMode.light;
api.reset();
}
/// Tear down the test environment.
///
/// Call this in tearDown() for each test.
Future<void> tearDown() async {
api.reset();
}
void _initializeRoomRegistry() {
if (roomRegistry.all.isEmpty) {
registerFrontHall();
registerControlRoom();
registerSecurity();
registerParlor();
registerMediaRoom();
}
}
// ============================================================
// Given - Set up preconditions
// ============================================================
/// Set up an unauthenticated (guest) user.
void givenGuestUser() {
_authState = MockAuth.guest;
}
/// Set up an authenticated user.
void givenAuthenticatedUser({
String name = 'Test User',
String email = 'test@example.com',
String defaultRoom = 'front-hall',
}) {
_authState = MockAuth.user(
name: name,
email: email,
defaultRoom: defaultRoom,
);
}
/// Set up an admin user.
void givenAdminUser({
String name = 'Admin User',
String email = 'admin@example.com',
}) {
_authState = MockAuth.admin(name: name, email: email);
}
/// Set up a custom auth state.
void givenAuthState(AuthState state) {
_authState = state;
}
/// Set up mock containers response.
void givenContainers([List<Map<String, dynamic>>? containers]) {
api.whenGet(
'/infrastructure/containers',
containers ?? Fixtures.containers,
);
}
/// Set up mock domains response (for ProxyHostsPage).
void givenDomains([List<Map<String, dynamic>>? domains]) {
api.whenGet(
'/infrastructure/domains',
domains ?? Fixtures.domains,
);
}
/// Set up mock proxy hosts response (raw NPM format).
void givenProxyHosts([List<Map<String, dynamic>>? hosts]) {
api.whenGet(
'/infrastructure/npm/proxy-hosts',
hosts ?? Fixtures.proxyHosts,
);
}
/// Set up mock users response.
void givenUsers([List<Map<String, dynamic>>? users]) {
api.whenGet('/auth/users', users ?? Fixtures.users);
}
/// Set up mock groups response.
void givenGroups([List<Map<String, dynamic>>? groups]) {
api.whenGet('/auth/groups', groups ?? Fixtures.groups);
}
/// Set up mock quick links response.
void givenQuickLinks([List<Map<String, dynamic>>? links]) {
api.whenGet('/dashboard/quick-links', links ?? Fixtures.quickLinks);
}
/// Set up mock system stats response.
void givenSystemStats([Map<String, dynamic>? stats]) {
api.whenGet('/tools/system/stats', stats ?? Fixtures.systemStats);
}
/// Set up mock environment response.
void givenEnvironment([Map<String, dynamic>? environment]) {
api.whenGet('/tools/environment', environment ?? Fixtures.environment);
}
/// Set up mock environment response without air quality.
void givenEnvironmentNoAirQuality() {
api.whenGet('/tools/environment', Fixtures.environmentNoAirQuality);
}
/// Set up theme mode.
void givenThemeMode(ThemeMode mode) {
_themeMode = mode;
}
/// Set up an API error response.
void givenApiError({
required String method,
required String path,
int statusCode = 500,
String? message,
}) {
api.whenError(
method: method,
path: path,
statusCode: statusCode,
message: message,
);
}
// ============================================================
// Wrap - Create test widget with providers
// ============================================================
/// Wrap a widget with the test harness providers.
///
/// This sets up:
/// - ProviderScope with auth, theme, and API overrides
/// - MaterialApp with theme
/// - Scaffold for proper widget context
Widget wrap(Widget child, {bool useScaffold = true}) {
final content = useScaffold ? Scaffold(body: child) : child;
return ProviderScope(
overrides: [
// Override auth provider to return our mock state
authProvider.overrideWith(() => _MockAuthNotifier(_authState)),
// Override theme provider
themeProvider.overrideWith(() => _MockThemeNotifier(_themeMode)),
// Override API client to use mock
coreApiClientProvider.overrideWithValue(api.dio),
],
child: MaterialApp(
theme: ThemeData.light(useMaterial3: true),
darkTheme: ThemeData.dark(useMaterial3: true),
themeMode: _themeMode,
home: content,
),
);
}
/// Wrap with a custom route for navigation testing.
Widget wrapWithRouter(Widget child) {
return ProviderScope(
overrides: [
authProvider.overrideWith(() => _MockAuthNotifier(_authState)),
themeProvider.overrideWith(() => _MockThemeNotifier(_themeMode)),
coreApiClientProvider.overrideWithValue(api.dio),
],
child: MaterialApp(
theme: ThemeData.light(useMaterial3: true),
darkTheme: ThemeData.dark(useMaterial3: true),
themeMode: _themeMode,
home: child,
),
);
}
// ============================================================
// Verify - Check assertions
// ============================================================
/// Verify that a specific API endpoint was called.
void verifyApiCalled(String method, String path) {
final called = api.requests.any(
(r) => r.method.toUpperCase() == method.toUpperCase() && r.path == path,
);
expect(called, isTrue, reason: 'Expected $method $path to be called');
}
/// Verify that no API calls were made.
void verifyNoApiCalls() {
expect(api.requests, isEmpty, reason: 'Expected no API calls');
}
/// Get the request body of the last API call.
dynamic getLastRequestBody() {
return api.lastRequest?.data;
}
}
/// Mock auth notifier that returns a fixed state.
class _MockAuthNotifier extends AuthNotifier {
_MockAuthNotifier(this._state);
final AuthState _state;
@override
Future<AuthState> build() async => _state;
}
/// Mock theme notifier that returns a fixed theme.
class _MockThemeNotifier extends ThemeNotifier {
_MockThemeNotifier(this._mode);
final ThemeMode _mode;
@override
ThemeSetting build() {
return switch (_mode) {
ThemeMode.light => ThemeSetting.light,
ThemeMode.dark => ThemeSetting.dark,
ThemeMode.system => ThemeSetting.system,
};
}
}
-204
View File
@@ -1,204 +0,0 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:go_router/go_router.dart';
import 'package:tatlock_ui/routing/room_registry.dart';
import '../harness/test_harness.dart';
void main() {
final harness = TestHarness();
setUp(() => harness.setUp());
tearDown(() => harness.tearDown());
group('RoomDefinition', () {
test('creates room with all required fields', () {
final room = RoomDefinition(
id: 'test-room',
label: 'Test Room',
icon: Icons.home_outlined,
selectedIcon: Icons.home,
defaultRoute: '/test-room',
routes: () => [],
);
expect(room.id, 'test-room');
expect(room.label, 'Test Room');
expect(room.icon, Icons.home_outlined);
expect(room.selectedIcon, Icons.home);
expect(room.defaultRoute, '/test-room');
expect(room.requiredPermissions, isEmpty);
});
test('creates room with permissions', () {
final room = RoomDefinition(
id: 'admin-room',
label: 'Admin Room',
icon: Icons.admin_panel_settings_outlined,
selectedIcon: Icons.admin_panel_settings,
defaultRoute: '/admin',
routes: () => [],
requiredPermissions: ['admin:access', 'admin:read'],
);
expect(room.requiredPermissions.length, 2);
expect(room.requiredPermissions, contains('admin:access'));
});
test('routes function returns RouteBase list', () {
final room = RoomDefinition(
id: 'test-room',
label: 'Test Room',
icon: Icons.home_outlined,
selectedIcon: Icons.home,
defaultRoute: '/test-room',
routes: () => [
GoRoute(
path: '/test-room',
builder: (context, state) => const SizedBox(),
),
],
);
final routes = room.routes();
expect(routes.length, 1);
expect(routes.first, isA<GoRoute>());
});
});
group('RoomRegistry', () {
test('all returns registered rooms', () {
// Rooms are registered by harness.setUp()
final rooms = roomRegistry.all;
expect(rooms, isNotEmpty);
});
test('byId returns room for valid ID', () {
final room = roomRegistry.byId('front-hall');
expect(room, isNotNull);
expect(room!.label, 'Front Hall');
});
test('byId returns null for invalid ID', () {
final room = roomRegistry.byId('non-existent-room');
expect(room, isNull);
});
test('indexOfId returns correct index', () {
final index = roomRegistry.indexOfId('front-hall');
expect(index, 0);
final controlRoomIndex = roomRegistry.indexOfId('control-room');
expect(controlRoomIndex, 1);
});
test('indexOfId returns -1 for invalid ID', () {
final index = roomRegistry.indexOfId('non-existent');
expect(index, -1);
});
test('indexOfRoute matches exact route', () {
final index = roomRegistry.indexOfRoute('/front-hall');
expect(index, 0);
});
test('indexOfRoute matches sub-routes', () {
final index = roomRegistry.indexOfRoute('/control-room/containers');
expect(index, 1);
final securityIndex = roomRegistry.indexOfRoute('/security/users');
expect(securityIndex, 2);
});
test('indexOfRoute returns 0 for unknown route', () {
final index = roomRegistry.indexOfRoute('/unknown-route');
expect(index, 0); // Defaults to first room
});
test('allRoutes returns routes from all rooms', () {
final routes = roomRegistry.allRoutes();
expect(routes, isNotEmpty);
// Should have routes from all registered rooms
});
test('accessibleTo filters by permissions', () {
// All current rooms have no required permissions
final accessible = roomRegistry.accessibleTo({});
expect(accessible.length, roomRegistry.all.length);
});
test('accessibleTo returns all rooms for empty permissions when no rooms require permissions', () {
final accessible = roomRegistry.accessibleTo({'some:permission'});
// All rooms should be accessible since none require permissions
expect(accessible.length, roomRegistry.all.length);
});
});
group('Room Registration Order', () {
test('front-hall is first', () {
expect(roomRegistry.all[0].id, 'front-hall');
});
test('control-room is second', () {
expect(roomRegistry.all[1].id, 'control-room');
});
test('security is third', () {
expect(roomRegistry.all[2].id, 'security');
});
test('parlor is fourth', () {
expect(roomRegistry.all[3].id, 'parlor');
});
test('media-room is fifth', () {
expect(roomRegistry.all[4].id, 'media-room');
});
});
group('Room Default Routes', () {
test('front-hall default route is /front-hall', () {
final room = roomRegistry.byId('front-hall');
expect(room?.defaultRoute, '/front-hall');
});
test('control-room default route is /control-room/containers', () {
final room = roomRegistry.byId('control-room');
expect(room?.defaultRoute, '/control-room/containers');
});
test('security default route is /security/users', () {
final room = roomRegistry.byId('security');
expect(room?.defaultRoute, '/security/users');
});
test('parlor default route is /parlor', () {
final room = roomRegistry.byId('parlor');
expect(room?.defaultRoute, '/parlor');
});
test('media-room default route is /media-room', () {
final room = roomRegistry.byId('media-room');
expect(room?.defaultRoute, '/media-room');
});
});
group('Room Icons', () {
test('each room has distinct icons', () {
final rooms = roomRegistry.all;
final icons = rooms.map((r) => r.icon).toSet();
final selectedIcons = rooms.map((r) => r.selectedIcon).toSet();
// All icons should be unique
expect(icons.length, rooms.length);
expect(selectedIcons.length, rooms.length);
});
test('icon and selectedIcon are different for each room', () {
for (final room in roomRegistry.all) {
expect(room.icon, isNot(equals(room.selectedIcon)),
reason: '${room.label} should have different icon and selectedIcon');
}
});
});
}
@@ -1,410 +0,0 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:tatlock_ui/shared/components/data_grid/data_grid_column.dart';
import 'package:tatlock_ui/shared/components/data_grid/data_grid_config.dart';
import 'package:tatlock_ui/shared/components/data_grid/data_grid_state.dart';
import '../../../harness/test_harness.dart';
/// Test data class for DataGrid tests.
class TestItem {
const TestItem({
required this.id,
required this.name,
required this.value,
this.isActive = true,
});
final String id;
final String name;
final int value;
final bool isActive;
}
void main() {
final harness = TestHarness();
setUp(() => harness.setUp());
tearDown(() => harness.tearDown());
group('DataGridColumn', () {
test('creates column with required fields', () {
final column = DataGridColumn<TestItem>(
id: 'name',
header: 'Name',
valueBuilder: (item) => item.name,
);
expect(column.id, 'name');
expect(column.header, 'Name');
expect(column.sortable, isFalse);
expect(column.searchable, isFalse);
});
test('creates sortable column', () {
final column = DataGridColumn<TestItem>(
id: 'name',
header: 'Name',
valueBuilder: (item) => item.name,
sortable: true,
);
expect(column.sortable, isTrue);
});
test('creates searchable column', () {
final column = DataGridColumn<TestItem>(
id: 'name',
header: 'Name',
valueBuilder: (item) => item.name,
searchable: true,
);
expect(column.searchable, isTrue);
});
test('valueBuilder extracts correct value', () {
final column = DataGridColumn<TestItem>(
id: 'name',
header: 'Name',
valueBuilder: (item) => item.name,
);
final item = TestItem(id: '1', name: 'Test Item', value: 42);
expect(column.valueBuilder(item), 'Test Item');
});
test('supports fixed width', () {
final column = DataGridColumn<TestItem>(
id: 'id',
header: 'ID',
valueBuilder: (item) => item.id,
width: const DataGridColumnWidth.fixed(100),
);
expect(column.width, isA<GridFixedWidth>());
expect((column.width as GridFixedWidth).width, 100);
});
test('supports flex width', () {
final column = DataGridColumn<TestItem>(
id: 'name',
header: 'Name',
valueBuilder: (item) => item.name,
width: const DataGridColumnWidth.flex(2),
);
expect(column.width, isA<GridFlexWidth>());
expect((column.width as GridFlexWidth).flex, 2);
});
test('default width is flex(1)', () {
final column = DataGridColumn<TestItem>(
id: 'name',
header: 'Name',
valueBuilder: (item) => item.name,
);
expect(column.width, isA<GridFlexWidth>());
expect((column.width as GridFlexWidth).flex, 1);
});
test('supports custom alignment', () {
final column = DataGridColumn<TestItem>(
id: 'value',
header: 'Value',
valueBuilder: (item) => item.value.toString(),
alignment: DataGridColumnAlignment.end,
);
expect(column.alignment, DataGridColumnAlignment.end);
expect(column.textAlign, TextAlign.end);
expect(column.crossAxisAlignment, CrossAxisAlignment.end);
});
test('effectiveSortField defaults to lowercase header', () {
final column = DataGridColumn<TestItem>(
id: 'name',
header: 'Full Name',
valueBuilder: (item) => item.name,
);
expect(column.effectiveSortField, 'full name');
});
test('effectiveSortField uses sortField when provided', () {
final column = DataGridColumn<TestItem>(
id: 'name',
header: 'Full Name',
valueBuilder: (item) => item.name,
sortField: 'name',
);
expect(column.effectiveSortField, 'name');
});
});
group('DataGridConfig', () {
test('creates config with columns', () {
final config = DataGridConfig<TestItem>(
columns: [
DataGridColumn<TestItem>(
id: 'id',
header: 'ID',
valueBuilder: (item) => item.id,
),
DataGridColumn<TestItem>(
id: 'name',
header: 'Name',
valueBuilder: (item) => item.name,
),
],
);
expect(config.columns.length, 2);
});
test('enableSearch defaults to false', () {
final config = DataGridConfig<TestItem>(
columns: [],
);
expect(config.enableSearch, isFalse);
});
test('enables search when specified', () {
final config = DataGridConfig<TestItem>(
columns: [
DataGridColumn<TestItem>(
id: 'name',
header: 'Name',
valueBuilder: (item) => item.name,
searchable: true,
),
],
enableSearch: true,
);
expect(config.enableSearch, isTrue);
});
test('supports custom search hint', () {
final config = DataGridConfig<TestItem>(
columns: [],
enableSearch: true,
searchHint: 'Search items...',
);
expect(config.searchHint, 'Search items...');
});
test('supports row selection mode', () {
final config = DataGridConfig<TestItem>(
columns: [],
rowsSelectable: true,
);
expect(config.rowsSelectable, isTrue);
});
test('visibleColumns filters hidden columns', () {
final config = DataGridConfig<TestItem>(
columns: [
DataGridColumn<TestItem>(
id: 'id',
header: 'ID',
valueBuilder: (item) => item.id,
visible: false,
),
DataGridColumn<TestItem>(
id: 'name',
header: 'Name',
valueBuilder: (item) => item.name,
),
],
);
expect(config.visibleColumns.length, 1);
expect(config.visibleColumns.first.id, 'name');
});
test('searchableColumnIndices returns correct indices', () {
final config = DataGridConfig<TestItem>(
columns: [
DataGridColumn<TestItem>(
id: 'id',
header: 'ID',
valueBuilder: (item) => item.id,
),
DataGridColumn<TestItem>(
id: 'name',
header: 'Name',
valueBuilder: (item) => item.name,
searchable: true,
),
DataGridColumn<TestItem>(
id: 'value',
header: 'Value',
valueBuilder: (item) => item.value.toString(),
searchable: true,
),
],
);
expect(config.searchableColumnIndices, [1, 2]);
});
});
group('DataGridState', () {
test('creates initial state with defaults', () {
const state = DataGridState<TestItem>();
expect(state.items, isEmpty);
expect(state.isLoading, isFalse);
expect(state.selectedIds, isEmpty);
expect(state.searchQuery, isEmpty);
expect(state.isInitialLoad, isTrue);
});
test('creates loading state', () {
const state = DataGridState<TestItem>(
isLoading: true,
);
expect(state.isLoading, isTrue);
});
test('stores items', () {
final items = [
const TestItem(id: '1', name: 'Item 1', value: 10),
const TestItem(id: '2', name: 'Item 2', value: 20),
];
final state = DataGridState<TestItem>(
items: items,
isLoading: false,
);
expect(state.items.length, 2);
expect(state.items[0].name, 'Item 1');
});
test('stores selected IDs', () {
const state = DataGridState<TestItem>(
selectedIds: {'1', '2', '3'},
);
expect(state.selectedIds.length, 3);
expect(state.selectedIds.contains('1'), isTrue);
});
test('stores search query', () {
const state = DataGridState<TestItem>(
searchQuery: 'test query',
);
expect(state.searchQuery, 'test query');
});
test('stores sort column index', () {
const state = DataGridState<TestItem>(
sortColumnIndex: 1,
sortDescending: true,
);
expect(state.sortColumnIndex, 1);
expect(state.sortDescending, isTrue);
});
test('stores error', () {
const state = DataGridState<TestItem>(
error: 'Something went wrong',
);
expect(state.error, 'Something went wrong');
});
test('stores pagination info', () {
const state = DataGridState<TestItem>(
currentPage: 2,
totalCount: 100,
);
expect(state.currentPage, 2);
expect(state.totalCount, 100);
});
});
group('DataGridColumnWidth', () {
test('fixed width creates GridFixedWidth', () {
const width = DataGridColumnWidth.fixed(150);
expect(width, isA<GridFixedWidth>());
expect((width as GridFixedWidth).width, 150);
});
test('flex width creates GridFlexWidth', () {
const width = DataGridColumnWidth.flex(2);
expect(width, isA<GridFlexWidth>());
expect((width as GridFlexWidth).flex, 2);
});
test('default flex is 1', () {
const width = DataGridColumnWidth.flex();
expect((width as GridFlexWidth).flex, 1);
});
test('fraction width creates GridFractionWidth', () {
const width = DataGridColumnWidth.fraction(0.5);
expect(width, isA<GridFractionWidth>());
expect((width as GridFractionWidth).fraction, 0.5);
});
});
group('DataGridColumnAlignment', () {
test('has start alignment', () {
expect(DataGridColumnAlignment.start, isNotNull);
});
test('has center alignment', () {
expect(DataGridColumnAlignment.center, isNotNull);
});
test('has end alignment', () {
expect(DataGridColumnAlignment.end, isNotNull);
});
});
group('DataGridDataMode', () {
test('all mode', () {
const mode = DataGridDataMode.all();
expect(mode, isA<AllDataMode>());
});
test('paginated mode with default page size', () {
const mode = DataGridDataMode.paginated();
expect(mode, isA<PaginatedDataMode>());
expect((mode as PaginatedDataMode).pageSize, 25);
});
test('paginated mode with custom page size', () {
const mode = DataGridDataMode.paginated(pageSize: 50);
expect((mode as PaginatedDataMode).pageSize, 50);
});
test('infinite mode with defaults', () {
const mode = DataGridDataMode.infinite();
expect(mode, isA<InfiniteDataMode>());
expect((mode as InfiniteDataMode).initialLoad, 50);
expect((mode as InfiniteDataMode).loadMoreThreshold, 10);
});
test('infinite mode with custom values', () {
const mode = DataGridDataMode.infinite(
initialLoad: 100,
loadMoreThreshold: 20,
);
expect((mode as InfiniteDataMode).initialLoad, 100);
expect((mode as InfiniteDataMode).loadMoreThreshold, 20);
});
});
}
+11 -172
View File
@@ -1,180 +1,19 @@
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:tatlock_ui/routing/room_registry.dart';
import 'harness/test_harness.dart';
import 'package:tatlock_ui/app.dart';
void main() {
final harness = TestHarness();
testWidgets('App renders dashboard', (WidgetTester tester) async {
await tester.pumpWidget(
const ProviderScope(
child: TatlockApp(),
),
);
setUp(() => harness.setUp());
tearDown(() => harness.tearDown());
// Wait for async operations
await tester.pumpAndSettle();
group('Room Registry', () {
test('is initialized with all rooms', () {
expect(roomRegistry.all.isNotEmpty, isTrue);
expect(roomRegistry.all.length, greaterThanOrEqualTo(5));
});
test('contains expected rooms', () {
final roomIds = roomRegistry.all.map((r) => r.id).toList();
expect(roomIds, contains('front-hall'));
expect(roomIds, contains('control-room'));
expect(roomIds, contains('security'));
expect(roomIds, contains('parlor'));
expect(roomIds, contains('media-room'));
});
test('returns correct index for route', () {
expect(roomRegistry.indexOfRoute('/front-hall'), 0);
expect(roomRegistry.indexOfRoute('/control-room/containers'), 1);
expect(roomRegistry.indexOfRoute('/security/users'), 2);
expect(roomRegistry.indexOfRoute('/parlor'), 3);
expect(roomRegistry.indexOfRoute('/media-room'), 4);
});
test('finds room by ID', () {
final frontHall = roomRegistry.byId('front-hall');
expect(frontHall, isNotNull);
expect(frontHall!.label, 'Front Hall');
expect(frontHall.defaultRoute, '/front-hall');
final controlRoom = roomRegistry.byId('control-room');
expect(controlRoom, isNotNull);
expect(controlRoom!.label, 'Control Room');
final nonExistent = roomRegistry.byId('non-existent');
expect(nonExistent, isNull);
});
test('returns default route for room', () {
final frontHall = roomRegistry.byId('front-hall');
expect(frontHall?.defaultRoute, '/front-hall');
final controlRoom = roomRegistry.byId('control-room');
expect(controlRoom?.defaultRoute, '/control-room/containers');
final security = roomRegistry.byId('security');
expect(security?.defaultRoute, '/security/users');
});
});
group('Test Harness', () {
test('provides guest auth state by default', () async {
harness.givenGuestUser();
expect(MockAuth.guest.isAuthenticated, isFalse);
});
test('provides authenticated user state', () {
harness.givenAuthenticatedUser(name: 'John Doe');
// The auth state is set internally, verified via wrap()
});
test('provides admin user state', () {
harness.givenAdminUser();
final adminState = MockAuth.admin();
expect(adminState.isGlobalAdmin, isTrue);
});
test('mock API client registers responses', () {
harness.givenContainers();
// Verify the mock is registered (would be called during widget tests)
});
});
group('Mock Auth', () {
test('guest state is not authenticated', () {
expect(MockAuth.guest.isAuthenticated, isFalse);
expect(MockAuth.guest.accessToken, isNull);
});
test('user state is authenticated', () {
final user = MockAuth.user();
expect(user.isAuthenticated, isTrue);
expect(user.accessToken, isNotNull);
expect(user.userName, 'Test User');
});
test('admin state has admin role', () {
final admin = MockAuth.admin();
expect(admin.isAuthenticated, isTrue);
expect(admin.isGlobalAdmin, isTrue);
expect(admin.roles.length, 1);
});
test('expired state has past expiry', () {
final expired = MockAuth.expired();
expect(expired.isTokenExpired, isTrue);
});
});
group('Mock API Client', () {
test('returns registered response', () async {
final client = MockApiClient();
client.whenGet('/test', {'message': 'hello'});
final response = await client.dio.get<Map<String, dynamic>>('/test');
expect(response.data?['message'], 'hello');
});
test('returns 404 for unregistered endpoint', () async {
final client = MockApiClient();
expect(
() => client.dio.get('/unknown'),
throwsA(isA<Exception>()),
);
});
test('records requests', () async {
final client = MockApiClient();
client.whenGet('/test1', {});
client.whenGet('/test2', {});
await client.dio.get('/test1');
await client.dio.get('/test2');
expect(client.requests.length, 2);
expect(client.requests[0].path, '/test1');
expect(client.requests[1].path, '/test2');
});
test('supports error responses', () async {
final client = MockApiClient();
client.whenError(method: 'GET', path: '/error', statusCode: 500);
expect(
() => client.dio.get('/error'),
throwsA(isA<Exception>()),
);
});
});
group('Fixtures', () {
test('provides container data', () {
expect(Fixtures.containers.length, 4);
expect(Fixtures.containers[0]['Names'], contains('/nginx-proxy'));
});
test('provides proxy host data', () {
expect(Fixtures.proxyHosts.length, 3);
expect(Fixtures.proxyHosts[0]['domain_names'], contains('home.schweitz.net'));
});
test('provides user data', () {
expect(Fixtures.users.length, 3);
expect(Fixtures.users[0]['name'], 'Admin User');
});
test('provides group data', () {
expect(Fixtures.groups.length, 3);
expect(Fixtures.groups[0]['name'], 'admins');
});
test('provides auth sync response', () {
final response = Fixtures.authSyncResponse(name: 'Test');
expect(response['name'], 'Test');
expect(response['preferences'], isNotNull);
});
expect(find.text('Welcome to Tatlock'), findsOneWidget);
});
}
-51
View File
@@ -1,51 +0,0 @@
#!/usr/bin/env dart
// Generates web/health/health.json from pubspec.yaml
// Run: dart run tool/generate_health_json.dart
// ignore_for_file: avoid_print
import 'dart:convert';
import 'dart:io';
import 'package:yaml/yaml.dart';
void main() {
final pubspecFile = File('pubspec.yaml');
if (!pubspecFile.existsSync()) {
stderr.writeln('Error: pubspec.yaml not found');
exit(1);
}
final pubspecContent = pubspecFile.readAsStringSync();
final pubspec = loadYaml(pubspecContent) as YamlMap;
final name = pubspec['name'] as String;
final description = pubspec['description'] as String? ?? '';
final versionString = pubspec['version'] as String;
// Parse version: "1.0.3+1" -> version="1.0.3", buildNumber=1
final versionParts = versionString.split('+');
final version = versionParts[0];
final buildNumber = versionParts.length > 1 ? int.parse(versionParts[1]) : 0;
final health = {
'status': 'healthy',
'name': name,
'title': description,
'version': version,
'buildNumber': buildNumber,
'fullVersion': '$version+$buildNumber',
};
final healthDir = Directory('web/health');
if (!healthDir.existsSync()) {
healthDir.createSync(recursive: true);
}
final healthFile = File('web/health/health.json');
healthFile.writeAsStringSync(
const JsonEncoder.withIndent(' ').convert(health),
);
print('Generated web/health/health.json with version $version+$buildNumber');
}
BIN
View File
Binary file not shown.

Before

Width:  |  Height:  |  Size: 4.2 KiB

+7
View File
@@ -0,0 +1,7 @@
<!DOCTYPE html>
<html>
<head>
<title>OK</title>
</head>
<body>OK</body>
</html>
-8
View File
@@ -1,8 +0,0 @@
{
"status": "healthy",
"name": "tatlock_ui",
"title": "Tatlock - a Home Lab AI",
"version": "1.0.4",
"buildNumber": 1,
"fullVersion": "1.0.4+1"
}
-30
View File
@@ -1,30 +0,0 @@
<!DOCTYPE html>
<html>
<head>
<title>Health Check</title>
<style>
body { font-family: monospace; padding: 20px; background: #1a1a1a; color: #0f0; }
.healthy { color: #0f0; }
.error { color: #f00; }
pre { background: #222; padding: 15px; border-radius: 5px; }
</style>
</head>
<body>
<h1 id="status">Loading...</h1>
<pre id="data"></pre>
<script>
fetch('./health.json')
.then(r => r.json())
.then(data => {
document.getElementById('status').textContent = data.status?.toUpperCase() || 'OK';
document.getElementById('status').className = data.status === 'healthy' ? 'healthy' : 'error';
document.getElementById('data').textContent = JSON.stringify(data, null, 2);
})
.catch(err => {
document.getElementById('status').textContent = 'ERROR';
document.getElementById('status').className = 'error';
document.getElementById('data').textContent = err.message;
});
</script>
</body>
</html>
+2 -15
View File
@@ -1,6 +1,5 @@
<!DOCTYPE html>
<html>
<head>
<!--
If you are serving your web app in a path other than the root, change the
@@ -25,27 +24,15 @@
<meta name="mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="black">
<meta name="apple-mobile-web-app-title" content="Tatlock">
<meta name="theme-color" content="#040607">
<link rel="apple-touch-icon" href="icons/Icon-192.png">
<!-- Favicon -->
<link rel="icon" type="image/x-icon" href="favicon.ico" />
<link rel="icon" type="image/png" href="favicon.png" />
<link rel="icon" type="image/png" href="favicon.png"/>
<title>Tatlock</title>
<link rel="manifest" href="manifest.json">
<style>
body {
margin: 0;
padding: 0;
/* Match Flutter's dark theme scaffold background (FlexScheme.aquaBlue) */
background-color: #111111;
}
</style>
</head>
<body>
<script src="flutter_bootstrap.js" async></script>
</body>
</html>
</html>
+3 -3
View File
@@ -3,8 +3,8 @@
"short_name": "Tatlock",
"start_url": ".",
"display": "standalone",
"background_color": "#040607",
"theme_color": "#040607",
"background_color": "#1a1a2e",
"theme_color": "#1a1a2e",
"description": "Tatlock Home Dashboard",
"orientation": "portrait-primary",
"prefer_related_applications": false,
@@ -32,4 +32,4 @@
"purpose": "maskable"
}
]
}
}