python旅遊小項目

小旅遊小項目展示

本項目采用 vant-UI 作為項目的 UI ，快速成型界面， Vant 的官方位址：
- https://vant-contrib.gitee.io/vant/#/zh-CN/home
前端頁面采用 Vue-cli 成型，後端依靠 Django ，使用 Api 通信快速完成

前端頁面展示

首頁面

python旅遊小項目

搜尋頁面

python旅遊小項目

我的頁面

python旅遊小項目

其他頁面

python旅遊小項目	python旅遊小項目	python旅遊小項目
python旅遊小項目	python旅遊小項目	python旅遊小項目
python旅遊小項目	python旅遊小項目	python旅遊小項目
python旅遊小項目	python旅遊小項目	python旅遊小項目

後端頁面展示

python旅遊小項目

`PDMan` ORM模組化

system子產品
sight子產品
accounts子產品
order子產品

關系圖

python旅遊小項目

`API` 接口

`accounts` 子產品接口

####使用者登入

api

請求URL（POST）

/account/user/api/login/

請求參數

參數值	類型	描述
`username`	必填	使用者名
`password`	必填	密碼

傳回執行個體

{
    "user": {
        "nickname": "李四",
        "avatar": "http://localhost:8000/medias/avatar/202105/%E4%B8%BB%E4%BA%A7%E5%93%81.png",
        "username": "17083430700"
    },
    "profile": {
        "real_name": "ZRR",
        "sex": 1,
        "sex_display": "男"
    }
}

使用者登出 `api`

請求URL（GET）

/account/user/api/logout/

傳回狀态碼 status =201

使用者注冊 `api`

請求URL（POST）

/account/user/api/register/

請求參數（需用到驗證碼接口）

參數值	類型	描述
`username`	必填	手機号
`password`	必填	密碼
`nickname`	必填	昵稱
`sms_code`	必填	驗證碼

傳回執行個體

{
    "user": {
        "nickname": "張三",
        "avatar": "",
        "username": "17083430701"
    },
    "profile": {
        "real_name": "",
        "sex": 1,
        "sex_display": "男"
    }
}

使用者詳細資訊 `api`

請求URL（GET）

/account/user/api/info/

傳回執行個體

{
    "user": {
        "nickname": "張三",
        "avatar": "",
        "username": "17083430701"
    },
    "profile": {
        "real_name": "",
        "sex": 1,
        "sex_display": "男"
    }
}

`system` 子產品接口

輪播圖 `api`

請求URL（GET）

/system/slider/list/

傳回執行個體

{
    "meta": {},
    "objects": [
        {
            "id": 1,
            "img_url": "http://localhost:8000/medias/202105/slider/banner2.png",
            "target_url": null,
            "name": "窦大夫祠"
        },
        {
            "id": 2,
            "img_url": "http://localhost:8000/medias/202105/slider/banner1.png",
            "target_url": null,
            "name": "二龍山"
        },
        {
            "id": 3,
            "img_url": "http://localhost:8000/medias/202105/slider/banner3.png",
            "target_url": null,
            "name": "崛圍山"
        }
    ]
}

`smsCodeapi`

請求URL（POST）

/system/send/sms/

請求參數

參數值	類型	描述
`phone_num`	必填	手機号

傳回執行個體

{
    "phone_num": "17083430701",
    "sms_code": 397702,
    "timeout": 300
}

`sight` 子產品接口

景點清單 `api`

請求URL（GET）

/sight/sight/list/

請求參數

參數值	類型	描述
`page`	選填	頁碼
`is_hot`	選填	是否熱門
`is_top`	選填	是否精選
`name`	選填	名稱

傳回執行個體

{
    "meta": {
        "total_count": 6,
        "page_count": 2,
        "current_page": 2
    },
    "objects": [
        {
            "id": 27,
            "name": "迎澤公園",
            "main_img": "http://localhost:8000/medias/202105/sight/wKgE2l1bTouAHckxACFKt8kMMXs85.jpg",
            "score": 5.0,
            "city": "太原",
            "min_price": 10.0,
            "province": "山西",
            "comment_count": 0
        }
    ]
}

景點緩存（ `redis` ）清單

請求URL（GET）

/sight/sight/list/cache/

同景點清單 api 一樣

景點詳細資訊 `api`

請求URL（GET）

/sight/sight/detail/<int:pk>/

傳回執行個體

{
    "id": 1,
    "name": "二龍山",
    "desc": "二龍山",
    "img": "http://localhost:8000/medias/202105/sight/04f1842f6cea4753aebde62e9b680a97.jpg",
    "score": 5.0,
    "content": "<h1>位于太原市西北部，中北大學校内，山高百餘米，景色秀麗，山上鮮花遍開，有益足道、愛心林、怡人台、龍山飛瀑、愛心台、長廊、大型草畫等景點，為中北大學勤工助學學生修建而成。</h1>\r\n\r\n<hr />\r\n<p><span class=\"marker\">交通</span></p>\r\n\r\n<p>835路中北大學站</p>\r\n\r\n<p><span class=\"marker\">門票</span></p>\r\n\r\n<p>具體詳情請咨詢景區</p>\r\n\r\n<p><span class=\"marker\">開放時間</span></p>\r\n\r\n<p>全天 (1月1日-12月31日 周一-周日)</p>\r\n\r\n<hr />\r\n<h2>景點位置</h2>\r\n\r\n<p>山西省太原市尖草坪區上蘭村（中北大學校園内）</p>",
    "province": "山西",
    "city": "太原",
    "area": "尖草坪",
    "town": "上蘭村",
    "min_price": 10.0,
    "comment_count": 1,
    "image_count": 1
}

景點評論清單 `api`

請求URL（GET）

/comment/list/<int:pk>/

請求參數

參數值	類型	描述
`page`	選填	頁碼

傳回執行個體

{
    "meta": {
        "total_count": 1,
        "page_count": 1,
        "current_page": 1
    },
    "objects": [
        {
            "user": {
                "pk": 2,
                "nickname": "李四"
            },
            "pk": 2,
            "content": "二龍山又名烈石山，西臨汾河，地勢險要，是太原的北大門。解放戰争期間，閻錫山軍隊在烈石山上修建了大量軍事設施，現儲存有碉堡3座、地下暗道1處。二龍山，在太原市西北角中北大學校園内，是少有的和校園相依托的風景區。山勢不太高，但是景色秀麗，山上鮮花遍布，景點衆多，太原二龍山旅遊風景區是太原為數不多的避暑勝地。",
            "love_count": 65,
            "score": 5.0,
            "is_public": 1,
            "images": [
                {
                    "img": "http://localhost:8000/medias/202105/file/c711f75cfc1f4f3d8c009bbb21919a2e.jpg",
                    "summary": "二龍山評論"
                },
                {
                    "img": "http://localhost:8000/medias/202105/file/2427bc6964aa48b08ec3b6fc56de6552.jpg",
                    "summary": "二龍山評論"
                },
                {
                    "img": "http://localhost:8000/medias/202105/file/019f654a568044a5ae091043923c378c.jpg",
                    "summary": "二龍山評論"
                }
            ],
            "created_at": "2021-04-15"
        }
    ]
}

景點下的門票清單 `api`

請求URL（GET）

/ticket/list/<int:pk>/

請求參數

參數值	類型	描述
`page`	選填	頁碼

傳回執行個體

{
    "meta": {
        "total_count": 1,
        "page_count": 1,
        "current_page": 1
    },
    "objects": [
        {
            "pk": 1,
            "name": "二龍山門票",
            "desc": "23:52前可訂明日",
            "types": 11,
            "price": 10.0,
            "discount": 10.0,
            "total_stock": 100000,
            "remain_stock": 99976,
            "sell_price": 10.0
        }
    ]
}

####景點介紹

api

請求URL（GET）

/sight/info/<int:pk>/

傳回執行個體

