J3 是一个基于 Flutter 和 Dart 的跨平台项目，旨在提供一个高效、灵活的开发环境。
项目需求是在移动设备上运行一个应用，除了基础的业务能力，此应用的核心能力是启动 HTTP 服务，这个服务既能在局域网中作为中心服务提供给各终端连接进行数据交互，也能定时将数据同步到云端服务器。
应用端采用 Flutter 开发，服务端采用 Dart 开发，服务端的既可以作为独立服务运行，也可以作为嵌入式服务运行。
本项目采用将服务端嵌入到应用端的方案，在应用启动时启动服务端，在应用退出时退出服务端。服务端和应用端通过 HTTP 协议进行数据交互。
应用端有直接修改数据库的能力，但为了服务端的兼容性，应用端仅在需要数据库结构迁移时会操作数据库，其他情况一律通过服务端操作数据库。
数据库使用 SQLite，数据表结构定义在 j3_server 包中。
数据库使用 SQLite，数据表结构定义在各自的 prisma 目录中。
数据库 ORM 使用的是 orm 和 orm_flutter。这个包是实现 Prisma 的引擎，和 JavaScript/TypeScript 的版本有相同的 API，但并未完全实现，详细介绍见Prisma。
独立运行的服务端支持的数据库有:
- PostgreSQL
- MySQL/MariaDB
- SQLite
- SQL Server
- MongoDB
- CockroachDB
嵌入式的服务端支持的数据库有:
- SQLite
综上，我采用了 SQLite 作为数据库，主要是因为兼容性。
orm_flutter 目前仅支持了 iOS 和 Android 平台，所以嵌入式服务端仅支持这两个平台，详见介绍Flutter Integration。
orm_flutter 目前仅支持了 iOS 和 Android 平台，所以嵌入式服务端仅支持这两个平台，详见介绍Flutter Integration。
orm_flutter 目前仅支持了 iOS 和 Android 平台，所以嵌入式服务端仅支持这两个平台，详见介绍Flutter Integration。
项目使用 Melos 进行包管理，包结构如下：
.
├── apps # 应用
│ ├── dashboard # 平台端
│ ├── kitchen # 厨房端
│ ├── merchant # 商户端
│ ├── mobile # 移动端
│ ├── pos # 收银端
│ ├── tablet # 平板端
│ └── ...
├── packages # 包
│ ├── server # 服务端
│ ├── shared # 共享包
│ ├── utils # 工具包
│ └── ...
├── melos.yaml # Melos配置文件
└── pubspec.yaml # Flutter项目配置文件
并非所有终端 App 都需要使用 Flutter 开发，可以根据实际需求调整，但服务端是必须要用 Dart 开发的。
如果采用了这个方案实现终端离线化，那么我的建议还是使用 Flutter 重构相关的终端 App，即便这会占用大量的开发成本。这样就可以使用同一个项目进行开发和构建了。
- 应用
- 平台端 dashboard
- 厨房端 kitchen
- 商户端 merchant
- 移动端 mobile
- 收银端 pos
- 嵌入式服务端
- 通过
orm_flutter操作 SQLite 数据库
- 平板端 tablet
- 服务端
- 服务端 server
- 独立式服务端
- 通过
orm操作 SQLite 数据库
- 共享包 shared
- 工具包 utils
- 服务端 server
这是根据 BenDaye 的 Windows 11 [版本 10.0.22631.4169] 的电脑创建项目时的版本，理论上其他版本也可以，但未经过测试，可能会出现兼容性问题：
-
Flutter SDK: >=3.24.3
- Dart SDK: >=3.5.3（包含在 Flutter SDK 中）
-
Node.js: >=20.11.1
-
npm: >=10.2.4
-
Melos: >=6.1.0
请确保您安装的 SDK 版本不低于上述列出的最小版本，以确保项目能够正常运行和开发。
# 以下是我本机的 flutter doctor 命令的输出
$ flutter doctor
Flutter assets will be downloaded from https://storage.flutter-io.cn. Make sure you trust this source!
Doctor summary (to see all details, run flutter doctor -v):
[√] Flutter (Channel stable, 3.24.3, on Microsoft Windows [版本 10.0.22631.4169], locale zh-CN)
[√] Windows Version (Installed version of Windows is version 10 or higher)
[√] Android toolchain - develop for Android devices (Android SDK version 35.0.0)
[√] Chrome - develop for the web
[√] Visual Studio - develop Windows apps (Visual Studio Community 2022 17.11.3)
[√] Android Studio (version 2024.1)
[√] VS Code, 64-bit edition (version 1.93.0-insider)
[√] Proxy Configuration
[√] Connected device (3 available)
[√] Network resources
• No issues found!
- Flutter 安装指南：https://flutter.dev/docs/get-started/install
- Dart 安装指南：https://dart.dev/get-dart
- 访问 Flutter 官网下载适合你操作系统的安装包。
- 解压安装包到你想要的目录。
- 将 Flutter 的 bin 目录添加到你的 PATH 环境变量中。
- 运行
flutter doctor命令检查是否还需要安装其他依赖。 - Dart SDK 已包含在 Flutter SDK 中，无需单独安装。
- Melos 官方文档：https://melos.invertase.dev/getting-started
- 确保已安装 Dart SDK。
- 运行以下命令安装 Melos：
dart pub global activate melos - 将 Dart 的全局 bin 目录添加到 PATH 环境变量中。
- 运行
melos --version确认安装成功。
- Node.js 官方下载页面：https://nodejs.org/en/download/
- NVM 安装指南：https://github.com/nvm-sh/nvm#installing-and-updating
- 访问 Node.js 官方网站，下载适合你操作系统的安装包。
- 运行安装程序，按照提示完成安装。
- 安装完成后，打开终端运行
node --version和npm --version确认安装成功。
- 安装 NVM：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash - 重新加载终端配置或重启终端。
- 安装最新版 Node.js：
nvm install node - 使用已安装的 Node.js：
nvm use node - 验证安装：
node --version npm --version
使用 NVM 的优势在于可以方便地管理多个 Node.js 版本。
melos bootstrap
melos run prisma:generate:all
melos run prisma:migrate:dev:all
使用 vscode 打开项目，选择要运行的应用，然后按 F5 键运行。
cd packages/server
dart run --enable-vm-service server
TODO
TODO