Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions .github/workflows/analyze.yml
Original file line number Diff line number Diff line change
Expand Up @@ -61,3 +61,11 @@ jobs:

- name: Test
run: flutter test

- name: Set up Node for feedback checks
uses: actions/setup-node@v4
with:
node-version: '22'

- name: Test feedback recovery
run: node --test web/feedback/test/*.test.mjs
11 changes: 11 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -122,6 +122,17 @@ jobs:
flutter analyze --no-pub
flutter test


- name: Set up Node for feedback checks
if: steps.plan.outputs.skip == 'false'
uses: actions/setup-node@v4
with:
node-version: '22'

- name: Test feedback recovery
if: steps.plan.outputs.skip == 'false'
run: node --test web/feedback/test/*.test.mjs

tag:
name: Tag the release
needs: plan
Expand Down
2 changes: 2 additions & 0 deletions lib/pages/settings_page.dart
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ import '../widgets/adaptive_switch.dart';
import '../widgets/app_shell/app_shell_metrics.dart';
import '../widgets/blurred_app_bar.dart';
import '../widgets/desktop_popup.dart';
import '../widgets/feedback_entry.dart';
import '../widgets/ios/ios_native_navigation_bar.dart';
import '../widgets/update_dialogs.dart';
import 'debug_log_page.dart';
Expand Down Expand Up @@ -329,6 +330,7 @@ class _SettingsPageState extends State<SettingsPage> {
),
const Divider(),

const FeedbackEntry(),
ListTile(
leading: const Icon(Icons.privacy_tip_outlined),
title: const Text('隐私政策与使用支持'),
Expand Down
59 changes: 59 additions & 0 deletions lib/widgets/feedback_entry.dart
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
import 'dart:async';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:url_launcher/url_launcher.dart';

import 'adaptive_alert_dialog.dart';

/// Opens the public feedback page and provides a usable fallback on failure.
class FeedbackEntry extends StatefulWidget {
const FeedbackEntry({super.key, this.launcher});

final Future<bool> Function(Uri)? launcher;

@override
State<FeedbackEntry> createState() => _FeedbackEntryState();
}

class _FeedbackEntryState extends State<FeedbackEntry> {
static final _url = Uri.parse('https://techpie-feedback.dzhes.app');
bool _opening = false;

Future<void> _open() async {
if (_opening) return;
setState(() => _opening = true);
try {
var opened = false;
try {
opened = await (widget.launcher?.call(_url) ??
launchUrl(_url, mode: LaunchMode.externalApplication));
} catch (_) {
// Both a false result and a platform failure need the same recovery.
}
if (opened || !mounted) return;
final copy = await showAdaptiveAlertDialog<bool>(
context: context,
title: '无法打开反馈页面',
message: '请复制链接后在浏览器中打开。\n$_url',
actions: const [
AdaptiveAlertAction(label: '关闭', value: false),
AdaptiveAlertAction(label: '复制链接', value: true, isDefault: true),
],
);
if (copy == true) await Clipboard.setData(ClipboardData(text: '$_url'));
} finally {
if (mounted) setState(() => _opening = false);
}
}

@override
Widget build(BuildContext context) => ListTile(
leading: const Icon(Icons.feedback_outlined),
title: const Text('用户反馈与工单'),
subtitle: const Text('提交问题、建议,或查看工单进度'),
trailing: const Icon(Icons.open_in_new),
enabled: !_opening,
onTap: () => unawaited(_open()),
);
}
88 changes: 88 additions & 0 deletions test/feedback_entry_test.dart
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
import 'dart:async';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:techpie/widgets/feedback_entry.dart';

void main() {
testWidgets('successful launch preserves feedback entry without a dialog',
(tester) async {
Uri? opened;
await tester.pumpWidget(
MaterialApp(
home: Scaffold(
body: FeedbackEntry(
launcher: (url) async {
opened = url;
return true;
},
),
),
),
);
await tester.tap(find.text('用户反馈与工单'));
await tester.pumpAndSettle();
expect(opened.toString(), 'https://techpie-feedback.dzhes.app');
expect(find.text('无法打开反馈页面'), findsNothing);
});

for (final throws in [false, true]) {
testWidgets('launch ${throws ? 'exception' : 'false'} offers copyable link',
(tester) async {
String? copied;
tester.binding.defaultBinaryMessenger.setMockMethodCallHandler(
SystemChannels.platform,
(call) async {
if (call.method == 'Clipboard.setData') {
copied = (call.arguments as Map)['text'] as String;
}
return null;
},
);
addTearDown(
() => tester.binding.defaultBinaryMessenger
.setMockMethodCallHandler(SystemChannels.platform, null),
);
await tester.pumpWidget(
MaterialApp(
home: Scaffold(
body: FeedbackEntry(
launcher: (_) async {
if (throws) throw PlatformException(code: 'unavailable');
return false;
},
),
),
),
);
await tester.tap(find.text('用户反馈与工单'));
await tester.pumpAndSettle();
expect(find.text('无法打开反馈页面'), findsOneWidget);
await tester.tap(find.text('复制链接'));
await tester.pumpAndSettle();
expect(copied, 'https://techpie-feedback.dzhes.app');
});
}

testWidgets('late launch failure after navigation does not display a dialog',
(tester) async {
final pending = Completer<bool>();
await tester.pumpWidget(
MaterialApp(
home: Scaffold(
body: FeedbackEntry(
launcher: (_) => pending.future,
),
),
),
);
await tester.tap(find.text('用户反馈与工单'));
await tester.pump();
await tester.pumpWidget(const MaterialApp(home: SizedBox()));
pending.complete(false);
await tester.pumpAndSettle();
expect(tester.takeException(), isNull);
expect(find.text('无法打开反馈页面'), findsNothing);
});
}
5 changes: 5 additions & 0 deletions web/feedback/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
node_modules/
.vercel/
.env*
!.env.example
.data/
9 changes: 9 additions & 0 deletions web/feedback/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# TechPie 反馈入口

本目录只包含反馈表单与工单查询界面。API、存储、后台管理、测试和部署配置独立放在 E:\Projects\techpie-feedback-api。

接口地址:https://techpie-feedback.dzhes.app/api/feedback。API 项目部署时同步这里的公开界面到 public/,因此该域名也提供反馈入口,后台地址为 /miku。

表单包含 GeekPie-UniAuth 用户名(非学号)、反馈类型、平台与版本、使用场景、标题、具体问题、复现步骤、期望结果与联系方式。用户名自行填写,未做 SSO 身份验证,不传递 SSO Token。提交后生成工单 ID,可下载凭证并查看公开回复与处理进度。

Flutter 设置页通过“用户反馈与工单”打开入口。API 的账户密码、存储凭据及运行数据均不在本目录。
93 changes: 93 additions & 0 deletions web/feedback/public/app.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
import { api, el, details } from "./common.js";
let receipt;
function tab(mode) {
for (const name of ["new", "lookup"]) {
el(`${name}-panel`).hidden = name !== mode;
el(`${name}-tab`).setAttribute("aria-selected", String(name === mode));
}
}
el("new-tab").onclick = () => tab("new");
el("lookup-tab").onclick = () => tab("lookup");
document.querySelector(".tabs").onkeydown = (event) => {
if (["ArrowLeft", "ArrowRight"].includes(event.key)) {
event.preventDefault();
const mode = el("new-panel").hidden ? "new" : "lookup";
tab(mode);
el(`${mode}-tab`).focus();
}
};
const form = el("feedback-form");
el("another-feedback").onclick = () => {
receipt = null;
form.reset();
form.hidden = false;
el("receipt").hidden = true;
form.elements.contact.type = "email";
form.elements.contact.autocomplete = "email";
el("receipt-id").textContent = "";
form.elements.userId.focus();
};
form.elements.contactType.onchange = () => {
form.elements.contact.type =
form.elements.contactType.value === "邮箱" ? "email" : "text";
form.elements.contact.autocomplete =
form.elements.contactType.value === "邮箱" ? "email" : "off";
};
form.onsubmit = async (event) => {
event.preventDefault();
const button = form.querySelector("button");
button.disabled = true;
el("form-message").textContent = "";
try {
receipt = await api("create", {
...Object.fromEntries(new FormData(form)),
consent: form.elements.consent.checked,
});
el("receipt-id").textContent = receipt.id;
form.hidden = true;
el("receipt").hidden = false;
el("receipt").focus();
} catch (error) {
el("form-message").textContent = error.message;
} finally {
button.disabled = false;
}
};
el("save-receipt").onclick = () => {
const file = new Blob(
[
`TechPie 工单凭证\n工单 ID:${receipt.id}\n查询入口:${location.origin}/\n请妥善保存工单 ID。\n`,
],
{ type: "text/plain;charset=utf-8" },
);
const url = URL.createObjectURL(file);
const a = document.createElement("a");
a.href = url;
a.download = `${receipt.id}.txt`;
a.click();
setTimeout(() => URL.revokeObjectURL(url), 1000);
};
el("view-receipt").onclick = () => {
el("lookup-form").elements.id.value = receipt.id;
tab("lookup");
el("lookup-form").requestSubmit();
};
el("lookup-form").onsubmit = async (event) => {
event.preventDefault();
const form = event.currentTarget;
const button = form.querySelector("button");
button.disabled = true;
el("lookup-message").textContent = "";
el("lookup-result").replaceChildren();
try {
const { ticket } = await api("lookup", {
...Object.fromEntries(new FormData(form)),
id: form.elements.id.value.trim().toUpperCase(),
});
details(ticket, el("lookup-result"));
} catch (error) {
el("lookup-message").textContent = error.message;
} finally {
button.disabled = false;
}
};
Loading