v0.7.0版本发布

Author: mtianyan

.gitignore

@@ -55,3 +55,4 @@ Temporary Items
 /build/
 **/__pycache__/
 /tyadmin_api_cli.egg-info/
+**/node_modules

CHANGELOG.md

@@ -1,3 +1,16 @@
+## 0.7.0 (2020-11-30)
+
+#### Bug Fixes
+
+- 重构页面生成代码，统一处理默认值等情况
+- 修复编码问题，创建文件夹问题
+- 优化生成命令提示信息
+
+#### Features / Enhancement
+
+- 添加demo项目，作为各种情况的测试项目
+- 更新README部分教程
+
 ## v0.6.3 (2020-10-26)
 
 #### Bug Fixes

README.md

@@ -1,75 +1,106 @@
-# 基于Django Restful Framework 和 Antd Design Pro V4 类似Xadmin 的基于Models 的管理后台前后端生成工具。
+# TyAdmin 基于Django Restful Framework 和 Antd Design Pro V4 的基于Models 的 **No Code** 零代码零学习成本管理后台前后端生成工具。
 
 ![](https://img.shields.io/pypi/v/tyadmin-api-cli)
 ![](https://img.shields.io/pypi/wheel/tyadmin-api-cli)
 
-更强大，更现代化，自定义度更高的Xadmin！！！
-自动生成前后端管理后台，神奇自动对接。免去普通增删改查，筛选，搜索功能开发。
+TyAdmin: 只需要花五分钟按着README中快速上手配置，无额外文档，无框架学习成本，零代码，全自动！更强大！更现代化！功能更多！
 
-交流反馈群: 304094780
+0. 自动生成前后端管理后台，页面接口神奇全自动对接。登录验证，修改密码，Dashboard数据统计。
+1. 一次拥有 **增删改查，筛选，搜索，数据全量导出，选择导出** 
+2. 外键字段，多对多字段，富文本，文件，图片，django自带权限系统，
+3. 已兼容第三方 django-celery-beat 后台管理
+
+## 多种登录方式
+
+![](http://cdn.pic.mtianyan.cn/blog_img/20201130234228.png)
+
+## 内嵌自动dashboard，自动注册现有model count 数据。
+
+![](http://cdn.pic.mtianyan.cn/blog_img/20201130234054.png)
+
+## 全自动的列表展示，增删改查， 筛选，搜索，导出Excel
+
+![](http://cdn.pic.mtianyan.cn/blog_img/20201130234448.png)
+
+![](http://cdn.pic.mtianyan.cn/blog_img/20201130234525.png)
+
+## django自带权限组支持，外键蓝点小标记pop支持
+
+![](http://cdn.pic.mtianyan.cn/blog_img/20201130234705.png)
+
+![](http://cdn.pic.mtianyan.cn/blog_img/20201130234753.png)
+
+## 基于Model定义的表单字段级别自动验证
+
+![](http://cdn.pic.mtianyan.cn/blog_img/20201010194705.png)
+
+## 内嵌富文本支持,仅需把字段定义为`richTextField`,无需任何额外集成。
+
+![](http://cdn.pic.mtianyan.cn/blog_img/20201010192630.png)
 
-只需要设计好Model，运行两条命令`python manage.py init_admin`,`python manage.py gen_all`
+交流反馈群: 304094780
 
->后端代码生成一个django app到项目目录, 代码归你掌控，无阻二次开发！
->前端生成一个完整的Antd design pro V4项目，代码归你掌控，无阻二次开发！
+只需要设计好Model，在settings中配置需要生成哪些model，运行一条命令`python manage.py init_admin && python manage.py gen_all`
 
-前端页面， 后端接口，路由，菜单全部自动对接。
+>后端代码生成一个django app到项目目录, 只需注册一下， 无需再写一行代码！ 代码归你掌控，无阻二次开发！
+>前端生成一个完整的Antd design pro V4项目，只需启动一次，无需再写一行代码！ 代码归你掌控，无阻二次开发！
 
-已生成示例网站: 
+前端页面，后端接口，路由，菜单全部自动对接。
 
-1. https://imooc.funpython.cn/xadmin
+## 在线demo地址(待上线):
 
-2. https://mooc.funpython.cn/xadmin
+>http://demo.funpython.cn
 
-## demo项目快速上手
+# 快速上手 (已有项目可从第二步开始，注意修改GEN_APPS 变量为自己需要生成的app列表)
 
+>如有问题，可对比demos下tyadmin_demo_finish项目找自己的不同
 
-### 1. 获得一个还未拥有后台api界面的demo项目代码(已存在项目可直接从第二步开始):
+### 1. 下载demo项目安装依赖
 
 ```
-git clone https://github.com/mtianyan/cookiecutter-tyadmin-demo.git
+git clone https://github.com/mtianyan/tyadmin_api_cli.git
+cd tyadmin_api_cli/demos/tyadmin_demo_init
 # 安装项目 原本就需要的依赖
 pip install -r requirement.txt
 ```
 
-### 2. 安装tyadmin-api-cli
+### 2. 安装tyadmin-api-cli并注册tyadmin-api-cli
 
 ```
 pip install tyadmin-api-cli
-```
-
-### 3. 注册tyadmin-api-cli
 
-```
 INSTALLED_APPS = [
+    'captcha',
     'tyadmin_api_cli',
 ]
 
 TY_ADMIN_CONFIG = {
-    'GEN_APPS': ['users', 'article']
+    'GEN_APPS': ['demo']
 }
 ```
 
-填写你想要生成的app列表。
+GEN_APPS: 填写你想要生成的app列表。
 
-### 4. 初始化 后端app 及 前端项目 并 生成后端自动化的视图，过滤器，路由，序列器。 前端页面及路由菜单。
+### 3. 初始化 后端app(tyadmin_api) + 前端项目(tyadmin)  && 生成后端自动化的视图，过滤器，路由，序列器 + 前端页面及路由菜单
 
 ```
 python manage.py init_admin && python manage.py gen_all
 ```
 
 ### 5. 注册生成出的app
 
-```
+```diff
 INSTALLED_APPS = [
-    'tyadmin_api_cli',
     'captcha',
-    'tyadmin_api'
+    'tyadmin_api_cli',
++   'tyadmin_api'
 ]
 ```
 
 ### 6. 注册路由
 
+demos/tyadmin_demo_complete/tyadmin_demo/urls.py
+
 ```
     path('api/xadmin/v1/', include('tyadmin_api.urls')),
 ```
@@ -79,6 +110,7 @@ INSTALLED_APPS = [
 ```
 python manage.py makemigrations
 python manage.py migrate
+python manage.py createsuperuser # 创建一个可以登入后台的用户
 python manage.py runserver # 默认运行在8000端口
 ```
 
@@ -89,22 +121,12 @@ python manage.py runserver # 默认运行在8000端口
 ```
 cd tyadmin
 npm install
-npm run start # 默认会运行在8001端口
+npm run start:dev # 默认会运行在8001端口
 ```
 
-访问http://127.0.0.1:8001/xadmin/
+访问http://127.0.0.1:8001/xadmin/ 输入刚才创建的用户名密码登录查看系统
 
-## 内嵌自动dashboard，自动注册现有model count 数据。
-
-![](http://cdn.pic.mtianyan.cn/blog_img/20201010184239.png)
-
-## 全自动的列表展示，搜索，筛选功能。
-
-![](http://cdn.pic.mtianyan.cn/blog_img/20201010192457.png)
-
-## 内嵌富文本支持,仅需把字段定义为`richTextField`,无需任何额外集成。
-
-![](http://cdn.pic.mtianyan.cn/blog_img/20201010192630.png)
+# 附录(随意了解一下即可)
 
 ## model->前端对应关系
 
@@ -123,27 +145,9 @@ npm run start # 默认会运行在8001端口
 | DateField| Date选择器|
 | DateTimeField| DateTime选择器|
 
-
-
 ### ForeignKey自动生成下拉单选菜单, ManyToManyField自动生成下拉多选菜单
 
->指定`f'{MAIN_DISPLAY}__name'` 关联另一张表哪个字段用于table显示
-
-```python
-course_org = ForeignKey(CourseOrg, verbose_name="所属机构",
-                        help_text=f'{MAIN_DISPLAY}__name')
-```
 
-![](http://cdn.pic.mtianyan.cn/blog_img/20201010192310.png)
-
-```
-labels = ManyToManyField("Label", verbose_name="课程拥有的label", 
-                help_text=f'{MAIN_DISPLAY}__title')
-```
-
-![](http://cdn.pic.mtianyan.cn/blog_img/20201010194349.png)
-
-![](http://cdn.pic.mtianyan.cn/blog_img/20201010194222.png)
 
 ### richTextField 自动生成富文本
 
@@ -168,24 +172,20 @@ gender = CharField(verbose_name="性别",choices=GENDER_CHOICES)
 ### ImageField 自动生成带预览的表单上传功能，列表页可选两种展示方式。
 
 ```python
-avatar = ImageField(verbose_name="头像", help_text=MAIN_AVATAR)
-image = ImageField(verbose_name="封面图", help_text=MAIN_PIC)    
+avatar = ImageField(verbose_name="头像") # 变量名为avatar或logo的会自动为头像样式
+image = ImageField(verbose_name="封面图")    
 ```
 
 ![](http://cdn.pic.mtianyan.cn/blog_img/20201010191641.png)
 
-头像样式 `MAIN_AVATAR`:
-
 ![](http://cdn.pic.mtianyan.cn/blog_img/20201010191917.png)
 
-图片样式 `MAIN_PIC`:
-
 ![](http://cdn.pic.mtianyan.cn/blog_img/20201010191843.png)
 
 ### FileField 字段生成文件上传功能。
 
 ```
-download = FileField(verbose_name="资源文件", max_length=100)
+download = FileField(verbose_name="资源文件")
 ```
 
 ![](http://cdn.pic.mtianyan.cn/blog_img/20201010193041.png)
@@ -219,7 +219,7 @@ birthday = DateField(verbose_name="生日")
 ```
 ![](http://cdn.pic.mtianyan.cn/blog_img/20201010193614.png)
 
-### DateTimeField 自动表单 DateTime 选择框。时间范围筛选器。
+### DateTimeField 自动表单 DateTime 选择框，时间范围筛选器。
 
 ```
 last_login = DateTimeField(verbose_name="上次登录")
@@ -231,19 +231,5 @@ last_login = DateTimeField(verbose_name="上次登录")
 
 ![](http://cdn.pic.mtianyan.cn/blog_img/20201010195116.png)
 
-## 基于Model定义的表单字段级别自动验证
-
-```
-    title = CharField(max_length=255, verbose_name="课程标题", unique=True)
-```
-
-![](http://cdn.pic.mtianyan.cn/blog_img/20201010194705.png)
-
-## 轻松的后端自定义验证
-
-```
-if xxx:
-    raise ValidationError({"filed_name": ["错误提示"]})
-```
 
 

setup.py

@@ -12,13 +12,13 @@ def package_files(directories):
         for (path, directories, filenames) in walk(item):
             for filename in filenames:
                 paths.append(join('..', path, filename))
-    print(paths)
+    # print(paths)
     return paths
 
 
 setup(
     name="tyadmin_api_cli",
-    version="0.6.3",
+    version="0.7.0",
     keywords=("pip", "mtianyan", "xadmin", "Django", "Antd", "Antd Design Pro"),
     description="modern base on models django admin powered by Antd Design Pro",
     long_description="modern base on models django admin powered by Antd Design Pro",
@@ -37,5 +37,5 @@ def package_files(directories):
         ])
     },
     platforms="any",
-    install_requires=["django", "django-simple-captcha", "djangorestframework"]
+    install_requires=["django", "django-simple-captcha", "djangorestframework", "demjson"]
 )

tyadmin_api_cli/antd_full_templates/config/auto_menu.json

@@ -1 +1,84 @@
-[]
+
+                [
+          {
+            name: '首页',
+            path: '/xadmin/index',
+            icon: 'dashboard',
+            component: './TyAdminBuiltIn/DashBoard'
+          },
+            {
+                      name: 'permission',
+                      icon: 'smile',
+                      path: '/xadmin/permission',
+                      component: './AutoGenPage/PermissionList',
+                   },{
+                      name: 'group',
+                      icon: 'smile',
+                      path: '/xadmin/group',
+                      component: './AutoGenPage/GroupList',
+                   },{
+                      name: '被外键关联-非必填',
+                      icon: 'smile',
+                      path: '/xadmin/demo_foreign_key',
+                      component: './AutoGenPage/DemoForeignKeyList',
+                   },{
+                      name: '被多对多关联',
+                      icon: 'smile',
+                      path: '/xadmin/tags',
+                      component: './AutoGenPage/TagsList',
+                   },{
+                      name: '被多对多关联',
+                      icon: 'smile',
+                      path: '/xadmin/category',
+                      component: './AutoGenPage/CategoryList',
+                   },{
+                      name: 'rich text demo',
+                      icon: 'smile',
+                      path: '/xadmin/rich_text_demo',
+                      component: './AutoGenPage/RichTextDemoList',
+                   },{
+                      name: '',
+                      icon: 'smile',
+                      path: '/xadmin/many_to_many_demo',
+                      component: './AutoGenPage/ManyToManyDemoList',
+                   },{
+                      name: '全部字段类型-choices',
+                      icon: 'smile',
+                      path: '/xadmin/demo_model_require',
+                      component: './AutoGenPage/DemoModelRequireList',
+                   },{
+                      name: '全部字段类型-必填',
+                      icon: 'smile',
+                      path: '/xadmin/demo_model',
+                      component: './AutoGenPage/DemoModelList',
+                   },{
+                      name: '全部字段类型-默认',
+                      icon: 'smile',
+                      path: '/xadmin/demo_default_model',
+                      component: './AutoGenPage/DemoDefaultModelList',
+                   },{
+                      name: '用户管理',
+                      icon: 'smile',
+                      path: '/xadmin/user_profile',
+                      component: './AutoGenPage/UserProfileList',
+                   }
+   ,{
+    name: 'Tyadmin内置',
+    icon: 'VideoCamera',
+    path: '/xadmin/sys',
+    routes: [
+      {
+        name: 'TyAdmin日志',
+        icon: 'smile',
+        path: '/xadmin/sys/ty_admin_sys_log',
+        component: './TyAdminBuiltIn/TyAdminSysLogList'
+      },
+      {
+        name: 'TyAdmin验证',
+        icon: 'smile',
+        path: '/xadmin/sys/ty_admin_email_verify_record',
+        component: './TyAdminBuiltIn/TyAdminEmailVerifyRecordList'
+      }
+    ]
+  }]
+