SmartChart是一个基于Echarts的微代码开发平台, 适用于任何WEB项目
Echarts-django, Django-smartchart是基于smartchart进行了简化,可轻松应用于你的项目
简单, 敏捷, 高效, 通用化, 高度可定制化, 让你的项目瞬间档次提升
为你完全打通前后端, 图形数据联动, 筛选开发毫无压力
支持集木式的开发模式
我们让简单和通用化不再是个矛盾体
安装使用说明:
如果你是非Python语言的开发者
你可以把smartchart当作服务来嵌入你的页面使用
1. 安装Python环境,请安装最新版3.9!!
2. 命令行安装: pip3 install smartchart
# Mac or Linux 初始化方法
3. 初始化DB, 命令行输入
smartchart makemigrations
smartchart migrate
4. 建立管理员帐号, 如果已有可忽略
smartchart createsuperuser
5. 本地命令行启动:
smartchart
如果你需要远程访问，启动方式:
smartchart runserver 0.0.0.0:8000 --insecure
# Window 初始化方法
3. 初始化DB, 你需要找到你的python安装地址,不记得了参考下图方法
如C:\Users\xxx\AppData\Local\Programs\Python\Python39
命令行输入
cd C:\Users\....\Python39\Scripts\
python smartchart makemigrations
python smartchart migrate
4. 建立管理员帐号, 如果已有可忽略
python smartchart createsuperuser
5. 本地命令行启动:
python smartchart
如果你需要远程访问
启动方式:
python smartchart runserver 0.0.0.0:8000 --insecure
6. 访问http://127.0.0.1:8000/echart/init_db/ 进行数据初始化
开发前建意新建一个非超级管理员帐号(重要),避免改到内置的数据集和图形,并观看视屏说明!!
如果需要，你可以采用单点登录的方式与smartchart进行对接
/echart/smart_login?id=xxx&stamp=xxx&token=xxx&url=/
参数说明：
id: 用户名(在smartchart平台中管理)
stamp: 时间戳(1970年1月1日到生成时间的毫秒数)
token: 采用sha1加密, token=SHA1(链接秘钥+stamp+id)
链接秘钥默认smartchart,
请在环境变量设定SMART_KEY替换(重要)
url: 登录成功后跳转链接
**提示：为了数据安全,对外生产环境使用,务必设定你的环境变量SMART_KEY
**
如果你是python开发者,可以在你的django项目中当作apps使用
pip install smartchart #只支持最新版Python3.9.x
pip install smartchart==3.7.3 #只支持python3.7.x
pip install smartchart==3.6.3 #只支持python3.6.x
简单配置一下, 你可以参考此demo
1. 在你的setting.py的INSTALL_APPS中加入'smart_chart.echart'
2. MIDDLEWARE 中注释掉XFrameOptionsMiddleware
3. setting.py中设定为中国时区, 支持中文基础平台建设!
LANGUAGE_CODE = 'zh-hans'
TIME_ZONE = 'Asia/Shanghai'
USE_I18N = True
USE_L10N = True
USE_TZ = False
4. 在你的url.py中加入引用
from django.conf.urls import include
from django.views.generic import RedirectView
5. url.py的urlpatterns中加入路由
path('echart/', include('smart_chart.echart.urls')),
path('', RedirectView.as_view(url='echart/index/')), #首页,可自定义路由
6. 初始化DB, 命令行输入:
python manage.py makemigrations
python manage.py migrate
7. 建立管理员帐号, 如果已有可忽略
python manage.py createsuperuser
8. 启动服务
python manage.py runserver
图形样列参考
安装及使用问题,微信群有时效性,加以下微信号拉你入群
更多使用说明:
SmartChart designed for you
SmartChart是为你而生的一个产品, 你只需要使用通用开发技术就可以使用,无需学习特定的技能, 因为她的通用性, 所以让你的知识不会因为改变而淘汰
因为她的灵活性, 你可以充分发挥你的智慧让她变得非常的Smart
抛弃繁琐的操作, 加速你的开发效率, 和BI产品相比, 如同Linux与Window的区别
她是一个数据集装箱, 让你非常方便的把数据组装起来后, 可使用统一的接口对外服务,支持系统间嵌入,实时,快速定制化开发. 你也可以理解为数据中台, 用可视化提供统一数据服务. 这是一个面向开发人员的平台, 实现数据的最后一公里
开始使用smart chart, 您不需要任何专业知识, 无需coding, 选择模块组装即可!
但如果要使用好smart chart, 建意了解下javascript, H5, Echart这些前端知识, 可以让你的应用更加得心应手,创作更炫的效果
如果你需要更进一步订制你的数据, 你需要了解下SQL的使用,本项目高级应用语言都是通用的技能, 象js, h5,sql 学习成本低
入门视屏说明(以下文字说明是之前版本,现已迭代多次,建意看视屏了解)
Smart Chart 基础
主要分为 数据连接池, 数据集, 图形格式, 页面模板, 主题, 组装盒(Dashboard)
(数据集+图形格式) => 图形(report)
(图形report+report+...) + 页面模板 + 主题 => Dashboard
一般企业应用
数据连接池 + 数据集 => 统一数据接口 由 IT(数据建模工程师完成)
图形格式 + 页面模板 + 组装 => 统一可视化接口 由数据分析师或业务完成
开发流程
数据分析师&业务 确定好需求, 进行页面草图设计, 提出数据需求给建模工程师, 完成数据接口后, 数据分析师&业务挑选图形格式(含powerbi, tableau等BI产品), 模板进行组装, 特殊展示需求对相应的code进行修改(js, html)
数据集
数据集可以理解为一个个的cube, 通过sql生成, 支持定时, 点频, 实时刷新的机制, 我们建意你用专业的工具开发sql 查询, 如navicate,datagrip,hue
数据集的高级用法, 参考如下链接 数据集图形对应关系
对于一般用户来说, 无需了解如何生成数据集, 但建意了解以下数据集的常识
数据集统一向图形传递数据的参数名为dataset, dataset是一个二维表结构, 如下
dataset = [
['时间','人口','发展','潜力'],
['2018年', 12 , 10 , 9],
['2017年', 8 , 7 , 3],
......
]
图形设定
smartchart内置了非常多的图形, 可以直接拿来使用, 但是要定制自已的样式, 建意稍作修改, 比如加上图形, 更改tips, 标题等等, 具体修改方式, 请参考smartchart平台样列
如果你想进一步了解, 你可以参考 自定义图形指南
PowerBI/Tableau嵌入的也虚拟成了图形格式, 具体方式见另一文章
那接下来我们需要给图形一个舞台, 那就是模板,
模版
模版就是一个html页面, 理论上来说, 你可以随意发挥, 为了让不太懂html的同学定制自已的模板, 我们提供了可视化开发模板,设计好的code复制过去覆盖这一块代码即可, 如有其它需求可自行修改(前提你得稍微会点h5
)
每一个div对应一个DIV格式, 可以比喻成给图形包一件衣服,我们会把图形绑定到这个容器中,你可以用它来设定容器的样式,如长宽高,边距,边框等等:
更多模板使用说明, 请参考: 模板指南
你也可以使用 可视化设计工具 进行模板的开发
接下来只需要在dashborad中进行组装就可以了
Dashboard
选择你需要拼装的数据集,对应的图形,你也可以修改div, 让他更适合当前页面的需求, 选择你喜欢的主题, 会自动应用到页面
估计以让说明你有点不知如何下手, 下面你可以STEP by STEP 的去尝试, 建议先看最下方的视屏