严格的四层架构:views → services → repositories → models,repository 层独占 ORM 访问
Django-Custom-Template — Django 社区模板
作者 AzyzHm
Django REST API 启动器,分层架构与三档测试隔离,适合快速搭建可维护后端。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
目前只有 1 张可用预览,尚未找到可用演示站,暂无法补充内页和手机端截图。
目前有 1 张原始预览,可打开完整图片查看设计细节。
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
环境配置按 base/development/production/test 拆分,使用 django-environ 管理
测试分为 unit、integration、e2e 三个隔离层级,均基于 pytest 和内存 SQLite
CI/CD 流水线包含 lint、测试(上传覆盖率产物)和 Docker 构建
Docker 化开发环境,docker-compose 内置 PostgreSQL 服务
完整社区健康文件:CONTRIBUTING、CODE_OF_CONDUCT、SECURITY、issue 模板和 PR 模板
模板详细介绍
Django Custom Template 是一个面向 Django REST Framework 的启动器模板,主打“约定优于配置”的工程化骨架。它把项目拆成 config、core 和 tests 三大块,其中 core 内部严格分层为 views、services、repositories、models,并规定只有 repository 层能直接操作 ORM。这种结构让业务逻辑与数据访问解耦,适合希望从一开始就保持代码边界清晰的团队。
模板自带一套完整的开发基础设施:环境配置按 base、development、production、test 拆分,测试分成 unit、integration、e2e 三个独立层级,分别用 pytest 运行,且测试数据库使用内存 SQLite。CI/CD 流水线覆盖 lint、测试和 Docker 构建,并附带 Dependabot 依赖更新。API 部分实现了基于 session 认证的 CRUD 示例,包含分页和对象级权限检查,可以直接作为参考或在此基础上扩展。
需要注意的是,模板定位是“启动器”而非完整业务应用,示例模型和接口仅用于演示架构。生产环境部署所需的细节(如 PostgreSQL 配置、静态文件处理、安全设置)需要你根据实际项目自行核对和补充。如果你正在寻找一个结构清晰、测试分层明确的 Django 后端起点,这个模板值得一试。
适合你的项目吗?
适用场景
- 需要快速搭建 Django REST API 项目骨架的开发者
- 希望从一开始就采用分层架构和严格测试策略的团队
- 作为学习 Django 分层架构和测试组织的参考项目
- 需要 CI/CD 和 Docker 配置作为起点的项目
适合人群
- 熟悉 Django 和 DRF 的中级开发者
- 偏好清晰项目结构和工程化约定的团队
- 愿意花时间调整示例代码以匹配自身业务的项目
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
克隆后需复制 .env.example 为 .env 并填写数据库等配置。
- 2
本地开发需 Python 3.12+ 和 PostgreSQL 16(或用 Docker 运行)。
- 3
测试使用内存 SQLite,无需额外数据库。
- 4
生产部署前请核对 settings 中的安全项、静态文件与数据库配置。
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明MIT许可的Django项目模板,允许免费使用、修改与商用,仅需保留版权与许可声明。
使用时需要遵守
- 保留原作者版权声明和 MIT 许可证声明。
- 保留版权声明与许可声明于所有副本或实质部分
额外费用与待核对事项
- README未说明public目录下静态素材(如banner图片)的独立授权情况
查看原文依据
Permission is hereby granted, free of charge, to any person obtaining a copy
许可证原文
This project is licensed under the [MIT License](LICENSE).
README 原文
https://github.com/AzyzHm/Django-Custom-Template/blob/main/LICENSEhttps://github.com/AzyzHm/Django-Custom-Template/blob/HEAD/README.mdPermission is hereby granted, free of char
许可证原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-09-24。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料一般 · 70 / 100
- 技术栈
- Django
- 网站类型
- 社区 · 启动器
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-09-05
- 截图检查日期
- 2026-09-06
目前没有记录演示链接。请依据仓库说明在本地评估;仅凭截图无法确认交互行为。
目录记录的主要技术栈是 Django。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
当前版本没有可核对的编辑审核记录;旧的应用时间不代表已完成事实审核。
这条历史介绍未保存固定版本的来源快照。请对照当前仓库,发现不一致可反馈。
反馈内容错误看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

django-react-template
django-react-template 是一个面向 Django 与 React 开发者的启动模板,旨在减少新项目初始化时的重复工作。
Django · 启动器

django-react-boilerplate
django-react-boilerplate 是一个面向 SaaS 应用的 Django + React 启动器,其核心思路是“自己动手”。
Django · SaaS

typescript-backend-toolkit
Production-ready Express.js/TypeScript framework with auto-generated OpenAPI, Artisan-style CLI, plugin system…
Django · 后台

django-saas-boilerplate
A modern, production-ready Django boilerplate for building SaaS applications with HTMX, Tailwind CSS, and Alpi…
Django · SaaS

django-starter-template
A production-ready Django 5.2 LTS template
Django · 启动器

Django-website-template
Django templates for freelancer's, agencies to supercharge development
Django · 启动器
