homewx

家的管理 · 爱的时光

一站式家庭数字生活平台:记账、购物、任务、食谱、日历、瞬间、文件管理、家庭协作,一个平台管好一个家。

Spring Boot 4 Java 17 PostgreSQL 16 Vue 3 ArkTS Docker

功能全景

12 大模块,覆盖家庭生活的方方面面

🏠

首页驾驶舱

家庭数据一屏总览,收支、任务、日程尽收眼底。

💰

记账

多账本多账户,收支分类统计,图表清晰直观。

🔐

加密账本

私密小金库,后端硬隔离,只有你能看见。

🛒

购物清单

全家共享的购物清单,买了什么实时同步。

任务管理

家务分工、亲子任务,指派与提醒一站搞定。

🍳

餐饮计划

蜗牛小厨:食谱库 + 一周餐饮计划,不再纠结吃什么。

📅

日历

家庭日程、纪念日、账单日,统一视图不错过。

📸

瞬间

日记小窝,记录家庭生活的每一个闪光时刻。

📁

文件管理

家庭文件云端归档,证件、照片分类存放。

👨‍👩‍👧‍👦

家庭管理

成员邀请、角色分配,一家人各就其位。

🔔

通知

任务提醒、账单到期、家庭动态及时送达。

🛡️

认证安全 · 管理后台

sa-token 认证 + RBAC 权限,配套 Web 管理后台。

特色优势

为家庭而生,也为自部署而生

👨‍👩‍👧‍👦

真正的家庭协作

全表 household_id 数据隔离,邀请码一键加入,家人之间既共享又各有边界。

🔐

私密小金库

加密账本在后端做硬隔离,私密收支只有本人可见,家人也无法窥探。

🐳

NAS 一键部署

docker compose up -d 即可运行,1.5GB 内存起步;内嵌 PostgreSQL + Flyway 自动迁移 44 张表。

🌗

深浅双模式设计系统

暖橙家庭风设计体系,浅色 / 深色双主题,26 个页面统一语言。

🛡️

完整安全体系

sa-token 会话认证 + RSA 加密登录 + RBAC 四角色 35 项权限,家庭数据安全第一。

📱

多端规划

Web 管理端已就绪,鸿蒙 APP 已完成,iOS / Android 规划中,数据同源。

APP 开发进度

鸿蒙端先行,iOS / Android 规划中

📱

鸿蒙 HarmonyOS

ArkTS · Stage 模型 · API 12+

100%

26 个页面全部对齐设计稿,支持深色模式,已在 Mate 60 Pro 真机验证。

🖥️

Web 前端

Vue 3 · Element Plus

100%

管理后台与 Web 端功能完整,与后端接口全量联调通过。

🍎

iOS

规划中

0%

待开发,设计规范与接口已就绪。

🤖

Android

规划中

0%

待开发,设计规范与接口已就绪。

部署手册

三分钟,在自己家的 NAS 上跑起来

🐳 Docker 一键部署

terminal
# 克隆后端仓库(内含 docker-compose.yml)
git clone https://gitee.com/woniu12355/homewx-backend.git
cd homewx-backend

# 一键启动(内嵌 PostgreSQL,自动建库迁移)
docker compose up -d

# 访问 http://你的IP:8080
# 默认账号:admin / admin123

🗄️ NAS 部署要点

  • 极简模式:单容器内嵌数据库,约 1.5GB 内存即可流畅运行
  • 完整模式:前后端分离部署,数据库独立容器,适合长期使用
  • 数据持久化:数据卷挂载 ./data,升级不丢数据
  • HTTPS 反代:推荐使用 Caddy 或群晖自带反向代理
  • 版本升级:只需 docker compose pull && docker compose up -d

技术栈

主流而稳健的技术选型

☕ 后端

  • Spring Boot 4.0.6
  • Java 17
  • MyBatis-Flex
  • sa-token 认证
  • PostgreSQL 16
  • Flyway 迁移

🖥️ 前端

  • Vue 3
  • TypeScript
  • Element Plus
  • Pinia
  • Vite
  • PWA

📱 鸿蒙端

  • ArkTS
  • Stage 模型
  • API 12+
  • hvigor 构建

项目地址与开源共建

欢迎每一个热爱家庭与代码的你

🤝 参与共建

  • 通过 Issue 反馈问题或提出想法,通过 PR 贡献代码
  • 分支约定:master 为生产分支,feat/*fix/* 合入开发环境
  • CI/CD:Jenkins 流水线约 2 分钟自动完成构建与部署

如果这个项目对你有帮助,欢迎在 Gitee 上点亮一颗 ⭐ Star!