create-odoo-module 1.0.0

package/src/generators/flutter-generator.js

@@ -0,0 +1,1695 @@
+'use strict';
+
+const path = require('path');
+const { writeFile, mkdirp } = require('../utils/file-system');
+const logger = require('../utils/logger');
+
+/**
+ * Generate a production-ready Flutter/Dart application
+ * pre-wired to the Odoo module via JSON-RPC.
+ */
+async function generateFlutterApp(targetDir, config) {
+  const s = config.moduleNameSnake;
+  const P = config.moduleNamePascal;
+  const M = config.moduleNameOdoo;
+  const L = config.moduleNameLabel;
+  const K = s.replace(/_/g, '-');   // kebab for pubspec name
+
+  logger.verbose('Generating Flutter app...');
+
+  const flutterDir = path.join(targetDir, 'flutter_app');
+
+  // ── Directory skeleton ────────────────────────────────────────────────────
+  const dirs = [
+    'lib/src/config',
+    'lib/src/core',
+    'lib/src/models',
+    'lib/src/repositories',
+    'lib/src/screens',
+    'lib/src/widgets',
+    'lib/src/providers',
+    'lib/l10n',
+    'test',
+    'integration_test',
+    'assets/images',
+    'assets/icons',
+    'android/app/src/main',
+    'ios/Runner',
+  ];
+  for (const d of dirs) await mkdirp(path.join(flutterDir, d));
+
+  // ── Generate all files ────────────────────────────────────────────────────
+  await Promise.all([
+    writeFile(path.join(flutterDir, 'pubspec.yaml'),                         genPubspec(s, K, L, config)),
+    writeFile(path.join(flutterDir, 'analysis_options.yaml'),                genAnalysisOptions()),
+    writeFile(path.join(flutterDir, '.gitignore'),                           genFlutterGitignore()),
+    writeFile(path.join(flutterDir, 'README.md'),                            genFlutterReadme(L, M, s, config)),
+
+    // lib/
+    writeFile(path.join(flutterDir, 'lib', 'main.dart'),                     genMain(s, P, L, config)),
+
+    // lib/src/config/
+    writeFile(path.join(flutterDir, 'lib', 'src', 'config', 'odoo_config.dart'),    genConfig(s, config)),
+
+    // lib/src/core/
+    writeFile(path.join(flutterDir, 'lib', 'src', 'core', 'odoo_client.dart'),      genOdooClient(s, P, M)),
+    writeFile(path.join(flutterDir, 'lib', 'src', 'core', 'auth_service.dart'),     genAuthService(s, P)),
+    writeFile(path.join(flutterDir, 'lib', 'src', 'core', 'exceptions.dart'),       genExceptions()),
+
+    // lib/src/models/
+    writeFile(path.join(flutterDir, 'lib', 'src', 'models', `${s}_model.dart`),     genModel(s, P, M, L)),
+
+    // lib/src/repositories/
+    writeFile(path.join(flutterDir, 'lib', 'src', 'repositories', `${s}_repository.dart`), genRepository(s, P, M, L)),
+
+    // lib/src/providers/
+    writeFile(path.join(flutterDir, 'lib', 'src', 'providers', `${s}_provider.dart`), genProvider(s, P, M, L)),
+
+    // lib/src/screens/
+    writeFile(path.join(flutterDir, 'lib', 'src', 'screens', 'login_screen.dart'),  genLoginScreen(s, P, L)),
+    writeFile(path.join(flutterDir, 'lib', 'src', 'screens', 'list_screen.dart'),   genListScreen(s, P, L)),
+    writeFile(path.join(flutterDir, 'lib', 'src', 'screens', 'detail_screen.dart'), genDetailScreen(s, P, M, L)),
+    writeFile(path.join(flutterDir, 'lib', 'src', 'screens', 'create_screen.dart'), genCreateScreen(s, P, M, L)),
+
+    // lib/src/widgets/
+    writeFile(path.join(flutterDir, 'lib', 'src', 'widgets', `${s}_card.dart`),     genCard(s, P, L)),
+    writeFile(path.join(flutterDir, 'lib', 'src', 'widgets', 'state_badge.dart'),   genStateBadge()),
+    writeFile(path.join(flutterDir, 'lib', 'src', 'widgets', 'loading_overlay.dart'), genLoadingOverlay()),
+
+    // tests
+    writeFile(path.join(flutterDir, 'test', `${s}_test.dart`),              genTest(s, P, M, L)),
+    writeFile(path.join(flutterDir, 'integration_test', 'app_test.dart'),   genIntegrationTest(s, P, L)),
+  ]);
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// Flutter/Dart file generators
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function genPubspec(s, K, L, config) {
+  return `name: ${K}_app
+description: Flutter application for ${L} Odoo module.
+             Generated by create-odoo-module — https://create-odoo-module.dev
+version: 1.0.0+1
+publish_to: 'none'
+
+environment:
+  sdk: '>=3.3.0 <4.0.0'
+  flutter: '>=3.19.0'
+
+dependencies:
+  flutter:
+    sdk: flutter
+
+  # ── Odoo / HTTP ────────────────────────────────────────────────────────────
+  odoo_rpc: ^0.4.0
+  http: ^1.2.0
+  dio: ^5.4.0
+
+  # ── State management ───────────────────────────────────────────────────────
+  flutter_riverpod: ^2.5.0
+  riverpod_annotation: ^2.3.0
+
+  # ── Navigation ─────────────────────────────────────────────────────────────
+  go_router: ^13.2.0
+
+  # ── Storage ────────────────────────────────────────────────────────────────
+  shared_preferences: ^2.2.0
+  flutter_secure_storage: ^9.0.0
+
+  # ── UI ─────────────────────────────────────────────────────────────────────
+  cupertino_icons: ^1.0.6
+  flutter_spinkit: ^5.2.0
+  cached_network_image: ^3.3.0
+  intl: ^0.19.0
+  gap: ^3.0.1
+  shimmer: ^3.0.0
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+  integration_test:
+    sdk: flutter
+  flutter_lints: ^4.0.0
+  riverpod_generator: ^2.4.0
+  build_runner: ^2.4.0
+  mockito: ^5.4.0
+  build_verify: ^3.1.0
+
+flutter:
+  uses-material-design: true
+  assets:
+    - assets/images/
+    - assets/icons/
+`;
+}
+
+function genAnalysisOptions() {
+  return `include: package:flutter_lints/flutter.yaml
+
+linter:
+  rules:
+    prefer_single_quotes: true
+    prefer_const_constructors: true
+    prefer_const_declarations: true
+    avoid_print: true
+    use_super_parameters: true
+    require_trailing_commas: true
+
+analyzer:
+  exclude:
+    - "**/*.g.dart"
+    - "**/*.freezed.dart"
+`;
+}
+
+function genFlutterGitignore() {
+  return `.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.packages
+build/
+*.iml
+*.lock
+android/.gradle/
+android/local.properties
+ios/.symlinks/
+ios/Pods/
+ios/Flutter/Flutter.framework
+ios/Flutter/Flutter.podspec
+`;
+}
+
+function genFlutterReadme(L, M, s, config) {
+  return `# ${L} — Flutter App
+
+Mobile application for the **${L}** Odoo module (\`${M}\`).
+Generated by [create-odoo-module](https://create-odoo-module.dev).
+
+## Getting Started
+
+\`\`\`bash
+flutter pub get
+flutter run
+\`\`\`
+
+## Configuration
+
+Edit \`lib/src/config/odoo_config.dart\` with your Odoo server details.
+
+## Architecture
+
+| Layer | Description |
+|-------|-------------|
+| \`config/\`       | Odoo server configuration |
+| \`core/\`         | JSON-RPC client + auth service |
+| \`models/\`       | Dart data models |
+| \`repositories/\` | Data access layer (CRUD) |
+| \`providers/\`    | Riverpod state management |
+| \`screens/\`      | UI pages |
+| \`widgets/\`      | Reusable UI components |
+`;
+}
+
+function genMain(s, P, L, config) {
+  return `import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:shared_preferences/shared_preferences.dart';
+import 'src/core/auth_service.dart';
+import 'src/screens/login_screen.dart';
+import 'src/screens/list_screen.dart';
+
+void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  final prefs = await SharedPreferences.getInstance();
+
+  runApp(
+    ProviderScope(
+      overrides: [
+        sharedPreferencesProvider.overrideWithValue(prefs),
+      ],
+      child: const ${P}App(),
+    ),
+  );
+}
+
+class ${P}App extends ConsumerWidget {
+  const ${P}App({super.key});
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    return MaterialApp(
+      title: '${L}',
+      debugShowCheckedModeBanner: false,
+      theme: ThemeData(
+        colorScheme: ColorScheme.fromSeed(
+          seedColor: const Color(0xFF875A7B), // Odoo brand purple
+          brightness: Brightness.light,
+        ),
+        useMaterial3: true,
+        appBarTheme: const AppBarTheme(
+          backgroundColor: Color(0xFF875A7B),
+          foregroundColor: Colors.white,
+          elevation: 0,
+        ),
+        cardTheme: CardTheme(
+          elevation: 2,
+          shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(12)),
+        ),
+        inputDecorationTheme: InputDecorationTheme(
+          border: OutlineInputBorder(borderRadius: BorderRadius.circular(8)),
+          filled: true,
+        ),
+        elevatedButtonTheme: ElevatedButtonThemeData(
+          style: ElevatedButton.styleFrom(
+            backgroundColor: const Color(0xFF875A7B),
+            foregroundColor: Colors.white,
+            shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(8)),
+            padding: const EdgeInsets.symmetric(horizontal: 24, vertical: 12),
+          ),
+        ),
+      ),
+      home: const _AuthGate(),
+    );
+  }
+}
+
+class _AuthGate extends ConsumerWidget {
+  const _AuthGate();
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final authAsync = ref.watch(authStateProvider);
+
+    return authAsync.when(
+      data: (isAuth) => isAuth ? const ListScreen() : const LoginScreen(),
+      loading: () => const Scaffold(
+        body: Center(child: CircularProgressIndicator()),
+      ),
+      error: (_, __) => const LoginScreen(),
+    );
+  }
+}
+`;
+}
+
+function genConfig(s, config) {
+  return `/// Odoo server configuration.
+/// Edit these values to match your deployment.
+class OdooConfig {
+  OdooConfig._();
+
+  /// Base URL of the Odoo server (no trailing slash)
+  static const String baseUrl = '${config.odooUrl || 'http://localhost:8069'}';
+
+  /// Database name
+  static const String defaultDatabase = '${config.odooDb || 'odoo'}';
+
+  /// HTTP request timeout in seconds
+  static const int timeoutSeconds = 30;
+
+  /// Number of records to load per page
+  static const int pageSize = 40;
+}
+`;
+}
+
+function genOdooClient(s, P, M) {
+  return `import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:odoo_rpc/odoo_rpc.dart';
+import 'package:shared_preferences/shared_preferences.dart';
+import '../config/odoo_config.dart';
+import 'exceptions.dart';
+
+// ── Providers ─────────────────────────────────────────────────────────────────
+
+final sharedPreferencesProvider = Provider<SharedPreferences>((ref) {
+  throw UnimplementedError('Override sharedPreferencesProvider in main()');
+});
+
+final odooClientProvider = Provider<OdooClient>((ref) {
+  return OdooClient(OdooConfig.baseUrl);
+});
+
+// ── OdooJsonRpcClient — thin wrapper ────────────────────────────────────────
+
+class OdooJsonRpcClient {
+  final OdooClient _client;
+
+  OdooJsonRpcClient(this._client);
+
+  /// Authenticate with Odoo.
+  Future<OdooSession> authenticate(String db, String login, String password) async {
+    try {
+      return await _client.authenticate(db, login, password);
+    } on OdooSessionExpiredException {
+      throw OdooAuthException('Session expired');
+    } catch (e) {
+      throw OdooAuthException('Authentication failed: \$e');
+    }
+  }
+
+  /// Call a model method via JSON-RPC call_kw.
+  Future<dynamic> callKw({
+    required String model,
+    required String method,
+    required List<dynamic> args,
+    required Map<String, dynamic> kwargs,
+  }) async {
+    try {
+      return await _client.callKw({
+        'model':  model,
+        'method': method,
+        'args':   args,
+        'kwargs': kwargs,
+      });
+    } on OdooSessionExpiredException {
+      throw OdooSessionException('Your session has expired. Please log in again.');
+    } on OdooErrorException catch (e) {
+      throw OdooServerException(e.message);
+    } catch (e) {
+      throw OdooNetworkException('Network error: \$e');
+    }
+  }
+
+  /// Check if the current session is still valid.
+  Future<bool> checkSession() async {
+    try {
+      await _client.checkSession();
+      return true;
+    } catch (_) {
+      return false;
+    }
+  }
+
+  /// Destroy current session (logout).
+  Future<void> destroySession() async {
+    try {
+      await _client.destroySession();
+    } catch (_) {}
+  }
+}
+
+final odooRpcClientProvider = Provider<OdooJsonRpcClient>((ref) {
+  final client = ref.watch(odooClientProvider);
+  return OdooJsonRpcClient(client);
+});
+`;
+}
+
+function genAuthService(s, P) {
+  return `import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:shared_preferences/shared_preferences.dart';
+import 'package:odoo_rpc/odoo_rpc.dart';
+import '../config/odoo_config.dart';
+import 'odoo_client.dart';
+
+// ── Auth state provider ────────────────────────────────────────────────────────
+final authStateProvider = FutureProvider<bool>((ref) async {
+  final prefs = ref.watch(sharedPreferencesProvider);
+  final sessionId = prefs.getString('odoo_session_id');
+  return sessionId != null && sessionId.isNotEmpty;
+});
+
+// ── Auth service ──────────────────────────────────────────────────────────────
+class AuthService {
+  final OdooJsonRpcClient _rpc;
+  final SharedPreferences _prefs;
+
+  AuthService(this._rpc, this._prefs);
+
+  Future<bool> login(String db, String login, String password) async {
+    final session = await _rpc.authenticate(db, login, password);
+    await _prefs.setString('odoo_session_id', session.id);
+    await _prefs.setString('odoo_db',         db);
+    await _prefs.setString('odoo_login',      login);
+    await _prefs.setInt   ('odoo_uid',        session.userId);
+    return true;
+  }
+
+  Future<void> logout() async {
+    await _rpc.destroySession();
+    await _prefs.remove('odoo_session_id');
+    await _prefs.remove('odoo_db');
+    await _prefs.remove('odoo_login');
+    await _prefs.remove('odoo_uid');
+  }
+
+  bool get isLoggedIn => _prefs.getString('odoo_session_id')?.isNotEmpty == true;
+  int  get userId     => _prefs.getInt('odoo_uid') ?? 0;
+  String get database => _prefs.getString('odoo_db') ?? OdooConfig.defaultDatabase;
+}
+
+final authServiceProvider = Provider<AuthService>((ref) {
+  final rpc   = ref.watch(odooRpcClientProvider);
+  final prefs = ref.watch(sharedPreferencesProvider);
+  return AuthService(rpc, prefs);
+});
+`;
+}
+
+function genExceptions() {
+  return `/// Base class for all Odoo-related exceptions.
+abstract class OdooException implements Exception {
+  final String message;
+  const OdooException(this.message);
+  @override
+  String toString() => '\$runtimeType: \$message';
+}
+
+class OdooAuthException    extends OdooException { const OdooAuthException(super.m); }
+class OdooSessionException extends OdooException { const OdooSessionException(super.m); }
+class OdooServerException  extends OdooException { const OdooServerException(super.m); }
+class OdooNetworkException extends OdooException { const OdooNetworkException(super.m); }
+class OdooNotFoundException extends OdooException { const OdooNotFoundException(super.m); }
+`;
+}
+
+function genModel(s, P, M, L) {
+  return `import 'package:flutter/foundation.dart';
+
+@immutable
+class ${P}Record {
+  final int     id;
+  final String  name;
+  final String  reference;
+  final String  state;
+  final String  priority;
+  final String? description;
+  final DateTime? dateStart;
+  final DateTime? dateEnd;
+  final int     durationDays;
+  final Map<String, dynamic>? userId;
+  final bool    active;
+  final DateTime? createDate;
+
+  const ${P}Record({
+    required this.id,
+    required this.name,
+    required this.reference,
+    required this.state,
+    this.priority = '0',
+    this.description,
+    this.dateStart,
+    this.dateEnd,
+    this.durationDays = 0,
+    this.userId,
+    this.active = true,
+    this.createDate,
+  });
+
+  // ── Deserialise from Odoo search_read / read response ────────────────────
+  factory ${P}Record.fromMap(Map<String, dynamic> map) {
+    return ${P}Record(
+      id:           map['id']          as int,
+      name:         _s(map['name']),
+      reference:    _s(map['reference']),
+      state:        _s(map['state']),
+      priority:     _s(map['priority'] ?? '0'),
+      description:  map['description'] is String ? map['description'] as String : null,
+      dateStart:    _parseDate(map['date_start']),
+      dateEnd:      _parseDate(map['date_end']),
+      durationDays: (map['duration_days'] as num?)?.toInt() ?? 0,
+      userId:       map['user_id'] is List
+          ? {'id': (map['user_id'] as List)[0], 'name': (map['user_id'] as List)[1]}
+          : null,
+      active:       (map['active'] as bool?) ?? true,
+      createDate:   map['create_date'] is String
+          ? DateTime.tryParse(map['create_date'] as String)
+          : null,
+    );
+  }
+
+  // ── Serialise for create / write ─────────────────────────────────────────
+  Map<String, dynamic> toMap() => {
+    'name':        name,
+    'state':       state,
+    'priority':    priority,
+    if (description != null) 'description':  description,
+    if (dateStart   != null) 'date_start':   _fmtDate(dateStart!),
+    if (dateEnd     != null) 'date_end':     _fmtDate(dateEnd!),
+  };
+
+  ${P}Record copyWith({
+    String?  name,
+    String?  state,
+    String?  priority,
+    String?  description,
+    DateTime? dateStart,
+    DateTime? dateEnd,
+  }) => ${P}Record(
+    id:           id,
+    name:         name         ?? this.name,
+    reference:    reference,
+    state:        state        ?? this.state,
+    priority:     priority     ?? this.priority,
+    description:  description  ?? this.description,
+    dateStart:    dateStart    ?? this.dateStart,
+    dateEnd:      dateEnd      ?? this.dateEnd,
+    durationDays: durationDays,
+    userId:       userId,
+    active:       active,
+    createDate:   createDate,
+  );
+
+  // ── Helpers ───────────────────────────────────────────────────────────────
+  String get responsibleName => (userId?['name'] as String?) ?? '—';
+
+  String get stateLabel {
+    const labels = {
+      'draft':       'Draft',
+      'confirmed':   'Confirmed',
+      'in_progress': 'In Progress',
+      'done':        'Done',
+      'cancelled':   'Cancelled',
+    };
+    return labels[state] ?? state;
+  }
+
+  bool get isDraft      => state == 'draft';
+  bool get isConfirmed  => state == 'confirmed';
+  bool get isInProgress => state == 'in_progress';
+  bool get isDone       => state == 'done';
+  bool get isCancelled  => state == 'cancelled';
+
+  static String _s(dynamic v) => v is String ? v : '';
+  static String _fmtDate(DateTime d) => d.toIso8601String().split('T')[0];
+  static DateTime? _parseDate(dynamic v) => v is String ? DateTime.tryParse(v) : null;
+
+  @override
+  bool operator ==(Object other) => other is ${P}Record && other.id == id;
+
+  @override
+  int get hashCode => id.hashCode;
+}
+`;
+}
+
+function genRepository(s, P, M, L) {
+  return `import 'package:flutter_riverpod/flutter_riverpod.dart';
+import '../core/odoo_client.dart';
+import '../models/${s}_model.dart';
+
+class ${P}Repository {
+  final OdooJsonRpcClient _rpc;
+
+  ${P}Repository(this._rpc);
+
+  static const _model  = '${M}';
+  static const _listFields = [
+    'id', 'name', 'reference', 'state', 'priority',
+    'user_id', 'date_start', 'date_end', 'active',
+  ];
+  static const _detailFields = [
+    'id', 'name', 'reference', 'state', 'priority', 'description',
+    'user_id', 'company_id', 'tag_ids', 'date_start', 'date_end',
+    'duration_days', 'active', 'create_date', 'write_date',
+  ];
+
+  // ── List records ──────────────────────────────────────────────────────────
+  Future<List<${P}Record>> fetchAll({
+    List<dynamic> domain = const [],
+    int limit  = 40,
+    int offset = 0,
+    String order = 'name asc',
+  }) async {
+    final result = await _rpc.callKw(
+      model:  _model,
+      method: 'search_read',
+      args:   [],
+      kwargs: {
+        'domain': [['active', '=', true], ...domain],
+        'fields': _listFields,
+        'limit':  limit,
+        'offset': offset,
+        'order':  order,
+      },
+    );
+    return (result as List).map((m) => ${P}Record.fromMap(m as Map<String, dynamic>)).toList();
+  }
+
+  // ── Total count ───────────────────────────────────────────────────────────
+  Future<int> count({List<dynamic> domain = const []}) async {
+    final result = await _rpc.callKw(
+      model:  _model,
+      method: 'search_count',
+      args:   [[['active', '=', true], ...domain]],
+      kwargs: {},
+    );
+    return (result as num).toInt();
+  }
+
+  // ── Single record ─────────────────────────────────────────────────────────
+  Future<${P}Record> fetchById(int id) async {
+    final result = await _rpc.callKw(
+      model:  _model,
+      method: 'read',
+      args:   [[id]],
+      kwargs: {'fields': _detailFields},
+    );
+    return ${P}Record.fromMap((result as List).first as Map<String, dynamic>);
+  }
+
+  // ── Create ────────────────────────────────────────────────────────────────
+  Future<int> create(Map<String, dynamic> values) async {
+    final id = await _rpc.callKw(
+      model:  _model,
+      method: 'create',
+      args:   [values],
+      kwargs: {},
+    );
+    return (id as num).toInt();
+  }
+
+  // ── Update ────────────────────────────────────────────────────────────────
+  Future<void> update(int id, Map<String, dynamic> values) async {
+    await _rpc.callKw(
+      model:  _model,
+      method: 'write',
+      args:   [[id], values],
+      kwargs: {},
+    );
+  }
+
+  // ── Delete ────────────────────────────────────────────────────────────────
+  Future<void> delete(int id) async {
+    await _rpc.callKw(
+      model:  _model,
+      method: 'unlink',
+      args:   [[id]],
+      kwargs: {},
+    );
+  }
+
+  // ── Business actions ──────────────────────────────────────────────────────
+  Future<void> callAction(int id, String method) async {
+    await _rpc.callKw(
+      model:  _model,
+      method: method,
+      args:   [[id]],
+      kwargs: {},
+    );
+  }
+
+  Future<void> confirm(int id)    => callAction(id, 'action_confirm');
+  Future<void> start(int id)      => callAction(id, 'action_start');
+  Future<void> markDone(int id)   => callAction(id, 'action_done');
+  Future<void> cancel(int id)     => callAction(id, 'action_cancel');
+  Future<void> resetDraft(int id) => callAction(id, 'action_reset_draft');
+}
+
+// ── Providers ─────────────────────────────────────────────────────────────────
+final ${s}RepositoryProvider = Provider<${P}Repository>((ref) {
+  return ${P}Repository(ref.watch(odooRpcClientProvider));
+});
+
+final ${s}ListProvider = FutureProvider.family<List<${P}Record>, int>((ref, page) async {
+  const pageSize = 40;
+  return ref.watch(${s}RepositoryProvider).fetchAll(
+    limit:  pageSize,
+    offset: page * pageSize,
+  );
+});
+
+final ${s}DetailProvider = FutureProvider.family<${P}Record, int>((ref, id) async {
+  return ref.watch(${s}RepositoryProvider).fetchById(id);
+});
+`;
+}
+
+function genProvider(s, P, M, L) {
+  return `import 'package:flutter_riverpod/flutter_riverpod.dart';
+import '../models/${s}_model.dart';
+import '../repositories/${s}_repository.dart';
+
+// ── Notifier — manages the live list state ─────────────────────────────────────
+class ${P}Notifier extends AsyncNotifier<List<${P}Record>> {
+  int _page  = 0;
+  bool _hasMore = true;
+
+  @override
+  Future<List<${P}Record>> build() async {
+    _page = 0;
+    _hasMore = true;
+    return _fetch();
+  }
+
+  Future<List<${P}Record>> _fetch() async {
+    return ref.read(${s}RepositoryProvider).fetchAll(
+      offset: _page * 40,
+      limit: 40,
+    );
+  }
+
+  Future<void> refresh() async {
+    state = const AsyncValue.loading();
+    _page = 0;
+    state = await AsyncValue.guard(_fetch);
+  }
+
+  Future<void> loadMore() async {
+    if (!_hasMore || state.isLoading) return;
+    final current = state.valueOrNull ?? [];
+    _page++;
+    final next = await _fetch();
+    if (next.isEmpty) { _hasMore = false; return; }
+    state = AsyncValue.data([...current, ...next]);
+  }
+
+  // ── Mutation helpers ────────────────────────────────────────────────────────
+
+  Future<int> create(Map<String, dynamic> values) async {
+    final id = await ref.read(${s}RepositoryProvider).create(values);
+    refresh();
+    return id;
+  }
+
+  Future<void> update(int id, Map<String, dynamic> values) async {
+    await ref.read(${s}RepositoryProvider).update(id, values);
+    refresh();
+  }
+
+  Future<void> delete(int id) async {
+    await ref.read(${s}RepositoryProvider).delete(id);
+    state = AsyncValue.data(
+      (state.valueOrNull ?? []).where((r) => r.id != id).toList(),
+    );
+  }
+
+  Future<void> callAction(int id, String method) async {
+    await ref.read(${s}RepositoryProvider).callAction(id, method);
+    refresh();
+  }
+}
+
+final ${s}NotifierProvider = AsyncNotifierProvider<${P}Notifier, List<${P}Record>>(
+  ${P}Notifier.new,
+);
+
+// ── Search state ───────────────────────────────────────────────────────────────
+final ${s}SearchProvider = StateProvider<String>((ref) => '');
+final ${s}FilterStateProvider = StateProvider<String?>((ref) => null);
+`;
+}
+
+function genLoginScreen(s, P, L) {
+  return `import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import '../core/auth_service.dart';
+import '../core/exceptions.dart';
+import '../config/odoo_config.dart';
+import 'list_screen.dart';
+
+class LoginScreen extends ConsumerStatefulWidget {
+  const LoginScreen({super.key});
+
+  @override
+  ConsumerState<LoginScreen> createState() => _LoginScreenState();
+}
+
+class _LoginScreenState extends ConsumerState<LoginScreen> {
+  final _formKey    = GlobalKey<FormState>();
+  final _urlCtrl    = TextEditingController(text: OdooConfig.baseUrl);
+  final _dbCtrl     = TextEditingController(text: OdooConfig.defaultDatabase);
+  final _loginCtrl  = TextEditingController(text: 'admin');
+  final _passCtrl   = TextEditingController();
+  bool _loading     = false;
+  bool _obscurePass = true;
+  String? _error;
+
+  @override
+  void dispose() {
+    _urlCtrl.dispose(); _dbCtrl.dispose();
+    _loginCtrl.dispose(); _passCtrl.dispose();
+    super.dispose();
+  }
+
+  Future<void> _submit() async {
+    if (!_formKey.currentState!.validate()) return;
+    setState(() { _loading = true; _error = null; });
+    try {
+      await ref.read(authServiceProvider).login(
+        _dbCtrl.text.trim(),
+        _loginCtrl.text.trim(),
+        _passCtrl.text,
+      );
+      ref.invalidate(authStateProvider);
+      if (mounted) {
+        Navigator.of(context).pushReplacement(
+          MaterialPageRoute(builder: (_) => const ListScreen()),
+        );
+      }
+    } on OdooAuthException catch (e) {
+      setState(() { _error = e.message; });
+    } on OdooNetworkException catch (e) {
+      setState(() { _error = 'Cannot reach server: \${e.message}'; });
+    } catch (e) {
+      setState(() { _error = 'Unexpected error: \$e'; });
+    } finally {
+      if (mounted) setState(() => _loading = false);
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      body: SafeArea(
+        child: Center(
+          child: SingleChildScrollView(
+            padding: const EdgeInsets.all(24),
+            child: ConstrainedBox(
+              constraints: const BoxConstraints(maxWidth: 420),
+              child: Form(
+                key: _formKey,
+                child: Column(
+                  mainAxisSize: MainAxisSize.min,
+                  crossAxisAlignment: CrossAxisAlignment.stretch,
+                  children: [
+                    // Logo / Title
+                    const Icon(Icons.widgets_rounded, size: 64, color: Color(0xFF875A7B)),
+                    const SizedBox(height: 16),
+                    Text('${L}',
+                      textAlign: TextAlign.center,
+                      style: Theme.of(context).textTheme.headlineMedium?.copyWith(
+                        fontWeight: FontWeight.bold, color: const Color(0xFF875A7B),
+                      ),
+                    ),
+                    const SizedBox(height: 8),
+                    Text('Sign in to your Odoo account',
+                      textAlign: TextAlign.center,
+                      style: Theme.of(context).textTheme.bodyMedium?.copyWith(color: Colors.grey),
+                    ),
+                    const SizedBox(height: 32),
+
+                    // Error banner
+                    if (_error != null) ...[
+                      Container(
+                        padding: const EdgeInsets.all(12),
+                        decoration: BoxDecoration(
+                          color: Colors.red.shade50,
+                          border: Border.all(color: Colors.red.shade200),
+                          borderRadius: BorderRadius.circular(8),
+                        ),
+                        child: Row(children: [
+                          const Icon(Icons.error_outline, color: Colors.red, size: 18),
+                          const SizedBox(width: 8),
+                          Expanded(child: Text(_error!, style: const TextStyle(color: Colors.red))),
+                        ]),
+                      ),
+                      const SizedBox(height: 16),
+                    ],
+
+                    // Server URL
+                    TextFormField(
+                      controller: _urlCtrl,
+                      decoration: const InputDecoration(
+                        labelText: 'Server URL',
+                        prefixIcon: Icon(Icons.link),
+                        hintText: 'http://localhost:8069',
+                      ),
+                      keyboardType: TextInputType.url,
+                      validator: (v) =>
+                        (v?.trim().isEmpty == true) ? 'Server URL is required' : null,
+                    ),
+                    const SizedBox(height: 12),
+
+                    // Database
+                    TextFormField(
+                      controller: _dbCtrl,
+                      decoration: const InputDecoration(
+                        labelText: 'Database',
+                        prefixIcon: Icon(Icons.storage),
+                      ),
+                      validator: (v) =>
+                        (v?.trim().isEmpty == true) ? 'Database name is required' : null,
+                    ),
+                    const SizedBox(height: 12),
+
+                    // Login
+                    TextFormField(
+                      controller: _loginCtrl,
+                      decoration: const InputDecoration(
+                        labelText: 'Username / Email',
+                        prefixIcon: Icon(Icons.person),
+                      ),
+                      keyboardType: TextInputType.emailAddress,
+                      validator: (v) =>
+                        (v?.trim().isEmpty == true) ? 'Username is required' : null,
+                    ),
+                    const SizedBox(height: 12),
+
+                    // Password
+                    TextFormField(
+                      controller: _passCtrl,
+                      obscureText: _obscurePass,
+                      decoration: InputDecoration(
+                        labelText: 'Password',
+                        prefixIcon: const Icon(Icons.lock),
+                        suffixIcon: IconButton(
+                          icon: Icon(_obscurePass ? Icons.visibility : Icons.visibility_off),
+                          onPressed: () => setState(() => _obscurePass = !_obscurePass),
+                        ),
+                      ),
+                      validator: (v) =>
+                        (v?.isEmpty == true) ? 'Password is required' : null,
+                    ),
+                    const SizedBox(height: 24),
+
+                    // Submit
+                    ElevatedButton(
+                      onPressed: _loading ? null : _submit,
+                      child: _loading
+                          ? const SizedBox.square(
+                              dimension: 20,
+                              child: CircularProgressIndicator(strokeWidth: 2, color: Colors.white),
+                            )
+                          : const Text('Sign In'),
+                    ),
+                    const SizedBox(height: 24),
+                    Center(
+                      child: Text(
+                        'Powered by create-odoo-module',
+                        style: TextStyle(color: Colors.grey.shade500, fontSize: 12),
+                      ),
+                    ),
+                  ],
+                ),
+              ),
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+}
+`;
+}
+
+function genListScreen(s, P, L) {
+  return `import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import '../providers/${s}_provider.dart';
+import '../widgets/${s}_card.dart';
+import '../widgets/loading_overlay.dart';
+import '../core/auth_service.dart';
+import 'create_screen.dart';
+import 'detail_screen.dart';
+import 'login_screen.dart';
+
+class ListScreen extends ConsumerStatefulWidget {
+  const ListScreen({super.key});
+
+  @override
+  ConsumerState<ListScreen> createState() => _ListScreenState();
+}
+
+class _ListScreenState extends ConsumerState<ListScreen> {
+  final _scrollCtrl = ScrollController();
+
+  @override
+  void initState() {
+    super.initState();
+    _scrollCtrl.addListener(_onScroll);
+  }
+
+  @override
+  void dispose() {
+    _scrollCtrl.dispose();
+    super.dispose();
+  }
+
+  void _onScroll() {
+    if (_scrollCtrl.position.pixels >= _scrollCtrl.position.maxScrollExtent - 200) {
+      ref.read(${s}NotifierProvider.notifier).loadMore();
+    }
+  }
+
+  Future<void> _logout() async {
+    await ref.read(authServiceProvider).logout();
+    ref.invalidate(authStateProvider);
+    if (mounted) {
+      Navigator.of(context).pushAndRemoveUntil(
+        MaterialPageRoute(builder: (_) => const LoginScreen()),
+        (_) => false,
+      );
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final recordsAsync = ref.watch(${s}NotifierProvider);
+    final search       = ref.watch(${s}SearchProvider);
+
+    return Scaffold(
+      appBar: AppBar(
+        title: const Text('${L}'),
+        actions: [
+          IconButton(
+            icon: const Icon(Icons.refresh),
+            tooltip: 'Refresh',
+            onPressed: () => ref.read(${s}NotifierProvider.notifier).refresh(),
+          ),
+          PopupMenuButton<String>(
+            onSelected: (v) { if (v == 'logout') _logout(); },
+            itemBuilder: (_) => [
+              const PopupMenuItem(value: 'logout', child: Row(children: [
+                Icon(Icons.logout, size: 18), SizedBox(width: 8), Text('Logout'),
+              ])),
+            ],
+          ),
+        ],
+        bottom: PreferredSize(
+          preferredSize: const Size.fromHeight(56),
+          child: Padding(
+            padding: const EdgeInsets.fromLTRB(12, 0, 12, 8),
+            child: TextField(
+              decoration: InputDecoration(
+                hintText: 'Search ${L}…',
+                prefixIcon: const Icon(Icons.search),
+                filled: true,
+                fillColor: Colors.white,
+                border: OutlineInputBorder(borderRadius: BorderRadius.circular(8), borderSide: BorderSide.none),
+                contentPadding: const EdgeInsets.symmetric(horizontal: 12),
+              ),
+              onChanged: (v) => ref.read(${s}SearchProvider.notifier).state = v,
+            ),
+          ),
+        ),
+      ),
+      body: recordsAsync.when(
+        data: (records) {
+          final filtered = search.isEmpty
+              ? records
+              : records.where((r) => r.name.toLowerCase().contains(search.toLowerCase())).toList();
+
+          if (filtered.isEmpty) {
+            return Center(
+              child: Column(
+                mainAxisSize: MainAxisSize.min,
+                children: [
+                  Icon(Icons.inbox_rounded, size: 80, color: Colors.grey.shade300),
+                  const SizedBox(height: 16),
+                  Text(
+                    search.isNotEmpty ? 'No results for "\$search"' : 'No records yet',
+                    style: TextStyle(color: Colors.grey.shade500, fontSize: 16),
+                  ),
+                  if (search.isEmpty) ...[
+                    const SizedBox(height: 12),
+                    ElevatedButton.icon(
+                      onPressed: () => _openCreate(context),
+                      icon: const Icon(Icons.add),
+                      label: const Text('Create first record'),
+                    ),
+                  ],
+                ],
+              ),
+            );
+          }
+
+          return RefreshIndicator(
+            onRefresh: () => ref.read(${s}NotifierProvider.notifier).refresh(),
+            child: ListView.builder(
+              controller: _scrollCtrl,
+              padding: const EdgeInsets.all(12),
+              itemCount: filtered.length,
+              itemBuilder: (ctx, i) => ${P}Card(
+                record: filtered[i],
+                onTap: () => _openDetail(ctx, filtered[i].id),
+              ),
+            ),
+          );
+        },
+        loading: () => const LoadingOverlay(message: 'Loading ${L}s…'),
+        error:   (e, _) => Center(
+          child: Column(mainAxisSize: MainAxisSize.min, children: [
+            const Icon(Icons.error_outline, color: Colors.red, size: 48),
+            const SizedBox(height: 12),
+            Text('\$e', style: const TextStyle(color: Colors.red)),
+            const SizedBox(height: 12),
+            ElevatedButton(
+              onPressed: () => ref.read(${s}NotifierProvider.notifier).refresh(),
+              child: const Text('Retry'),
+            ),
+          ]),
+        ),
+      ),
+      floatingActionButton: FloatingActionButton.extended(
+        onPressed: () => _openCreate(context),
+        icon: const Icon(Icons.add),
+        label: const Text('New'),
+      ),
+    );
+  }
+
+  void _openCreate(BuildContext context) => Navigator.push(
+    context,
+    MaterialPageRoute(builder: (_) => const CreateScreen()),
+  );
+
+  void _openDetail(BuildContext context, int id) => Navigator.push(
+    context,
+    MaterialPageRoute(builder: (_) => DetailScreen(recordId: id)),
+  );
+}
+`;
+}
+
+function genDetailScreen(s, P, M, L) {
+  return `import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:intl/intl.dart';
+import '../repositories/${s}_repository.dart';
+import '../providers/${s}_provider.dart';
+import '../widgets/state_badge.dart';
+
+class DetailScreen extends ConsumerWidget {
+  final int recordId;
+  const DetailScreen({super.key, required this.recordId});
+
+  static final _dateFmt = DateFormat('MMM d, yyyy');
+
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final detailAsync = ref.watch(${s}DetailProvider(recordId));
+
+    return Scaffold(
+      appBar: AppBar(
+        title: const Text('${L} Detail'),
+        actions: [
+          detailAsync.maybeWhen(
+            data: (rec) => PopupMenuButton<String>(
+              onSelected: (action) async {
+                final notifier = ref.read(${s}NotifierProvider.notifier);
+                try {
+                  await notifier.callAction(rec.id, 'action_\$action');
+                  ref.invalidate(${s}DetailProvider(recordId));
+                  if (context.mounted) {
+                    ScaffoldMessenger.of(context).showSnackBar(
+                      SnackBar(content: Text('Action "\$action" applied successfully')),
+                    );
+                  }
+                } catch (e) {
+                  if (context.mounted) {
+                    ScaffoldMessenger.of(context).showSnackBar(
+                      SnackBar(content: Text('Error: \$e'), backgroundColor: Colors.red),
+                    );
+                  }
+                }
+              },
+              itemBuilder: (_) {
+                final actions = <PopupMenuItem<String>>[];
+                if (rec.isDraft)      actions.add(const PopupMenuItem(value: 'confirm', child: Text('Confirm')));
+                if (rec.isConfirmed)  actions.add(const PopupMenuItem(value: 'start',   child: Text('Start')));
+                if (rec.isInProgress) actions.add(const PopupMenuItem(value: 'done',    child: Text('Mark Done')));
+                if (!rec.isDone && !rec.isCancelled)
+                                      actions.add(const PopupMenuItem(value: 'cancel',  child: Text('Cancel')));
+                if (rec.isCancelled)  actions.add(const PopupMenuItem(value: 'reset_draft', child: Text('Reset Draft')));
+                return actions;
+              },
+            ),
+            orElse: () => const SizedBox.shrink(),
+          ),
+        ],
+      ),
+      body: detailAsync.when(
+        data: (rec) => SingleChildScrollView(
+          padding: const EdgeInsets.all(16),
+          child: Column(
+            crossAxisAlignment: CrossAxisAlignment.start,
+            children: [
+              // Header card
+              Card(
+                child: Padding(
+                  padding: const EdgeInsets.all(16),
+                  child: Column(crossAxisAlignment: CrossAxisAlignment.start, children: [
+                    Row(children: [
+                      Expanded(
+                        child: Text(rec.name,
+                          style: const TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
+                        ),
+                      ),
+                      StateBadge(state: rec.state),
+                    ]),
+                    const SizedBox(height: 8),
+                    Text(rec.reference, style: TextStyle(color: Colors.grey.shade600, fontSize: 13)),
+                  ]),
+                ),
+              ),
+              const SizedBox(height: 12),
+
+              // Info card
+              Card(
+                child: Padding(
+                  padding: const EdgeInsets.all(16),
+                  child: Column(children: [
+                    _InfoRow(icon: Icons.person_outline,   label: 'Responsible', value: rec.responsibleName),
+                    _InfoRow(icon: Icons.calendar_today,   label: 'Start Date',  value: rec.dateStart != null ? _dateFmt.format(rec.dateStart!) : '—'),
+                    _InfoRow(icon: Icons.event,            label: 'End Date',    value: rec.dateEnd   != null ? _dateFmt.format(rec.dateEnd!)   : '—'),
+                    if (rec.durationDays > 0)
+                      _InfoRow(icon: Icons.timelapse,    label: 'Duration',    value: '\${rec.durationDays} days'),
+                    _InfoRow(icon: Icons.star_outline,     label: 'Priority',   value: ['Normal', 'Low', 'High', 'Very High'][int.tryParse(rec.priority) ?? 0]),
+                  ]),
+                ),
+              ),
+
+              if (rec.description?.isNotEmpty == true) ...[
+                const SizedBox(height: 12),
+                Card(
+                  child: Padding(
+                    padding: const EdgeInsets.all(16),
+                    child: Column(crossAxisAlignment: CrossAxisAlignment.start, children: [
+                      const Text('Description', style: TextStyle(fontWeight: FontWeight.bold)),
+                      const SizedBox(height: 8),
+                      Text(rec.description!),
+                    ]),
+                  ),
+                ),
+              ],
+            ],
+          ),
+        ),
+        loading: () => const Center(child: CircularProgressIndicator()),
+        error:   (e, _) => Center(child: Text('Error: \$e', style: const TextStyle(color: Colors.red))),
+      ),
+    );
+  }
+}
+
+class _InfoRow extends StatelessWidget {
+  final IconData icon;
+  final String label;
+  final String value;
+  const _InfoRow({required this.icon, required this.label, required this.value});
+
+  @override
+  Widget build(BuildContext context) {
+    return Padding(
+      padding: const EdgeInsets.symmetric(vertical: 6),
+      child: Row(children: [
+        Icon(icon, size: 18, color: Colors.grey),
+        const SizedBox(width: 12),
+        SizedBox(width: 100, child: Text(label, style: TextStyle(color: Colors.grey.shade600))),
+        Expanded(child: Text(value, style: const TextStyle(fontWeight: FontWeight.w500))),
+      ]),
+    );
+  }
+}
+`;
+}
+
+function genCreateScreen(s, P, M, L) {
+  return `import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import '../providers/${s}_provider.dart';
+
+class CreateScreen extends ConsumerStatefulWidget {
+  const CreateScreen({super.key});
+
+  @override
+  ConsumerState<CreateScreen> createState() => _CreateScreenState();
+}
+
+class _CreateScreenState extends ConsumerState<CreateScreen> {
+  final _formKey   = GlobalKey<FormState>();
+  final _nameCtrl  = TextEditingController();
+  final _descCtrl  = TextEditingController();
+  DateTime? _dateStart;
+  DateTime? _dateEnd;
+  String    _priority = '0';
+  bool      _saving = false;
+  String?   _error;
+
+  @override
+  void dispose() {
+    _nameCtrl.dispose();
+    _descCtrl.dispose();
+    super.dispose();
+  }
+
+  Future<void> _save() async {
+    if (!_formKey.currentState!.validate()) return;
+    setState(() { _saving = true; _error = null; });
+
+    try {
+      final values = <String, dynamic>{
+        'name':     _nameCtrl.text.trim(),
+        'priority': _priority,
+        if (_descCtrl.text.isNotEmpty) 'description': _descCtrl.text.trim(),
+        if (_dateStart != null) 'date_start': _dateStart!.toIso8601String().split('T')[0],
+        if (_dateEnd   != null) 'date_end':   _dateEnd!.toIso8601String().split('T')[0],
+      };
+      await ref.read(${s}NotifierProvider.notifier).create(values);
+      if (mounted) {
+        ScaffoldMessenger.of(context).showSnackBar(
+          const SnackBar(content: Text('Record created successfully!'), backgroundColor: Colors.green),
+        );
+        Navigator.of(context).pop();
+      }
+    } catch (e) {
+      setState(() { _error = '\$e'; });
+    } finally {
+      if (mounted) setState(() => _saving = false);
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(
+        title: const Text('New ${L}'),
+        actions: [
+          TextButton(
+            onPressed: _saving ? null : _save,
+            child: _saving
+                ? const SizedBox.square(dimension: 18, child: CircularProgressIndicator(strokeWidth: 2, color: Colors.white))
+                : const Text('Save', style: TextStyle(color: Colors.white, fontWeight: FontWeight.bold)),
+          ),
+        ],
+      ),
+      body: SingleChildScrollView(
+        padding: const EdgeInsets.all(16),
+        child: Form(
+          key: _formKey,
+          child: Column(children: [
+            if (_error != null)
+              Container(
+                width: double.infinity,
+                padding: const EdgeInsets.all(12),
+                margin: const EdgeInsets.only(bottom: 16),
+                decoration: BoxDecoration(
+                  color: Colors.red.shade50,
+                  border: Border.all(color: Colors.red.shade200),
+                  borderRadius: BorderRadius.circular(8),
+                ),
+                child: Text(_error!, style: const TextStyle(color: Colors.red)),
+              ),
+
+            TextFormField(
+              controller: _nameCtrl,
+              decoration: const InputDecoration(labelText: 'Name *', prefixIcon: Icon(Icons.label)),
+              validator: (v) => v?.trim().isEmpty == true ? 'Name is required' : null,
+              textInputAction: TextInputAction.next,
+            ),
+            const SizedBox(height: 12),
+
+            DropdownButtonFormField<String>(
+              value: _priority,
+              decoration: const InputDecoration(labelText: 'Priority', prefixIcon: Icon(Icons.star_outline)),
+              items: const [
+                DropdownMenuItem(value: '0', child: Text('Normal')),
+                DropdownMenuItem(value: '1', child: Text('Low')),
+                DropdownMenuItem(value: '2', child: Text('High')),
+                DropdownMenuItem(value: '3', child: Text('Very High')),
+              ],
+              onChanged: (v) => setState(() => _priority = v ?? '0'),
+            ),
+            const SizedBox(height: 12),
+
+            Row(children: [
+              Expanded(
+                child: ListTile(
+                  contentPadding: EdgeInsets.zero,
+                  leading: const Icon(Icons.calendar_today),
+                  title: Text(_dateStart == null ? 'Start Date' : _dateStart!.toString().split(' ')[0]),
+                  onTap: () async {
+                    final d = await showDatePicker(
+                      context: context,
+                      initialDate: _dateStart ?? DateTime.now(),
+                      firstDate: DateTime(2000),
+                      lastDate: DateTime(2100),
+                    );
+                    if (d != null) setState(() => _dateStart = d);
+                  },
+                ),
+              ),
+              Expanded(
+                child: ListTile(
+                  contentPadding: EdgeInsets.zero,
+                  leading: const Icon(Icons.event),
+                  title: Text(_dateEnd == null ? 'End Date' : _dateEnd!.toString().split(' ')[0]),
+                  onTap: () async {
+                    final d = await showDatePicker(
+                      context: context,
+                      initialDate: _dateEnd ?? DateTime.now(),
+                      firstDate: DateTime(2000),
+                      lastDate: DateTime(2100),
+                    );
+                    if (d != null) setState(() => _dateEnd = d);
+                  },
+                ),
+              ),
+            ]),
+            const SizedBox(height: 12),
+
+            TextFormField(
+              controller: _descCtrl,
+              decoration: const InputDecoration(labelText: 'Description', prefixIcon: Icon(Icons.notes), alignLabelWithHint: true),
+              maxLines: 4,
+              textInputAction: TextInputAction.newline,
+            ),
+          ]),
+        ),
+      ),
+    );
+  }
+}
+`;
+}
+
+function genCard(s, P, L) {
+  return `import 'package:flutter/material.dart';
+import 'package:intl/intl.dart';
+import '../models/${s}_model.dart';
+import 'state_badge.dart';
+
+class ${P}Card extends StatelessWidget {
+  final ${P}Record record;
+  final VoidCallback? onTap;
+
+  const ${P}Card({super.key, required this.record, this.onTap});
+
+  static final _dateFmt = DateFormat('MMM d, yyyy');
+
+  @override
+  Widget build(BuildContext context) {
+    return Card(
+      margin: const EdgeInsets.only(bottom: 8),
+      child: InkWell(
+        onTap: onTap,
+        borderRadius: BorderRadius.circular(12),
+        child: Padding(
+          padding: const EdgeInsets.all(12),
+          child: Row(children: [
+            // Avatar
+            CircleAvatar(
+              backgroundColor: const Color(0xFF875A7B),
+              radius: 22,
+              child: Text(
+                record.name.isNotEmpty ? record.name[0].toUpperCase() : '?',
+                style: const TextStyle(color: Colors.white, fontWeight: FontWeight.bold, fontSize: 16),
+              ),
+            ),
+            const SizedBox(width: 12),
+            // Content
+            Expanded(
+              child: Column(
+                crossAxisAlignment: CrossAxisAlignment.start,
+                children: [
+                  Row(children: [
+                    Expanded(
+                      child: Text(record.name,
+                        style: const TextStyle(fontWeight: FontWeight.bold, fontSize: 15),
+                        maxLines: 1, overflow: TextOverflow.ellipsis,
+                      ),
+                    ),
+                    StateBadge(state: record.state, compact: true),
+                  ]),
+                  const SizedBox(height: 4),
+                  Text(record.reference,
+                    style: TextStyle(color: Colors.grey.shade500, fontSize: 12),
+                  ),
+                  if (record.dateStart != null || record.responsibleName.isNotEmpty) ...[
+                    const SizedBox(height: 4),
+                    Row(children: [
+                      if (record.responsibleName.isNotEmpty) ...[
+                        Icon(Icons.person_outline, size: 12, color: Colors.grey.shade400),
+                        const SizedBox(width: 3),
+                        Text(record.responsibleName, style: TextStyle(color: Colors.grey.shade500, fontSize: 12)),
+                        const SizedBox(width: 8),
+                      ],
+                      if (record.dateStart != null) ...[
+                        Icon(Icons.calendar_today, size: 12, color: Colors.grey.shade400),
+                        const SizedBox(width: 3),
+                        Text(_dateFmt.format(record.dateStart!), style: TextStyle(color: Colors.grey.shade500, fontSize: 12)),
+                      ],
+                    ]),
+                  ],
+                ],
+              ),
+            ),
+            const Icon(Icons.chevron_right, color: Colors.grey),
+          ]),
+        ),
+      ),
+    );
+  }
+}
+`;
+}
+
+function genStateBadge() {
+  return `import 'package:flutter/material.dart';
+
+/// Coloured badge that reflects an Odoo record state.
+class StateBadge extends StatelessWidget {
+  final String state;
+  final bool compact;
+  const StateBadge({super.key, required this.state, this.compact = false});
+
+  static const _config = <String, (Color, Color, String)>{
+    'draft':       (Color(0xFFE3F2FD), Color(0xFF1565C0), 'Draft'),
+    'confirmed':   (Color(0xFFFFF3E0), Color(0xFFE65100), 'Confirmed'),
+    'in_progress': (Color(0xFFFFF9C4), Color(0xFFF57F17), 'In Progress'),
+    'done':        (Color(0xFFE8F5E9), Color(0xFF2E7D32), 'Done'),
+    'cancelled':   (Color(0xFFFFEBEE), Color(0xFFC62828), 'Cancelled'),
+  };
+
+  @override
+  Widget build(BuildContext context) {
+    final (bg, fg, label) = _config[state] ?? (Colors.grey.shade100, Colors.grey, state);
+    return Container(
+      padding: EdgeInsets.symmetric(horizontal: compact ? 6 : 10, vertical: compact ? 2 : 4),
+      decoration: BoxDecoration(
+        color: bg,
+        borderRadius: BorderRadius.circular(20),
+      ),
+      child: Text(
+        label,
+        style: TextStyle(color: fg, fontSize: compact ? 10 : 12, fontWeight: FontWeight.w600),
+      ),
+    );
+  }
+}
+`;
+}
+
+function genLoadingOverlay() {
+  return `import 'package:flutter/material.dart';
+import 'package:flutter_spinkit/flutter_spinkit.dart';
+
+class LoadingOverlay extends StatelessWidget {
+  final String? message;
+  const LoadingOverlay({super.key, this.message});
+
+  @override
+  Widget build(BuildContext context) {
+    return Center(
+      child: Column(
+        mainAxisSize: MainAxisSize.min,
+        children: [
+          const SpinKitThreeBounce(color: Color(0xFF875A7B), size: 30),
+          if (message != null) ...[
+            const SizedBox(height: 16),
+            Text(message!, style: TextStyle(color: Colors.grey.shade600)),
+          ],
+        ],
+      ),
+    );
+  }
+}
+`;
+}
+
+function genTest(s, P, M, L) {
+  return `import 'package:flutter_test/flutter_test.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:${s.replace(/_/g, '_')}_app/src/models/${s}_model.dart';
+
+void main() {
+  group('${P}Record model tests', () {
+    final sampleMap = {
+      'id':        1,
+      'name':      'Test Record',
+      'reference': 'REF/2025/00001',
+      'state':     'draft',
+      'priority':  '0',
+      'user_id':   [1, 'Admin'],
+      'date_start':'2025-01-01',
+      'date_end':  '2025-01-11',
+      'active':    true,
+      'duration_days': 10,
+    };
+
+    test('fromMap parses correctly', () {
+      final record = ${P}Record.fromMap(sampleMap);
+      expect(record.id,          1);
+      expect(record.name,        'Test Record');
+      expect(record.state,       'draft');
+      expect(record.isDraft,     true);
+      expect(record.dateStart,   DateTime(2025, 1, 1));
+      expect(record.durationDays, 10);
+      expect(record.responsibleName, 'Admin');
+    });
+
+    test('stateLabel returns correct label', () {
+      final draft     = ${P}Record.fromMap({...sampleMap, 'state': 'draft'});
+      final confirmed = ${P}Record.fromMap({...sampleMap, 'state': 'confirmed'});
+      final done      = ${P}Record.fromMap({...sampleMap, 'state': 'done'});
+      expect(draft.stateLabel,     'Draft');
+      expect(confirmed.stateLabel, 'Confirmed');
+      expect(done.stateLabel,      'Done');
+    });
+
+    test('copyWith creates modified copy', () {
+      final rec  = ${P}Record.fromMap(sampleMap);
+      final copy = rec.copyWith(name: 'Updated', state: 'confirmed');
+      expect(copy.name,  'Updated');
+      expect(copy.state, 'confirmed');
+      expect(copy.id,    rec.id);  // ID unchanged
+    });
+
+    test('equality is based on id', () {
+      final a = ${P}Record.fromMap(sampleMap);
+      final b = ${P}Record.fromMap({...sampleMap, 'name': 'Different Name'});
+      expect(a, equals(b));  // same id → equal
+    });
+
+    test('toMap returns correct create payload', () {
+      final rec = ${P}Record.fromMap(sampleMap);
+      final map = rec.toMap();
+      expect(map['name'],  'Test Record');
+      expect(map['state'], 'draft');
+      expect(map.containsKey('id'), false);        // id not in create payload
+      expect(map.containsKey('reference'), false); // reference is server-generated
+    });
+  });
+}
+`;
+}
+
+function genIntegrationTest(s, P, L) {
+  return `// Integration tests for ${L} Flutter app.
+// Requires a running Odoo instance and a valid session.
+// Run with: flutter test integration_test/app_test.dart
+
+import 'package:flutter_test/flutter_test.dart';
+import 'package:integration_test/integration_test.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+
+void main() {
+  IntegrationTestWidgetsFlutterBinding.ensureInitialized();
+
+  testWidgets('Login screen renders', (tester) async {
+    // TODO: Boot the app and verify the login screen appears
+    // await tester.pumpWidget(ProviderScope(child: FleetManagerApp()));
+    // expect(find.text('Sign In'), findsOneWidget);
+  });
+
+  testWidgets('List screen loads records after login', (tester) async {
+    // TODO: Inject a mock OdooClient and verify the list screen
+  });
+}
+`;
+}
+
+module.exports = { generateFlutterApp };