Skip to content
BranchesTags

Repository files navigation

Logo

养老机构运营北极星指标系统 Lite版

Nursing Home Operation North Star Metrics System (NHOM)

基于真实养老机构运营数据开发的运营分析系统，助力养老行业数字化管理

License: MIT Python 3.10+ Node.js 18+ FastAPI React

功能演示 • 快速开始 • 技术栈 • 文档 • 贡献

📸 功能演示

北极星指标看板

系统看板

北极星指标看板 - 实时展示核心经营指标

系统功能概览

功能模块 描述 状态
📊 北极星指标看板 核心指标可视化展示，支持趋势分析 ✅ 已完成
📝 数据录入 月度经营数据录入，支持表单验证 ✅ 已完成
🏢 机构管理 机构信息增删改查，支持分页 ✅ 已完成
🔐 用户认证 JWT登录认证，权限控制 ✅ 已完成
📱 移动端适配 响应式设计，支持手机/平板访问 ✅ 已完成

✨ 系统特点

  • 🎯 北极星指标体系：聚焦关键经营指标，包括财务健康度、运营效率、服务质量、人力效能四大维度
  • 📊 实时数据看板：多维度数据可视化展示，支持趋势分析和对比
  • 📱 移动端适配：响应式设计，支持手机、平板、桌面多端访问
  • 🔒 数据脱敏：原始数据已脱敏处理，保护敏感信息
  • 🚀 快速部署：支持Docker一键部署，也可手动部署

🛠️ 技术栈

后端

技术 版本 说明
Python 3.10+ 编程语言
FastAPI 0.109+ Web框架
SQLAlchemy 2.0+ ORM框架
SQLite - 数据库（可升级至PostgreSQL）
Uvicorn 0.27+ ASGI服务器
JWT - 用户认证

前端

技术 版本 说明
React 18+ UI框架
TypeScript 5.0+ 类型系统
Ant Design 5.12+ UI组件库
Tailwind CSS 3.4+ CSS框架
Recharts 2.10+ 图表库
Vite 5.0+ 构建工具

🚀 快速开始

环境要求

  • Python 3.10+
  • Node.js 18+
  • npm 9+ 或 yarn 1.22+

1. 克隆项目

git clone https://github.com/cnspica/NHOM.git
cd NHOM

2. 安装依赖

后端

cd backend
pip install -r requirements.txt

前端

cd frontend
npm install

3. 初始化数据库

cd backend
python init_db.py

这将创建数据库表、生成3个示范机构的12个月历史数据，以及默认用户账号。

4. 启动服务

方式一：使用启动脚本

# 启动后端（端口8888）
python start_backend.py

# 启动前端（端口3000）- 新开终端
python start_frontend.py

方式二：手动启动

# 后端
cd backend
uvicorn app.main:app --reload --host 0.0.0.0 --port 8888

# 前端 - 新开终端
cd frontend
npm run dev

5. 访问系统

6. 默认账号

角色 用户名 密码
管理员 admin admin123
普通用户 user user123

📖 文档

🎯 系统功能

1. 北极星指标看板

  • ⭐ 核心指标卡片展示（营业收入、利润率、入住率、满意率、人效、现金流）
  • 📈 指标趋势图表分析
  • 📊 分类指标汇总（财务、运营、服务、人力）

2. 数据录入

  • 📝 月度经营数据录入表单
  • 💰 财务指标：收入、成本、利润、现金流
  • 🏠 运营指标：床位数、入住情况、照护等级
  • 👥 人力指标：员工数、护理员数、人力成本
  • ❤️ 服务指标：满意率、服务完成率

3. 机构管理

  • 🏢 机构列表查看，支持分页
  • ➕ 新增机构信息
  • ✏️ 编辑机构信息
  • 🗑️ 删除机构（带确认弹窗）

4. 用户认证

  • 🔐 JWT Token认证
  • 👤 用户登录/登出
  • 🔒 路由权限控制

