前言

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

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

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

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

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

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

项目介绍

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、模板、脚本等构建相关文件的补充复制与命令更新