DjangoStarter v3.3.0 版本更新

前言

最近投入了不少时间在 DjangoStarter 项目上。

v3.3.0 版本主要是优化了 docker 构建流程，继续对框架进行瘦身，把原本的 daphne 服务器换成 Granian 服务器。其他的就是文档完善，加了Django和前端的入门教程。

为接下来的 Celery 集成和更多功能做准备。

总体来说这算是一个过渡版本。

项目开发过程中，我还输出了以下文章，可以参考阅读：

• 性能提升4倍！使用Granian作为Django项目的ASGI服务器
• 不同Django服务器和部署方式的性能调研
• Python、CSharp、Go、Nextjs，不同框架的性能到底差多少？

详细更新日志我放在文章底部了。

项目介绍

DjangoStarter 是面向独立开发者与小团队的 AI+全栈脚手架，用最少样板代码快速把想法做成可上线的产品。

基于 Django 5 + Django-Ninja（类型安全 API）+ HTMX/Alpine/Tailwind，内建认证、安全、中间件、代码生成、容器化与观测，把时间全部留给业务。

典型场景：个人/独立产品 MVP、企业内部工具、数据看板、以及各类 AI Agent/助手的后端与管理界面。

更新内容

https://github.com/Deali-Axy/DjangoStarter/releases/tag/v3.3.0

✨ Features（新功能）

• 🌐 全面增强的国际化支持（i18n）
  • 新增简体中文、繁体中文与英文三套完整翻译
  • 增加语言切换器、i18n 路由与模板标签
  • 为导航栏、页脚、错误页、隐私政策、服务条款等页面补全多语言内容
  • 修复 URL 前缀格式、移除旧的 JS 切换逻辑
• 🛠️ 管理后台入口新增至导航栏
• 🗑️ 移除 unfold 模块以降低维护成本

🐞 Bug Fixes（修复）

• 🔧 修复 Swagger 文档路径由 /api/doc → /api/docs 的不一致问题

♻️ Refactor（重构）

• 📦 Docker & 部署结构全面优化
  • 将 docker-compose.yml 统一更名为 compose.yml
  • 优化 Granian 命令格式（改为多行数组），提高可读性
  • 移除不必要的静态文件挂载
• 🚀 部署架构重构：使用 Granian 取代 nginx/daphne
  • 统一采用 Granian 作为高性能 ASGI 服务器
  • 简化部署结构，移除 nginx 相关配置与模板
  • 更新 README 关于 Granian 的使用与优势说明
• 🛠️ Dockerfile 重构
  • 调整构建阶段顺序（Tailwind → Gulp）确保依赖正确
  • 更合理的构建流程与文件复制逻辑

📦 Dependencies（依赖变更）

• 🔄 添加 Granian 作为 ASGI/WSGI/HTTP2 服务器
  • 集成三种启动方式：ASGI、WSGI 与 HTTP/2

📄 Docs（文档更新）

• 🆕 新增多篇核心文档：
  • 前端快速入门指南（TailwindCSS、HTMX、Alpine.js）
  • Tailwind 构建流程说明
  • DjangoStarter v3 快速入门教程（Windows 友好版）
  • macOS/Linux 启动说明
  • 项目路线图（docs/roadmap.md）
  • 文档重构计划清单（docs-todo.md）
• ✏️ 更新 REAMDE 多处内容：
  • 更新 Python 版本要求至 3.12
  • 补充 TODO 列表
  • 更新免责声明章节使其更清晰
  • 删除过时文档（docs/README.old.md）
• 🗂️ 调整快速入门文档文件名，统一结构与命名规范

🔧 Others（其他）

• ⛏️ 多处文档内容修订、格式优化与补充说明
• 📜 Tailwind、模板、脚本等构建相关文件的补充复制与命令更新