用于 TMS 项目的 Bulletproof Django API

项目介绍

本教程将指导您使用 Django 和 Django REST framework (DRF) 构建一个简单的 Web 应用，用于管理书籍信息，并通过 REST API 提供 CRUD (创建、读取、更新、删除) 操作。

先决条件

• 已安装 Python (建议版本 3.8 或更高)。
• 具备 Python 和 Django 的基础知识。
• 已安装 pip (Python 包安装程序)。
• 熟悉虚拟环境设置 (例如 venv)。

步骤一：环境搭建

推荐虚拟机配置:

• 内存 (RAM): 8GB，确保运行流畅，并为主机预留足够资源。
• 处理器: 4 核 (8 线程)。
• 存储: 100GB。
• 网络: 使用桥接网络，以便虚拟机拥有本地网络上的唯一 IP 地址，或使用 NAT 以便通过主机访问互联网。

虚拟机设置:

1. 下载 Ubuntu 镜像: 从官方网站下载 ubuntu-22.04-server-cloudimg-amd64.ova 文件。
2. 打开 VMware: 启动 VMware Workstation、VMware Fusion 或 VMware ESXi。
3. 导入 OVA 文件: 选择 文件 > 打开或导入 OVA，选择下载的 OVA 文件，并按照提示操作。
4. 命名虚拟机: 例如 tms_vm。
5. 配置虚拟机: 调整内存、处理器、硬盘和网络配置。

启动并配置 Ubuntu 22.04 服务器:

1. 启动虚拟机。
2. 登录并更新系统: sudo apt update && sudo apt upgrade -y
3. 安装必要工具: sudo apt install git python3 python3.10-venv python3-pip python3-venv git build-essential -y
4. 设置用户:

   sudo groupadd bulletproof
   sudo adduser django
   sudo usermod -ag bulletproof django

5. 创建项目目录: mkdir /home/django/projects
6. 更改目录所有权: sudo chown :bulletproof /home/django/projects
7. 设置权限: sudo chmod 775 /home/django/projects
8. 设置用户默认目录和权限:

   sudo usermod -d /home/django/projects django
   sudo chown django:bulletproof /home/django/projects
   su - django

VS Code 设置:

rebuild库存生产管理系统3.9.5

rebuild是一款高度可配置化的企业管理系统!可免费商用!低代码/零代码快速搭建企业中台、OA办公自动化、CRM客户关系管理、WMS库存管理、TMS运输管理、SCM供应链管理，甚至是 ERP 企业资源计划!REBUILD 侧重于业务需求实现，而非基础技术框架或项目启动模板，通过 REBUILD 可以真正实现零代码快速搭建，无需编程、无需编译代码，甚至无需了解技术。 使用开始使用 REBUIL

下载

为了远程开发，安装 Python 和 Pylance 扩展，以及 Flake8 (代码风格检查) 和 Black (代码格式化) 扩展。安装 Django 扩展以支持项目功能。确保在远程虚拟机中也通过 pip 安装 Flake8 和 Black。配置 Python 解释器使用虚拟环境，并在 VS Code 中启用代码检查和格式化。

1. 创建 pyproject.toml: (可选) 用于管理项目元数据和构建配置。示例:

   [tool.black]
   line-length = 100

2. 安装 Black: pip install black
3. 创建 .flake8 文件: 用于配置 Flake8 设置。示例:

   [flake8]
   max-line-length = 100
   extend-ignore = e203, w503

4. 安装 Flake8: pip install flake8

Python 设置:

1. 创建虚拟环境:

   mkdir tms && cd tms
   python3 -m venv .venv
   source .venv/bin/activate  # 在 Windows 上: env\scripts\activate

2. 安装 Django 和 DRF: pip install django djangorestframework
3. 创建 Django 项目: django-admin startproject tms .
4. 运行开发服务器: python manage.py runserver 0.0.0.0:8000

(如果遇到 django.core.exceptions.DisallowedHost 错误，请将服务器 IP 地址添加到 settings.py 中的 ALLOWED_HOSTS 列表中。)

访问 http://ip_address:8000 查看 Django 默认页面。

Git 仓库设置:

1. 创建 README.md 文件: 描述项目信息。
2. 创建 requirements.txt: pip freeze > requirements.txt
3. 创建许可证文件。
4. 创建 .gitignore 文件。
5. 生成 SSH 密钥: ssh-keygen -t ed25519 -c "your_email@example.com"
6. 将公钥添加到 GitHub。
7. 初始化 Git 仓库: git init
8. 添加远程仓库: git remote add origin git@github.com:username/repository.git
9. 提交代码: git add ., git commit -m "Initial commit", git push -u origin main

虚拟机快照:

完成初始设置后，创建虚拟机快照: VMware > 快照 > 拍摄快照，命名为 "initialsetup"。