<div align="center">
<br/>
<br/>
  <h1 align="center">
    资产全生命周期管理EAM
  </h1>
  <h4 align="center">
    基于Tornado的MVC管理后台，<a href="https://assets.tornadoadmin.cn/">演示地址</a> 
  </h4>
</div>

#### 项目简介

**易点易动**是国内领先的企业资产管理SaaS平台（EAM)，公司以自研的固定资产PaaS平台为核心，致力于为各行业客户提供智能、灵活的固定资产和设备解决方案。

通过易点易动的在线帮助可以让用户快速了解如何使用系统，并指导用户设置基础数据，管理固定资产、设备、库存、采购，以及财务折旧和处置。 在易点易动EAM系统中，实物资产管理分为两种模式：

**固定资产/设备管理：** 是指实物资产，按单品管理，每一个都是独立管理的，比如电脑等设备；
**库存管理：** 是指实物资产按品类管理的，每个品类中个体没有差异的，比如打印纸，硒鼓等。
系统包括多个客户端版本：

网页端（通过浏览器、企业微信、飞书、钉钉使用）
- 桌面端
- iOS APP
- Android APP
- 员工端（通过浏览器、企业微信、飞书、微信小程序和钉钉登录使用）

用户可以使用同一个账号登陆不同的客户端，数据互通。**其中，员工端由普通员工使用，其他客户端由管理员使用。**

系统通过对资产设置唯一的资产编码（标签）进行管理，通过PC端打印资产标签，粘贴到设备上，通过Android和iOS端进行日常管理（入库、领用、退库、借用、盘点、巡检点检、维修、保养等）。

对于第一次使用易点固定资产云系统，根据使用的模块，建议按如下顺序进行初始化：

1. **系统管理** → 组织架构 → 员工档案 → 系统角色 → 系统用户 → 表单和流程配置
2. **资产管理** → 相关设置 → 资产入库 → 日常管理（领用、调拨、变更、盘点等）
3. **设备管理**（巡检点检、设备维修、工单管理、设备保养等）
4. **库存管理** → 相关设置 → 日常管理（入库、出库、调拨、盘点等）
5. **软件管理** → 相关设置 → 日常管理（软件登记、分发、维保、变更等）
6. **采购管理**（采购申请、订单、收货、付款等）
7. **财务管理**（折旧、处置等）

>Tornado Admin 基于 python框架 Tornado + Layui 开发的后台管理系统，基于本系统即可快速构建你的功能业务
>
>项目旨在为python开发者提供一个后台管理系统的模板，成为您构建信息管理系统，物联网后台....等等应用时灵活，简单的工具
>
> gii_model 可用于快速反向生成model
> 
> gii_crud 快速生成 增删改查前后端代码, 简单调整下, 即可使用

####  内置功能

- [x] 用户管理：用户是系统操作者，该功能主要完成系统用户配置。
- [x] 权限管理：配置系统菜单，操作权限，按钮权限标识等。
- [x] 角色管理：角色菜单权限分配。
- [x] 操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
- [x] 登录日志：系统登录日志记录查询包含登录异常。
- [x] 服务监控：监视当前系统CPU、内存、磁盘、python版本,运行时长等相关信息。
- [x] 文件上传:   图片上传示例
- [ ] 定时任务:   简单的定时任务
- [x] 代码生成:   根据表生成model, 根据表生成增删改查后端代码和前台页面
- [x] JWT认证:   支持JWT认证

####  项目结构

```
Tornado Admin
├─common  # 公共类
│  ├─ __init__.py  # 项目启动时, 初始化数据库连接
│  ├─ ApsChedulerHelper.py  # 定时任务类
│  ├─ DbHelper.py  # 数据库连接公共类
│  └─ HttpHelper.py  # Http请求公共类
├─config  # 配置文件
│  └─ __init__.py
├─docker_data
├─docs  # 文档
├─handler  # 控制器层
│  ├─ __init__.py
│  ├─ IndexHandler.py  # 前台首页
│  ├─ HomeHandler.py   # 后台首页
│  ├─ AuthHandler.py   # 前台登录相关
│  ├─ BaseHandler.py   # 公共类
│  ├─ DeptHandler.py   # 部门管理
│  ├─ DictHandler.py   # 字典管理
│  ├─ FileHandler.py   # 文件管理
│  ├─ LogHandler.py    # 日志管理
│  ├─ MonitorHandler.py  # 监控管理
│  ├─ PowerHandler.py  # 权限管理
│  ├─ RoleHandler.py   # 角色管理
│  ├─ TaskHandler.py   # 任务管理
│  └─ UserHandler.py   # 用户管理
├─models
├─static  # 静态文件
├─templates  # 模板
├─app.py  # 主入口
├─docker-compose.yml
├─Dockerfile
├─README.md
├─requirements.txt
└─start.sh
```