{
    "pk": 1,
    "entry_explain": "<h1>位于太原市西北部，中北大學校内，山高百餘米，景色秀麗，山上鮮花遍開，有益足道、愛心林、怡人台、龍山飛瀑、愛心台、長廊、大型草畫等景點，為中北大學勤工助學學生修建而成。</h1>\r\n\r\n<hr />\r\n<p>交通</p>\r\n\r\n<p>835路中北大學站</p>\r\n\r\n<p>門票</p>\r\n\r\n<p>具體詳情請咨詢景區</p>\r\n\r\n<p>開放時間</p>\r\n\r\n<p>全天 (1月1日-12月31日 周一-周日)</p>\r\n\r\n<hr />\r\n<h2>景點位置</h2>\r\n\r\n<p>山西省太原市尖草坪區上蘭村（中北大學校園内）</p>",
    "play_way": "<h3>二龍山又名烈石山，西臨汾河，地勢險要，是太原的北大門。解放戰争期間，閻錫山軍隊在烈石山上修建了大量軍事設施，現儲存有碉堡3座、地下暗道1處。二龍山，在太原市西北角中北大學校園内，是少有的和校園相依托的風景區。山勢不太高，但是景色秀麗，山上鮮花遍布，景點衆多，太原二龍山旅遊風景區是太原為數不多的避暑勝地。</h3>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/2340c93ebce0477b82788c24318edabb.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/719ec2d7ebce4ac88f286ea863e243d7.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/9a7d9bb6b64d427d871efb3619d8bfd9.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/0b7568fc46794e778ac4204cfff7c403.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/887b1678c5c84c11a0fd34439abdb8ba.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/fb1d4c4aa4f94fe48f6a5f59f35e4c8d.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/0f48ef1e3f94444d86a871eafa69f47e.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/019f654a568044a5ae091043923c378c.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/2427bc6964aa48b08ec3b6fc56de6552.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/2ffe0923eedc4765888ce1ff6cda71a4.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/20c36e99210f41e9a3706d05e4ea6cc8.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/ed7886c77b0b42e3b7d7c32fe60805ef.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/c711f75cfc1f4f3d8c009bbb21919a2e.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/04f1842f6cea4753aebde62e9b680a97.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/12e2e1a4def4490dae87237799a55ee8.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/10651892dc234bc7b63dab3263dccf85.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/7b0c11d676f749478e827ca7b35d54ac.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/2f47940515ed4d06bcf4ecc29bbcffc4.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/32920e45f036419fa09a7c9c51cfbbd3.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/bef9359ad2354ef88a49453c02ced182.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/e64328fb06cf40d1b9288924f4af3dc8.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/f2f1c116018d43e59c5ed55f6940be7a.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/232bf0fa1d0d475c9704e8c29dc41147.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>\r\n\r\n<p><img src=\"https://ss2.meipian.me/users/418550/6253aa30173e454bb78bb9f79756f191.jpg?imageView2/2/w/750/h/1400/q/80\" /></p>",
    "tips": "<h4><strong>小貼士</strong></h4>\r\n\r\n<p>交通</p>\r\n\r\n<p>835路中北大學站</p>\r\n\r\n<p>門票</p>\r\n\r\n<p>具體詳情請咨詢景區</p>\r\n\r\n<p>開放時間</p>\r\n\r\n<p>全天 (1月1日-12月31日 周一-周日)</p>",
    "traffic": "<h2>景點位置</h2>\r\n\r\n<p>山西省太原市尖草坪區上蘭村（中北大學校園内）</p>"
}

景點詳情圖檔清單 `api`

請求URL（GET）

/sight/image/list/<int:pk>

請求參數

參數值	類型	描述
`page`	選填	頁碼

傳回執行個體

{
    "meta": {
        "total_count": 1,
        "page_count": 1,
        "current_page": 1
    },
    "objects": [
        {
            "image": "http://localhost:8000/medias/202105/file/2ffe0923eedc4765888ce1ff6cda71a4.jpg",
            "summary": "二龍山基礎"
        }
    ]
}

門票詳情 `api`

請求URL（GET）

/sight/ticket/detail/<int:pk>

傳回執行個體

{
    "pk": 1,
    "name": "二龍山門票",
    "desc": "23:52前可訂明日",
    "types": 11,
    "price": 10.0,
    "sell_price": 10.0,
    "discount": 10.0,
    "expire_date": 7,
    "return_policy": "聯系管理者",
    "has_invoice": true,
    "entry_way": "短信換票入園",
    "tips": "<div>位于太原市西北部，中北大學校内，山高百餘米，景色秀麗，山上鮮花遍開，有益足道、愛心林、怡人台、龍山飛瀑、愛心台、長廊、大型草畫等景點，為中北大學勤工助學學生修建而成。</div>\r\n\r\n<hr />\r\n<p>交通</p>\r\n\r\n<p>835路中北大學站</p>\r\n\r\n<p>門票</p>\r\n\r\n<p>具體詳情請咨詢景區</p>\r\n\r\n<p>開放時間</p>\r\n\r\n<p>全天 (1月1日-12月31日 周一-周日)</p>\r\n\r\n<hr />\r\n<h2>景點位置</h2>\r\n\r\n<p>山西省太原市尖草坪區上蘭村（中北大學校園内）</p>",
    "remark": "<p>這裡沒有小<span class=\"marker\">tips</span></p>"
}

`order` 子產品接口

訂單送出 `api`

請求URL（POST）

/order/ticket/submit/

請求參數

參數值	類型	描述
`ticket_id`	必填	門票ID
`play_date`	必填	出行時間
`to_user`	必填	使用者昵稱
`to_phone`	必填	使用者手機号
`buy_count`	必填	購買總價

傳回執行個體

{
    "sn": "202105171247379691779086"
}

####訂單詳情

api

請求URL（GET）

/order/order/detail/<int:sn>

傳回執行個體

{
    "sn": "202105171247379691779086",
    "buy_count": 20,
    "buy_amount": 200.0,
    "types": 10,
    "status": 11,
    "created_at": "2021-05-17",
    "remark": null,
    "to_user": "李四",
    "to_area": "",
    "to_address": "",
    "to_phone": "17083430700",
    "express_type": null,
    "express_no": null,
    "items": [
        {
            "pk": 21,
            "flash_name": "二龍山門票",
            "flash_price": 10.0,
            "flash_img": "http://localhost:8000/medias/202105/sight/7b0c11d676f749478e827ca7b35d54ac.jpg",
            "flash_origin_price": 10.0,
            "flash_discount": 10.0,
            "count": 20,
            "amount": 200.0,
            "remark": "出行時間2021-05-20",
            "object_id": 1,
            "app_label": "sight",
            "model": "ticket"
        }
    ]
}

訂單清單

請求URL（GET）

/order/order/list/

請求參數

參數值	類型	描述
`page`	選填	描述

傳回執行個體

{
    "meta": {
        "total_count": 1,
        "page_count": 1,
        "current_page": 1
    },
    "objects": [
        {
            "sn": "202105171247379691779086",
            "buy_amount": 200.0,
            "buy_count": 20,
            "types": 10,
            "status": 11,
            "remark": null,
            "created_at": "2021-05-17",
            "item_first": {
                "pk": 21,
                "flash_name": "二龍山門票",
                "flash_price": 10.0,
                "flash_img": "http://localhost:8000/medias/202105/sight/7b0c11d676f749478e827ca7b35d54ac.jpg",
                "flash_origin_price": 10.0,
                "flash_discount": 10.0,
                "count": 20,
                "amount": 200.0,
                "remark": "出行時間2021-05-20",
                "object_id": 1,
                "app_label": "sight",
                "model": "ticket"
            }
        }
    ]
}

全局狀态 `Code`

status	Code	描述
404	4004000	您通路的内容不存在或被删除
400	4000000	參數格式不正确
405	4050000	表單請求方式錯誤
401	4010000	請登入
500	5000000	伺服器正忙，請稍後重試

python旅遊小項目

小旅遊小項目展示

前端頁面展示

首頁面

搜尋頁面

我的頁面

其他頁面

後端頁面展示

PDMan ORM模組化

關系圖

API 接口

accounts 子產品接口

使用者登出 api

使用者注冊 api

使用者詳細資訊 api

system 子產品接口

輪播圖 api

smsCodeapi

sight 子產品接口

景點清單 api

景點緩存（ redis ）清單

景點詳細資訊 api

景點評論清單 api

景點下的門票清單 api

景點詳情圖檔清單 api

門票詳情 api

order 子產品接口

訂單送出 api

訂單清單

全局狀态 Code

繼續閱讀

`PDMan` ORM模組化

`API` 接口

`accounts` 子產品接口

使用者登出 `api`

使用者注冊 `api`

使用者詳細資訊 `api`

`system` 子產品接口

輪播圖 `api`

`smsCodeapi`

`sight` 子產品接口

景點清單 `api`

景點緩存（ `redis` ）清單

景點詳細資訊 `api`

景點評論清單 `api`

景點下的門票清單 `api`

景點詳情圖檔清單 `api`

門票詳情 `api`

`order` 子產品接口

訂單送出 `api`

全局狀态 `Code`