feat: add Control Room with containers and stacks management

- Add Control Room page with stacks sidebar and containers list
- Implement container actions (start/stop/restart) with snackbars
- Add container logs viewer dialog
- Add search/filter for both stacks and containers lists
- Add external links for Portainer and Netdata (url_launcher)
- Add VS Code launch configuration for Flutter web debugging

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Jeroen Schweitzer
2025-12-31 02:01:01 +01:00
co-authored by Claude Opus 4.5
parent dd6bcbdbda
commit 3b89ed8c18
42 changed files with 4166 additions and 21 deletions
@@ -0,0 +1,396 @@
import 'package:flutter/material.dart' hide Container;
import 'package:flutter_riverpod/flutter_riverpod.dart';
import '../../domain/entities/container.dart';
import '../providers/containers_provider.dart';
import '../widgets/container_logs_viewer.dart';
import '../widgets/container_status_badge.dart';
/// Page displaying the list of containers using DataGrid.
class ContainersListPage extends ConsumerWidget {
const ContainersListPage({super.key});
@override
Widget build(BuildContext context, WidgetRef ref) {
final containersAsync = ref.watch(containersProvider);
final colorScheme = Theme.of(context).colorScheme;
// Listen for container action results to show snackbars
ref.listen<AsyncValue<void>>(containerActionsProvider, (previous, next) {
if (previous?.isLoading == true && !next.isLoading) {
next.whenOrNull(
data: (_) {
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(
content: const Text('Container action completed'),
backgroundColor: colorScheme.primaryContainer,
behavior: SnackBarBehavior.floating,
duration: const Duration(seconds: 2),
),
);
},
error: (error, _) {
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(
content: Row(
children: [
Icon(Icons.error_outline, color: colorScheme.onErrorContainer),
const SizedBox(width: 8),
Expanded(
child: Text(
'Container action failed: $error',
style: TextStyle(color: colorScheme.onErrorContainer),
),
),
],
),
backgroundColor: colorScheme.errorContainer,
behavior: SnackBarBehavior.floating,
duration: const Duration(seconds: 4),
),
);
},
);
}
});
return containersAsync.when(
loading: () => const Center(child: CircularProgressIndicator()),
error: (error, stack) => Center(
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Icon(
Icons.error_outline,
size: 48,
color: colorScheme.error,
),
const SizedBox(height: 16),
const Text('Failed to load containers'),
const SizedBox(height: 8),
Text(
error.toString(),
style: TextStyle(color: colorScheme.outline),
),
const SizedBox(height: 16),
FilledButton.icon(
onPressed: () => ref.invalidate(containersProvider),
icon: const Icon(Icons.refresh),
label: const Text('Retry'),
),
],
),
),
data: (containers) => _ContainersList(
containers: containers,
onAction: (container, action) => _handleAction(ref, container, action),
onViewLogs: (c) => showContainerLogs(
context,
containerId: c.fullId,
containerName: c.name,
),
onRefresh: () => ref.invalidate(containersProvider),
),
);
}
void _handleAction(WidgetRef ref, Container container, String action) {
final actions = ref.read(containerActionsProvider.notifier);
switch (action) {
case 'start':
actions.start(container.fullId);
case 'stop':
actions.stop(container.fullId);
case 'restart':
actions.restart(container.fullId);
}
}
}
class _ContainersList extends StatefulWidget {
const _ContainersList({
required this.containers,
required this.onAction,
required this.onViewLogs,
required this.onRefresh,
});
final List<Container> containers;
final void Function(Container, String) onAction;
final void Function(Container) onViewLogs;
final VoidCallback onRefresh;
@override
State<_ContainersList> createState() => _ContainersListState();
}
class _ContainersListState extends State<_ContainersList> {
final _searchController = TextEditingController();
String _searchQuery = '';
@override
void dispose() {
_searchController.dispose();
super.dispose();
}
List<Container> get _filteredContainers {
if (_searchQuery.isEmpty) return widget.containers;
final query = _searchQuery.toLowerCase();
return widget.containers.where((c) {
return c.name.toLowerCase().contains(query) ||
c.image.toLowerCase().contains(query) ||
c.status.toLowerCase().contains(query);
}).toList();
}
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
final filtered = _filteredContainers;
return Column(
children: [
// Toolbar with search
Padding(
padding: const EdgeInsets.all(16),
child: Row(
children: [
Text(
'${filtered.length} of ${widget.containers.length} containers',
style: Theme.of(context).textTheme.titleSmall?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
const Spacer(),
SizedBox(
width: 250,
child: TextField(
controller: _searchController,
decoration: InputDecoration(
hintText: 'Search containers...',
prefixIcon: const Icon(Icons.search, size: 20),
suffixIcon: _searchQuery.isNotEmpty
? IconButton(
icon: const Icon(Icons.clear, size: 18),
onPressed: () {
_searchController.clear();
setState(() => _searchQuery = '');
},
)
: null,
isDense: true,
contentPadding: const EdgeInsets.symmetric(
horizontal: 12,
vertical: 8,
),
border: OutlineInputBorder(
borderRadius: BorderRadius.circular(8),
),
),
onChanged: (value) => setState(() => _searchQuery = value),
),
),
const SizedBox(width: 8),
IconButton(
icon: const Icon(Icons.refresh),
tooltip: 'Refresh',
onPressed: widget.onRefresh,
),
],
),
),
// Container list or empty state
Expanded(
child: filtered.isEmpty
? Center(
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Icon(
_searchQuery.isEmpty
? Icons.inbox_outlined
: Icons.search_off,
size: 64,
color: colorScheme.outline,
),
const SizedBox(height: 16),
Text(
_searchQuery.isEmpty
? 'No containers found'
: 'No containers match "$_searchQuery"',
style: Theme.of(context).textTheme.titleMedium?.copyWith(
color: colorScheme.onSurfaceVariant,
),
),
if (_searchQuery.isNotEmpty) ...[
const SizedBox(height: 8),
TextButton(
onPressed: () {
_searchController.clear();
setState(() => _searchQuery = '');
},
child: const Text('Clear search'),
),
],
],
),
)
: ListView.builder(
itemCount: filtered.length,
itemBuilder: (context, index) {
final container = filtered[index];
return _ContainerListTile(
container: container,
onAction: (action) => widget.onAction(container, action),
onViewLogs: () => widget.onViewLogs(container),
);
},
),
),
],
);
}
}
class _ContainerListTile extends StatelessWidget {
const _ContainerListTile({
required this.container,
required this.onAction,
required this.onViewLogs,
});
final Container container;
final void Function(String) onAction;
final VoidCallback onViewLogs;
@override
Widget build(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
return Card(
margin: const EdgeInsets.symmetric(horizontal: 16, vertical: 4),
child: Padding(
padding: const EdgeInsets.all(12),
child: Row(
children: [
// Status and name
Expanded(
flex: 2,
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Row(
children: [
ContainerStatusBadge(state: container.state),
const SizedBox(width: 8),
Expanded(
child: Text(
container.name,
style: const TextStyle(fontWeight: FontWeight.w500),
overflow: TextOverflow.ellipsis,
),
),
],
),
const SizedBox(height: 4),
Text(
container.image,
style: TextStyle(
fontSize: 12,
color: colorScheme.onSurfaceVariant,
),
overflow: TextOverflow.ellipsis,
),
],
),
),
// Ports
if (container.ports.isNotEmpty)
Expanded(
child: Text(
container.ports.map((p) => p.formatted).join(', '),
style: TextStyle(
fontSize: 12,
color: colorScheme.onSurfaceVariant,
fontFamily: 'monospace',
),
overflow: TextOverflow.ellipsis,
),
),
// Status text
SizedBox(
width: 120,
child: Text(
container.status,
style: TextStyle(
fontSize: 12,
color: colorScheme.onSurfaceVariant,
),
textAlign: TextAlign.end,
),
),
// Actions
const SizedBox(width: 8),
PopupMenuButton<String>(
icon: const Icon(Icons.more_vert),
tooltip: 'Actions',
onSelected: (action) {
if (action == 'logs') {
onViewLogs();
} else {
onAction(action);
}
},
itemBuilder: (context) => [
if (container.canStart)
const PopupMenuItem(
value: 'start',
child: Row(
children: [
Icon(Icons.play_arrow, size: 18),
SizedBox(width: 8),
Text('Start'),
],
),
),
if (container.canStop)
const PopupMenuItem(
value: 'stop',
child: Row(
children: [
Icon(Icons.stop, size: 18),
SizedBox(width: 8),
Text('Stop'),
],
),
),
if (container.canRestart)
const PopupMenuItem(
value: 'restart',
child: Row(
children: [
Icon(Icons.refresh, size: 18),
SizedBox(width: 8),
Text('Restart'),
],
),
),
const PopupMenuItem(
value: 'logs',
child: Row(
children: [
Icon(Icons.article, size: 18),
SizedBox(width: 8),
Text('View Logs'),
],
),
),
],
),
],
),
),
);
}
}
@@ -0,0 +1,92 @@
import 'package:riverpod_annotation/riverpod_annotation.dart';
import '../../../stacks/presentation/providers/stacks_provider.dart';
import '../../data/repositories/container_repository_impl.dart';
import '../../domain/entities/container.dart';
part 'containers_provider.g.dart';
/// Provides all containers.
@riverpod
Future<List<Container>> allContainers(AllContainersRef ref) async {
final repository = ref.watch(containerRepositoryProvider);
return repository.getContainers();
}
/// Provides containers filtered by the selected stack.
@riverpod
Future<List<Container>> containers(ContainersRef ref) async {
final repository = ref.watch(containerRepositoryProvider);
final selectedStack = ref.watch(selectedStackProvider);
if (selectedStack == null) {
return repository.getContainers();
}
return repository.getContainersByStack(selectedStack);
}
/// Provides a single container by ID.
@riverpod
Future<Container> container(ContainerRef ref, String id) async {
final repository = ref.watch(containerRepositoryProvider);
return repository.getContainer(id);
}
/// Controller for container actions.
@riverpod
class ContainerActions extends _$ContainerActions {
@override
AsyncValue<void> build() => const AsyncValue.data(null);
Future<void> start(String id) async {
state = const AsyncValue.loading();
state = await AsyncValue.guard(() async {
final repository = ref.read(containerRepositoryProvider);
await repository.startContainer(id);
ref.invalidate(allContainersProvider);
ref.invalidate(containersProvider);
});
}
Future<void> stop(String id) async {
state = const AsyncValue.loading();
state = await AsyncValue.guard(() async {
final repository = ref.read(containerRepositoryProvider);
await repository.stopContainer(id);
ref.invalidate(allContainersProvider);
ref.invalidate(containersProvider);
});
}
Future<void> restart(String id) async {
state = const AsyncValue.loading();
state = await AsyncValue.guard(() async {
final repository = ref.read(containerRepositoryProvider);
await repository.restartContainer(id);
ref.invalidate(allContainersProvider);
ref.invalidate(containersProvider);
});
}
Future<void> remove(String id, {bool force = false}) async {
state = const AsyncValue.loading();
state = await AsyncValue.guard(() async {
final repository = ref.read(containerRepositoryProvider);
await repository.removeContainer(id, force: force);
ref.invalidate(allContainersProvider);
ref.invalidate(containersProvider);
});
}
}
/// Container logs provider.
@riverpod
Future<String> containerLogs(
ContainerLogsRef ref,
String id, {
int? tail = 100,
}) async {
final repository = ref.watch(containerRepositoryProvider);
return repository.getContainerLogs(id, tail: tail);
}
@@ -0,0 +1,172 @@
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import '../providers/containers_provider.dart';
/// Widget for displaying container logs.
class ContainerLogsViewer extends ConsumerStatefulWidget {
const ContainerLogsViewer({
super.key,
required this.containerId,
required this.containerName,
});
final String containerId;
final String containerName;
@override
ConsumerState<ContainerLogsViewer> createState() =>
_ContainerLogsViewerState();
}
class _ContainerLogsViewerState extends ConsumerState<ContainerLogsViewer> {
final _scrollController = ScrollController();
int _tailLines = 100;
bool _autoScroll = true;
@override
void dispose() {
_scrollController.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
final logsAsync = ref.watch(
containerLogsProvider(widget.containerId, tail: _tailLines),
);
final colorScheme = Theme.of(context).colorScheme;
return Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
// Toolbar
Container(
padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 8),
decoration: BoxDecoration(
color: colorScheme.surfaceContainerHighest,
border: Border(
bottom: BorderSide(color: colorScheme.outlineVariant),
),
),
child: Row(
children: [
Text(
widget.containerName,
style: Theme.of(context).textTheme.titleSmall?.copyWith(
fontWeight: FontWeight.w600,
),
),
const Spacer(),
// Tail lines selector
DropdownButton<int>(
value: _tailLines,
items: const [
DropdownMenuItem(value: 50, child: Text('50 lines')),
DropdownMenuItem(value: 100, child: Text('100 lines')),
DropdownMenuItem(value: 500, child: Text('500 lines')),
DropdownMenuItem(value: 1000, child: Text('1000 lines')),
],
onChanged: (value) {
if (value != null) {
setState(() => _tailLines = value);
}
},
underline: const SizedBox.shrink(),
),
const SizedBox(width: 8),
IconButton(
icon: const Icon(Icons.copy, size: 18),
tooltip: 'Copy logs',
onPressed: logsAsync.whenOrNull(
data: (logs) => () async {
await Clipboard.setData(ClipboardData(text: logs));
if (context.mounted) {
ScaffoldMessenger.of(context).showSnackBar(
const SnackBar(content: Text('Logs copied to clipboard')),
);
}
},
),
),
IconButton(
icon: const Icon(Icons.refresh, size: 18),
tooltip: 'Refresh',
onPressed: () {
ref.invalidate(
containerLogsProvider(widget.containerId, tail: _tailLines),
);
},
),
],
),
),
// Logs content
Expanded(
child: logsAsync.when(
loading: () => const Center(child: CircularProgressIndicator()),
error: (error, _) => Center(
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Icon(Icons.error_outline, color: colorScheme.error, size: 48),
const SizedBox(height: 16),
Text('Failed to load logs'),
const SizedBox(height: 8),
Text(
error.toString(),
style: TextStyle(color: colorScheme.outline),
),
],
),
),
data: (logs) => logs.isEmpty
? Center(
child: Text(
'No logs available',
style: TextStyle(color: colorScheme.outline),
),
)
: Container(
color: Colors.black87,
padding: const EdgeInsets.all(12),
child: SelectableText(
logs,
style: const TextStyle(
fontFamily: 'monospace',
fontSize: 12,
color: Colors.white70,
height: 1.4,
),
),
),
),
),
],
);
}
}
/// Shows container logs in a bottom sheet.
void showContainerLogs(
BuildContext context, {
required String containerId,
required String containerName,
}) {
showModalBottomSheet(
context: context,
isScrollControlled: true,
useSafeArea: true,
builder: (context) => DraggableScrollableSheet(
initialChildSize: 0.7,
minChildSize: 0.3,
maxChildSize: 0.95,
expand: false,
builder: (context, scrollController) => ContainerLogsViewer(
containerId: containerId,
containerName: containerName,
),
),
);
}
@@ -0,0 +1,90 @@
import 'package:flutter/material.dart' hide Container;
import '../../domain/entities/container.dart';
/// Status badge for container state.
class ContainerStatusBadge extends StatelessWidget {
const ContainerStatusBadge({
super.key,
required this.state,
this.showLabel = true,
});
final ContainerState state;
final bool showLabel;
@override
Widget build(BuildContext context) {
final (color, icon, label) = _getStateStyle(context);
return DecoratedBox(
decoration: BoxDecoration(
color: color.withValues(alpha: 0.15),
borderRadius: BorderRadius.circular(4),
border: Border.all(color: color.withValues(alpha: 0.3)),
),
child: Padding(
padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 4),
child: Row(
mainAxisSize: MainAxisSize.min,
children: [
Icon(icon, size: 14, color: color),
if (showLabel) ...[
const SizedBox(width: 4),
Text(
label,
style: TextStyle(
fontSize: 12,
fontWeight: FontWeight.w500,
color: color,
),
),
],
],
),
),
);
}
(Color, IconData, String) _getStateStyle(BuildContext context) {
final colorScheme = Theme.of(context).colorScheme;
return switch (state) {
ContainerState.running => (
Colors.green,
Icons.play_circle,
'Running',
),
ContainerState.paused => (
Colors.orange,
Icons.pause_circle,
'Paused',
),
ContainerState.restarting => (
Colors.blue,
Icons.refresh,
'Restarting',
),
ContainerState.exited => (
colorScheme.outline,
Icons.stop_circle,
'Exited',
),
ContainerState.created => (
colorScheme.outline,
Icons.circle_outlined,
'Created',
),
ContainerState.removing => (
Colors.red,
Icons.delete,
'Removing',
),
ContainerState.dead => (
colorScheme.error,
Icons.error,
'Dead',
),
};
}
}