https://github.com/tencentblueking/bk-resource
bk_resource 是基于 Blueapps & Django Rest Framework，快速生成符合 12-factor 规范的 WEB SaaS 的脚本架
https://github.com/tencentblueking/bk-resource
Last synced: 3 months ago
JSON representation
bk_resource 是基于 Blueapps & Django Rest Framework，快速生成符合 12-factor 规范的 WEB SaaS 的脚本架
- Host: GitHub
- URL: https://github.com/tencentblueking/bk-resource
- Owner: TencentBlueKing
- License: other
- Created: 2023-04-10T08:26:22.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-07-09T10:45:15.000Z (over 1 year ago)
- Last Synced: 2025-04-16T07:20:15.470Z (9 months ago)
- Language: Python
- Homepage:
- Size: 780 KB
- Stars: 12
- Watchers: 7
- Forks: 8
- Open Issues: 7
-
Metadata Files:
- Readme: readme.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[](https://github.com/TencentBlueKing/bk-resource/blob/main/LICENSE.txt)
[](https://github.com/TencentBlueKing/bk-resource/releases)
[](https://github.com/TencentBlueKing/bk-resource/pulls)
[](https://codecov.io/gh/TencentBlueKing/bk-resource)
[](https://github.com/TencentBlueKing/bk-resource/actions/workflows/unittest.yml)
[(English Documents Available)](readme_en.md)
## Overview
`bk_resource` 是一个基于 [Blueapps](https://github.com/TencentBlueKing/blueapps) 和 [Django Rest Framework](https://github.com/encode/django-rest-framework) 的脚手架，
旨在帮助开发人员快速生成符合 [`12-factor`](https://12factor.net/) 规范的 WEB SaaS，并在`DDD`开发实践中方便地创建可扩展的领域服务
## Features
- [Basic] 基于 `Django` 进行封装，生成标准 `swagger API`
- [Basic] 基于 `django-environ` 适配环境变量与 `.env` 配置
- [Basic] 支持基于 `PEP-621` 的全工具链 (mypy\isort\flake8\black) 配置方案
- [Basic] 支持代码规范类工具整合：`pre-commit`、`code-cc`
- [Resource] 集成 `bk_resource` 组织工程目录结构，通过 `Resource` 的方式声明业务逻辑
- [Resource] 支持 `ApiResource` / `BkApiResource` 调用第三方 `API` 接口
## Getting started
### Installation
1. 安装`cruft`
```bash
$ pip install cruft
```
2. 通过`cruft`脚本架生成项目
```bash
$ cruft create https://github.com/TencentBlueKing/bk-resource.git --checkout main --directory template
```
3. 添加远程仓库地址并完成推送
```bash
cd {{ project_id }}
git init
git add .
git commit -m "init repo"
git remote add origin {{ git_url }}
git push -u origin master
```
### 模板生命周期管理
检查或更新模板前需确保本地代码已提交到 GIT 仓库
1. 检查模板是否更新
```bash
$ cruft check --checkout main
```
2. 合并模板到本地项目
```bash
$ cruft update --checkout main
```
### Usage
- [快速开始](template/readme.md)
- [使用文档](docs/usage.md)
### Domain Driven Design 开发实践
- Api 交互层
通过 UI Api 或者 Open Api 将服务暴露给用户，由对应的 Api 负责对应的业务逻辑串联。
- Scene 场景层
在通过 Api 访问后端时，实际访问的是由 Resource 暴露的一个场景服务，通过场景服务串联领域层的业务逻辑。
- Domain 领域层
领域层聚焦对应的细分模块，负责处理模块的具体业务逻辑，例如，在用户模块中，处理用户注册、登录、修改密码、重置密码等逻辑。
- Model 模型层
在 MVC 框架中 (如 Django)，将代码架构划分为 Model (模型)，View (视图)，Controller (控制器) 三层，View 用于界面展示，在前后端分离开发部署的实践中，已经不再由后端处理，后端只需要处理 Model & Controller。
## Roadmap
- [版本日志](release.md)
## Support
- [蓝鲸论坛](https://bk.tencent.com/s-mart/community)
- [蓝鲸 DevOps 在线视频教程](https://bk.tencent.com/s-mart/video/)
- [蓝鲸社区版交流群](https://jq.qq.com/?_wv=1027&k=5zk8F7G)
## BlueKing Community
- [BK-CMDB](https://github.com/Tencent/bk-cmdb)：蓝鲸配置平台（蓝鲸 CMDB）是一个面向资产及应用的企业级配置管理平台。
- [BK-CI](https://github.com/Tencent/bk-ci)：蓝鲸持续集成平台是一个开源的持续集成和持续交付系统，可以轻松将你的研发流程呈现到你面前。
- [BK-BCS](https://github.com/Tencent/bk-bcs)：蓝鲸容器管理平台是以容器技术为基础，为微服务业务提供编排管理的基础服务平台。
- [BK-PaaS](https://github.com/Tencent/bk-paas)：蓝鲸 PaaS 平台是一个开放式的开发平台，让开发者可以方便快捷地创建、开发、部署和管理 SaaS 应用。
- [BK-SOPS](https://github.com/Tencent/bk-sops)：标准运维（SOPS）是通过可视化的图形界面进行任务流程编排和执行的系统，是蓝鲸体系中一款轻量级的调度编排类 SaaS 产品。
- [BK-JOB](https://github.com/Tencent/bk-job) 蓝鲸作业平台(Job)是一套运维脚本管理系统，具备海量任务并发处理能力。
## Contributing
如果你有好的意见或建议，欢迎给我们提 Issues 或 Pull Requests，为蓝鲸开源社区贡献力量。
[腾讯开源激励计划](https://opensource.tencent.com/contribution) 鼓励开发者的参与和贡献，期待你的加入。
## License
基于 MIT 协议， 详细请参考 [LICENSE](LICENSE.txt)