#### 本地开发环境搭建

```bash
基础环境: python>=3.6 mysql>=5.6
示例: 使用conda 创建虚拟环境
# conda create -n <自定义名称> python=3.6
conda create -n asset36 python=3.6

# 下 载
git clone https://gitee.com/meadhu/asset-management.git
# 安 装
pip install -r requirements.txt -i https://pypi.douban.com/simple
# 修改数据库连接信息 【不需要提前创建数据库, 在第一次运行时会自动创建并导入初始化数据】
config/__init__.py
# 执行命令启动项目 【项目第一次启动, 会自动创建数据库, 并导入初始化数据】
python run.py
# 访问  默认后台账号密码  admin  admin
http://127.0.0.1:3001/
```

#### 线上docker部署
```shell
# 下 载
git clone https://gitee.com/meadhu/asset-management.git
# 进入项目目录
cd asset-management
# docker compose 构建项目镜像
docker-compose build
# docker-compose 运行项目
docker-compose up -d
# 访问
http://<线上IP>:3001/
```

#### 命令行工具

```bash
# 通过表名, 反向生成Model
python app.py gen_model <表名>
# 通过表名，生成CRUD页面和功能（前提是已经生成了Model）
python app.py gen_crud <表名>
# 在 /app.py 中, 添加路由
```

#### 代码生成示例
```shell
# 1. 创建表
DROP TABLE IF EXISTS `admin_project`;
CREATE TABLE `admin_project`  (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT 'ID',
  `name` varchar(255) CHARACTER SET utf8 COLLATE utf8_unicode_ci NULL DEFAULT NULL COMMENT '项目名称',
  `code` varchar(255) CHARACTER SET utf8 COLLATE utf8_unicode_ci NULL DEFAULT NULL COMMENT '项目标识',
  `remark` varchar(255) CHARACTER SET utf8 COLLATE utf8_unicode_ci NULL DEFAULT NULL COMMENT '备注',
  `details` varchar(255) CHARACTER SET utf8 COLLATE utf8_unicode_ci NULL DEFAULT NULL COMMENT '详情',
  `sort` int(11) NULL DEFAULT NULL COMMENT '排序',
  `create_at` datetime(0) NULL DEFAULT NULL COMMENT '创建时间',
  `update_at` datetime(0) NULL DEFAULT NULL COMMENT '更新时间',
  `enable` int(11) NULL DEFAULT NULL COMMENT '是否启用',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 1 CHARACTER SET = utf8 COLLATE = utf8_unicode_ci ROW_FORMAT = DYNAMIC;
INSERT INTO `admin_project` VALUES (1, '示例项目一', 'proj_code_1', '这是示例项目一的备注信息', '这是示例项目一的详情信息', 10, NULL, NULL, 1);
INSERT INTO `admin_project` VALUES (2, '示例项目2', 'proj_code_2', '这是示例项目2的备注信息', '这是示例项目2的详情信息', 20, NULL, NULL, 1);
INSERT INTO `admin_project` VALUES (3, '示例项目3', 'proj_code_3', '这是示例项目3的备注信息', '这是示例项目3的详情信息', 30, NULL, NULL, 0);
SELECT * from `admin_project` ORDER BY id DESC LIMIT 10;
```

```shell
# 2. 生成 model
python app.py gen_model admin_project
```

```shell
# 3. 生成 后端功能和前端页面
python app.py gen_crud admin_project
```

```shell
# 4. 修改 app.py 中，路由配置
```
<div align="center">
  <img  width="100%" style="border-radius:10px;margin-top:20px;margin-bottom:20px;box-shadow: 2px 0 6px gray;" src="docs/gii/demo12.png" />
</div>

```shell
# 5. 启动项目，访问 http://localhost:3001/admin/project/main
```
<div align="center">
  <img  width="100%" style="border-radius:10px;margin-top:20px;margin-bottom:20px;box-shadow: 2px 0 6px gray;" src="docs/gii/demo16.png" />
</div>

#### 预览项目

