📚 Flutter Web Admin 后台管理系统

基于 Serverpod + Flutter + PostgreSQL + Redis 构建的全栈后台管理系统

---

🌐 在线演示

演示地址： http://103.215.82.63:18000/

---

📸 系统截图

加载页面	首页 - 展开侧边栏
首页 - 收起侧边栏	API 测试 & 主题配置
按钮组件展示	消息通知组件
GiTag 标签组件	GiSpace 间距组件
GiIconBox 图标盒子	GiDot 圆点组件
GiIconSelector 图标选择器	GiTable 数据表格

---

📖 项目简介

这是一个现代化的全栈后台管理系统，采用 Serverpod 作为后端框架，Flutter Web 作为前端，PostgreSQL 作为主数据库，Redis 作为缓存层。项目使用 Monorepo 架构进行管理，通过 Melos 工具实现多包协同开发。

✨ 核心特性

• 🚀 高性能后端：基于 Serverpod 框架，提供 RESTful API 和实时通信能力
• 💎 现代化前端：使用 Flutter Web 构建响应式管理界面
• 🗄️ 强大的数据层：PostgreSQL 关系型数据库 + Redis 缓存
• 📦 Monorepo 架构：使用 Melos 管理多个相关包
• 🔄 类型安全：前后端共享数据模型，自动生成客户端代码
• 🐳 容器化部署：支持 Docker 和 Docker Compose 一键部署
• 🔐 安全可靠：完善的身份认证和权限管理系统

---

🚀 快速开始

1. 安装 Flutter 版本管理工具

fvm install

2. 安装项目依赖

melos bootstrap

3. 配置环境变量

进入 flutter_web_server 目录，在 env 目录下创建以下环境配置文件：

cd flutter_web_server

创建 .env.development 文件

# 数据库配置
POSTGRES_DB=flutter_web_admin
POSTGRES_USER=postgres
POSTGRES_PASSWORD=zofw6sPp0LEIOdXhztHQUmci8v9WgILN

# Redis配置
REDIS_PASSWORD=sK2WZqakWyrbjsQHBLlkqXMjCh1mXHa8 

# 服务密钥
SERVICE_SECRET=IYynD5iR2VZTRTeKXysY7wNPVftFrhRg

创建 .env.test 文件

# 数据库配置
POSTGRES_DB=flutter_web_admin_test
POSTGRES_USER=postgres
POSTGRES_PASSWORD=YCRfegJqtCpeNEaxJJCobIB9R-3ZkdCX

# Redis配置
REDIS_PASSWORD=o2rE1Sg0O4kPx62nedGmnrvb5tyZmLE8

创建 .env.production 文件

# 项目根目录
PROJECT_ROOT="~/workspace/flutter_web_admin/flutter_web_server"

# 应用配置
PORT="8080"
DOMAIN="api.admin.com"
VERSION="1.0.0"
CPU_LIMIT="0.50"
MEMORY_LIMIT="512M"
CPU_RESERVATION="0.25"
MEMORY_RESERVATION="256M"

# 健康检查配置
HEALTH_CHECK_URL="http://localhost:8080/health"
HEALTH_CHECK_RETRIES="30"
HEALTH_CHECK_INTERVAL="10"

# 数据库配置
POSTGRES_DB=flutter_web_admin
POSTGRES_USER=postgres
POSTGRES_PASSWORD=1MbAoaiEuZDntm_SFmVtqCDKERXsw3g_

# Redis配置
REDIS_PASSWORD=sK2WZqakWyrbjsQHBLlkqXMjCh1mXHa8

# 服务密钥
SERVICE_SECRET=i-3veRkAnJxBiTGfYvllMJJ6MJa8y2k9

4. 启动服务

在 flutter_web_server 目录下执行启动脚本：

./start.sh

后端服务将运行在 http://localhost:8080

5. 启动前端应用（可选）

cd flutter_web_admin
flutter run -d chrome

前端应用将在浏览器中打开

数据库模型

本项目使用 Serverpod 的 ORM 系统进行数据库建模：

• 数据库模型文档
• 数据库关系文档

生成客户端代码

当修改了服务端模型后，需要重新生成客户端代码：

cd flutter_web_server
serverpod generate

---

📝 文档

• Serverpod 官方文档
• Flutter 官方文档
• 项目开发进度
• 系统管理实现说明
• Serverpod 版本管理

---

🤝 参与贡献

欢迎贡献代码、报告问题或提出建议！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 提交 Pull Request

---

📄 许可证

请查看 LICENSE 文件了解详情

---

📧 联系方式

如有问题或建议，欢迎通过以下方式联系：

• 📮 提交 Issue
• 💬 添加微信：扫描下方二维码，直接与作者一对一沟通

扫一扫上面的二维码图案，加我为朋友

---

Made with ❤️ by coderxslee