ryanvmorais/django-fullstack-portfolio
GitHub: ryanvmorais/django-fullstack-portfolio
基于 Django 构建的专业级动态作品集模板，集成了防御性安全策略、数据库查询优化和自动化测试，旨在展示真实生产环境中的 Web 工程最佳实践。
Stars: 0 | Forks: 0
# 🌊 使用 Django 的动态作品集 | 教育类作品集模板
本仓库包含一个使用 Django 框架开发的**专业作品集**。虽然它在视觉上呈现为一个 *SPA*（单页应用），但该项目是作为一个健壮的系统构建的，专注于**高级安全性**、**数据库优化**和**整洁的架构**。
### 🎯 项目目标：
展示 Web 开发中**专业最佳实践**的应用，超越“基础 CRUD”。这里的重点是提供一个面向互联网的应用程序的实战示例，教导如何防范机器人、避免常见攻击，并以简单且极具启发性的方式优化数据库性能。
### 📚 你将在这个项目中找到什么？
该项目的结构旨在巩固软件工程的基本支柱：
* **攻防安全：** 实现 *Honeypot*（机器人陷阱）、*Rate Limit*（基于 IP 的发送限制），并集成 `bleach` 进行 HTML sanitization。
* **性能与扩展性：** 使用 `select_related` 和 `prefetch_related` 来缓解 N+1 查询问题，确保即时加载。
* **DevOps 思维：** 依赖结构划分为 `local`、`base` 和 `production`，并具有严格的 CSP (Content Security Policy) 和 HSTS 配置。
* **代码质量：** 使用 `pytest` 的自动化测试套件，覆盖成功流程和攻击尝试。
### 🧠 实施指南（代码背后的逻辑）：
对于初学者来说，最大的挑战不是记住 Django 命令，而是理解专业应用程序的**逻辑构建**。请查看构建该项目的核心支柱：
1. **关系型数据架构：** 我们使用 **Django 的 ORM** 来创建智能关系，而不是孤立的文本。例如，一个 `Projeto`（项目）关联到一个 `Categoria`（类别）和多个 `Tecnologias`（技术）。这使得数据库能为你工作，简化过滤和搜索。
2. **查询优化（性能）：** 为了避免网站变慢，我们使用了“高级技巧”：`select_related` 和 `prefetch_related`。它们减少了访问数据库的次数，在一次往返中获取所有必需的信息，这对于保持**高性能**至关重要。
3. **防御性安全 (Honeypot)：** 为了在不使用烦人的 CAPTCHA 的情况下保护联系表单，我们创建了一个“隐形陷阱”。这是一个人类看不到但机器人会自动填写的隐藏字段。如果该字段被填写，系统就会识别出机器人并默默丢弃发送请求。
4. **流量控制 (Rate Limiting)：** 为避免垃圾邮件攻击（每秒数千封邮件），我们在缓存中实现了锁定。系统监控用户的 IP，并在成功发送一次后，阻止其在 10 分钟内进行新的尝试，从而保护邮件服务器的完整性。
5. **内容净化 (Sanitização)：** 我们从不信任用户输入的内容。我们使用 `bleach` 库来“清理”收到的消息，确保任何注入恶意脚本（XSS 攻击）的尝试在到达数据库之前就被中和。
6. **浏览器加固 (CSP)：** 我们配置了 *Content Security Policy*。这就像是网站门口的保安，告诉浏览器：“只接受来自该服务器本身的样式和脚本”。这可以防止攻击者将外部代码注入你的前端。
7. **技能的动态展示：** 系统允许完全控制技能进度条的显示。通过管理面板，你可以定义每项技术的技能百分比（0 到 100）。如果你不想显示进度条，只需在管理面板 (*Admin*) 的个人资料中取消勾选 `Exibir barras de progresso` 部分并点击保存即可。
8. **友好的 URL (Slugs)：** 我们实现了自动生成 *Slugs*。这意味着 Django 将项目标题转换为人类和搜索引擎 (SEO) 易于阅读的链接，避免在 URL 中使用混乱的数字 ID。
9. **真实的生产环境：** 该项目不仅仅在你的计算机上运行。它采用环境变量 (`.env`) 和特定于服务器的配置（例如用于静态文件的 `WhiteNoise`）构建，确保在 **PythonAnywhere** 等平台上的部署顺畅且安全。
### 🛠️ 技术与工具：
为了保证最佳的学习体验并正确执行所有功能（例如自动屏幕清理），本项目使用了以下技术：
| 工具 | 描述 | 徽章 |
| :--- | :--- | :--- |
| **Python 3.10+** | 专注于后端可读性和效率的基础编程语言。 |  |
| **Django 4.2+** | “自带电池（功能完备）”的 Web 框架，用于所有的逻辑和 ORM。 |  |
| **Pytest** | 高级测试框架，保证每个功能的完整性。 |  |
| **Vanilla JS** | 纯 JavaScript (ES6+)，在没有繁重框架负担的情况下实现轻量级交互。 |  |
| **HTML5/CSS3** | 基于 Flexbox 和 Grid 的语义化结构和现代样式。 |  |
| **SQLite / Postgres** | 用于安全持久化信息的关系型数据库。 |  |
### ⚙️ 如何在本地运行项目：
1. **克隆代码仓库：**
git clone https://github.com/ryanvmorais/django-fullstack-portfolio.git
2. **配置环境变量：**
- 将 `.env.example` 文件复制为 `.env` 并输入你的密钥（SECRET_KEY、EMAIL_USER 等）。
3. **安装依赖项：**
pip install -r requirements.txt
4. **执行迁移并启动服务器：**
python manage.py migrate
python manage.py runserver
### 📋 练习活动（进阶挑战）：
为了练习所学知识并精通 Django，请尝试实现这些新功能：
1. **📊 统计仪表板（自定义 Admin）：** 在 Django Admin 中，创建一个显示每天收到多少封电子邮件的视图。
* **学习收获：** 你将学习如何操作 `admin.ModelAdmin` 并处理数据库聚合 (`Count`, `Sum`)。
2. **🌓 主题切换器（深色/浅色模式）：** 在前端创建一个按钮，在当前主题和网站的浅色版本之间切换，并将偏好设置保存在浏览器的 `localStorage` 中。
* **学习收获：** 强化对 **使用 Vanilla JS 进行 DOM 操作** 以及 CSS 变量 (*Design Tokens*) 使用的掌握。
3. **✉️ Push 通知或 Telegram：** 更改联系功能，使得在发送电子邮件之外，每当有人填写表单时，还会向 Telegram 机器人发送通知或在 Discord 中发送消息。
* **学习收获：** 你将学习如何使用 `requests` 库将 Django 与**外部 API** 集成。
4. **📂 动态项目筛选：** 在项目部分实现一个搜索系统，无需重新加载页面即可过滤结果（使用 AJAX）。
* **学习收获：** 掌握复杂的 **Querysets** 以及前端和后端之间的异步通信。
### 💡 有疑问或建议吗？
使用 Django 开发健壮且安全的系统涉及许多技术细节，但我在这里提供帮助！如果你在代码中发现了意外行为、在环境配置中遇到困难，或者想到了能让这个项目更具教学意义的架构改进：
* **提交一个 [Issue](https://github.com/ryanvmorais/django-fullstack-portfolio.git)：** 点击链接并描述你的疑问或建议。这是为社区构建可靠参考资料并帮助其他可能有相同问题的开发者的最佳方式！
* **给我发电子邮件：** 如果你更喜欢私下交流，可以写信到 [**contato@ryanmorais.com.br**](mailto:contato@ryanmorais.com.br)。
我将非常高兴能看到你在 Django 框架方面的进步，并接收你的反馈，以不断提高这份学习资料的质量！🤝
### ⚖️ 许可证
本项目基于 **MIT 许可证**。这意味着你可以随意使用、复制和修改代码，包括用于你自己的项目。有关更多详细信息，请参阅 [LICENSE](LICENSE) 文件。
标签：Django, Syscall, Web开发, 个人作品集, 逆向工具, 项目模板