Gitea 工单管理系统

Flutter 开发的 Gitea Issue 移动端客户端，默认连接：

http://111.228.39.103:3000

当前已实现：

• Gitea 账号密码登录。
• 登录后优先通过 POST /users/{username}/tokens 创建 API token。
• 如果 token 创建失败但 Basic Auth 可用，则退回 Basic Auth 会话。
• 本地安全保存认证信息。
• 仓库列表、仓库搜索、最近访问仓库。
• 工单列表、open / closed 切换、关键词 / 标签 / 里程碑 / 指派人筛选。
• 工单详情、Markdown 正文、评论列表。
• 创建工单、创建时选择标签、详情中添加/移除标签、添加评论、关闭工单、重新打开工单。
• Android HTTP 内测放行配置。
• iOS ATS HTTP 内测例外配置。

运行

flutter pub get
flutter run

覆盖默认 Gitea 地址：

flutter run --dart-define=GITEA_BASE_URL=https://gitea.example.com

构建 Android

flutter build apk --debug

已验证 debug APK 输出位置：

build/app/outputs/flutter-apk/app-debug.apk

构建 iOS

iOS / IPA 打包必须在 macOS + Xcode 环境完成。当前 Windows 环境无法直接生成可安装 IPA。

详见：

docs/ios-packaging.md

安全说明

当前默认 Gitea 地址是 HTTP。账号密码和 token 在 HTTP 下会明文传输，只适合内测。

正式使用前应为 Gitea 配置 HTTPS，并移除 Android / iOS 的明文 HTTP 例外配置。

鸿蒙说明

Flutter 官方稳定平台不包含 HarmonyOS/OpenHarmony。本项目业务代码尽量保持纯 Flutter/Dart，但鸿蒙构建需要 OpenHarmony-SIG Flutter SDK、DevEco Studio 和插件兼容性验证。

详见：

• docs/product-requirements.md
• docs/architecture-design.md