Skip to content

BeeThor/ContactsManager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 智能员工管理系统

一款基于 Wails v2 构建的现代化员工信息管理平台,集成了完善的人员信息管理功能,支持员工档案管理、数据分析统计、智能备份恢复等特性,为用户提供高效、安全、易用的人事管理解决方案。

集成 AI 智能助手 | 数据可视化分析 | 现代化 UI 设计

Go Svelte TypeScript Wails TailwindCSS SQLite

License: MIT Platform


✨ 项目亮点

🤖 AI 智能助手

智能对话与问数分析
DeepSeek | Qwen 等标准openAPI

👥 员工信息管理

完整的 CRUD 操作
头像上传与管理
批量导入导出 | 高级搜索

📊 数据可视化分析

团队效率分析
人员分布统计
实时图表 | 智能报表

📱 界面预览

1. 密码登录界面

密码登录界面 安全的用户认证系统,支持密码登录

2. 快捷登录界面

快捷登录界面 便捷的快速登录功能,提升用户体验

3-1. 员工管理主界面

员工管理界面 现代化的员工信息管理界面,支持实时搜索和筛选

3-2. 员工管理 - 添加员工

添加员工界面 直观的员工信息添加界面,支持头像上传和完整的信息管理

4. 数据分析仪表板

数据分析界面 直观的数据可视化图表,实时展示团队效率和人员分布

5-1. 系统设置 - 系统偏好

系统偏好设置 个性化的系统设置和偏好配置

5-2. 系统设置 - 备份设置

备份设置 数据备份和恢复功能配置

5-3. 系统设置 - AI设置

AI设置 完善的AI模型配置管理,支持多种AI模型设置

5-4. 系统设置 - 关于系统

关于系统 系统版本信息和应用详情

6-1. 个人资料 - 基本信息

个人信息管理 完善的个人信息管理,支持头像上传和基本信息编辑

6-2. 个人资料 - 安全设置

安全设置 密码修改和安全设置管理

6-3. 个人资料 - 活动记录

活动记录 详细的用户操作记录和活动日志追踪

7-1. AI 智能对话

AI智能对话 集成多种AI模型的智能对话助手,支持工作咨询和数据分析

7-2. AI 智能问数工具

AI智能问数工具 基于数据库的智能数据查询和分析工具,提供实时的员工统计和业务洞察

🌟 核心特性

👥 员工信息管理

  • 🔍 智能搜索: 支持姓名、部门、岗位、联系方式的模糊匹配搜索
  • 📋 高级筛选: 按团队、状态、用工类型、入职日期范围进行精确筛选
  • 🖼️ 头像管理: 支持 JPG/PNG/GIF/BMP 格式图片上传,Base64安全存储
  • 📤 批量操作: CSV批量导入、Excel导出、批量状态更新、批量删除
  • ✅ 数据验证: 完整的表单验证和数据格式检查

🤖 AI 智能助手

  • 🎯 多模型支持: 支持对接 DeepSeek、ChatGPT、Qwen 等主流openAPI模型
  • 💬 智能对话: 自然语言交互,支持工作咨询、数据查询、业务分析
  • 📊 智能问数工具: 基于实时数据库的智能数据分析,提供员工统计、业务洞察和数据可视化
    • 🔍 实时数据查询: 直接连接数据库,提供最新的员工统计信息
    • 📈 智能数据分析: 自动生成部门分布、职位统计、入职趋势等业务报表
    • 🎯 精准数据问答: 支持自然语言查询员工信息,如"张三有几个重复记录"
    • 📋 完整信息上下文: AI可访问完整员工列表进行深度分析和对比
  • 🔧 模型配置: 灵活的API配置管理,支持自定义模型参数和图标
  • 📈 使用统计: 详细的AI调用统计和性能分析,支持连通性测试和聊天统计
  • 🔄 会话管理: 多会话支持,历史对话保存和管理,支持工具模式切换

🔧 AI智能问数工具详解

系统独有的智能问数工具是一个革命性的数据分析功能,将AI的自然语言处理能力与实时数据库查询完美结合:

🎯 工具特色

  • 🗂️ 上下文感知: 自动加载完整员工数据库作为AI对话上下文
  • 🔄 实时数据: 每次启动问数工具都会加载最新的数据库状态
  • 💡 智能理解: 支持自然语言描述的复杂查询需求
  • 📊 统计分析: 自动计算并提供各种维度的统计分析

📋 数据覆盖范围

✅ 员工基本信息 (姓名、部门、职位、联系方式)
✅ 员工状态统计 (在职、离职、试用期等)
✅ 部门分布分析 (各部门人员数量和比例)
✅ 职位统计报告 (岗位分布和层级分析)
✅ 用工类型分析 (合同制、劳务、实习生等)
✅ 入职趋势分析 (月度、季度入职数据)
✅ 联系信息完整性 (邮箱、电话覆盖率)

🚀 使用场景示例

  • 数据查重: "帮我查找是否有重复的员工记录"
  • 部门分析: "分析各部门的人员配置情况"
  • 趋势预测: "最近3个月的入职趋势如何?"
  • 合规检查: "有哪些员工的联系信息不完整?"
  • 报表生成: "生成一份完整的人员结构分析报告"

🔍 技术实现亮点

  • 智能上下文注入: 问数模式下AI自动获得完整数据库上下文
  • 实时数据加载: 每次对话开始时自动调用 GetEmployeeStatistics() API
  • 结构化数据格式: 员工数据以标准化JSON格式提供给AI
  • 会话隔离: 工具模式与普通对话模式完全隔离,确保数据安全

