feat(legal): in-app Privacy & rules screen with plain-words summaries and links to the full documents
This commit is contained in:
parent
9668e0e70b
commit
a7e10eba7a
5 changed files with 180 additions and 0 deletions
|
|
@ -33,6 +33,7 @@ import 'ui/favorites_screen.dart';
|
||||||
import 'ui/home_screen.dart';
|
import 'ui/home_screen.dart';
|
||||||
import 'ui/intro_screen.dart';
|
import 'ui/intro_screen.dart';
|
||||||
import 'ui/inventory_list_screen.dart';
|
import 'ui/inventory_list_screen.dart';
|
||||||
|
import 'ui/legal_screen.dart';
|
||||||
import 'ui/plantares_screen.dart';
|
import 'ui/plantares_screen.dart';
|
||||||
import 'ui/sales_screen.dart';
|
import 'ui/sales_screen.dart';
|
||||||
import 'ui/market_offer_detail_screen.dart';
|
import 'ui/market_offer_detail_screen.dart';
|
||||||
|
|
@ -254,6 +255,10 @@ class TaneApp extends StatelessWidget {
|
||||||
path: '/about',
|
path: '/about',
|
||||||
builder: (context, state) => const AboutScreen(),
|
builder: (context, state) => const AboutScreen(),
|
||||||
),
|
),
|
||||||
|
GoRoute(
|
||||||
|
path: '/legal',
|
||||||
|
builder: (context, state) => const LegalScreen(),
|
||||||
|
),
|
||||||
GoRoute(
|
GoRoute(
|
||||||
path: '/inventory',
|
path: '/inventory',
|
||||||
builder: (context, state) => BlocProvider(
|
builder: (context, state) => BlocProvider(
|
||||||
|
|
|
||||||
|
|
@ -1,4 +1,5 @@
|
||||||
import 'package:flutter/material.dart';
|
import 'package:flutter/material.dart';
|
||||||
|
import 'package:go_router/go_router.dart';
|
||||||
import 'package:package_info_plus/package_info_plus.dart';
|
import 'package:package_info_plus/package_info_plus.dart';
|
||||||
import 'package:url_launcher/url_launcher.dart';
|
import 'package:url_launcher/url_launcher.dart';
|
||||||
|
|
||||||
|
|
@ -68,6 +69,13 @@ class AboutScreen extends StatelessWidget {
|
||||||
mode: LaunchMode.externalApplication,
|
mode: LaunchMode.externalApplication,
|
||||||
),
|
),
|
||||||
),
|
),
|
||||||
|
ListTile(
|
||||||
|
leading: const Icon(Icons.privacy_tip_outlined, color: seedGreen),
|
||||||
|
title: Text(t.legal.title),
|
||||||
|
subtitle: Text(t.legal.subtitle),
|
||||||
|
trailing: const Icon(Icons.chevron_right),
|
||||||
|
onTap: () => context.push('/legal'),
|
||||||
|
),
|
||||||
ListTile(
|
ListTile(
|
||||||
leading: const Icon(Icons.description_outlined, color: seedGreen),
|
leading: const Icon(Icons.description_outlined, color: seedGreen),
|
||||||
title: Text(t.about.openSourceLicenses),
|
title: Text(t.about.openSourceLicenses),
|
||||||
|
|
|
||||||
111
apps/app_seeds/lib/ui/legal_screen.dart
Normal file
111
apps/app_seeds/lib/ui/legal_screen.dart
Normal file
|
|
@ -0,0 +1,111 @@
|
||||||
|
import 'package:flutter/material.dart';
|
||||||
|
import 'package:url_launcher/url_launcher.dart';
|
||||||
|
|
||||||
|
import '../i18n/strings.g.dart';
|
||||||
|
import 'theme.dart';
|
||||||
|
|
||||||
|
/// Where the full legal documents are published. The masters live in the
|
||||||
|
/// repository under `docs/legal/` and must stay in sync with these pages.
|
||||||
|
const String legalBaseUrl = 'https://tane.comunes.org/legal';
|
||||||
|
|
||||||
|
/// "Privacy & rules": in-app, human-language summaries of the privacy policy,
|
||||||
|
/// the terms + community rules, and the seed-legality notice, each linking to
|
||||||
|
/// the full published text.
|
||||||
|
class LegalScreen extends StatelessWidget {
|
||||||
|
const LegalScreen({super.key});
|
||||||
|
|
||||||
|
@override
|
||||||
|
Widget build(BuildContext context) {
|
||||||
|
final t = context.t;
|
||||||
|
return Scaffold(
|
||||||
|
appBar: AppBar(title: Text(t.legal.title)),
|
||||||
|
body: ListView(
|
||||||
|
padding: const EdgeInsets.fromLTRB(20, 16, 20, 32),
|
||||||
|
children: [
|
||||||
|
_Section(
|
||||||
|
icon: Icons.lock_outline,
|
||||||
|
title: t.legal.privacyTitle,
|
||||||
|
body: t.legal.privacyBody,
|
||||||
|
url: '$legalBaseUrl/privacy',
|
||||||
|
),
|
||||||
|
_Section(
|
||||||
|
icon: Icons.handshake_outlined,
|
||||||
|
title: t.legal.rulesTitle,
|
||||||
|
body: t.legal.rulesBody,
|
||||||
|
url: '$legalBaseUrl/rules',
|
||||||
|
),
|
||||||
|
_Section(
|
||||||
|
icon: Icons.grass_outlined,
|
||||||
|
title: t.legal.seedsTitle,
|
||||||
|
body: t.legal.seedsBody,
|
||||||
|
url: '$legalBaseUrl/seeds',
|
||||||
|
),
|
||||||
|
],
|
||||||
|
),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// One titled summary block with its "read the full text" link.
|
||||||
|
class _Section extends StatelessWidget {
|
||||||
|
const _Section({
|
||||||
|
required this.icon,
|
||||||
|
required this.title,
|
||||||
|
required this.body,
|
||||||
|
required this.url,
|
||||||
|
});
|
||||||
|
|
||||||
|
final IconData icon;
|
||||||
|
final String title;
|
||||||
|
final String body;
|
||||||
|
final String url;
|
||||||
|
|
||||||
|
@override
|
||||||
|
Widget build(BuildContext context) {
|
||||||
|
final t = context.t;
|
||||||
|
final theme = Theme.of(context);
|
||||||
|
return Padding(
|
||||||
|
padding: const EdgeInsetsDirectional.only(bottom: 24),
|
||||||
|
child: Column(
|
||||||
|
crossAxisAlignment: CrossAxisAlignment.start,
|
||||||
|
children: [
|
||||||
|
Row(
|
||||||
|
children: [
|
||||||
|
Icon(icon, color: seedGreen),
|
||||||
|
const SizedBox(width: 10),
|
||||||
|
Expanded(
|
||||||
|
child: Text(
|
||||||
|
title,
|
||||||
|
style: theme.textTheme.titleMedium?.copyWith(
|
||||||
|
color: seedOnSurface,
|
||||||
|
fontWeight: FontWeight.w600,
|
||||||
|
),
|
||||||
|
),
|
||||||
|
),
|
||||||
|
],
|
||||||
|
),
|
||||||
|
const SizedBox(height: 8),
|
||||||
|
Text(
|
||||||
|
body,
|
||||||
|
style: theme.textTheme.bodyMedium?.copyWith(
|
||||||
|
color: seedOnSurface,
|
||||||
|
height: 1.5,
|
||||||
|
),
|
||||||
|
),
|
||||||
|
TextButton.icon(
|
||||||
|
style: TextButton.styleFrom(
|
||||||
|
padding: EdgeInsets.zero,
|
||||||
|
foregroundColor: seedGreen,
|
||||||
|
),
|
||||||
|
icon: const Icon(Icons.open_in_new, size: 16),
|
||||||
|
label: Text(t.legal.readFull),
|
||||||
|
onPressed: () => launchUrl(
|
||||||
|
Uri.parse(url),
|
||||||
|
mode: LaunchMode.externalApplication,
|
||||||
|
),
|
||||||
|
),
|
||||||
|
],
|
||||||
|
),
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -67,6 +67,12 @@ class SettingsScreen extends StatelessWidget {
|
||||||
trailing: const Icon(Icons.chevron_right),
|
trailing: const Icon(Icons.chevron_right),
|
||||||
onTap: () => context.push('/about'),
|
onTap: () => context.push('/about'),
|
||||||
),
|
),
|
||||||
|
ListTile(
|
||||||
|
leading: const Icon(Icons.privacy_tip_outlined, color: seedGreen),
|
||||||
|
title: Text(t.legal.title),
|
||||||
|
trailing: const Icon(Icons.chevron_right),
|
||||||
|
onTap: () => context.push('/legal'),
|
||||||
|
),
|
||||||
],
|
],
|
||||||
),
|
),
|
||||||
);
|
);
|
||||||
|
|
|
||||||
50
apps/app_seeds/test/ui/legal_screen_test.dart
Normal file
50
apps/app_seeds/test/ui/legal_screen_test.dart
Normal file
|
|
@ -0,0 +1,50 @@
|
||||||
|
import 'package:flutter/material.dart';
|
||||||
|
import 'package:flutter_localizations/flutter_localizations.dart';
|
||||||
|
import 'package:flutter_test/flutter_test.dart';
|
||||||
|
import 'package:tane/i18n/strings.g.dart';
|
||||||
|
import 'package:tane/ui/legal_screen.dart';
|
||||||
|
|
||||||
|
void main() {
|
||||||
|
Widget app() => TranslationProvider(
|
||||||
|
child: const MaterialApp(
|
||||||
|
localizationsDelegates: GlobalMaterialLocalizations.delegates,
|
||||||
|
home: LegalScreen(),
|
||||||
|
),
|
||||||
|
);
|
||||||
|
|
||||||
|
testWidgets('shows the three summaries with their full-text links', (
|
||||||
|
tester,
|
||||||
|
) async {
|
||||||
|
LocaleSettings.setLocaleSync(AppLocale.en);
|
||||||
|
await tester.pumpWidget(app());
|
||||||
|
await tester.pump();
|
||||||
|
|
||||||
|
expect(find.text('Your privacy'), findsOneWidget);
|
||||||
|
// No account, no tracker, plain-words copy is on screen.
|
||||||
|
expect(find.textContaining('without an account'), findsOneWidget);
|
||||||
|
expect(find.text('Read the full documents online'), findsWidgets);
|
||||||
|
|
||||||
|
// The later sections start below the fold of the test viewport.
|
||||||
|
await tester.scrollUntilVisible(find.text('About sharing seeds'), 300);
|
||||||
|
expect(find.text('Rules of the road'), findsOneWidget);
|
||||||
|
expect(find.text('About sharing seeds'), findsOneWidget);
|
||||||
|
});
|
||||||
|
|
||||||
|
testWidgets('renders under RTL without overflowing', (tester) async {
|
||||||
|
LocaleSettings.setLocaleSync(AppLocale.en);
|
||||||
|
await tester.pumpWidget(
|
||||||
|
TranslationProvider(
|
||||||
|
child: const MaterialApp(
|
||||||
|
localizationsDelegates: GlobalMaterialLocalizations.delegates,
|
||||||
|
home: Directionality(
|
||||||
|
textDirection: TextDirection.rtl,
|
||||||
|
child: LegalScreen(),
|
||||||
|
),
|
||||||
|
),
|
||||||
|
),
|
||||||
|
);
|
||||||
|
await tester.pump();
|
||||||
|
expect(tester.takeException(), isNull);
|
||||||
|
expect(find.byType(LegalScreen), findsOneWidget);
|
||||||
|
});
|
||||||
|
}
|
||||||
Loading…
Add table
Add a link
Reference in a new issue