# BoolTarget

**Repository Path**: riverbird/bool-target

## Basic Information

- **Project Name**: BoolTarget
- **Description**: 基于Flutter开发的布尔智汇下面针对目标管理的应用。
- **Primary Language**: Dart
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: https://sourceforge.net/projects/bool-note/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-02
- **Last Updated**: 2026-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 目标管理

## README

# 布尔目标 (bool-target)

> 规划你的人生蓝图，实现你的梦想目标。

**布尔目标** 是一款基于 Flutter 打造的跨平台人生目标管理应用。它以「人生分类 → 目标 → 子项」的层级结构，帮助你把宏大的梦想拆解为一个个可执行、可勾选的小步骤，并实时追踪每一个目标的完成进度。

一个「布尔」式的哲学贯穿始终：每个子项非真即假、要么完成要么未完成，用一次次简单的勾选，累积出人生的整体进展。

---

## ✨ 核心特性

- **多端一致体验**：一套代码，覆盖 Android、iOS、Web、Windows、macOS、Linux 六大平台。
- **账号体系**：支持账号密码登录与手机短信验证码登录，并提供注册功能；登录令牌（Token）本地安全存储，应用启动时自动校验并免密进入。
- **人生分类管理**：自定义你的分类（如事业、健康、旅行、家庭等），内置 16 种主题色彩可选，支持分类的新增、编辑与删除。
- **目标与子项**：为每个目标归属一个分类，并在目标下拆分为多个可勾选的子项，支持目标与子项的创建、编辑、删除。
- **进度追踪**：每个目标依据子项完成情况自动计算进度百分比，一眼看清达成度。
- **目标详情**：独立的详情页展示子项清单，可直接勾选完成状态并刷新进度。
- **Material 3 设计**：基于 Material Design 3 与蓝色主题种子，界面简洁现代。

## 🧱 技术栈

| 分类 | 选型 |
| --- | --- |
| 应用框架 | Flutter (Dart SDK `^3.11.5`) |
| 网络请求 | [`http`](https://pub.dev/packages/http) |
| 本地存储 | [`shared_preferences`](https://pub.dev/packages/shared_preferences) |
| 代码规范 | `flutter_lints` |
| 应用图标 | `flutter_launcher_icons` |
| UI 风格 | Material 3 |

应用通过 REST API 与后端服务通信（默认地址：`https://restapi.10qu.com.cn`），统一封装在 `ApiService` 中，支持 GET / POST / PUT / PATCH / DELETE 及 Bearer Token 鉴权。

## 📁 项目结构

```
bool_target/
├── lib/
│   ├── main.dart                 # 应用入口与启动闪屏（自动登录校验）
│   ├── api/
│   │   └── api_service.dart       # REST API 统一封装
│   ├── models/
│   │   ├── life_goal.dart         # 分类 / 目标 / 子项数据模型
│   │   └── user.dart              # 用户数据模型
│   ├── pages/
│   │   ├── login_page.dart        # 登录（密码 / 短信验证码）
│   │   ├── register_page.dart     # 注册
│   │   ├── main_page.dart         # 主页（分类筛选、目标列表、进度）
│   │   ├── category_manage_page.dart  # 分类管理
│   │   ├── create_goal_page.dart  # 创建目标
│   │   ├── edit_goal_page.dart    # 编辑目标
│   │   ├── goal_detail_page.dart  # 目标详情
│   │   └── about_page.dart        # 关于我们
│   └── utils/
│       └── storage_util.dart       # 本地存储封装
├── assets/images/                 # 图标与图片资源
├── android/ ios/ web/ windows/ macos/ linux/   # 各平台工程
└── pubspec.yaml                   # 依赖与资源配置
```

## 🚀 快速开始

### 环境要求

- 已安装 [Flutter SDK](https://docs.flutter.dev/get-started/install)（Dart SDK `^3.11.5` 及以上）
- 目标平台的开发工具链（如 Android Studio / Xcode / Visual Studio 等）

### 安装与运行

```bash
# 进入工程目录
cd bool_target

# 获取依赖
flutter pub get

# 查看可用设备
flutter devices

# 运行到指定设备（如 Chrome / 已连接手机）
flutter run
```

### 构建发布

```bash
# Android
flutter build apk

# iOS（需在 macOS 环境）
flutter build ios

# Web
flutter build web

# Windows / macOS / Linux 桌面
flutter build windows
flutter build macos
flutter build linux
```

## ⚙️ 配置说明

- **后端地址**：修改 `lib/api/api_service.dart` 中的 `baseUrl` 指向你的服务地址。
- **应用图标**：更新 `assets/images/logo.png` 后，执行 `dart run flutter_launcher_icons` 重新生成各端图标。
- **应用名称与版本**：见 `pubspec.yaml`。