wangzb87/kinit

[关于]

Kinit 是一套开箱即用的中后台解决方案，可以作为新项目的启动模版！

前后端分离架构，开箱即用，紧随前沿技术！

高性能，高效率，高颜值，易扩展

长期维护，积极更新！

通知：

2023-09-09：因 vue-element-plus-admin 作者最近已经将框架版本从 1.x 升级到 2.x，并且许多功能都发生了重构，目前我正在做的是将本项目前端同步从 vue-element-plus-admin 1.x 升级到 2.x，前端功能上会发生很大变动，所以下个版本会更新到 3.0.0 版本。

介绍

Kinit 是一套全部开源的快速开发平台，毫无保留给个人及企业免费使用。

后端采用现代、快速（高性能） FastAPI 异步框架 + 自动生成交互式API文档 + （强制类型约束）Pydantic + （高效率）SQLAlchemy 2.0；
PC端采用 vue-element-plus-admin 、Vue3、Element Plus、TypeScript等主流技术开发；
移动端采用 uni-app，Vue2，uView 2为主要技术开发；
后端加入 Typer 命令行应用，简单化数据初始化，数据表模型迁移等操作；
新加入定时任务功能，采用 APScheduler 定时任务框架 + Redis 消息队列 + MongoDB 持久存储；
权限认证使用（哈希）密码和 JWT Bearer 令牌的 OAuth2，支持多终端认证系统。
支持加载动态权限菜单，多方式轻松权限控制，按钮级别权限控制。
已加入常见的 MySQL + MongoDB + Redis 数据库异步操作。
开箱即用的中后台解决方案，可以用来作为新项目的启动模版，也可用于学习参考。并且时刻关注着最新技术动向，尽可能的第一时间更新。
与 vue-element-plus-admin 前端框架时刻保持同步更新。

特别鸣谢

vue-element-plus-admin：基于vue3、element-plus、typescript 的后台集成方案

RuoYi 若依官方网站：RuoYi 是一个优秀的 Java 后台管理系统

django-vue-admin：django-vue-admin 是一个优秀的基于 Django 开发后台管理系统

Ant Design Pro：开箱即用的中台前端/设计解决方案

小诺开源技术 (xiaonuo.vip)：国内首个国密前后端分离快速开发平台

在线体验

PC端演示地址：https://kinit.ktianc.top

微信小程序端演示：

搜索：kinit
扫码：

账号：15020221010
密码：kinit2022

源码地址

gitee地址(主推)：https://gitee.com/ktianc/kinit

github地址：https://github.com/vvandk/kinit

PC端内置功能

移动端内置功能

登录认证：支持用户使用手机号+密码方式登录，微信手机号一键登录方式。

说明：新建用户密码默认为手机号后六位；

说明：用户在第一次登录时，必须修改当前用户密码。
导航栏：首页、我的、工作台
我的基础功能：编辑资料、头像修改、密码修改、常见问题、关于我们等

前序准备

后端技术

Python3：熟悉 python3 基础语法
FastAPI - 熟悉后台接口 Web 框架
SQLAlchemy 2.0 - 数据数据库操作
Typer - 熟悉命令行工具的使用
MySQL 和 MongoDB 和 Redis - 熟悉数据存储数据库
iP查询接口文档：IP查询第三方服务，有1000次的免费次数

PC端

node 和 git - 项目开发环境
Vite - 熟悉 vite 特性
Vue3 - 熟悉 Vue 基础语法
TypeScript - 熟悉 TypeScript 基本语法
Es6+ - 熟悉 es6 基本语法
Vue-Router-Next - 熟悉 vue-router 基本使用
Element-Plus - element-plus 基本使用
Mock.js - mockjs 基本语法
vue3-json-viewer：简单易用的json内容展示组件,适配vue3和vite。
SortableJS/vue.draggable.next：Vue 组件（Vue.js 3.0）允许拖放和与视图模型数组同步。
高德地图API (amap.com)：地图 JSAPI 2.0 是高德开放平台免费提供的第四代 Web 地图渲染引擎。

移动端

uni-app - 熟悉 uni-app 基本语法
Vue2 - 熟悉 Vue 基础语法
uView UI 2：uView UI 组件的基本使用
uni-read-pages ：自动读取 pages.json 所有配置。
uni-simple-router ：在uni-app中使用vue-router的方式进行跳转路由，路由拦截。

定时任务

Python3 -熟悉 python3 基础语法
APScheduler - 熟悉定时任务框架
MongoDB 和 Redis - 熟悉数据存储数据库

安装和使用

