🏛️ Athena

现代化的 Deno Fresh 全栈开发模板

基于 Fresh 2.0 + TypeScript + TailwindCSS 构建的企业级 Web 应用模板

---

🌐 在线演示 • 🚀 Releases • 📚 文档 • 📊 测试报告 • 🐛 问题反馈

---

✨ 项目特色

Athena 是一个现代化的全栈 Web 应用开发模板，基于 Deno Fresh 2.0 构建，提供企业级的开发体验和最佳实践。

🎯 核心亮点

• 🚀 现代技术栈 - Deno 2.0 + Fresh 2.0 + TypeScript 5.0+
• ⚡ 极致性能 - Islands 架构 + SSR + 边缘计算优化
• 🎨 精美 UI - TailwindCSS + 响应式设计 + 暗色主题
• 🔐 企业安全 - 多提供商 OAuth + JWT + MFA + 审计日志
• 🧪 质量保证 - 完整测试套件 + 自动化 CI/CD + 代码覆盖率
• 📦 开箱即用 - 丰富组件库 + Hooks + 状态管理 + 工具函数

📋 完整特性列表

🎨 UI & 设计

• ✅ 响应式设计系统
• ✅ 暗色/亮色主题切换
• ✅ 丰富的 UI 组件库
• ✅ TailwindCSS + Sass 样式
• ✅ 自定义图标系统
• ✅ 动画和过渡效果

🔧 开发体验

• ✅ TypeScript 类型安全
• ✅ 热重载开发服务器
• ✅ 代码格式化和 Lint
• ✅ 自动化 CI/CD
• ✅ 完整的文档系统
• ✅ 开发工具集成

⚡ 性能优化

• ✅ Islands 架构
• ✅ 服务端渲染 (SSR)
• ✅ 静态资源优化
• ✅ 代码分割和懒加载
• ✅ 缓存策略
• ✅ 边缘计算支持

🛡️ 安全特性

• ✅ 多提供商 OAuth 认证
• ✅ JWT 会话管理
• ✅ 多因素认证 (MFA)
• ✅ 账户锁定保护
• ✅ 审计日志系统
• ✅ 安全中间件

🧪 测试 & 质量

• ✅ 单元测试 + 集成测试
• ✅ 性能测试 + 基准测试
• ✅ 代码覆盖率报告
• ✅ 自动化测试流水线
• ✅ 质量门禁
• ✅ 持续集成

🚀 部署 & 运维

• ✅ 自动化发布流程
• ✅ 版本管理工具
• ✅ 环境配置管理
• ✅ 监控和日志
• ✅ 多平台部署支持
• ✅ Docker 容器化

---

🚀 快速开始

📋 环境要求

• Deno 2.0+
• Git
• VS Code (推荐)

⚡ 一键启动

# 1. 克隆项目
git clone https://github.com/dext7r/athena.git
cd athena

# 2. 启动开发服务器
deno task start

# 🎉 打开浏览器访问 http://localhost:8000

🔧 详细安装步骤

1. 克隆项目

git clone https://github.com/dext7r/athena.git
cd athena

2. 配置环境变量

# 复制环境变量模板
cp .env.example .env

# 编辑 .env 文件，配置 OAuth 提供商（可选）
# 至少需要配置一个 OAuth 提供商才能使用登录功能

3. 启动项目

# 开发模式（推荐）
deno task dev

# 或生产模式
deno task start

4. 验证安装

• 访问 http://localhost:8000
• 查看控制台输出确认无错误
• 尝试登录功能（需要配置 OAuth）

---

📚 文档导航

🎯 快速导航

类型	文档	描述
📋	项目概览	架构设计和技术选型
🔧	开发指南	完整的开发流程和规范
🚀	快速发布	5分钟学会发布流程
📦	发布指南	完整的版本管理文档
🔐	环境配置	环境变量配置指南
🧪	测试指南	测试框架和最佳实践
🚀	部署指南	部署到各种平台
🤝	贡献指南	如何参与项目开发

🔗 重要链接

资源	链接	说明
🌐	在线演示	体验完整功能
📦	GitHub Releases	查看所有版本
🤖	GitHub Actions	CI/CD 状态
📊	测试报告	代码覆盖率
🐛	问题反馈	报告 Bug
💬	讨论区	社区交流

---

🛠️ 开发命令

📋 常用命令列表

🚀 启动命令

deno task start      # 启动生产服务器
deno task dev        # 启动开发服务器（热重载）

🧪 测试命令

deno task test       # 运行所有测试
deno task test:watch # 监视模式运行测试
deno task test:coverage # 生成覆盖率报告

🔧 开发工具

deno task check      # 类型检查
deno task lint       # 代码检查
deno task fmt        # 代码格式化
deno task build      # 构建项目

📦 版本管理

deno task version:patch      # 发布修复版本
deno task version:minor      # 发布功能版本
deno task version:major      # 发布重大版本
deno task version:dry-run    # 预览版本更新

---

🤝 贡献

我们欢迎所有形式的贡献！请查看 贡献指南 了解详情。

🌟 贡献方式

• 🐛 报告 Bug
• 💡 提出功能建议
• 📖 改进文档
• 🔧 提交代码

---

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

---

🌟 如果这个项目对您有帮助，请给我们一个 Star

感谢您的支持！ 🙏

---

Made with ❤️ by h7ml