📊 数据分析可视化

  • 📈 实时统计: 员工总数、团队分布、在职率等关键指标实时展示
  • 🏆 效率排行: 基于在职率的团队效率排行榜,直观展示团队表现
  • 🎨 可视化图表: 环形图、柱状图、进度条等多种图表类型
  • 🔄 动态更新: 数据变更时图表自动刷新,保持信息同步
  • 📋 分类统计: 按用工类型、部门、状态等维度进行详细分析

🔐 用户认证与安全

  • 🛡️ 安全登录: BCrypt密码加密,会话令牌管理
  • 👤 用户管理: 个人信息管理,头像上传,密码修改
  • ⚙️ 权限控制: 基于角色的访问控制,确保数据安全
  • 📝 活动记录: 用户操作日志记录,支持审计追踪
  • 💾 本地存储: SQLite本地数据库,数据完全掌控

🏗️ 技术架构

🛠️ 技术栈

🔧 后端技术

  • Go 核心业务逻辑
  • SQLite 本地数据存储
  • Wails 桌面应用框架

🎨 前端技术

  • Svelte 响应式UI框架
  • TypeScript 类型安全开发
  • Tailwind 现代化样式
  • Vite 高效构建工具

🚀 快速开始

📋 环境要求

环境 版本要求 说明
Go 1.21+ 后端开发环境
Node.js 18+ 前端构建环境
Wails v2 桌面应用构建工具

⚡ 安装与运行

# 1. 克隆项目
git clone https://github.com/BeeThor/ContactsManager.git
cd ContactsManager

# 2. 安装 Wails CLI (如果还未安装)
go install github.com/wailsapp/wails/v2/cmd/wails@latest

# 3. 安装前端依赖
cd frontend
npm install
cd ..

# 4. 开发模式运行
wails dev

# 5. 构建生产版本
wails build

🎯 快速体验

  1. 首次运行: 应用启动后会自动创建数据库并初始化管理员账户
  2. 默认账户: username: admin / password: admin123
  3. AI功能: 在设置页面配置AI API密钥即可体验智能助手功能

📁 项目结构

ContactsManager/
├── 📄 app.go                    # 🔧 后端核心业务逻辑
├── 📄 main.go                   # 🚀 应用程序入口点
├── 📄 go.mod                    # 📦 Go模块依赖管理
├── 📄 wails.json                # ⚙️ Wails框架配置文件
│
├── 📁 frontend/                 # 🎨 前端代码目录
│   ├── 📁 src/
│   │   ├── 📄 App.svelte        # 🏠 主应用组件
│   │   ├── 📄 main.ts           # 🎯 前端应用入口
│   │   ├── 📁 components/       # 🧩 可复用UI组件
│   │   │   ├── 📄 EmployeeTable.svelte     # 👥 员工信息表格
│   │   │   ├── 📄 EmployeeForm.svelte      # 📝 员工信息表单
│   │   │   ├── 📄 AIChatDialog.svelte      # 🤖 AI聊天对话框
│   │   │   ├── 📄 Navigation.svelte        # 🧭 导航栏组件
│   │   │   └── 📄 ...                      # 其他UI组件
│   │   ├── 📁 pages/            # 📊 主要页面组件
│   │   │   ├── 📄 Employees.svelte         # 👥 员工管理页面
│   │   │   ├── 📄 Analytics.svelte         # 📈 数据分析页面
│   │   │   ├── 📄 Settings.svelte          # ⚙️ 系统设置页面
│   │   │   └── 📄 Profile.svelte           # 👤 个人中心页面
│   │   ├── 📁 utils/            # 🛠️ 工具函数库
│   │   └── 📁 assets/           # 🖼️ 静态资源文件
│   ├── 📄 package.json          # 📦 前端依赖配置
│   ├── 📄 vite.config.js        # ⚡ Vite构建配置
│   ├── 📄 tailwind.config.js    # 🎨 Tailwind CSS配置
│   └── 📄 tsconfig.json         # 📘 TypeScript编译配置
│
└── 📁 build/                    # 🏗️ 构建输出目录
    └── 📁 bin/                  # 📦 可执行文件
        └── 📱 ContactsManager.app  # 🍎 macOS应用包

🛠️ 开发指南

🔧 开发环境搭建

# 1. 克隆并进入项目目录
git clone https://github.com/BeeThor/ContactsManager.git
cd ContactsManager

# 2. 安装Wails CLI
go install github.com/wailsapp/wails/v2/cmd/wails@latest

# 3. 验证环境
wails doctor

# 4. 安装依赖并启动开发服务器
wails dev

🐛 调试方法

  • 后端调试: 使用Go的标准调试工具,在VS Code中设置断点
  • 前端调试: 在开发模式下打开浏览器开发者工具
  • 日志查看: 检查终端输出和应用内置的日志功能

📦 构建部署

# 开发构建(包含调试信息)
wails build -debug

# 生产构建(优化版本)
wails build

# 跨平台构建
wails build -platform darwin/amd64    # macOS Intel
wails build -platform darwin/arm64    # macOS Apple Silicon  
wails build -platform windows/amd64   # Windows 64位
wails build -platform linux/amd64     # Linux 64位

📄 许可证与致谢

📜 开源许可证

MIT License

Copyright (c) 2024 BeeThor

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.

MIT License

🙏 技术致谢

感谢以下优秀的开源项目:

  • Wails - 强大的Go桌面应用框架
  • Svelte - 现代化的前端框架
  • Tailwind CSS - 实用优先的CSS框架
  • SQLite - 轻量级数据库引擎
  • Vite - 极速的前端构建工具

📧 联系方式


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

Made with ❤️ by BeeThor

About

一款基于 Wails v2 构建的现代化员工信息管理平台,集成了完善的人员信息管理功能,支持员工档案管理、数据分析统计、智能备份恢复等特性,为用户提供高效、安全、易用的人事管理解决方案。

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors