很长一段时间以来，我一直想学习 django 框架，但另一个更紧迫的项目始终占据优先地位。和许多开发人员一样，我在机器学习方面使用 python，但当我第一次学习 Web 编程时，php 仍然占据主导地位，所以当我需要选择一个新的复杂框架来创建 Web 应用程序来发布我的机器时学习工作中，我还是转向了PHP。一段时间以来，我一直在使用名为 Laravel 的框架来构建我的网站，这个 PHP 框架向我介绍了现代 Web 编程的模型-视图-控制器模式。让事情变得更加复杂的是，我喜欢使用现代 JavaScript 框架构建我的前端。我最熟悉 vue.JS，因此对于这个项目，我坚持使用 Vue.js，尽管更常见的是人们使用 React。
为什么要使用复杂的框架？学习 Django、laravel、React 或 Vue 等框架的最大挑战是什么？
每个人都有自己的答案，但我越来越喜欢 mvc 框架，因为它们提供了很多关于如何构建应用程序的指导。它使我不必每次都重新发明轮子。起初，这些框架看起来有些限制和神秘，但一旦我熟悉了结构，我发现添加新功能会更容易。
挑战在于事情可能变得过于简单。像 Django 这样的框架依赖于许多速记或假设，这些速记或假设可能基于熟悉的概念，但在 Django 中具有特定的不熟悉的名称和结构。在我的应用程序中，Django 处理 API 和所有 Web 路由。如果我想添加新的 API 端点，我需要将一个函数添加到 view.py 中的文件中，然后转到 urls.py 文件并添加一条语句来导入该函数，并添加另一条语句来定义该函数所在的 URL。 API端点可用。之后，我需要编辑前端 Vue 组件以使用 JavaScript 查询该端点以获取数据并向用户显示或操作它。
一旦我的项目建立起来，添加这样的功能很快。我只需要添加大约四行代码，然后我就可以专注于views.py 文件中新函数所需的逻辑，以处理 http 请求并以 JSON 格式返回所需的数据。具有挑战性的部分是了解这些文件是什么以及它们如何协同工作来创建整个应用程序。
我发现学习像 Django 这样的框架的最佳方法是找到一个工作示例并开始尝试进行小的更改以了解数据流。当概念开始变得更加清晰且更有意义时，请参阅文档。要求人工智能模型解释代码片段以及框架中不同标准文件的作用。很快我们就会意识到这些工具的出现是为了从长远来看节省时间并简化应用程序的维护和更新。由于 Django 和 Vue 框架具有标准结构，因此当您稍后再回顾它们时，您会发现更容易理解为什么以某种方式编码，并且更容易重新熟悉您的工作。由于您熟悉他们的应用程序的基本结构，因此更容易学习别人的应用程序并理解核心功能。
那么 Django 的一些基础知识可以帮助人们入门吗？对我来说，首先要了解的是，Django 项目是通过运行命令来创建新的 Django 项目而生成的，这会生成一组基本文件和文件夹，这些文件和文件夹构成了可用于开始构建的“基础项目”。项目文件夹将包含几个 python 文件，其中的设置适用于整个项目。您会发现自己经常访问的重要文件是 settings.py（所有设置都在其中）和 urls.py。当您有“Django 如何决定将静态文件放在哪里”之类的问题时，答案通常位于 settings.py 中的某个位置。当您想要向应用程序添加新 URL 时，您需要更新 urls.py 文件。
除了这些项目级文件之外，您还可以为项目中的每个应用程序创建一个文件夹。然后需要在 settings.py 文件中注册（即命名）这些应用程序。我的项目中的主应用程序文件夹称为文档。在该文件夹中，我有一个 models.py 文件、一个 serializer.py 文件、一个views.py 文件。还有其他的，但这是重要的三个。
在 models.py 中，我指定了我的 Document 对象及其具有的字段。 Django 帮我在 IRIS 数据库中创建一个 Documents 表，其中包含保存我计划存储在 Document 对象中的信息所需的架构。在我的 models.py 文件中，我告诉它我的文档都有一个名称（不超过 255 个字符的字符串）、一个内容字段（只是大量文本）以及一个数据库名称（其中向量）存储（另一个文本字段）、嵌入类型（另一个文本字段），最后是向量嵌入维度（一个数字）。使用这些定义，Django 创建具有必要列类型的必要数据库表。将对象保存到数据库就像 Document.save() 一样简单。
serializer.py 文件内部只是一个关于如何将对象转换为 json 的定义，反之亦然。对于基本用例，有一个标准方法来定义它，您可以在这个项目中看到它。
现在我们进入 Django 的重点，views.py 文件。我们在这里定义接受 HTTP 请求并返回数据（例如整个 HTTP 响应）或 JSON API（如果是 JSON API）的函数。这意味着 Django 可以提供整个网页，也可以作为您应用程序的前端，或者它可以只提供 JSON 数据，您可以在完全不同的平台上构建您的前端。
一开始使用所有这些看似任意的文件和约定可能会让人感觉很麻烦，但是一旦您发现这样做意味着您的应用程序刚刚开始工作并处理 HTTP 请求并提供正确的数据作为响应，它就可以不断构建新的特性和功能是非常有趣的。一旦您定义了一个对象、Web 路由和函数来处理 HTTP 请求，您就会意识到定义第二个和第三个对象来向应用程序添加功能是多么容易。
我从 github 上的 @guillaume.Rongier7183 创建的 Iris Django 模板中分叉了我的项目：https://github.com/grongierisc/iris-django-template
该模板仅包含 Django，对于学习 Django 框架非常有帮助。 我所做的主要添加之一是添加带有 Tailwind css 的 Vue.js，以表明您可以将现代 Javascript 框架与此包集成，并在 IRIS 上运行单页应用程序。单页面应用程序是一个 JavaScript 应用程序，它发送 xhr 请求以获取 JSON 数据并动态更新页面，而无需完全重新加载页面。它有其优点和缺点，但它是现代 Web 开发的标志。
我鼓励人们不仅将我的项目视为 IRIS 上的 RAG 和 Vector Stores 的示例，而且将其视为使用 Django 与 Vue.js 和 Tailwind 的模板，以便在其之上轻松快速地创建现代灵活的 Web 应用程序虹膜。该存储库位于 github 上：https://github.com/mindfulcoder49/iris-django-template
我很乐意回答任何问题或提供任何见解，以了解任何人在尝试调整此项目以供自己使用时可能遇到的任何问题。
