https://github.com/ppvan/tree
Ecommerce website build with django
https://github.com/ppvan/tree
django python python3
Last synced: about 2 months ago
JSON representation
Ecommerce website build with django
- Host: GitHub
- URL: https://github.com/ppvan/tree
- Owner: ppvan
- License: gpl-3.0
- Created: 2023-03-27T13:24:07.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-06-28T16:40:11.000Z (almost 3 years ago)
- Last Synced: 2025-11-10T21:33:17.499Z (7 months ago)
- Topics: django, python, python3
- Language: CSS
- Homepage:
- Size: 35.5 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Tree
## Cài đặt môi trường
### Cài đặt WSL 2 hoặc Dual Boot
> Nếu bạn chưa cài đặt WSL 2 hoặc Dual Boot, hãy làm theo hướng dẫn [ở đây](https://docs.microsoft.com/en-us/windows/wsl/install-win10)
### Cài đặt Vscode để kết nối với WSL
> Cài đặt Vscode [ở đây](https://code.visualstudio.com/download)
> Hướng dẫn sử dụng Vscode và WSL [ở đây](https://code.visualstudio.com/docs/remote/wsl)
### Cài đặt Python
Cài đặt Python 3.10 (bắt buộc) và thêm vào PATH. Kiểm tra
```bash
$ python --version
Python 3.10.10
```
Clone project về máy và cài đặt các thư viện cần thiết
```bash
$ git clone https://github.com/ppvan/tree.git
$ cd tree
```
#### Tạo môi trường ảo Python
```bash
$ python -m venv venv
```
Kích hoạt môi trường ảo
> Linux
```bash
$ source venv/bin/activate
```
Cài đặt các thư viện
```bash
$ pip install -r requirements.txt
```
#### Cài đặt database (Postgres)
> Hướng dẫn cho arch linux
```
sudo pacman -S postgresql
sudo systemctl enable postgresql.service
sudo systemctl start postgresql.service
```
> Thường thì sẽ có một tài khoản mặc định postgres, project được config theo cái này.
> Nếu cần thay đổi xem phần config env
#### Config môi trường
```
DB_NAME - Tên database
DB_USER - Tên người dùng database, cần có quyền tạo bảng
DB_PASSWORD - Mật khẩu người dùng
DB_HOST - Host database (thường là localhost trừ khi deploy db riêng)
DB_PORT - Cổng database chạy
EMAIL_HOST - Server STMP Mail
EMAIL_HOST_USER - Tên người dùng đại diện ứng dụng
EMAIL_HOST_PASSWORD Mật khẩu mail
SECRET_KEY Key để Django thực hiện các chức năng bảo mật
```
### Chạy server
```bash
$ python manage.py runserver
```
Khi dev frontend, mở thêm 1 terminal để chạy tailwind (cần cài sẵn nodejs)
```bash
$ cd tailwind/
$ npm run dev
```
Để vscode nhận diện thư viện nhằm hỗ trợ auto complete, format code, ...
Tổ hợp phím `Ctrl + Shift + P` và gõ `Python: Select Interpreter` chọn `venv` trong thư mục project
## Cách dùng git
- Chỉ làm việc trên branch của mình
- Tạo pull request để merge code vào branch `main`
- Trước khi code bất kì thứ gì, hãy pull code mới nhất về
## Tip django
[CONTRIBUTE.md](https://github.com/ppvan/tree/blob/main/CONTRIBUTE.md)
## Tiêu chuẩn code
- Luôn đặt tên biến, hàm dạng `snake_case`, tên class dạng `CamelCase`
- Hạn chế comment nhưng cần viết Docsstring cho các hàm, class
- Sử dụng VScode + flake8 + autopep8 để format code