📊 示范数据

系统内置3个示范机构的数据：

机构编码 机构名称 类型 总床位数 建筑面积
INST-A 颐养苑 养老公寓 320 18,500㎡
INST-B 康乐居 养老机构 260 15,200㎡
INST-C 福寿园 养老机构 210 12,800㎡

数据已根据原始报告脱敏处理：

  • 机构名称使用代号
  • 时间偏移至2023年
  • 金额数据保持比例关系

🏗️ 项目结构

NHOM/
├── 📁 backend/                 # 后端服务
│   ├── 📁 app/
│   │   ├── 📁 models/         # 数据模型
│   │   ├── 📁 schemas/        # Pydantic模型
│   │   ├── 📁 routers/        # API路由
│   │   ├── 📁 services/       # 业务逻辑
│   │   └── 📁 utils/          # 工具函数
│   ├── 📄 init_db.py          # 数据库初始化
│   └── 📄 requirements.txt
├── 📁 frontend/                # 前端应用
│   ├── 📁 src/
│   │   ├── 📁 components/     # 组件
│   │   ├── 📁 pages/          # 页面
│   │   ├── 📁 hooks/          # 自定义Hooks
│   │   ├── 📁 services/       # API服务
│   │   └── 📁 types/          # TypeScript类型
│   └── 📄 package.json
├── 📁 docs/                    # 文档
│   └── 📁 screenshots/         # 截图
├── 📄 README.md                # 项目说明
├── 📄 LICENSE                  # 许可证
├── 📄 CHANGELOG.md             # 更新日志
├── 📄 CONTRIBUTING.md          # 贡献指南
├── 📄 CODE_OF_CONDUCT.md       # 行为准则
└── 📄 SECURITY.md              # 安全政策

🔌 API 接口

认证接口

方法 路径 说明
POST /api/v1/auth/login 用户登录
POST /api/v1/auth/register 用户注册
GET /api/v1/auth/me 获取当前用户信息

看板接口

方法 路径 说明
GET /api/v1/dashboard/summary 获取看板汇总数据
GET /api/v1/dashboard/trends 获取指标趋势
GET /api/v1/dashboard/comparison 获取多机构对比

机构接口

方法 路径 说明
GET /api/v1/institutions 获取机构列表
GET /api/v1/institutions/{id} 获取机构详情
POST /api/v1/institutions 创建机构
PUT /api/v1/institutions/{id} 更新机构
DELETE /api/v1/institutions/{id} 删除机构

详细API文档请查看：API文档

🗺️ 路线图

已实现 ✅

  • 系统架构设计
  • 后端API开发
  • 数据脱敏处理
  • 前端界面开发
  • 北极星指标看板
  • 数据录入模块
  • 机构管理增删改
  • 用户认证系统
  • 移动端适配
  • 系统集成测试

计划中 📋

  • 数据导入导出（Excel/CSV）
  • 报表自动生成（PDF）
  • 预警提醒功能
  • 多语言支持
  • 数据备份和恢复
  • 高级数据分析（同比/环比/预测）
  • 自定义指标配置

🤝 贡献

我们欢迎所有形式的贡献，包括但不限于：

  • 🐛 提交Bug报告
  • 💡 提出新功能建议
  • 📝 改进文档
  • 🔧 提交代码修复
  • ✨ 提交新功能

请查看 贡献指南 了解详细信息。

行为准则

本项目遵守 行为准则，参与项目即表示你同意遵守其条款。

📄 许可证

本项目采用 MIT 许可证开源。

MIT License

Copyright (c) 2026 海潮的碎碎念

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🙏 致谢

感谢所有为本项目做出贡献的开发者！

特别感谢：

📞 联系我们

⭐ 如果这个项目对您有帮助，请给我们一个Star！

Made with ❤️ by 海潮的碎碎念

About

养老机构运营北极星指标系统 lite版

Resources

Readme
MIT license

Security policy

Security policy
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages