中文 English

• Python

  • 后端语言

• Django

  • 提供数据库

  • 后端，提供数据库支持和服务

  • 提供简要前端和便捷的后台管理页面

  • 版本 >= 3.2

  • 更低版本的可能问题

    • 类型注解出错

      • 类型注解不影响代码执行，但仍可能导致项目无法运行。错误源于QuerySet不支持[]。
      • 推荐解决方案（添加于错误代码前） QuerySet.__class_getitem__ = classmethod(lambda cls, *args, **kwargs: cls)
      • 若您了解Python的类型注解，也可以注释所有涉及QuerySet[]的类型注解。

    • 后台侧边栏渲染异常

• Vue(推荐，非必要)

  • 前端，提供更精致可互动的呈现页面

1. 安装Django

   pip install django

2. 创建迁移

   python manage.py makemigrations

3. 执行迁移

   python manage.py migrate

   此后无需执行1-3步

4. 查看本机ip(用于部署，可选)

   • Windows ipconfig -> WLAN部分 -> IPv4(v6)地址

   • MacOS/Linux ifconfig -> addr

5. 运行开发服务器

   python manage.py runserver [[ip:]port]

   • 部署 python manage.py runserver $ip$:80，其中$ip$是第四步查询的本机ip

   • 调试网页 python manage.py runserver 0:80 python manage.py runserver 80 python manage.py runserver

6. 访问服务

   1. 若无异常，第5步输出类似于：

      Django version 3.2, using settings 'managing.settings'
      Starting development server at http://127.0.0.1:8000/
      Quit the server with CTRL-BREAK.
      

   2. 此时，通过第二行的网址(示例中为http://127.0.0.1:8000/)即可访问网页

      URL未设置时，你应在网页中看到一个火箭和以下内容：

      The install worked successfully! Congratulations!
      You are seeing this page because DEBUG=True is in
      your settings file and you have not configured any URLs.
      

      正常情况下呈现一个简单的页面，包含最近的一条记录信息

7. 运行Vue前端

   npm run serve

   注：首次运行时还需执行npm run install.

   

8. 关闭服务

   命令行键入CTRL-BREAK，服务将被关闭，终端恢复到可输入状态

在Django可正常启动后，可以使用进阶操作提升效率

• 后台管理

  1. 创建管理员账户

     python manage.py createsuperuser按提示输入信息

  2. 运行Django

  3. 访问后台并登录

     • 直接访问项目URL/admin(示例中为http://127.0.0.1:8000/admin/)
     • 访问项目首页，点击超链接跳转

• 单元测试

  1. 在indoor_positioning/tests.py中创建继承自TestCase的测试用例

     每个测试用例对应一个场景或环境

  2. 定义setUp为该测试用例的系列测试创建统一的环境

  3. 编写测试，测试是以test开始的方法

     注意：每个测试都将生成一个独立的实例并执行一次setUp

  4. 运行测试

     • Django自带测试
       • python manage.py test
       • python manage.py test [APP[.FILE[.CASE[.TEST]]]]
       • 单个测试不太方便，但安全
     • VSCode
       • 可通过左侧测试栏进行快捷、自动测试，并支持调试和部分测试，但使用生产数据库(测试后会恢复)，存在数据干扰
       • 也可使用launch.json，创建测试配置执行Django自带测试并调试

     注意：单元测试将启用独立的临时数据库，不干扰已有数据

已略去部分文件

├── manage.py                   Django启动文件
├── managing                    配置目录
│   ├── settings.py                 Django配置文件
│   └── urls.py                     网络路由配置
├── indoor_positioning          定位（核心）
│   ├── models.py                   数据库模型
│   ├── views.py                    视图，提供网络服务
│   ├── utils.py                    工具函数，后端算法
│   ├── admin.py                    后台
│   └── tests.py                    单元测试
├── algorithms/algorithms.ipynb 交互式显示算法效果
├── templates                   模板目录
│   ├── receive.html                接收数据页面
│   ├── show_position.html          基于Django的定位页面，前后端结合
│   └── vue.html                    基于Vue的定位页面，前后端分离
├── static                      静态文件目录
├── frontend                    前端目录
├── README.md                   帮助
├── README_EN.md                英文帮助
└── db.sqlite3                  临时数据库，首次运行代码时生成，可改为其他数据库

本项目创建于2022年4月3日，于2022年5月8日初步完成，著作权归北京大学2021-2022学年春季学期计算机网络（实验班）第五小组（下称为“本团队”）所有。 项目仅供学习参考使用。未经许可，不得用于学习以外的用途，本团队不承担由此产生的任何义务和后果。