```shell
# 分页代码  https://github.com/wizeline/sqlalchemy-pagination
from sqlalchemy_pagination import paginate
page = paginate(session.query(User), 1, 25)
# The pagination objects has the following attributes
#items: The items of the current page base on the query
#total: Total number of items
#pages: Total number of pages
#has_next: Boolean indication wether there are more pages to fetch
#has_previous: Boolean indicating wether there are previous pages
#next_page: Next page number or None if the current page is the last one
#previous_page: Previous page number or None if the current page is the last one
```

#### JWT认证 使用
```shell
# 添加 verify_token 参数值为 True, 示例在 handler/UserHandler.py def data()
@authorize("admin:user:main", log=False, verify_token=True)

# 请求示例
curl --location --request GET 'http://localhost:3001/admin/user/data?page=1&limit=10' \
--header 'Authorization: Bearer eyJ0eXAiOiJqd3QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VybmFtZSI6ImFkbWluIiwiZXhwIjoxNjUzNjU2NjI2fQ.h2WryWa_6jcdEtUtRZM1kEUDNTUif8b5pcb_ZBMgGQ4' 
```

### SQLAlchemy
```
emp = session.query(Employee).filter_by(EMP_ID='1001').first()
emp = session.query(Employee).filter(Employee.EMP_ID == '1001').first()
emps = session.query(Employee).filter(Employee.EMP_ID.like('%9')).all()
emps = session.query(Employee).filter(Employee.MARITAL_STAT == None).all()
emps = session.query(Employee).filter(Employee.EDUCATION.in_(['Bachelor', 'Master'])).all()
emps = session.query(Employee).filter(Employee.GENDER=='Female', Employee.EDUCATION=='Bachelor').all()
emps = session.query(Employee).filter(and_(Employee.GENDER=='Female', Employee.EDUCATION=='Bachelor')).all()
emps = session.query(Employee).filter(or_(Employee.MARITAL_STAT=='Single', Employee.NR_OF_CHILDREN==0)).all()

def test_create_emp(self):
    emp = Employee(
        EMP_ID = "9002",
        FIRST_NAME= "Lauren",
        LAST_NAME = "Daigle",
        GENDER = "Female",
        AGE = 20,
        EMAIL = "unknown",
        PHONE_NR = "unknown",
        EDUCATION = "Bachelor",
        MARITAL_STAT = "Single",
        NR_OF_CHILDREN = 0
    )
    session.add(emp)
    session.commit()

def test_modify(self):
    emp = session.query(Employee).filter_by(EMP_ID='9002').first()
    emp.AGE = '21'
    session.commit()
    
def test_delete(self):
    emp = session.query(Employee).filter_by(EMP_ID='9002').first()
    session.delete(emp)
    session.commit()
    
# 表间关系
https://blog.csdn.net/stone0823/article/details/112344065
class User(Base, ModelExt):
  __tablename__ = 'users'
  id = Column(Integer, primary_key=True)
  name = Column(String)
  fullname = Column(String)
  nickname = Column(String)
  
  addresses = relationship("Address", back_populates="user")
  
class Address(Base, ModelExt):
  __tablename__ = 'addresses'
  id = Column(Integer, primary_key=True)
  email_address = Column(String, nullable=False)
  #user_id = Column(Integer, ForeignKey("users.id", ondelete="CASCADE", onupdate="CASCADE"))
  
  user_id = Column(Integer, ForeignKey("users.id"))
  user = relationship("User", back_populates="addresses")

# 多表关联查询  
def test_query_via_join(self):
    result = session.query(User, Address).join(Address).all()
    for item in result:
        print(item[0].id, item[0].fullname, item[1].email_address)

def test_query_via_relation(self):
    result = session.query(User).all()
    for item in result:
        addresses = item.addresses
        for addr in addresses:
            print(item.id, item.fullname, addr.email_address)

def test_query_many_to_one(self):
    result = session.query(Address).all()
    for addr in result:
        print(addr.id, addr.email_address, addr.user.fullname)

def test_get_address_manually(self):
    """
    不管数据库是否建立关系，sqlalchemy是否建立关系
    都可以用下面手工的方式查询和获取
    :return:
    """
    user = session.query(User).filter_by(id=2).first()
    addresses = session.query(Address).filter(Address.user_id == user.id).all()
    print(addresses)

```

智锋科技/资产管理系统

简介

发行版

贡献者

近期动态

智锋科技/资产管理系统 .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

智锋科技/资产管理系统