获取代码

git clone https://gitee.com/ktianc/kinit.git

准备工作

Python == 3.10 (其他版本均未测试)
nodejs >= 14.0 (推荐使用最新稳定版)
Mysql >= 8.0
MongoDB (推荐使用最新稳定版)
Redis (推荐使用最新稳定版)

后端

安装依赖

cd kinit-api

pip3 install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

修改项目数据库配置信息

在 application/config 目录中

development.py：开发环境
production.py：生产环境

"""
Mysql 数据库配置项
连接引擎官方文档：https://www.osgeo.cn/sqlalchemy/core/engines.html
数据库链接配置说明：mysql+asyncmy://数据库用户名:数据库密码@数据库地址:数据库端口/数据库名称
"""
SQLALCHEMY_DATABASE_URL = "mysql+asyncmy://数据库用户名:数据库密码@数据库地址:数据库端口/数据库名称"
SQLALCHEMY_DATABASE_TYPE = "mysql"


"""
Redis 数据库配置
"""
REDIS_DB_ENABLE = True
REDIS_DB_URL = "redis://:密码@地址:端口/数据库"

"""
MongoDB 数据库配置
"""
MONGO_DB_ENABLE = True
MONGO_DB_NAME = "数据库名称"
MONGO_DB_URL = f"mongodb://用户名:密码@地址:端口/?authSource={MONGO_DB_NAME}"

"""
阿里云对象存储OSS配置
阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
 *  [accessKeyId] {String}：通过阿里云控制台创建的AccessKey。
 *  [accessKeySecret] {String}：通过阿里云控制台创建的AccessSecret。
 *  [bucket] {String}：通过控制台或PutBucket创建的bucket。
 *  [endpoint] {String}：bucket所在的区域， 默认oss-cn-hangzhou。
"""
ALIYUN_OSS = {
    "accessKeyId": "accessKeyId",
    "accessKeySecret": "accessKeySecret",
    "endpoint": "endpoint",
    "bucket": "bucket",
    "baseUrl": "baseUrl"
}

"""
获取IP地址归属地
文档：https://user.ip138.com/ip/doc
"""
IP_PARSE_ENABLE = True
IP_PARSE_TOKEN = "IP_PARSE_TOKEN"

并在alembic.ini文件中配置数据库信息，用于数据库映射

# mysql+pymysql://数据库用户名:数据库密码@数据库地址:数据库端口/数据库名称
[dev]
# 开发环境
version_locations = %(here)s/alembic/versions_dev
sqlalchemy.url = sqlalchemy.url = mysql+pymysql://root:123456@127.0.0.1/kinit


[pro]
# 生产环境
version_locations = %(here)s/alembic/versions_pro
sqlalchemy.url = sqlalchemy.url = mysql+pymysql://root:123456@127.0.0.1/kinit

创建数据库

mysql> create database kinit;             # 创建数据库
mysql> use kinit;                         # 使用已创建的数据库 
mysql> set names utf8;                    # 设置编码

初始化数据库数据

# 项目根目录下执行，需提前创建好数据库
# 会自动将模型迁移到数据库，并生成初始化数据
# 执行前请确认执行的环境与settings.py文件中配置的DEBUG一致

# （生产环境）
python3 main.py init

# （开发环境）
python3 main.py init --env dev

修改项目基本配置信息

修改数据库表 - vadmin_system_settings 中的关键信息

# 阿里云短信配置
sms_access_key
sms_access_key_secret
sms_sign_name_1
sms_template_code_1
sms_sign_name_2
sms_template_code_2

# 高德地图配置
map_key

# 微信小程序配置
wx_server_app_id
wx_server_app_secret

# 邮箱配置
email_access
email_password
email_server
email_port

启动

# 进入项目根目录下执行
python3 main.py run

PC端

安装依赖

cd kinit-admin

pnpm install

运行

pnpm run dev

打包

pnpm run build:pro

定时任务

安装依赖

# 安装依赖库
pip3 install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

# 第三方源：
1. 阿里源： https://mirrors.aliyun.com/pypi/simple/

修改项目数据库配置信息

在 application/config 目录中

development.py：开发环境
production.py：生产环境

"""
MongoDB 数据库配置

与接口是同一个数据库
"""
MONGO_DB_NAME = "数据库名称"
MONGO_DB_URL = f"mongodb://用户名:密码@地址:端口/?authSource={MONGO_DB_NAME}"


"""
Redis 数据库配置

与接口是同一个数据库
"""
REDIS_DB_URL = "redis://:密码@地址:端口/数据库名称"