# old_husky

**Repository Path**: readceo/old_husky

## Basic Information

- **Project Name**: old_husky
- **Description**: 用来进行可视化分析和管理AD域服务器，并对接企业微信的平台
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/RandolphCYG/old_husky
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 5
- **Created**: 2023-09-20
- **Last Updated**: 2023-09-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

@[TOC](husky架构&安装步骤&开发规划&演示)
![在这里插入图片描述](https://img-blog.csdnimg.cn/cover1/248658033621860363.jpg)

# 1. 架构说明
1. 主要工具

| 工具 | 版本 | 说明 |
|--|--|--|
| python | 3.6 | windows [python3.6.8](https://www.python.org/ftp/python/3.6.8/python-3.6.8-amd64.exe) // MAC [python3.6.12](https://www.python.org/downloads/release/python-3612/) |
| [django](https://www.djangoproject.com/download/) | 2.2.15 |  web后端框架 |
| [react](https://react.docschina.org/docs/getting-started.html) | 16.13.1 |  前端框架(spa应用) |
| [ant design pro](https://pro.ant.design/index-cn) | v5 | 组件式ui库(阿里) |
| echarts | 4.8.0 | 9月份将发布5.0版本 |
| mysql | 5.7 | 数据持久化 |
| redis | 3.2.100 | [数据库、缓存和消息中间件](http://www.redis.cn/) ； 用来作为celery的消息队列，替代rabbitMQ |
| [celery](http://docs.jinkan.org/docs/celery/) | 4.4.7 | 分布式任务队列，提供异步和定时任务支持 在django配置好celery后生成数据库表 `python manage.py migrate django_celery_results`  |
| eventlet | 0.28.0 | 对celery的并发支持补充(husky_back目录下) `celery -A husky worker -l info -P eventlet -E` 异步任务 |
| django-celery-beat | 2.0.0 | celery的定时/周期任务支持(husky_back目录下) `celery -A husky beat -l info` |
| flower | 0.9.5 | 对celery任务进行监控 运行命令(husky_back目录下)`celery flower -A husky`管理地址`http://127.0.0.1:5555/` |
| [ldap3](https://ldap3.readthedocs.io/en/latest/) | 2.8.1 | 用来管理LDAP服务器 |

2. 辅助工具

| 辅助工具 | 版本 | 说明 |
|--|--|--|
|npm|6.14.7|最新版本|
|pip|20.2.1|安装python包|
|pipenv|2020.6.2|python虚拟环境版本管理|

`注意1`——celery需要配python3.6，因为高版本的python中异步`aync`关键词会和celery中的`kombu`库中的定义的变量冲突！
`注意2`——celery在windows中应该由`eventlet`处理异步并发任务

`部署中在centos中需要注意python3.6.12，然后celery不需要eventlet也可以支持异步并发`

3. 项目仓库

[husky](https://gitee.com/RandolphCYG/husky)
master分支保留全部代码、feature-ad分支只保留AD域相关内容，新开分支feature-visual分支只保留可视化内容，后续考虑在样式等方面不同分支也不同；

# 2. 安装步骤
## 2.1. 配置python环境并运行Django项目(通识)
1. 安装[python3.8.5](https://www.python.org/downloads/release/python-385/)
安装很简单，参考[python3.8 下载安装 | pip 配置国内源 | python各种工具介绍](https://blog.csdn.net/qq_33997198/article/details/107420579)下载安装python部分，注意`勾选将python加到环境变量`中

2. 安装配置全局django环境：
`cmd`中执行
	
	```python
	# 安装指定版本django框架 若没有为pip配置全局的国内源可选择带-i http://pypi.douban.com/simple --trusted-host pypi.douban.com参数
	pip install django==2.2.15 -i http://pypi.douban.com/simple --trusted-host pypi.douban.com
	```
3. 跑项目用全局python环境
vscode跑django项目可参考
[【Youtobe trydjango】Django2.2教程和React实战系列一【项目简介 | 搭建 | 工具】](https://blog.csdn.net/qq_33997198/article/details/103972513)最后一节
## 2.2. 安装前配置好后端mysql、redis

```python
# 拉项目源码
git clone git@gitee.com:RandolphCYG/husky.git
# 打开一个终端,进入后端项目 husky_back
cd husky_back
# 执行数据库迁移语句
python manage.py makemigrations
python manage.py migrate
# 创建超级用户
python manage.py createsuperuser
# 然后会让你输入邮箱(可不输入)、密码(admin即可、强制同意)

# 修改django配置文件 ...\husky\husky_back\husky\settings.py
'default': {
    'ENGINE': 'django.db.backends.mysql',   # 数据库引擎
    'NAME': 'husky',                        # 数据库名
    'USER': 'root',                         # 用户名
    'PASSWORD': 'adqwe123',                 # 密码
    'HOST': '127.0.0.1',                    # mysql服务主机ip
    'PORT': '3306',                         # mysql服务端口
    },
    
# redis缓存服务器 ...\husky\husky_back\husky\settings.py
CACHES = {
    # 默认缓存库
    "default": {
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://127.0.0.1:6379/0",
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
            # "PASSWORD": "V%xw1xZqDK",   # 密码
        }
    },
    # 配置信息缓存库
    "configs_cache": {
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://127.0.0.1:6379/1",
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
            # "PASSWORD": "V%xw1xZqDK",   # 密码
        }
    },
    # AD域账号信息缓存库
    "ad_accounts_cache": {
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": "redis://127.0.0.1:6379/2",
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
            # "PASSWORD": "V%xw1xZqDK",   # 密码
        }
    }
}
# 然后就可以启动后端项目了

```

## 2.3. 启动前后端项目
```python
# 打开一个终端,进入后端项目 husky_back
cd husky_back
# 启动后端django项目
python manage.py runserver

# 新打开一个终端,进入前端项目 husky_front 
cd husky_front
# 下载依赖 
yarn
# 不使用mock数据启动前端项目
yarn run start:no-mock
# 从前端项目进入网页即可
```
# 3. 开发规划
 - 正在开发优化的功能
`可视化`一方面需要向上交流，另一方方面需要准备好前端的流程设计；
`企业微信`对接，需要将之前开发过的weworkapi的代码融入使用下；

 - 待开发功能
 - [ ] 用户的批量管理逻辑(提供表格模板下载填写、上传、执行)【优先级很低】
 - [ ] 企业微信api接入——企业微信成员加入时候填写信息，将信息与现在的AD域账户的管理模块接通，然后再通过此中枢平台的后端对接其他平台，完成其他平台账号的统一创建和管理
 - 已完成功能
 - [x] django后端restful接口改造【因为没有新增django model 因此并未使用】
 - [x] AD域账户管理模块——异步任务前端后端一致(勿让用户等待)
 - [x] 用户登录(LDAP)登出
`详情`LDAP和普通方式均可登录，但是需要先配置好AD域账号方可使用AD域管理相关功能
 - [x] AD域账账号查询
 `详情`将AD域的连接配置和大量的账号信息存储在redis中，当对AD域增改时才从AD服务器建立连接更新redis一次，尽可能地减少读取AD服务器的次数
AD域模块和消息通知配置存到redis；
`细节`每次读取AD账号列表时，先从redis去读，没有数据才去AD服务器去查，此时尽量所有用户所有字段都能取得到。
 - [x] AD域账号单个创建【异步】
 - [x] AD域账号创建完成邮件通知【异步】
`bug`发邮件还有一个小bug，发件人、收件人乱码(已经写了utf8)，配置成公司的邮件服务器会爆出这个bug，用腾讯邮箱没问题；
 - [x] AD域服务器配置
配置会报存在redis，目前设置的作用字段之后还可以再优化；
 - [x] 邮件服务器配置
 - [x] bug可视化前端echarts接入(前端阶段)
 - [x] `LDAP账户`支持分页、模糊查询、时间段框选；

# 4. 功能演示
 - 登录(LDAP)
![在这里插入图片描述](https://img-blog.csdnimg.cn/20201006220602300.png)
 - 首页(可以换成更需要表达的组件)
![在这里插入图片描述](https://img-blog.csdnimg.cn/20201013180914526.png)

 - 配置中心——用户账户设置

 - [ ] 支持用户个人邮箱手机号和密码的修改

![在这里插入图片描述](https://img-blog.csdnimg.cn/20201008102922903.png)
 - 配置中心——AD域服务器配置
![在这里插入图片描述](https://img-blog.csdnimg.cn/20201008102444455.png)

 - 配置中心——邮件服务器配置
![在这里插入图片描述](https://img-blog.csdnimg.cn/202010081023139.png)


 - AD域管理——AD域账户
![在这里插入图片描述](https://img-blog.csdnimg.cn/20201013181109276.png)

 - [x] 支持账号/姓名/部门字段的模糊查询
 - [x] 支持异步任务手工创建账号
 - [ ]  支持子公司员工从母公司HR系统定时同步(配有手动同步按钮)
 - [ ] 支持从母公司HR系统穿梭框选择母公司架构员工到LDAP服务器创建账号
 - [ ] 穿梭框支持搜索表格
 - [x] 支持管理员可修改用户密码
 - [ ] 支持对架构改动的同事进行LDAP架构上的同步变动
 - [ ] 支持将离职用户禁用状态(暂时搜索不到禁用用户，搜索范围不包含此部分)
 - [ ] 支持显示用户状态 


模态框嵌套穿梭框嵌套搜索表格(前端mock完成)
![在这里插入图片描述](https://img-blog.csdnimg.cn/20201009212602333.png)

6. AD域管理——AD域服务器(留空待做)
 - [ ] 支持树形显示LDAP的OU架构
 - [ ] 支持在树上对OU架构进行调整修改
 - [ ] 考虑用户和组织单位的策略的修改

![在这里插入图片描述](https://img-blog.csdnimg.cn/20201006221303792.png)
7. bug可视化(前端暂)
 - [ ] 支持对数据的多级可视化展示和查询、根据框选数据生成可视化图表

![在这里插入图片描述](https://img-blog.csdnimg.cn/20200927105652438.png)
8. 可视化图表(待完善)
![在这里插入图片描述](https://img-blog.csdnimg.cn/20200927105733688.png)
![在这里插入图片描述](https://img-blog.csdnimg.cn/20200927105806718.png)

# 常见报错处理
## 1. Ran out of input
celery的beat运行不起来报错时，需要删除不一致`husky_back`中的`celerybeat-schedule`几个文件；


# 参考文章

 1. [Django项目使用Celery](https://zhuanlan.zhihu.com/p/162039762)