diff --git a/README.md b/README.md index 5a504094f..4f54bc1e8 100644 --- a/README.md +++ b/README.md @@ -1,304 +1,169 @@ -
- -

- -[![GitHub Repo stars](https://img.shields.io/github/stars/InternLM/xtuner?style=social)](https://github.com/InternLM/xtuner/stargazers) -[![license](https://img.shields.io/github/license/InternLM/xtuner.svg)](https://github.com/InternLM/xtuner/blob/main/LICENSE) -[![PyPI](https://img.shields.io/pypi/v/xtuner)](https://pypi.org/project/xtuner/) -[![Downloads](https://static.pepy.tech/badge/xtuner)](https://pypi.org/project/xtuner/) -[![issue resolution](https://img.shields.io/github/issues-closed-raw/InternLM/xtuner)](https://github.com/InternLM/xtuner/issues) -[![open issues](https://img.shields.io/github/issues-raw/InternLM/xtuner)](https://github.com/InternLM/xtuner/issues) - -👋 join us on [![Static Badge](https://img.shields.io/badge/-grey?style=social&logo=wechat&label=WeChat)](https://cdn.vansin.top/internlm/xtuner.jpg) -[![Static Badge](https://img.shields.io/badge/-grey?style=social&logo=twitter&label=Twitter)](https://twitter.com/intern_lm) -[![Static Badge](https://img.shields.io/badge/-grey?style=social&logo=discord&label=Discord)](https://discord.gg/xa29JuW87d) - -🔍 Explore our models on -[![Static Badge](https://img.shields.io/badge/-gery?style=social&label=🤗%20Huggingface)](https://huggingface.co/xtuner) -[![Static Badge](https://img.shields.io/badge/-gery?style=social&label=🤖%20ModelScope)](https://www.modelscope.cn/organization/xtuner) -[![Static Badge](https://img.shields.io/badge/-gery?style=social&label=🧰%20OpenXLab)](https://openxlab.org.cn/usercenter/xtuner) -[![Static Badge](https://img.shields.io/badge/-gery?style=social&label=🧠%20WiseModel)](https://www.wisemodel.cn/organization/xtuner) - -English | [简体中文](README_zh-CN.md) - -
- -## 🚀 Speed Benchmark - -- Llama2 7B Training Speed - -
- -
- -- Llama2 70B Training Speed - -
- -
- -## 🎉 News -- **\[2025/02\]** Support [OREAL](https://github.com/InternLM/OREAL), a new RL method for math reasoning! -- **\[2025/01\]** Support [InternLM3 8B Instruct](https://huggingface.co/internlm/internlm3-8b-instruct)! -- **\[2024/07\]** Support [MiniCPM](xtuner/configs/minicpm/) models! -- **\[2024/07\]** Support [DPO](https://github.com/InternLM/xtuner/tree/main/xtuner/configs/dpo), [ORPO](https://github.com/InternLM/xtuner/tree/main/xtuner/configs/orpo) and [Reward Model](https://github.com/InternLM/xtuner/tree/main/xtuner/configs/reward_model) training with packed data and sequence parallel! See [documents](https://xtuner.readthedocs.io/en/latest/dpo/overview.html) for more details. -- **\[2024/07\]** Support [InternLM 2.5](xtuner/configs/internlm/internlm2_5_chat_7b/) models! -- **\[2024/06\]** Support [DeepSeek V2](xtuner/configs/deepseek/deepseek_v2_chat/) models! **2x faster!** -- **\[2024/04\]** [LLaVA-Phi-3-mini](https://huggingface.co/xtuner/llava-phi-3-mini-hf) is released! Click [here](xtuner/configs/llava/phi3_mini_4k_instruct_clip_vit_large_p14_336) for details! -- **\[2024/04\]** [LLaVA-Llama-3-8B](https://huggingface.co/xtuner/llava-llama-3-8b) and [LLaVA-Llama-3-8B-v1.1](https://huggingface.co/xtuner/llava-llama-3-8b-v1_1) are released! Click [here](xtuner/configs/llava/llama3_8b_instruct_clip_vit_large_p14_336) for details! -- **\[2024/04\]** Support [Llama 3](xtuner/configs/llama) models! -- **\[2024/04\]** Support Sequence Parallel for enabling highly efficient and scalable LLM training with extremely long sequence lengths! \[[Usage](https://github.com/InternLM/xtuner/blob/docs/docs/zh_cn/acceleration/train_extreme_long_sequence.rst)\] \[[Speed Benchmark](https://github.com/InternLM/xtuner/blob/docs/docs/zh_cn/acceleration/benchmark.rst)\] -- **\[2024/02\]** Support [Gemma](xtuner/configs/gemma) models! -- **\[2024/02\]** Support [Qwen1.5](xtuner/configs/qwen/qwen1_5) models! -- **\[2024/01\]** Support [InternLM2](xtuner/configs/internlm) models! The latest VLM [LLaVA-Internlm2-7B](https://huggingface.co/xtuner/llava-internlm2-7b) / [20B](https://huggingface.co/xtuner/llava-internlm2-20b) models are released, with impressive performance! -- **\[2024/01\]** Support [DeepSeek-MoE](https://huggingface.co/deepseek-ai/deepseek-moe-16b-chat) models! 20GB GPU memory is enough for QLoRA fine-tuning, and 4x80GB for full-parameter fine-tuning. Click [here](xtuner/configs/deepseek/) for details! -- **\[2023/12\]** 🔥 Support multi-modal VLM pretraining and fine-tuning with [LLaVA-v1.5](https://github.com/haotian-liu/LLaVA) architecture! Click [here](xtuner/configs/llava/README.md) for details! -- **\[2023/12\]** 🔥 Support [Mixtral 8x7B](https://huggingface.co/mistralai/Mixtral-8x7B-Instruct-v0.1) models! Click [here](xtuner/configs/mixtral/README.md) for details! -- **\[2023/11\]** Support [ChatGLM3-6B](xtuner/configs/chatglm) model! -- **\[2023/10\]** Support [MSAgent-Bench](https://modelscope.cn/datasets/damo/MSAgent-Bench) dataset, and the fine-tuned LLMs can be applied by [Lagent](https://github.com/InternLM/lagent)! -- **\[2023/10\]** Optimize the data processing to accommodate `system` context. More information can be found on [Docs](docs/en/user_guides/dataset_format.md)! -- **\[2023/09\]** Support [InternLM-20B](xtuner/configs/internlm) models! -- **\[2023/09\]** Support [Baichuan2](xtuner/configs/baichuan) models! -- **\[2023/08\]** XTuner is released, with multiple fine-tuned adapters on [Hugging Face](https://huggingface.co/xtuner). - -## 📖 Introduction - -XTuner is an efficient, flexible and full-featured toolkit for fine-tuning large models. - -**Efficient** - -- Support LLM, VLM pre-training / fine-tuning on almost all GPUs. XTuner is capable of fine-tuning 7B LLM on a single 8GB GPU, as well as multi-node fine-tuning of models exceeding 70B. -- Automatically dispatch high-performance operators such as FlashAttention and Triton kernels to increase training throughput. -- Compatible with [DeepSpeed](https://github.com/microsoft/DeepSpeed) 🚀, easily utilizing a variety of ZeRO optimization techniques. - -**Flexible** - -- Support various LLMs ([InternLM](https://huggingface.co/internlm), [Mixtral-8x7B](https://huggingface.co/mistralai), [Llama 2](https://huggingface.co/meta-llama), [ChatGLM](https://huggingface.co/THUDM), [Qwen](https://huggingface.co/Qwen), [Baichuan](https://huggingface.co/baichuan-inc), ...). -- Support VLM ([LLaVA](https://github.com/haotian-liu/LLaVA)). The performance of [LLaVA-InternLM2-20B](https://huggingface.co/xtuner/llava-internlm2-20b) is outstanding. -- Well-designed data pipeline, accommodating datasets in any format, including but not limited to open-source and custom formats. -- Support various training algorithms ([QLoRA](http://arxiv.org/abs/2305.14314), [LoRA](http://arxiv.org/abs/2106.09685), full-parameter fune-tune), allowing users to choose the most suitable solution for their requirements. - -**Full-featured** - -- Support continuous pre-training, instruction fine-tuning, and agent fine-tuning. -- Support chatting with large models with pre-defined templates. -- The output models can seamlessly integrate with deployment and server toolkit ([LMDeploy](https://github.com/InternLM/lmdeploy)), and large-scale evaluation toolkit ([OpenCompass](https://github.com/open-compass/opencompass), [VLMEvalKit](https://github.com/open-compass/VLMEvalKit)). - -## 🔥 Supports - - - - - - - - - - - - - - - - -
- Models - - SFT Datasets - - Data Pipelines - - Algorithms -
- - - - - - - -
- -## 🛠️ Quick Start - -### Installation - -- It is recommended to build a Python-3.10 virtual environment using conda - - ```bash - conda create --name xtuner-env python=3.10 -y - conda activate xtuner-env - ``` - -- Install XTuner via pip - - ```shell - pip install -U xtuner - ``` - - or with DeepSpeed integration - - ```shell - pip install -U 'xtuner[deepspeed]' - ``` - -- Install XTuner from source - - ```shell - git clone https://github.com/InternLM/xtuner.git - cd xtuner - pip install -e '.[all]' - ``` - -### Fine-tune - -XTuner supports the efficient fine-tune (*e.g.*, QLoRA) for LLMs. Dataset prepare guides can be found on [dataset_prepare.md](./docs/en/user_guides/dataset_prepare.md). - -- **Step 0**, prepare the config. XTuner provides many ready-to-use configs and we can view all configs by - - ```shell - xtuner list-cfg - ``` - - Or, if the provided configs cannot meet the requirements, please copy the provided config to the specified directory and make specific modifications by - - ```shell - xtuner copy-cfg ${CONFIG_NAME} ${SAVE_PATH} - vi ${SAVE_PATH}/${CONFIG_NAME}_copy.py - ``` - -- **Step 1**, start fine-tuning. - - ```shell - xtuner train ${CONFIG_NAME_OR_PATH} - ``` - - For example, we can start the QLoRA fine-tuning of InternLM2.5-Chat-7B with oasst1 dataset by - - ```shell - # On a single GPU - xtuner train internlm2_5_chat_7b_qlora_oasst1_e3 --deepspeed deepspeed_zero2 - # On multiple GPUs - (DIST) NPROC_PER_NODE=${GPU_NUM} xtuner train internlm2_5_chat_7b_qlora_oasst1_e3 --deepspeed deepspeed_zero2 - (SLURM) srun ${SRUN_ARGS} xtuner train internlm2_5_chat_7b_qlora_oasst1_e3 --launcher slurm --deepspeed deepspeed_zero2 - ``` - - - `--deepspeed` means using [DeepSpeed](https://github.com/microsoft/DeepSpeed) 🚀 to optimize the training. XTuner comes with several integrated strategies including ZeRO-1, ZeRO-2, and ZeRO-3. If you wish to disable this feature, simply remove this argument. - - - For more examples, please see [finetune.md](./docs/en/user_guides/finetune.md). - -- **Step 2**, convert the saved PTH model (if using DeepSpeed, it will be a directory) to Hugging Face model, by +# Django 电商管理系统 + +这是一个基于 Django 和 PostgreSQL 开发的电商管理系统，包含完整的产品管理、订单管理、用户管理等功能。 + +## 功能特性 + +### 核心功能 +- 🏠 **首页展示**: 轮播图、推荐产品、分类展示 +- 📱 **响应式设计**: 支持PC、平板、手机等多种设备 +- 🔍 **搜索功能**: 全站搜索，支持产品名称、描述等 +- 📧 **通知系统**: 用户通知管理 +- 📞 **联系我们**: 联系表单，消息管理 + +### 用户管理 +- 👤 **用户认证**: 登录、登出、用户资料管理 +- 🔐 **权限控制**: 基于Django内置权限系统 +- 📊 **用户仪表板**: 订单统计、个人信息管理 +- 🔔 **消息通知**: 系统通知、订单状态更新 + +### 产品管理 +- 📦 **产品管理**: 产品CRUD、图片管理、属性管理 +- 🏷️ **分类管理**: 多级分类、分类图片 +- 🏢 **品牌管理**: 品牌信息、LOGO管理 +- 🔍 **产品筛选**: 按分类、品牌、价格筛选 +- 📸 **图片管理**: 多图片上传、主图设置 + +### 订单管理 +- 🛒 **购物车**: 添加、修改、删除商品 +- 💝 **收藏夹**: 产品收藏功能 +- 📋 **订单管理**: 订单创建、状态跟踪 +- 💰 **支付管理**: 支付方式、支付状态 +- 🚚 **物流跟踪**: 发货、配送状态跟踪 + +### 系统管理 +- ⚙️ **网站设置**: 基本信息、SEO设置、联系方式 +- 🎠 **轮播图管理**: 首页轮播图管理 +- ❓ **FAQ管理**: 常见问题管理 +- 📊 **活动日志**: 用户操作记录 +- 📧 **邮件模板**: 系统邮件模板管理 + +## 技术栈 + +- **后端**: Django 5.2.5 +- **数据库**: PostgreSQL +- **前端**: Bootstrap 5.3.0, Font Awesome 6.0.0 +- **图片处理**: Pillow +- **部署**: Gunicorn, Whitenoise + +## 项目结构 - ```shell - xtuner convert pth_to_hf ${CONFIG_NAME_OR_PATH} ${PTH} ${SAVE_PATH} - ``` +``` +myproject/ +├── core/ # 核心应用 +│ ├── models.py # 网站设置、通知、日志等模型 +│ ├── views.py # 首页、搜索、通知等视图 +│ └── admin.py # 管理界面配置 +├── users/ # 用户管理应用 +│ ├── models.py # 用户模型扩展 +│ ├── admin.py # 用户管理界面 +├── products/ # 产品管理应用 +│ ├── models.py # 产品、分类、品牌等模型 +│ ├── views.py # 产品列表、详情等视图 +│ └── admin.py # 产品管理界面 +├── orders/ # 订单管理应用 +│ ├── models.py # 订单、支付、物流等模型 +│ ├── admin.py # 订单管理界面 +├── templates/ # 模板文件 +│ ├── base.html # 基础模板 +│ └── core/ # 核心模板 +├── static/ # 静态文件 +│ ├── css/ # 样式文件 +│ ├── js/ # JavaScript文件 +│ └── images/ # 图片文件 +└── media/ # 上传文件目录 +``` -### Chat +## 安装与运行 -XTuner provides tools to chat with pretrained / fine-tuned LLMs. +### 1. 环境要求 +- Python 3.8+ +- PostgreSQL 12+ -```shell -xtuner chat ${NAME_OR_PATH_TO_LLM} --adapter {NAME_OR_PATH_TO_ADAPTER} [optional arguments] +### 2. 安装依赖 +```bash +pip install -r requirements.txt ``` -For example, we can start the chat with InternLM2.5-Chat-7B : +### 3. 数据库配置 +在 `myproject/settings.py` 中配置PostgreSQL数据库连接： + +```python +DATABASES = { + 'default': { + 'ENGINE': 'django.db.backends.postgresql', + 'NAME': 'myproject_db', + 'USER': 'postgres', + 'PASSWORD': 'your_password', + 'HOST': 'localhost', + 'PORT': '5432', + } +} +``` -```shell -xtuner chat internlm/internlm2_5-chat-7b --prompt-template internlm2_chat +### 4. 数据库迁移 +```bash +python manage.py makemigrations +python manage.py migrate ``` -For more examples, please see [chat.md](./docs/en/user_guides/chat.md). +### 5. 创建超级用户 +```bash +python manage.py createsuperuser +``` -### Deployment +### 6. 运行开发服务器 +```bash +python manage.py runserver +``` -- **Step 0**, merge the Hugging Face adapter to pretrained LLM, by +访问 `http://127.0.0.1:8000` 查看网站，访问 `http://127.0.0.1:8000/admin` 进入管理后台。 - ```shell - xtuner convert merge \ - ${NAME_OR_PATH_TO_LLM} \ - ${NAME_OR_PATH_TO_ADAPTER} \ - ${SAVE_PATH} \ - --max-shard-size 2GB - ``` +## 使用说明 -- **Step 1**, deploy fine-tuned LLM with any other framework, such as [LMDeploy](https://github.com/InternLM/lmdeploy) 🚀. +### 管理后台操作 - ```shell - pip install lmdeploy - python -m lmdeploy.pytorch.chat ${NAME_OR_PATH_TO_LLM} \ - --max_new_tokens 256 \ - --temperture 0.8 \ - --top_p 0.95 \ - --seed 0 - ``` +1. **网站设置**: 在管理后台的"网站设置"中配置网站基本信息 +2. **分类管理**: 创建产品分类，支持多级分类 +3. **品牌管理**: 添加品牌信息和LOGO +4. **产品管理**: 添加产品，设置价格、库存、图片等 +5. **轮播图**: 配置首页轮播图 +6. **FAQ**: 添加常见问题 - 🔥 Seeking efficient inference with less GPU memory? Try 4-bit quantization from [LMDeploy](https://github.com/InternLM/lmdeploy)! For more details, see [here](https://github.com/InternLM/lmdeploy/tree/main#quantization). +### 前台功能 -### Evaluation +1. **浏览产品**: 按分类、品牌筛选产品 +2. **搜索功能**: 搜索产品名称或描述 +3. **用户注册**: 注册账号并完善个人信息 +4. **购物车**: 添加产品到购物车 +5. **订单管理**: 查看订单状态和历史 -- We recommend using [OpenCompass](https://github.com/InternLM/opencompass), a comprehensive and systematic LLM evaluation library, which currently supports 50+ datasets with about 300,000 questions. +## 开发说明 -## 🤝 Contributing +### 自定义用户模型 +系统使用扩展的用户模型 `users.User`，包含额外的用户信息字段。 -We appreciate all contributions to XTuner. Please refer to [CONTRIBUTING.md](.github/CONTRIBUTING.md) for the contributing guideline. +### 模型关系 +- 产品与分类：多对一关系 +- 产品与品牌：多对一关系 +- 订单与用户：多对一关系 +- 订单与产品：多对多关系（通过OrderItem） -## 🎖️ Acknowledgement +### 管理界面 +所有模型都配置了完善的Django管理界面，支持： +- 列表显示和筛选 +- 搜索功能 +- 批量操作 +- 内联编辑 -- [Llama 2](https://github.com/facebookresearch/llama) -- [DeepSpeed](https://github.com/microsoft/DeepSpeed) -- [QLoRA](https://github.com/artidoro/qlora) -- [LMDeploy](https://github.com/InternLM/lmdeploy) -- [LLaVA](https://github.com/haotian-liu/LLaVA) +## 许可证 -## 🖊️ Citation +MIT License -```bibtex -@misc{2023xtuner, - title={XTuner: A Toolkit for Efficiently Fine-tuning LLM}, - author={XTuner Contributors}, - howpublished = {\url{https://github.com/InternLM/xtuner}}, - year={2023} -} -``` +## 贡献 + +欢迎提交Issue和Pull Request来改进这个项目。 -## License +## 联系方式 -This project is released under the [Apache License 2.0](LICENSE). Please also adhere to the Licenses of models and datasets being used. +如有问题，请通过GitHub Issue联系我们。 diff --git a/core/__init__.py b/core/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/core/admin.py b/core/admin.py new file mode 100644 index 000000000..72e81de32 --- /dev/null +++ b/core/admin.py @@ -0,0 +1,87 @@ +from django.contrib import admin +from django.utils.html import format_html +from .models import (SiteSettings, Banner, Notification, ActivityLog, + FAQ, ContactMessage, EmailTemplate) + +@admin.register(SiteSettings) +class SiteSettingsAdmin(admin.ModelAdmin): + fieldsets = ( + ('基本信息', { + 'fields': ('site_name', 'site_description', 'site_keywords', 'logo', 'favicon') + }), + ('联系信息', { + 'fields': ('contact_email', 'contact_phone', 'address') + }), + ('社交媒体', { + 'fields': ('weibo_url', 'wechat_qr') + }), + ('SEO设置', { + 'fields': ('google_analytics', 'baidu_analytics') + }), + ('系统设置', { + 'fields': ('maintenance_mode', 'maintenance_message') + }), + ) + + def has_add_permission(self, request): + return not SiteSettings.objects.exists() + +@admin.register(Banner) +class BannerAdmin(admin.ModelAdmin): + list_display = ('title', 'is_active', 'sort_order', 'start_date', 'end_date', 'created_at') + list_filter = ('is_active', 'created_at', 'start_date', 'end_date') + search_fields = ('title', 'subtitle') + ordering = ('sort_order', '-created_at') + +@admin.register(Notification) +class NotificationAdmin(admin.ModelAdmin): + list_display = ('user', 'title', 'notification_type', 'is_read', 'created_at') + list_filter = ('notification_type', 'is_read', 'created_at') + search_fields = ('user__username', 'title', 'message') + raw_id_fields = ('user',) + readonly_fields = ('created_at', 'read_at') + +@admin.register(ActivityLog) +class ActivityLogAdmin(admin.ModelAdmin): + list_display = ('user', 'action', 'description', 'ip_address', 'created_at') + list_filter = ('action', 'created_at') + search_fields = ('user__username', 'description', 'ip_address') + raw_id_fields = ('user',) + readonly_fields = ('created_at',) + + def has_add_permission(self, request): + return False # 只读，不允许手动添加 + +@admin.register(FAQ) +class FAQAdmin(admin.ModelAdmin): + list_display = ('question', 'category', 'is_active', 'sort_order', 'view_count', 'created_at') + list_filter = ('is_active', 'category', 'created_at') + search_fields = ('question', 'answer', 'category') + ordering = ('sort_order', '-created_at') + +@admin.register(ContactMessage) +class ContactMessageAdmin(admin.ModelAdmin): + list_display = ('name', 'email', 'subject', 'is_replied', 'created_at') + list_filter = ('is_replied', 'created_at', 'replied_at') + search_fields = ('name', 'email', 'subject', 'message') + readonly_fields = ('created_at',) + raw_id_fields = ('replied_by',) + + fieldsets = ( + ('联系信息', { + 'fields': ('name', 'email', 'phone', 'created_at') + }), + ('消息内容', { + 'fields': ('subject', 'message') + }), + ('回复信息', { + 'fields': ('is_replied', 'reply_message', 'replied_by', 'replied_at') + }), + ) + +@admin.register(EmailTemplate) +class EmailTemplateAdmin(admin.ModelAdmin): + list_display = ('name', 'code', 'subject', 'is_active', 'created_at') + list_filter = ('is_active', 'created_at') + search_fields = ('name', 'code', 'subject') + readonly_fields = ('created_at', 'updated_at') diff --git a/core/apps.py b/core/apps.py new file mode 100644 index 000000000..8115ae60b --- /dev/null +++ b/core/apps.py @@ -0,0 +1,6 @@ +from django.apps import AppConfig + + +class CoreConfig(AppConfig): + default_auto_field = 'django.db.models.BigAutoField' + name = 'core' diff --git a/core/migrations/0001_initial.py b/core/migrations/0001_initial.py new file mode 100644 index 000000000..fc8be5b30 --- /dev/null +++ b/core/migrations/0001_initial.py @@ -0,0 +1,159 @@ +# Generated by Django 5.2.5 on 2025-08-12 02:09 + +import django.db.models.deletion +from django.db import migrations, models + + +class Migration(migrations.Migration): + + initial = True + + dependencies = [ + ('contenttypes', '0002_remove_content_type_name'), + ] + + operations = [ + migrations.CreateModel( + name='Banner', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('title', models.CharField(max_length=200, verbose_name='标题')), + ('subtitle', models.CharField(blank=True, max_length=200, verbose_name='副标题')), + ('image', models.ImageField(upload_to='banners/', verbose_name='图片')), + ('link', models.URLField(blank=True, verbose_name='链接')), + ('button_text', models.CharField(blank=True, max_length=50, verbose_name='按钮文字')), + ('is_active', models.BooleanField(default=True, verbose_name='是否激活')), + ('sort_order', models.IntegerField(default=0, verbose_name='排序')), + ('start_date', models.DateTimeField(blank=True, null=True, verbose_name='开始时间')), + ('end_date', models.DateTimeField(blank=True, null=True, verbose_name='结束时间')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ], + options={ + 'verbose_name': '轮播图', + 'verbose_name_plural': '轮播图', + 'ordering': ['sort_order', '-created_at'], + }, + ), + migrations.CreateModel( + name='ContactMessage', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('name', models.CharField(max_length=100, verbose_name='姓名')), + ('email', models.EmailField(max_length=254, verbose_name='邮箱')), + ('phone', models.CharField(blank=True, max_length=20, verbose_name='电话')), + ('subject', models.CharField(max_length=200, verbose_name='主题')), + ('message', models.TextField(verbose_name='消息内容')), + ('is_replied', models.BooleanField(default=False, verbose_name='是否已回复')), + ('reply_message', models.TextField(blank=True, verbose_name='回复内容')), + ('replied_at', models.DateTimeField(blank=True, null=True, verbose_name='回复时间')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ], + options={ + 'verbose_name': '联系消息', + 'verbose_name_plural': '联系消息', + 'ordering': ['-created_at'], + }, + ), + migrations.CreateModel( + name='EmailTemplate', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('name', models.CharField(max_length=100, verbose_name='模板名称')), + ('code', models.CharField(max_length=50, unique=True, verbose_name='模板代码')), + ('subject', models.CharField(max_length=200, verbose_name='邮件主题')), + ('html_content', models.TextField(verbose_name='HTML内容')), + ('text_content', models.TextField(blank=True, verbose_name='文本内容')), + ('variables', models.JSONField(blank=True, help_text='JSON格式的变量说明', null=True, verbose_name='可用变量')), + ('is_active', models.BooleanField(default=True, verbose_name='是否激活')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')), + ], + options={ + 'verbose_name': '邮件模板', + 'verbose_name_plural': '邮件模板', + }, + ), + migrations.CreateModel( + name='FAQ', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('question', models.CharField(max_length=300, verbose_name='问题')), + ('answer', models.TextField(verbose_name='答案')), + ('category', models.CharField(blank=True, max_length=100, verbose_name='分类')), + ('is_active', models.BooleanField(default=True, verbose_name='是否激活')), + ('sort_order', models.IntegerField(default=0, verbose_name='排序')), + ('view_count', models.IntegerField(default=0, verbose_name='查看次数')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')), + ], + options={ + 'verbose_name': '常见问题', + 'verbose_name_plural': '常见问题', + 'ordering': ['sort_order', '-created_at'], + }, + ), + migrations.CreateModel( + name='Notification', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('title', models.CharField(max_length=200, verbose_name='标题')), + ('message', models.TextField(verbose_name='消息内容')), + ('notification_type', models.CharField(choices=[('info', '信息'), ('success', '成功'), ('warning', '警告'), ('error', '错误')], default='info', max_length=20, verbose_name='通知类型')), + ('is_read', models.BooleanField(default=False, verbose_name='是否已读')), + ('link', models.URLField(blank=True, verbose_name='相关链接')), + ('object_id', models.PositiveIntegerField(blank=True, null=True)), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ('read_at', models.DateTimeField(blank=True, null=True, verbose_name='阅读时间')), + ], + options={ + 'verbose_name': '通知', + 'verbose_name_plural': '通知', + 'ordering': ['-created_at'], + }, + ), + migrations.CreateModel( + name='SiteSettings', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('site_name', models.CharField(default='我的网站', max_length=100, verbose_name='网站名称')), + ('site_description', models.TextField(blank=True, verbose_name='网站描述')), + ('site_keywords', models.TextField(blank=True, verbose_name='网站关键词')), + ('logo', models.ImageField(blank=True, null=True, upload_to='site/', verbose_name='网站LOGO')), + ('favicon', models.ImageField(blank=True, null=True, upload_to='site/', verbose_name='网站图标')), + ('contact_email', models.EmailField(blank=True, max_length=254, verbose_name='联系邮箱')), + ('contact_phone', models.CharField(blank=True, max_length=20, verbose_name='联系电话')), + ('address', models.TextField(blank=True, verbose_name='地址')), + ('weibo_url', models.URLField(blank=True, verbose_name='微博链接')), + ('wechat_qr', models.ImageField(blank=True, null=True, upload_to='site/', verbose_name='微信二维码')), + ('google_analytics', models.TextField(blank=True, verbose_name='Google Analytics代码')), + ('baidu_analytics', models.TextField(blank=True, verbose_name='百度统计代码')), + ('maintenance_mode', models.BooleanField(default=False, verbose_name='维护模式')), + ('maintenance_message', models.TextField(blank=True, verbose_name='维护提示信息')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')), + ], + options={ + 'verbose_name': '网站设置', + 'verbose_name_plural': '网站设置', + }, + ), + migrations.CreateModel( + name='ActivityLog', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('action', models.CharField(choices=[('create', '创建'), ('update', '更新'), ('delete', '删除'), ('login', '登录'), ('logout', '登出'), ('view', '查看'), ('download', '下载'), ('upload', '上传'), ('other', '其他')], max_length=20, verbose_name='操作')), + ('description', models.TextField(verbose_name='描述')), + ('ip_address', models.GenericIPAddressField(blank=True, null=True, verbose_name='IP地址')), + ('user_agent', models.TextField(blank=True, verbose_name='用户代理')), + ('object_id', models.PositiveIntegerField(blank=True, null=True)), + ('extra_data', models.JSONField(blank=True, null=True, verbose_name='额外数据')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ('content_type', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, to='contenttypes.contenttype')), + ], + options={ + 'verbose_name': '活动日志', + 'verbose_name_plural': '活动日志', + 'ordering': ['-created_at'], + }, + ), + ] diff --git a/core/migrations/0002_initial.py b/core/migrations/0002_initial.py new file mode 100644 index 000000000..d97cf74a3 --- /dev/null +++ b/core/migrations/0002_initial.py @@ -0,0 +1,39 @@ +# Generated by Django 5.2.5 on 2025-08-12 02:09 + +import django.db.models.deletion +from django.conf import settings +from django.db import migrations, models + + +class Migration(migrations.Migration): + + initial = True + + dependencies = [ + ('contenttypes', '0002_remove_content_type_name'), + ('core', '0001_initial'), + migrations.swappable_dependency(settings.AUTH_USER_MODEL), + ] + + operations = [ + migrations.AddField( + model_name='activitylog', + name='user', + field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='activity_logs', to=settings.AUTH_USER_MODEL, verbose_name='用户'), + ), + migrations.AddField( + model_name='contactmessage', + name='replied_by', + field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='replied_messages', to=settings.AUTH_USER_MODEL, verbose_name='回复人'), + ), + migrations.AddField( + model_name='notification', + name='content_type', + field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, to='contenttypes.contenttype'), + ), + migrations.AddField( + model_name='notification', + name='user', + field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='notifications', to=settings.AUTH_USER_MODEL, verbose_name='用户'), + ), + ] diff --git a/core/migrations/__init__.py b/core/migrations/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/core/models.py b/core/models.py new file mode 100644 index 000000000..285456e35 --- /dev/null +++ b/core/models.py @@ -0,0 +1,219 @@ +from django.db import models +from django.conf import settings +from django.utils import timezone +from django.contrib.contenttypes.models import ContentType +from django.contrib.contenttypes.fields import GenericForeignKey + +class SiteSettings(models.Model): + """网站设置""" + site_name = models.CharField('网站名称', max_length=100, default='我的网站') + site_description = models.TextField('网站描述', blank=True) + site_keywords = models.TextField('网站关键词', blank=True) + logo = models.ImageField('网站LOGO', upload_to='site/', blank=True, null=True) + favicon = models.ImageField('网站图标', upload_to='site/', blank=True, null=True) + contact_email = models.EmailField('联系邮箱', blank=True) + contact_phone = models.CharField('联系电话', max_length=20, blank=True) + address = models.TextField('地址', blank=True) + + # 社交媒体链接 + weibo_url = models.URLField('微博链接', blank=True) + wechat_qr = models.ImageField('微信二维码', upload_to='site/', blank=True, null=True) + + # SEO设置 + google_analytics = models.TextField('Google Analytics代码', blank=True) + baidu_analytics = models.TextField('百度统计代码', blank=True) + + # 系统设置 + maintenance_mode = models.BooleanField('维护模式', default=False) + maintenance_message = models.TextField('维护提示信息', blank=True) + + created_at = models.DateTimeField('创建时间', auto_now_add=True) + updated_at = models.DateTimeField('更新时间', auto_now=True) + + class Meta: + verbose_name = '网站设置' + verbose_name_plural = '网站设置' + + def __str__(self): + return self.site_name + + def save(self, *args, **kwargs): + # 确保只有一个设置实例 + if not self.pk and SiteSettings.objects.exists(): + raise ValueError('只能有一个网站设置实例') + return super().save(*args, **kwargs) + +class Banner(models.Model): + """轮播图""" + title = models.CharField('标题', max_length=200) + subtitle = models.CharField('副标题', max_length=200, blank=True) + image = models.ImageField('图片', upload_to='banners/') + link = models.URLField('链接', blank=True) + button_text = models.CharField('按钮文字', max_length=50, blank=True) + is_active = models.BooleanField('是否激活', default=True) + sort_order = models.IntegerField('排序', default=0) + start_date = models.DateTimeField('开始时间', null=True, blank=True) + end_date = models.DateTimeField('结束时间', null=True, blank=True) + created_at = models.DateTimeField('创建时间', auto_now_add=True) + + class Meta: + verbose_name = '轮播图' + verbose_name_plural = '轮播图' + ordering = ['sort_order', '-created_at'] + + def __str__(self): + return self.title + + @property + def is_valid(self): + now = timezone.now() + if self.start_date and now < self.start_date: + return False + if self.end_date and now > self.end_date: + return False + return self.is_active + +class Notification(models.Model): + """通知""" + NOTIFICATION_TYPE_CHOICES = [ + ('info', '信息'), + ('success', '成功'), + ('warning', '警告'), + ('error', '错误'), + ] + + user = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE, + verbose_name='用户', related_name='notifications') + title = models.CharField('标题', max_length=200) + message = models.TextField('消息内容') + notification_type = models.CharField('通知类型', max_length=20, + choices=NOTIFICATION_TYPE_CHOICES, default='info') + is_read = models.BooleanField('是否已读', default=False) + link = models.URLField('相关链接', blank=True) + + # 关联对象（可选） + content_type = models.ForeignKey(ContentType, on_delete=models.CASCADE, + null=True, blank=True) + object_id = models.PositiveIntegerField(null=True, blank=True) + content_object = GenericForeignKey('content_type', 'object_id') + + created_at = models.DateTimeField('创建时间', auto_now_add=True) + read_at = models.DateTimeField('阅读时间', null=True, blank=True) + + class Meta: + verbose_name = '通知' + verbose_name_plural = '通知' + ordering = ['-created_at'] + + def __str__(self): + return f"{self.user.username} - {self.title}" + + def mark_as_read(self): + if not self.is_read: + self.is_read = True + self.read_at = timezone.now() + self.save() + +class ActivityLog(models.Model): + """活动日志""" + ACTION_CHOICES = [ + ('create', '创建'), + ('update', '更新'), + ('delete', '删除'), + ('login', '登录'), + ('logout', '登出'), + ('view', '查看'), + ('download', '下载'), + ('upload', '上传'), + ('other', '其他'), + ] + + user = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE, + verbose_name='用户', null=True, blank=True, + related_name='activity_logs') + action = models.CharField('操作', max_length=20, choices=ACTION_CHOICES) + description = models.TextField('描述') + ip_address = models.GenericIPAddressField('IP地址', null=True, blank=True) + user_agent = models.TextField('用户代理', blank=True) + + # 关联对象 + content_type = models.ForeignKey(ContentType, on_delete=models.CASCADE, + null=True, blank=True) + object_id = models.PositiveIntegerField(null=True, blank=True) + content_object = GenericForeignKey('content_type', 'object_id') + + # 额外数据 + extra_data = models.JSONField('额外数据', blank=True, null=True) + + created_at = models.DateTimeField('创建时间', auto_now_add=True) + + class Meta: + verbose_name = '活动日志' + verbose_name_plural = '活动日志' + ordering = ['-created_at'] + + def __str__(self): + user_str = self.user.username if self.user else '匿名用户' + return f"{user_str} - {self.get_action_display()}: {self.description}" + +class FAQ(models.Model): + """常见问题""" + question = models.CharField('问题', max_length=300) + answer = models.TextField('答案') + category = models.CharField('分类', max_length=100, blank=True) + is_active = models.BooleanField('是否激活', default=True) + sort_order = models.IntegerField('排序', default=0) + view_count = models.IntegerField('查看次数', default=0) + created_at = models.DateTimeField('创建时间', auto_now_add=True) + updated_at = models.DateTimeField('更新时间', auto_now=True) + + class Meta: + verbose_name = '常见问题' + verbose_name_plural = '常见问题' + ordering = ['sort_order', '-created_at'] + + def __str__(self): + return self.question + +class ContactMessage(models.Model): + """联系消息""" + name = models.CharField('姓名', max_length=100) + email = models.EmailField('邮箱') + phone = models.CharField('电话', max_length=20, blank=True) + subject = models.CharField('主题', max_length=200) + message = models.TextField('消息内容') + is_replied = models.BooleanField('是否已回复', default=False) + reply_message = models.TextField('回复内容', blank=True) + replied_by = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.SET_NULL, + null=True, blank=True, verbose_name='回复人', + related_name='replied_messages') + replied_at = models.DateTimeField('回复时间', null=True, blank=True) + created_at = models.DateTimeField('创建时间', auto_now_add=True) + + class Meta: + verbose_name = '联系消息' + verbose_name_plural = '联系消息' + ordering = ['-created_at'] + + def __str__(self): + return f"{self.name} - {self.subject}" + +class EmailTemplate(models.Model): + """邮件模板""" + name = models.CharField('模板名称', max_length=100) + code = models.CharField('模板代码', max_length=50, unique=True) + subject = models.CharField('邮件主题', max_length=200) + html_content = models.TextField('HTML内容') + text_content = models.TextField('文本内容', blank=True) + variables = models.JSONField('可用变量', blank=True, null=True, + help_text='JSON格式的变量说明') + is_active = models.BooleanField('是否激活', default=True) + created_at = models.DateTimeField('创建时间', auto_now_add=True) + updated_at = models.DateTimeField('更新时间', auto_now=True) + + class Meta: + verbose_name = '邮件模板' + verbose_name_plural = '邮件模板' + + def __str__(self): + return self.name diff --git a/core/tests.py b/core/tests.py new file mode 100644 index 000000000..7ce503c2d --- /dev/null +++ b/core/tests.py @@ -0,0 +1,3 @@ +from django.test import TestCase + +# Create your tests here. diff --git a/core/urls.py b/core/urls.py new file mode 100644 index 000000000..5e637d85c --- /dev/null +++ b/core/urls.py @@ -0,0 +1,17 @@ +from django.urls import path +from . import views + +app_name = 'core' + +urlpatterns = [ + path('', views.home, name='home'), + path('about/', views.about, name='about'), + path('contact/', views.contact, name='contact'), + path('faq/', views.faq_list, name='faq_list'), + path('faq//', views.faq_detail, name='faq_detail'), + path('dashboard/', views.dashboard, name='dashboard'), + path('notifications/', views.notifications, name='notifications'), + path('notifications//read/', views.mark_notification_read, name='mark_notification_read'), + path('notifications/read-all/', views.mark_all_notifications_read, name='mark_all_notifications_read'), + path('search/', views.search, name='search'), +] \ No newline at end of file diff --git a/core/views.py b/core/views.py new file mode 100644 index 000000000..3502c8fc7 --- /dev/null +++ b/core/views.py @@ -0,0 +1,204 @@ +from django.shortcuts import render, get_object_or_404, redirect +from django.contrib import messages +from django.core.paginator import Paginator +from django.db.models import Q, F +from django.http import JsonResponse +from django.views.decorators.csrf import csrf_exempt +from django.contrib.auth.decorators import login_required +from django.utils import timezone +from .models import SiteSettings, Banner, FAQ, ContactMessage, Notification +from products.models import Product, Category +from orders.models import Order + +def get_site_settings(): + """获取网站设置""" + try: + return SiteSettings.objects.first() + except SiteSettings.DoesNotExist: + return None + +def home(request): + """首页""" + context = { + 'site_settings': get_site_settings(), + 'banners': Banner.objects.filter(is_active=True).order_by('sort_order'), + 'featured_products': Product.objects.filter( + is_active=True, is_featured=True + ).select_related('category', 'brand')[:8], + 'categories': Category.objects.filter(is_active=True, parent=None).order_by('sort_order')[:6], + } + return render(request, 'core/home.html', context) + +def about(request): + """关于我们""" + context = { + 'site_settings': get_site_settings(), + } + return render(request, 'core/about.html', context) + +def contact(request): + """联系我们""" + if request.method == 'POST': + name = request.POST.get('name') + email = request.POST.get('email') + phone = request.POST.get('phone', '') + subject = request.POST.get('subject') + message = request.POST.get('message') + + if name and email and subject and message: + ContactMessage.objects.create( + name=name, + email=email, + phone=phone, + subject=subject, + message=message + ) + messages.success(request, '您的消息已发送成功，我们会尽快回复您！') + return redirect('core:contact') + else: + messages.error(request, '请填写所有必填字段。') + + context = { + 'site_settings': get_site_settings(), + } + return render(request, 'core/contact.html', context) + +def faq_list(request): + """常见问题列表""" + category = request.GET.get('category', '') + search = request.GET.get('search', '') + + faqs = FAQ.objects.filter(is_active=True) + + if category: + faqs = faqs.filter(category=category) + + if search: + faqs = faqs.filter( + Q(question__icontains=search) | Q(answer__icontains=search) + ) + + categories = FAQ.objects.filter(is_active=True).values_list( + 'category', flat=True + ).distinct().exclude(category='') + + paginator = Paginator(faqs.order_by('sort_order', '-created_at'), 10) + page_number = request.GET.get('page') + page_obj = paginator.get_page(page_number) + + context = { + 'site_settings': get_site_settings(), + 'page_obj': page_obj, + 'categories': categories, + 'current_category': category, + 'search_query': search, + } + return render(request, 'core/faq_list.html', context) + +def faq_detail(request, pk): + """常见问题详情""" + faq = get_object_or_404(FAQ, pk=pk, is_active=True) + + # 增加查看次数 + FAQ.objects.filter(pk=pk).update(view_count=F('view_count') + 1) + + context = { + 'site_settings': get_site_settings(), + 'faq': faq, + } + return render(request, 'core/faq_detail.html', context) + +@login_required +def dashboard(request): + """用户仪表板""" + user = request.user + + # 获取用户的订单统计 + orders = Order.objects.filter(user=user) + order_stats = { + 'total': orders.count(), + 'pending': orders.filter(status='pending').count(), + 'paid': orders.filter(status='paid').count(), + 'shipped': orders.filter(status='shipped').count(), + 'delivered': orders.filter(status='delivered').count(), + } + + # 最近的订单 + recent_orders = orders.order_by('-created_at')[:5] + + # 未读通知 + unread_notifications = user.notifications.filter(is_read=False).count() + + context = { + 'site_settings': get_site_settings(), + 'order_stats': order_stats, + 'recent_orders': recent_orders, + 'unread_notifications': unread_notifications, + } + return render(request, 'core/dashboard.html', context) + +@login_required +def notifications(request): + """用户通知列表""" + notifications = request.user.notifications.order_by('-created_at') + + paginator = Paginator(notifications, 20) + page_number = request.GET.get('page') + page_obj = paginator.get_page(page_number) + + context = { + 'site_settings': get_site_settings(), + 'page_obj': page_obj, + } + return render(request, 'core/notifications.html', context) + +@login_required +def mark_notification_read(request, pk): + """标记通知为已读""" + notification = get_object_or_404(Notification, pk=pk, user=request.user) + notification.mark_as_read() + + if request.headers.get('X-Requested-With') == 'XMLHttpRequest': + return JsonResponse({'status': 'success'}) + + return redirect('core:notifications') + +@login_required +def mark_all_notifications_read(request): + """标记所有通知为已读""" + request.user.notifications.filter(is_read=False).update( + is_read=True, + read_at=timezone.now() + ) + + if request.headers.get('X-Requested-With') == 'XMLHttpRequest': + return JsonResponse({'status': 'success'}) + + return redirect('core:notifications') + +def search(request): + """全站搜索""" + query = request.GET.get('q', '').strip() + + if not query: + return redirect('core:home') + + # 搜索产品 + products = Product.objects.filter( + Q(name__icontains=query) | + Q(description__icontains=query) | + Q(short_description__icontains=query), + is_active=True + ).select_related('category', 'brand') + + paginator = Paginator(products, 12) + page_number = request.GET.get('page') + page_obj = paginator.get_page(page_number) + + context = { + 'site_settings': get_site_settings(), + 'page_obj': page_obj, + 'query': query, + 'total_results': products.count(), + } + return render(request, 'core/search_results.html', context) diff --git a/manage.py b/manage.py new file mode 100755 index 000000000..92bb9a3b2 --- /dev/null +++ b/manage.py @@ -0,0 +1,22 @@ +#!/usr/bin/env python +"""Django's command-line utility for administrative tasks.""" +import os +import sys + + +def main(): + """Run administrative tasks.""" + os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings') + try: + from django.core.management import execute_from_command_line + except ImportError as exc: + raise ImportError( + "Couldn't import Django. Are you sure it's installed and " + "available on your PYTHONPATH environment variable? Did you " + "forget to activate a virtual environment?" + ) from exc + execute_from_command_line(sys.argv) + + +if __name__ == '__main__': + main() diff --git a/myproject/__init__.py b/myproject/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/myproject/asgi.py b/myproject/asgi.py new file mode 100644 index 000000000..18346a369 --- /dev/null +++ b/myproject/asgi.py @@ -0,0 +1,16 @@ +""" +ASGI config for myproject project. + +It exposes the ASGI callable as a module-level variable named ``application``. + +For more information on this file, see +https://docs.djangoproject.com/en/5.2/howto/deployment/asgi/ +""" + +import os + +from django.core.asgi import get_asgi_application + +os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings') + +application = get_asgi_application() diff --git a/myproject/settings.py b/myproject/settings.py new file mode 100644 index 000000000..9f51609a5 --- /dev/null +++ b/myproject/settings.py @@ -0,0 +1,142 @@ +""" +Django settings for myproject project. + +Generated by 'django-admin startproject' using Django 5.2.5. + +For more information on this file, see +https://docs.djangoproject.com/en/5.2/topics/settings/ + +For the full list of settings and their values, see +https://docs.djangoproject.com/en/5.2/ref/settings/ +""" + +from pathlib import Path + +# Build paths inside the project like this: BASE_DIR / 'subdir'. +BASE_DIR = Path(__file__).resolve().parent.parent + + +# Quick-start development settings - unsuitable for production +# See https://docs.djangoproject.com/en/5.2/howto/deployment/checklist/ + +# SECURITY WARNING: keep the secret key used in production secret! +SECRET_KEY = 'django-insecure-l)bg1_0q_+xj5dupmjsn($apiclz$0he_mwf)kl$f3!tary^f9' + +# SECURITY WARNING: don't run with debug turned on in production! +DEBUG = True + +ALLOWED_HOSTS = [] + + +# Application definition + +INSTALLED_APPS = [ + 'django.contrib.admin', + 'django.contrib.auth', + 'django.contrib.contenttypes', + 'django.contrib.sessions', + 'django.contrib.messages', + 'django.contrib.staticfiles', + 'core', + 'users', + 'products', + 'orders', +] + +MIDDLEWARE = [ + 'django.middleware.security.SecurityMiddleware', + 'django.contrib.sessions.middleware.SessionMiddleware', + 'django.middleware.common.CommonMiddleware', + 'django.middleware.csrf.CsrfViewMiddleware', + 'django.contrib.auth.middleware.AuthenticationMiddleware', + 'django.contrib.messages.middleware.MessageMiddleware', + 'django.middleware.clickjacking.XFrameOptionsMiddleware', +] + +ROOT_URLCONF = 'myproject.urls' + +TEMPLATES = [ + { + 'BACKEND': 'django.template.backends.django.DjangoTemplates', + 'DIRS': [BASE_DIR / 'templates'], + 'APP_DIRS': True, + 'OPTIONS': { + 'context_processors': [ + 'django.template.context_processors.debug', + 'django.template.context_processors.request', + 'django.contrib.auth.context_processors.auth', + 'django.contrib.messages.context_processors.messages', + ], + }, + }, +] + +WSGI_APPLICATION = 'myproject.wsgi.application' + + +# Database +# https://docs.djangoproject.com/en/5.2/ref/settings/#databases + +DATABASES = { + 'default': { + 'ENGINE': 'django.db.backends.postgresql', + 'NAME': 'myproject_db', + 'USER': 'postgres', + 'PASSWORD': 'postgres', + 'HOST': 'localhost', + 'PORT': '5432', + } +} + + +# Password validation +# https://docs.djangoproject.com/en/5.2/ref/settings/#auth-password-validators + +AUTH_PASSWORD_VALIDATORS = [ + { + 'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator', + }, + { + 'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator', + }, + { + 'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator', + }, + { + 'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator', + }, +] + + +# Internationalization +# https://docs.djangoproject.com/en/5.2/topics/i18n/ + +LANGUAGE_CODE = 'zh-hans' + +TIME_ZONE = 'Asia/Shanghai' + +USE_I18N = True + +USE_TZ = True + + +# Static files (CSS, JavaScript, Images) +# https://docs.djangoproject.com/en/5.2/howto/static-files/ + +STATIC_URL = 'static/' +STATIC_ROOT = BASE_DIR / 'staticfiles' +STATICFILES_DIRS = [ + BASE_DIR / 'static', +] + +# Media files +MEDIA_URL = 'media/' +MEDIA_ROOT = BASE_DIR / 'media' + +# Default primary key field type +# https://docs.djangoproject.com/en/5.2/ref/settings/#default-auto-field + +DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField' + +# Custom User Model +AUTH_USER_MODEL = 'users.User' diff --git a/myproject/urls.py b/myproject/urls.py new file mode 100644 index 000000000..ffae7d300 --- /dev/null +++ b/myproject/urls.py @@ -0,0 +1,37 @@ +""" +URL configuration for myproject project. + +The `urlpatterns` list routes URLs to views. For more information please see: + https://docs.djangoproject.com/en/5.2/topics/http/urls/ +Examples: +Function views + 1. Add an import: from my_app import views + 2. Add a URL to urlpatterns: path('', views.home, name='home') +Class-based views + 1. Add an import: from other_app.views import Home + 2. Add a URL to urlpatterns: path('', Home.as_view(), name='home') +Including another URLconf + 1. Import the include() function: from django.urls import include, path + 2. Add a URL to urlpatterns: path('blog/', include('blog.urls')) +""" +from django.contrib import admin +from django.urls import path, include +from django.conf import settings +from django.conf.urls.static import static + +urlpatterns = [ + path('admin/', admin.site.urls), + path('', include('core.urls')), + path('products/', include('products.urls')), + path('accounts/', include('django.contrib.auth.urls')), +] + +# 开发环境下的媒体文件服务 +if settings.DEBUG: + urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) + urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT) + +# 自定义管理界面标题 +admin.site.site_header = "网站管理系统" +admin.site.site_title = "管理系统" +admin.site.index_title = "欢迎使用管理系统" diff --git a/myproject/wsgi.py b/myproject/wsgi.py new file mode 100644 index 000000000..7c6fdd6bb --- /dev/null +++ b/myproject/wsgi.py @@ -0,0 +1,16 @@ +""" +WSGI config for myproject project. + +It exposes the WSGI callable as a module-level variable named ``application``. + +For more information on this file, see +https://docs.djangoproject.com/en/5.2/howto/deployment/wsgi/ +""" + +import os + +from django.core.wsgi import get_wsgi_application + +os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings') + +application = get_wsgi_application() diff --git a/orders/__init__.py b/orders/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/orders/admin.py b/orders/admin.py new file mode 100644 index 000000000..65ccaaef8 --- /dev/null +++ b/orders/admin.py @@ -0,0 +1,92 @@ +from django.contrib import admin +from django.utils.html import format_html +from .models import (Order, OrderItem, Payment, Shipping, ShippingTracking, + Cart, Wishlist) + +class OrderItemInline(admin.TabularInline): + model = OrderItem + extra = 0 + fields = ('product', 'product_name', 'product_sku', 'unit_price', 'quantity', 'subtotal') + readonly_fields = ('subtotal',) + +class PaymentInline(admin.TabularInline): + model = Payment + extra = 0 + fields = ('payment_method', 'payment_status', 'amount', 'transaction_id', 'paid_at') + +@admin.register(Order) +class OrderAdmin(admin.ModelAdmin): + list_display = ('order_number', 'user', 'status', 'total_amount', 'final_amount', + 'shipping_name', 'created_at') + list_filter = ('status', 'created_at', 'paid_at', 'shipped_at') + search_fields = ('order_number', 'user__username', 'user__email', 'shipping_name', 'shipping_phone') + readonly_fields = ('order_number', 'created_at', 'updated_at') + raw_id_fields = ('user',) + inlines = [OrderItemInline, PaymentInline] + + fieldsets = ( + ('订单信息', { + 'fields': ('order_number', 'user', 'status', 'created_at', 'updated_at') + }), + ('金额信息', { + 'fields': ('total_amount', 'shipping_fee', 'discount_amount', 'final_amount') + }), + ('收货信息', { + 'fields': ('shipping_name', 'shipping_phone', 'shipping_address', 'shipping_zip_code') + }), + ('备注信息', { + 'fields': ('note', 'admin_note') + }), + ('时间记录', { + 'fields': ('paid_at', 'shipped_at', 'delivered_at') + }), + ) + + def get_queryset(self, request): + return super().get_queryset(request).select_related('user') + +@admin.register(OrderItem) +class OrderItemAdmin(admin.ModelAdmin): + list_display = ('order', 'product_name', 'product_sku', 'unit_price', 'quantity', 'subtotal') + list_filter = ('created_at',) + search_fields = ('order__order_number', 'product__name', 'product_name', 'product_sku') + raw_id_fields = ('order', 'product') + +@admin.register(Payment) +class PaymentAdmin(admin.ModelAdmin): + list_display = ('order', 'payment_method', 'payment_status', 'amount', 'transaction_id', 'created_at') + list_filter = ('payment_method', 'payment_status', 'created_at', 'paid_at') + search_fields = ('order__order_number', 'transaction_id', 'third_party_id') + raw_id_fields = ('order',) + +@admin.register(Shipping) +class ShippingAdmin(admin.ModelAdmin): + list_display = ('order', 'shipping_company', 'tracking_number', 'shipping_status', 'shipped_at') + list_filter = ('shipping_status', 'shipping_company', 'shipped_at', 'delivered_at') + search_fields = ('order__order_number', 'tracking_number', 'shipping_company') + raw_id_fields = ('order',) + +@admin.register(ShippingTracking) +class ShippingTrackingAdmin(admin.ModelAdmin): + list_display = ('shipping', 'location', 'description', 'timestamp') + list_filter = ('timestamp', 'created_at') + search_fields = ('shipping__order__order_number', 'location', 'description') + raw_id_fields = ('shipping',) + +@admin.register(Cart) +class CartAdmin(admin.ModelAdmin): + list_display = ('user', 'product', 'quantity', 'subtotal', 'created_at') + list_filter = ('created_at', 'updated_at') + search_fields = ('user__username', 'product__name') + raw_id_fields = ('user', 'product') + + def subtotal(self, obj): + return obj.subtotal + subtotal.short_description = '小计' + +@admin.register(Wishlist) +class WishlistAdmin(admin.ModelAdmin): + list_display = ('user', 'product', 'created_at') + list_filter = ('created_at',) + search_fields = ('user__username', 'product__name') + raw_id_fields = ('user', 'product') diff --git a/orders/apps.py b/orders/apps.py new file mode 100644 index 000000000..8ae0375c4 --- /dev/null +++ b/orders/apps.py @@ -0,0 +1,6 @@ +from django.apps import AppConfig + + +class OrdersConfig(AppConfig): + default_auto_field = 'django.db.models.BigAutoField' + name = 'orders' diff --git a/orders/migrations/0001_initial.py b/orders/migrations/0001_initial.py new file mode 100644 index 000000000..93f5085ff --- /dev/null +++ b/orders/migrations/0001_initial.py @@ -0,0 +1,133 @@ +# Generated by Django 5.2.5 on 2025-08-12 02:09 + +from django.db import migrations, models + + +class Migration(migrations.Migration): + + initial = True + + dependencies = [ + ] + + operations = [ + migrations.CreateModel( + name='Cart', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('quantity', models.IntegerField(default=1, verbose_name='数量')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')), + ], + options={ + 'verbose_name': '购物车', + 'verbose_name_plural': '购物车', + }, + ), + migrations.CreateModel( + name='Order', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('order_number', models.CharField(max_length=50, unique=True, verbose_name='订单号')), + ('status', models.CharField(choices=[('pending', '待付款'), ('paid', '已付款'), ('processing', '处理中'), ('shipped', '已发货'), ('delivered', '已送达'), ('cancelled', '已取消'), ('refunded', '已退款')], default='pending', max_length=20, verbose_name='订单状态')), + ('total_amount', models.DecimalField(decimal_places=2, max_digits=10, verbose_name='总金额')), + ('shipping_fee', models.DecimalField(decimal_places=2, default=0, max_digits=8, verbose_name='运费')), + ('discount_amount', models.DecimalField(decimal_places=2, default=0, max_digits=8, verbose_name='优惠金额')), + ('final_amount', models.DecimalField(decimal_places=2, max_digits=10, verbose_name='实付金额')), + ('shipping_name', models.CharField(max_length=100, verbose_name='收货人姓名')), + ('shipping_phone', models.CharField(max_length=20, verbose_name='收货人电话')), + ('shipping_address', models.TextField(verbose_name='收货地址')), + ('shipping_zip_code', models.CharField(blank=True, max_length=10, verbose_name='邮政编码')), + ('note', models.TextField(blank=True, verbose_name='订单备注')), + ('admin_note', models.TextField(blank=True, verbose_name='管理员备注')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')), + ('paid_at', models.DateTimeField(blank=True, null=True, verbose_name='付款时间')), + ('shipped_at', models.DateTimeField(blank=True, null=True, verbose_name='发货时间')), + ('delivered_at', models.DateTimeField(blank=True, null=True, verbose_name='送达时间')), + ], + options={ + 'verbose_name': '订单', + 'verbose_name_plural': '订单', + 'ordering': ['-created_at'], + }, + ), + migrations.CreateModel( + name='OrderItem', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('product_name', models.CharField(max_length=200, verbose_name='产品名称')), + ('product_sku', models.CharField(max_length=50, verbose_name='产品SKU')), + ('unit_price', models.DecimalField(decimal_places=2, max_digits=10, verbose_name='单价')), + ('quantity', models.IntegerField(verbose_name='数量')), + ('subtotal', models.DecimalField(decimal_places=2, max_digits=10, verbose_name='小计')), + ('product_attributes', models.JSONField(blank=True, null=True, verbose_name='产品属性')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ], + options={ + 'verbose_name': '订单项', + 'verbose_name_plural': '订单项', + }, + ), + migrations.CreateModel( + name='Payment', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('payment_method', models.CharField(choices=[('alipay', '支付宝'), ('wechat', '微信支付'), ('bank_card', '银行卡'), ('cash', '现金'), ('other', '其他')], max_length=20, verbose_name='支付方式')), + ('payment_status', models.CharField(choices=[('pending', '待支付'), ('success', '支付成功'), ('failed', '支付失败'), ('cancelled', '已取消'), ('refunded', '已退款')], default='pending', max_length=20, verbose_name='支付状态')), + ('amount', models.DecimalField(decimal_places=2, max_digits=10, verbose_name='支付金额')), + ('transaction_id', models.CharField(blank=True, max_length=100, verbose_name='交易流水号')), + ('third_party_id', models.CharField(blank=True, max_length=100, verbose_name='第三方交易号')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ('paid_at', models.DateTimeField(blank=True, null=True, verbose_name='支付时间')), + ], + options={ + 'verbose_name': '支付记录', + 'verbose_name_plural': '支付记录', + 'ordering': ['-created_at'], + }, + ), + migrations.CreateModel( + name='Shipping', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('shipping_company', models.CharField(blank=True, max_length=100, verbose_name='快递公司')), + ('tracking_number', models.CharField(blank=True, max_length=100, verbose_name='快递单号')), + ('shipping_status', models.CharField(choices=[('preparing', '准备中'), ('shipped', '已发货'), ('in_transit', '运输中'), ('delivered', '已送达'), ('returned', '已退回')], default='preparing', max_length=20, verbose_name='配送状态')), + ('shipped_at', models.DateTimeField(blank=True, null=True, verbose_name='发货时间')), + ('delivered_at', models.DateTimeField(blank=True, null=True, verbose_name='送达时间')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')), + ], + options={ + 'verbose_name': '配送记录', + 'verbose_name_plural': '配送记录', + }, + ), + migrations.CreateModel( + name='ShippingTracking', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('location', models.CharField(max_length=200, verbose_name='位置')), + ('description', models.TextField(verbose_name='描述')), + ('timestamp', models.DateTimeField(verbose_name='时间')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ], + options={ + 'verbose_name': '配送跟踪', + 'verbose_name_plural': '配送跟踪', + 'ordering': ['-timestamp'], + }, + ), + migrations.CreateModel( + name='Wishlist', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ], + options={ + 'verbose_name': '收藏夹', + 'verbose_name_plural': '收藏夹', + }, + ), + ] diff --git a/orders/migrations/0002_initial.py b/orders/migrations/0002_initial.py new file mode 100644 index 000000000..a05a92ee1 --- /dev/null +++ b/orders/migrations/0002_initial.py @@ -0,0 +1,22 @@ +# Generated by Django 5.2.5 on 2025-08-12 02:09 + +import django.db.models.deletion +from django.db import migrations, models + + +class Migration(migrations.Migration): + + initial = True + + dependencies = [ + ('orders', '0001_initial'), + ('products', '0001_initial'), + ] + + operations = [ + migrations.AddField( + model_name='cart', + name='product', + field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='products.product', verbose_name='产品'), + ), + ] diff --git a/orders/migrations/0003_initial.py b/orders/migrations/0003_initial.py new file mode 100644 index 000000000..b0442dd0c --- /dev/null +++ b/orders/migrations/0003_initial.py @@ -0,0 +1,72 @@ +# Generated by Django 5.2.5 on 2025-08-12 02:09 + +import django.db.models.deletion +from django.conf import settings +from django.db import migrations, models + + +class Migration(migrations.Migration): + + initial = True + + dependencies = [ + ('orders', '0002_initial'), + ('products', '0001_initial'), + migrations.swappable_dependency(settings.AUTH_USER_MODEL), + ] + + operations = [ + migrations.AddField( + model_name='cart', + name='user', + field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='cart_items', to=settings.AUTH_USER_MODEL, verbose_name='用户'), + ), + migrations.AddField( + model_name='order', + name='user', + field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='orders', to=settings.AUTH_USER_MODEL, verbose_name='用户'), + ), + migrations.AddField( + model_name='orderitem', + name='order', + field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='items', to='orders.order', verbose_name='订单'), + ), + migrations.AddField( + model_name='orderitem', + name='product', + field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='products.product', verbose_name='产品'), + ), + migrations.AddField( + model_name='payment', + name='order', + field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='payments', to='orders.order', verbose_name='订单'), + ), + migrations.AddField( + model_name='shipping', + name='order', + field=models.OneToOneField(on_delete=django.db.models.deletion.CASCADE, related_name='shipping', to='orders.order', verbose_name='订单'), + ), + migrations.AddField( + model_name='shippingtracking', + name='shipping', + field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='tracking_records', to='orders.shipping', verbose_name='配送'), + ), + migrations.AddField( + model_name='wishlist', + name='product', + field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='products.product', verbose_name='产品'), + ), + migrations.AddField( + model_name='wishlist', + name='user', + field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='wishlist_items', to=settings.AUTH_USER_MODEL, verbose_name='用户'), + ), + migrations.AlterUniqueTogether( + name='cart', + unique_together={('user', 'product')}, + ), + migrations.AlterUniqueTogether( + name='wishlist', + unique_together={('user', 'product')}, + ), + ] diff --git a/orders/migrations/__init__.py b/orders/migrations/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/orders/models.py b/orders/models.py new file mode 100644 index 000000000..dd34f7117 --- /dev/null +++ b/orders/models.py @@ -0,0 +1,206 @@ +from django.db import models +from django.conf import settings +from django.utils import timezone +from products.models import Product + +class Order(models.Model): + """订单""" + ORDER_STATUS_CHOICES = [ + ('pending', '待付款'), + ('paid', '已付款'), + ('processing', '处理中'), + ('shipped', '已发货'), + ('delivered', '已送达'), + ('cancelled', '已取消'), + ('refunded', '已退款'), + ] + + order_number = models.CharField('订单号', max_length=50, unique=True) + user = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE, + verbose_name='用户', related_name='orders') + status = models.CharField('订单状态', max_length=20, choices=ORDER_STATUS_CHOICES, + default='pending') + total_amount = models.DecimalField('总金额', max_digits=10, decimal_places=2) + shipping_fee = models.DecimalField('运费', max_digits=8, decimal_places=2, default=0) + discount_amount = models.DecimalField('优惠金额', max_digits=8, decimal_places=2, default=0) + final_amount = models.DecimalField('实付金额', max_digits=10, decimal_places=2) + + # 收货信息 + shipping_name = models.CharField('收货人姓名', max_length=100) + shipping_phone = models.CharField('收货人电话', max_length=20) + shipping_address = models.TextField('收货地址') + shipping_zip_code = models.CharField('邮政编码', max_length=10, blank=True) + + # 备注信息 + note = models.TextField('订单备注', blank=True) + admin_note = models.TextField('管理员备注', blank=True) + + # 时间信息 + created_at = models.DateTimeField('创建时间', auto_now_add=True) + updated_at = models.DateTimeField('更新时间', auto_now=True) + paid_at = models.DateTimeField('付款时间', null=True, blank=True) + shipped_at = models.DateTimeField('发货时间', null=True, blank=True) + delivered_at = models.DateTimeField('送达时间', null=True, blank=True) + + class Meta: + verbose_name = '订单' + verbose_name_plural = '订单' + ordering = ['-created_at'] + + def __str__(self): + return f"订单 {self.order_number}" + + def save(self, *args, **kwargs): + if not self.order_number: + # 生成订单号 + import uuid + self.order_number = f"ORD{timezone.now().strftime('%Y%m%d')}{str(uuid.uuid4())[:8].upper()}" + super().save(*args, **kwargs) + +class OrderItem(models.Model): + """订单项""" + order = models.ForeignKey(Order, on_delete=models.CASCADE, + related_name='items', verbose_name='订单') + product = models.ForeignKey(Product, on_delete=models.CASCADE, verbose_name='产品') + product_name = models.CharField('产品名称', max_length=200) # 冗余存储，防止产品删除 + product_sku = models.CharField('产品SKU', max_length=50) + unit_price = models.DecimalField('单价', max_digits=10, decimal_places=2) + quantity = models.IntegerField('数量') + subtotal = models.DecimalField('小计', max_digits=10, decimal_places=2) + + # 产品属性快照 + product_attributes = models.JSONField('产品属性', blank=True, null=True) + + created_at = models.DateTimeField('创建时间', auto_now_add=True) + + class Meta: + verbose_name = '订单项' + verbose_name_plural = '订单项' + + def __str__(self): + return f"{self.order.order_number} - {self.product_name}" + + def save(self, *args, **kwargs): + self.subtotal = self.unit_price * self.quantity + super().save(*args, **kwargs) + +class Payment(models.Model): + """支付记录""" + PAYMENT_METHOD_CHOICES = [ + ('alipay', '支付宝'), + ('wechat', '微信支付'), + ('bank_card', '银行卡'), + ('cash', '现金'), + ('other', '其他'), + ] + + PAYMENT_STATUS_CHOICES = [ + ('pending', '待支付'), + ('success', '支付成功'), + ('failed', '支付失败'), + ('cancelled', '已取消'), + ('refunded', '已退款'), + ] + + order = models.ForeignKey(Order, on_delete=models.CASCADE, + related_name='payments', verbose_name='订单') + payment_method = models.CharField('支付方式', max_length=20, + choices=PAYMENT_METHOD_CHOICES) + payment_status = models.CharField('支付状态', max_length=20, + choices=PAYMENT_STATUS_CHOICES, default='pending') + amount = models.DecimalField('支付金额', max_digits=10, decimal_places=2) + transaction_id = models.CharField('交易流水号', max_length=100, blank=True) + third_party_id = models.CharField('第三方交易号', max_length=100, blank=True) + + created_at = models.DateTimeField('创建时间', auto_now_add=True) + paid_at = models.DateTimeField('支付时间', null=True, blank=True) + + class Meta: + verbose_name = '支付记录' + verbose_name_plural = '支付记录' + ordering = ['-created_at'] + + def __str__(self): + return f"{self.order.order_number} - {self.get_payment_method_display()}" + +class Shipping(models.Model): + """配送记录""" + SHIPPING_STATUS_CHOICES = [ + ('preparing', '准备中'), + ('shipped', '已发货'), + ('in_transit', '运输中'), + ('delivered', '已送达'), + ('returned', '已退回'), + ] + + order = models.OneToOneField(Order, on_delete=models.CASCADE, + related_name='shipping', verbose_name='订单') + shipping_company = models.CharField('快递公司', max_length=100, blank=True) + tracking_number = models.CharField('快递单号', max_length=100, blank=True) + shipping_status = models.CharField('配送状态', max_length=20, + choices=SHIPPING_STATUS_CHOICES, default='preparing') + + shipped_at = models.DateTimeField('发货时间', null=True, blank=True) + delivered_at = models.DateTimeField('送达时间', null=True, blank=True) + created_at = models.DateTimeField('创建时间', auto_now_add=True) + updated_at = models.DateTimeField('更新时间', auto_now=True) + + class Meta: + verbose_name = '配送记录' + verbose_name_plural = '配送记录' + + def __str__(self): + return f"{self.order.order_number} - 配送" + +class ShippingTracking(models.Model): + """配送跟踪""" + shipping = models.ForeignKey(Shipping, on_delete=models.CASCADE, + related_name='tracking_records', verbose_name='配送') + location = models.CharField('位置', max_length=200) + description = models.TextField('描述') + timestamp = models.DateTimeField('时间') + created_at = models.DateTimeField('创建时间', auto_now_add=True) + + class Meta: + verbose_name = '配送跟踪' + verbose_name_plural = '配送跟踪' + ordering = ['-timestamp'] + + def __str__(self): + return f"{self.shipping.order.order_number} - {self.location}" + +class Cart(models.Model): + """购物车""" + user = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE, + verbose_name='用户', related_name='cart_items') + product = models.ForeignKey(Product, on_delete=models.CASCADE, verbose_name='产品') + quantity = models.IntegerField('数量', default=1) + created_at = models.DateTimeField('创建时间', auto_now_add=True) + updated_at = models.DateTimeField('更新时间', auto_now=True) + + class Meta: + verbose_name = '购物车' + verbose_name_plural = '购物车' + unique_together = ['user', 'product'] + + def __str__(self): + return f"{self.user.username} - {self.product.name}" + + @property + def subtotal(self): + return self.product.price * self.quantity + +class Wishlist(models.Model): + """收藏夹""" + user = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE, + verbose_name='用户', related_name='wishlist_items') + product = models.ForeignKey(Product, on_delete=models.CASCADE, verbose_name='产品') + created_at = models.DateTimeField('创建时间', auto_now_add=True) + + class Meta: + verbose_name = '收藏夹' + verbose_name_plural = '收藏夹' + unique_together = ['user', 'product'] + + def __str__(self): + return f"{self.user.username} - {self.product.name}" diff --git a/orders/tests.py b/orders/tests.py new file mode 100644 index 000000000..7ce503c2d --- /dev/null +++ b/orders/tests.py @@ -0,0 +1,3 @@ +from django.test import TestCase + +# Create your tests here. diff --git a/orders/views.py b/orders/views.py new file mode 100644 index 000000000..91ea44a21 --- /dev/null +++ b/orders/views.py @@ -0,0 +1,3 @@ +from django.shortcuts import render + +# Create your views here. diff --git a/products/__init__.py b/products/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/products/admin.py b/products/admin.py new file mode 100644 index 000000000..5bbe13723 --- /dev/null +++ b/products/admin.py @@ -0,0 +1,79 @@ +from django.contrib import admin +from django.utils.html import format_html +from .models import (Category, Brand, Product, ProductImage, + ProductAttribute, ProductAttributeValue) + +class ProductImageInline(admin.TabularInline): + model = ProductImage + extra = 1 + fields = ('image', 'alt_text', 'is_primary', 'sort_order') + +class ProductAttributeValueInline(admin.TabularInline): + model = ProductAttributeValue + extra = 1 + fields = ('attribute', 'value') + +@admin.register(Category) +class CategoryAdmin(admin.ModelAdmin): + list_display = ('name', 'parent', 'is_active', 'sort_order', 'created_at') + list_filter = ('is_active', 'created_at', 'parent') + search_fields = ('name', 'description') + prepopulated_fields = {} + ordering = ('sort_order', 'name') + +@admin.register(Brand) +class BrandAdmin(admin.ModelAdmin): + list_display = ('name', 'is_active', 'created_at') + list_filter = ('is_active', 'created_at') + search_fields = ('name', 'description') + +@admin.register(Product) +class ProductAdmin(admin.ModelAdmin): + list_display = ('name', 'sku', 'category', 'brand', 'price', 'stock_quantity', + 'is_active', 'is_featured', 'created_at') + list_filter = ('is_active', 'is_featured', 'category', 'brand', 'created_at') + search_fields = ('name', 'sku', 'description') + prepopulated_fields = {'slug': ('name',)} + raw_id_fields = ('created_by',) + inlines = [ProductImageInline, ProductAttributeValueInline] + + fieldsets = ( + ('基本信息', { + 'fields': ('name', 'slug', 'sku', 'category', 'brand', 'created_by') + }), + ('描述信息', { + 'fields': ('description', 'short_description') + }), + ('价格库存', { + 'fields': ('price', 'cost_price', 'stock_quantity', 'min_stock_level') + }), + ('规格信息', { + 'fields': ('weight', 'dimensions') + }), + ('状态设置', { + 'fields': ('is_active', 'is_featured') + }), + ) + + def get_queryset(self, request): + return super().get_queryset(request).select_related('category', 'brand', 'created_by') + +@admin.register(ProductImage) +class ProductImageAdmin(admin.ModelAdmin): + list_display = ('product', 'alt_text', 'is_primary', 'sort_order', 'created_at') + list_filter = ('is_primary', 'created_at') + search_fields = ('product__name', 'alt_text') + raw_id_fields = ('product',) + +@admin.register(ProductAttribute) +class ProductAttributeAdmin(admin.ModelAdmin): + list_display = ('display_name', 'name', 'attribute_type', 'is_required', 'is_filterable') + list_filter = ('attribute_type', 'is_required', 'is_filterable') + search_fields = ('name', 'display_name') + +@admin.register(ProductAttributeValue) +class ProductAttributeValueAdmin(admin.ModelAdmin): + list_display = ('product', 'attribute', 'value', 'created_at') + list_filter = ('attribute', 'created_at') + search_fields = ('product__name', 'attribute__display_name', 'value') + raw_id_fields = ('product', 'attribute') diff --git a/products/apps.py b/products/apps.py new file mode 100644 index 000000000..145a2ac9e --- /dev/null +++ b/products/apps.py @@ -0,0 +1,6 @@ +from django.apps import AppConfig + + +class ProductsConfig(AppConfig): + default_auto_field = 'django.db.models.BigAutoField' + name = 'products' diff --git a/products/migrations/0001_initial.py b/products/migrations/0001_initial.py new file mode 100644 index 000000000..b260b68b6 --- /dev/null +++ b/products/migrations/0001_initial.py @@ -0,0 +1,121 @@ +# Generated by Django 5.2.5 on 2025-08-12 02:09 + +import django.db.models.deletion +from django.db import migrations, models + + +class Migration(migrations.Migration): + + initial = True + + dependencies = [ + ] + + operations = [ + migrations.CreateModel( + name='Brand', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('name', models.CharField(max_length=100, verbose_name='品牌名称')), + ('logo', models.ImageField(blank=True, null=True, upload_to='brands/', verbose_name='品牌LOGO')), + ('description', models.TextField(blank=True, verbose_name='品牌描述')), + ('website', models.URLField(blank=True, verbose_name='官方网站')), + ('is_active', models.BooleanField(default=True, verbose_name='是否激活')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ], + options={ + 'verbose_name': '品牌', + 'verbose_name_plural': '品牌', + }, + ), + migrations.CreateModel( + name='ProductAttribute', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('name', models.CharField(max_length=100, verbose_name='属性名称')), + ('display_name', models.CharField(max_length=100, verbose_name='显示名称')), + ('attribute_type', models.CharField(choices=[('text', '文本'), ('number', '数字'), ('select', '选择'), ('color', '颜色'), ('size', '尺寸')], default='text', max_length=20, verbose_name='属性类型')), + ('is_required', models.BooleanField(default=False, verbose_name='是否必填')), + ('is_filterable', models.BooleanField(default=True, verbose_name='是否可筛选')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ], + options={ + 'verbose_name': '产品属性', + 'verbose_name_plural': '产品属性', + }, + ), + migrations.CreateModel( + name='ProductAttributeValue', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('value', models.TextField(verbose_name='属性值')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ], + options={ + 'verbose_name': '产品属性值', + 'verbose_name_plural': '产品属性值', + }, + ), + migrations.CreateModel( + name='ProductImage', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('image', models.ImageField(upload_to='products/', verbose_name='图片')), + ('alt_text', models.CharField(blank=True, max_length=200, verbose_name='替代文本')), + ('is_primary', models.BooleanField(default=False, verbose_name='是否为主图')), + ('sort_order', models.IntegerField(default=0, verbose_name='排序')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ], + options={ + 'verbose_name': '产品图片', + 'verbose_name_plural': '产品图片', + 'ordering': ['sort_order', 'created_at'], + }, + ), + migrations.CreateModel( + name='Category', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('name', models.CharField(max_length=100, verbose_name='分类名称')), + ('description', models.TextField(blank=True, verbose_name='描述')), + ('image', models.ImageField(blank=True, null=True, upload_to='categories/', verbose_name='分类图片')), + ('is_active', models.BooleanField(default=True, verbose_name='是否激活')), + ('sort_order', models.IntegerField(default=0, verbose_name='排序')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ('parent', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='children', to='products.category', verbose_name='父分类')), + ], + options={ + 'verbose_name': '产品分类', + 'verbose_name_plural': '产品分类', + 'ordering': ['sort_order', 'name'], + }, + ), + migrations.CreateModel( + name='Product', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('name', models.CharField(max_length=200, verbose_name='产品名称')), + ('slug', models.SlugField(unique=True, verbose_name='URL别名')), + ('description', models.TextField(verbose_name='产品描述')), + ('short_description', models.TextField(blank=True, max_length=500, verbose_name='简短描述')), + ('sku', models.CharField(max_length=50, unique=True, verbose_name='SKU')), + ('price', models.DecimalField(decimal_places=2, max_digits=10, verbose_name='价格')), + ('cost_price', models.DecimalField(blank=True, decimal_places=2, max_digits=10, null=True, verbose_name='成本价')), + ('stock_quantity', models.IntegerField(default=0, verbose_name='库存数量')), + ('min_stock_level', models.IntegerField(default=10, verbose_name='最低库存')), + ('weight', models.DecimalField(blank=True, decimal_places=3, max_digits=8, null=True, verbose_name='重量(kg)')), + ('dimensions', models.CharField(blank=True, max_length=100, verbose_name='尺寸')), + ('is_active', models.BooleanField(default=True, verbose_name='是否上架')), + ('is_featured', models.BooleanField(default=False, verbose_name='是否推荐')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')), + ('brand', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, to='products.brand', verbose_name='品牌')), + ('category', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='products.category', verbose_name='分类')), + ], + options={ + 'verbose_name': '产品', + 'verbose_name_plural': '产品', + 'ordering': ['-created_at'], + }, + ), + ] diff --git a/products/migrations/0002_initial.py b/products/migrations/0002_initial.py new file mode 100644 index 000000000..fe0b276c8 --- /dev/null +++ b/products/migrations/0002_initial.py @@ -0,0 +1,42 @@ +# Generated by Django 5.2.5 on 2025-08-12 02:09 + +import django.db.models.deletion +from django.conf import settings +from django.db import migrations, models + + +class Migration(migrations.Migration): + + initial = True + + dependencies = [ + ('products', '0001_initial'), + migrations.swappable_dependency(settings.AUTH_USER_MODEL), + ] + + operations = [ + migrations.AddField( + model_name='product', + name='created_by', + field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL, verbose_name='创建者'), + ), + migrations.AddField( + model_name='productattributevalue', + name='attribute', + field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='products.productattribute', verbose_name='属性'), + ), + migrations.AddField( + model_name='productattributevalue', + name='product', + field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='attributes', to='products.product', verbose_name='产品'), + ), + migrations.AddField( + model_name='productimage', + name='product', + field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='images', to='products.product', verbose_name='产品'), + ), + migrations.AlterUniqueTogether( + name='productattributevalue', + unique_together={('product', 'attribute')}, + ), + ] diff --git a/products/migrations/__init__.py b/products/migrations/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/products/models.py b/products/models.py new file mode 100644 index 000000000..83dbc21ec --- /dev/null +++ b/products/models.py @@ -0,0 +1,138 @@ +from django.db import models +from django.conf import settings +from django.utils import timezone + +class Category(models.Model): + """产品分类""" + name = models.CharField('分类名称', max_length=100) + description = models.TextField('描述', blank=True) + parent = models.ForeignKey('self', on_delete=models.CASCADE, null=True, blank=True, + related_name='children', verbose_name='父分类') + image = models.ImageField('分类图片', upload_to='categories/', blank=True, null=True) + is_active = models.BooleanField('是否激活', default=True) + sort_order = models.IntegerField('排序', default=0) + created_at = models.DateTimeField('创建时间', auto_now_add=True) + + class Meta: + verbose_name = '产品分类' + verbose_name_plural = '产品分类' + ordering = ['sort_order', 'name'] + + def __str__(self): + return self.name + +class Brand(models.Model): + """品牌""" + name = models.CharField('品牌名称', max_length=100) + logo = models.ImageField('品牌LOGO', upload_to='brands/', blank=True, null=True) + description = models.TextField('品牌描述', blank=True) + website = models.URLField('官方网站', blank=True) + is_active = models.BooleanField('是否激活', default=True) + created_at = models.DateTimeField('创建时间', auto_now_add=True) + + class Meta: + verbose_name = '品牌' + verbose_name_plural = '品牌' + + def __str__(self): + return self.name + +class Product(models.Model): + """产品""" + name = models.CharField('产品名称', max_length=200) + slug = models.SlugField('URL别名', unique=True) + description = models.TextField('产品描述') + short_description = models.TextField('简短描述', max_length=500, blank=True) + category = models.ForeignKey(Category, on_delete=models.CASCADE, verbose_name='分类') + brand = models.ForeignKey(Brand, on_delete=models.CASCADE, verbose_name='品牌', + blank=True, null=True) + sku = models.CharField('SKU', max_length=50, unique=True) + price = models.DecimalField('价格', max_digits=10, decimal_places=2) + cost_price = models.DecimalField('成本价', max_digits=10, decimal_places=2, + blank=True, null=True) + stock_quantity = models.IntegerField('库存数量', default=0) + min_stock_level = models.IntegerField('最低库存', default=10) + weight = models.DecimalField('重量(kg)', max_digits=8, decimal_places=3, + blank=True, null=True) + dimensions = models.CharField('尺寸', max_length=100, blank=True) + is_active = models.BooleanField('是否上架', default=True) + is_featured = models.BooleanField('是否推荐', default=False) + created_by = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE, + verbose_name='创建者') + created_at = models.DateTimeField('创建时间', auto_now_add=True) + updated_at = models.DateTimeField('更新时间', auto_now=True) + + class Meta: + verbose_name = '产品' + verbose_name_plural = '产品' + ordering = ['-created_at'] + + def __str__(self): + return self.name + + @property + def is_in_stock(self): + return self.stock_quantity > 0 + + @property + def is_low_stock(self): + return self.stock_quantity <= self.min_stock_level + +class ProductImage(models.Model): + """产品图片""" + product = models.ForeignKey(Product, on_delete=models.CASCADE, + related_name='images', verbose_name='产品') + image = models.ImageField('图片', upload_to='products/') + alt_text = models.CharField('替代文本', max_length=200, blank=True) + is_primary = models.BooleanField('是否为主图', default=False) + sort_order = models.IntegerField('排序', default=0) + created_at = models.DateTimeField('创建时间', auto_now_add=True) + + class Meta: + verbose_name = '产品图片' + verbose_name_plural = '产品图片' + ordering = ['sort_order', 'created_at'] + + def __str__(self): + return f"{self.product.name} - 图片" + +class ProductAttribute(models.Model): + """产品属性""" + name = models.CharField('属性名称', max_length=100) + display_name = models.CharField('显示名称', max_length=100) + attribute_type_choices = [ + ('text', '文本'), + ('number', '数字'), + ('select', '选择'), + ('color', '颜色'), + ('size', '尺寸'), + ] + attribute_type = models.CharField('属性类型', max_length=20, + choices=attribute_type_choices, default='text') + is_required = models.BooleanField('是否必填', default=False) + is_filterable = models.BooleanField('是否可筛选', default=True) + created_at = models.DateTimeField('创建时间', auto_now_add=True) + + class Meta: + verbose_name = '产品属性' + verbose_name_plural = '产品属性' + + def __str__(self): + return self.display_name + +class ProductAttributeValue(models.Model): + """产品属性值""" + product = models.ForeignKey(Product, on_delete=models.CASCADE, + related_name='attributes', verbose_name='产品') + attribute = models.ForeignKey(ProductAttribute, on_delete=models.CASCADE, + verbose_name='属性') + value = models.TextField('属性值') + created_at = models.DateTimeField('创建时间', auto_now_add=True) + + class Meta: + verbose_name = '产品属性值' + verbose_name_plural = '产品属性值' + unique_together = ['product', 'attribute'] + + def __str__(self): + return f"{self.product.name} - {self.attribute.display_name}: {self.value}" diff --git a/products/tests.py b/products/tests.py new file mode 100644 index 000000000..7ce503c2d --- /dev/null +++ b/products/tests.py @@ -0,0 +1,3 @@ +from django.test import TestCase + +# Create your tests here. diff --git a/products/urls.py b/products/urls.py new file mode 100644 index 000000000..a272db450 --- /dev/null +++ b/products/urls.py @@ -0,0 +1,13 @@ +from django.urls import path +from . import views + +app_name = 'products' + +urlpatterns = [ + path('', views.product_list, name='product_list'), + path('product//', views.product_detail, name='product_detail'), + path('categories/', views.category_list, name='category_list'), + path('category//', views.category_detail, name='category_detail'), + path('brands/', views.brand_list, name='brand_list'), + path('brand//', views.brand_detail, name='brand_detail'), +] \ No newline at end of file diff --git a/products/views.py b/products/views.py new file mode 100644 index 000000000..6d99e6434 --- /dev/null +++ b/products/views.py @@ -0,0 +1,287 @@ +from django.shortcuts import render, get_object_or_404 +from django.core.paginator import Paginator +from django.db.models import Q, Min, Max +from django.http import JsonResponse +from core.models import SiteSettings +from .models import Product, Category, Brand, ProductAttribute + +def get_site_settings(): + """获取网站设置""" + try: + return SiteSettings.objects.first() + except SiteSettings.DoesNotExist: + return None + +def product_list(request): + """产品列表""" + products = Product.objects.filter(is_active=True).select_related('category', 'brand') + + # 筛选条件 + category_id = request.GET.get('category') + brand_id = request.GET.get('brand') + min_price = request.GET.get('min_price') + max_price = request.GET.get('max_price') + search = request.GET.get('search', '').strip() + sort = request.GET.get('sort', 'created_at') + + if category_id: + products = products.filter(category_id=category_id) + + if brand_id: + products = products.filter(brand_id=brand_id) + + if min_price: + try: + products = products.filter(price__gte=float(min_price)) + except ValueError: + pass + + if max_price: + try: + products = products.filter(price__lte=float(max_price)) + except ValueError: + pass + + if search: + products = products.filter( + Q(name__icontains=search) | + Q(description__icontains=search) | + Q(short_description__icontains=search) + ) + + # 排序 + sort_options = { + 'created_at': '-created_at', + 'name': 'name', + 'price_asc': 'price', + 'price_desc': '-price', + } + if sort in sort_options: + products = products.order_by(sort_options[sort]) + + # 分页 + paginator = Paginator(products, 12) + page_number = request.GET.get('page') + page_obj = paginator.get_page(page_number) + + # 获取筛选选项 + categories = Category.objects.filter(is_active=True).order_by('sort_order', 'name') + brands = Brand.objects.filter(is_active=True).order_by('name') + + # 价格范围 + price_range = Product.objects.filter(is_active=True).aggregate( + min_price=Min('price'), + max_price=Max('price') + ) + + context = { + 'site_settings': get_site_settings(), + 'page_obj': page_obj, + 'categories': categories, + 'brands': brands, + 'price_range': price_range, + 'current_category': int(category_id) if category_id else None, + 'current_brand': int(brand_id) if brand_id else None, + 'current_min_price': min_price, + 'current_max_price': max_price, + 'search_query': search, + 'current_sort': sort, + 'total_products': products.count(), + } + return render(request, 'products/product_list.html', context) + +def product_detail(request, slug): + """产品详情""" + product = get_object_or_404( + Product.objects.select_related('category', 'brand', 'created_by') + .prefetch_related('images', 'attributes__attribute'), + slug=slug, + is_active=True + ) + + # 相关产品 + related_products = Product.objects.filter( + category=product.category, + is_active=True + ).exclude(id=product.id).select_related('category', 'brand')[:4] + + context = { + 'site_settings': get_site_settings(), + 'product': product, + 'related_products': related_products, + } + return render(request, 'products/product_detail.html', context) + +def category_list(request): + """分类列表""" + categories = Category.objects.filter( + is_active=True, + parent=None + ).prefetch_related('children').order_by('sort_order', 'name') + + context = { + 'site_settings': get_site_settings(), + 'categories': categories, + } + return render(request, 'products/category_list.html', context) + +def category_detail(request, pk): + """分类详情""" + category = get_object_or_404(Category, pk=pk, is_active=True) + + # 获取该分类及其子分类的所有产品 + category_ids = [category.id] + if category.children.exists(): + category_ids.extend(category.children.filter(is_active=True).values_list('id', flat=True)) + + products = Product.objects.filter( + category_id__in=category_ids, + is_active=True + ).select_related('category', 'brand') + + # 筛选和排序 + brand_id = request.GET.get('brand') + min_price = request.GET.get('min_price') + max_price = request.GET.get('max_price') + sort = request.GET.get('sort', 'created_at') + + if brand_id: + products = products.filter(brand_id=brand_id) + + if min_price: + try: + products = products.filter(price__gte=float(min_price)) + except ValueError: + pass + + if max_price: + try: + products = products.filter(price__lte=float(max_price)) + except ValueError: + pass + + # 排序 + sort_options = { + 'created_at': '-created_at', + 'name': 'name', + 'price_asc': 'price', + 'price_desc': '-price', + } + if sort in sort_options: + products = products.order_by(sort_options[sort]) + + # 分页 + paginator = Paginator(products, 12) + page_number = request.GET.get('page') + page_obj = paginator.get_page(page_number) + + # 获取该分类下的品牌 + brands = Brand.objects.filter( + product__category_id__in=category_ids, + is_active=True + ).distinct().order_by('name') + + # 价格范围 + price_range = products.aggregate( + min_price=Min('price'), + max_price=Max('price') + ) + + context = { + 'site_settings': get_site_settings(), + 'category': category, + 'page_obj': page_obj, + 'brands': brands, + 'price_range': price_range, + 'current_brand': int(brand_id) if brand_id else None, + 'current_min_price': min_price, + 'current_max_price': max_price, + 'current_sort': sort, + 'total_products': products.count(), + } + return render(request, 'products/category_detail.html', context) + +def brand_list(request): + """品牌列表""" + brands = Brand.objects.filter(is_active=True).order_by('name') + + paginator = Paginator(brands, 12) + page_number = request.GET.get('page') + page_obj = paginator.get_page(page_number) + + context = { + 'site_settings': get_site_settings(), + 'page_obj': page_obj, + } + return render(request, 'products/brand_list.html', context) + +def brand_detail(request, pk): + """品牌详情""" + brand = get_object_or_404(Brand, pk=pk, is_active=True) + + products = Product.objects.filter( + brand=brand, + is_active=True + ).select_related('category', 'brand') + + # 筛选和排序 + category_id = request.GET.get('category') + min_price = request.GET.get('min_price') + max_price = request.GET.get('max_price') + sort = request.GET.get('sort', 'created_at') + + if category_id: + products = products.filter(category_id=category_id) + + if min_price: + try: + products = products.filter(price__gte=float(min_price)) + except ValueError: + pass + + if max_price: + try: + products = products.filter(price__lte=float(max_price)) + except ValueError: + pass + + # 排序 + sort_options = { + 'created_at': '-created_at', + 'name': 'name', + 'price_asc': 'price', + 'price_desc': '-price', + } + if sort in sort_options: + products = products.order_by(sort_options[sort]) + + # 分页 + paginator = Paginator(products, 12) + page_number = request.GET.get('page') + page_obj = paginator.get_page(page_number) + + # 获取该品牌下的分类 + categories = Category.objects.filter( + product__brand=brand, + is_active=True + ).distinct().order_by('sort_order', 'name') + + # 价格范围 + price_range = products.aggregate( + min_price=Min('price'), + max_price=Max('price') + ) + + context = { + 'site_settings': get_site_settings(), + 'brand': brand, + 'page_obj': page_obj, + 'categories': categories, + 'price_range': price_range, + 'current_category': int(category_id) if category_id else None, + 'current_min_price': min_price, + 'current_max_price': max_price, + 'current_sort': sort, + 'total_products': products.count(), + } + return render(request, 'products/brand_detail.html', context) diff --git a/requirements.txt b/requirements.txt index d119b17d2..b489e94c4 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,3 +1,6 @@ --r requirements/runtime.txt --r requirements/deepspeed.txt --r requirements/modelscope.txt +Django==5.2.5 +psycopg2-binary==2.9.10 +Pillow==11.3.0 +python-decouple==3.8 +whitenoise==6.7.0 +gunicorn==22.0.0 diff --git a/static/css/style.css b/static/css/style.css new file mode 100644 index 000000000..9e87b1846 --- /dev/null +++ b/static/css/style.css @@ -0,0 +1,135 @@ +/* 自定义样式 */ +body { + font-family: 'Microsoft YaHei', 'PingFang SC', 'Helvetica Neue', Arial, sans-serif; +} + +.card { + transition: transform 0.2s ease-in-out; + border: 1px solid rgba(0,0,0,.125); +} + +.card:hover { + transform: translateY(-5px); + box-shadow: 0 4px 8px rgba(0,0,0,.1); +} + +.navbar-brand img { + max-height: 40px; +} + +.carousel-item img { + width: 100%; + height: 400px; + object-fit: cover; +} + +.product-card .card-img-top { + height: 200px; + object-fit: cover; +} + +.price { + font-size: 1.2em; + font-weight: bold; + color: #e74c3c; +} + +.btn { + border-radius: 4px; +} + +.alert { + border-radius: 4px; +} + +footer { + margin-top: auto; +} + +/* 响应式设计 */ +@media (max-width: 768px) { + .carousel-item img { + height: 250px; + } + + .product-card .card-img-top { + height: 150px; + } +} + +/* 加载动画 */ +.loading { + display: inline-block; + width: 20px; + height: 20px; + border: 3px solid #f3f3f3; + border-top: 3px solid #3498db; + border-radius: 50%; + animation: spin 2s linear infinite; +} + +@keyframes spin { + 0% { transform: rotate(0deg); } + 100% { transform: rotate(360deg); } +} + +/* 工具提示 */ +.tooltip { + font-size: 0.875rem; +} + +/* 表单样式 */ +.form-control:focus { + border-color: #007bff; + box-shadow: 0 0 0 0.2rem rgba(0,123,255,.25); +} + +/* 分页样式 */ +.pagination { + justify-content: center; +} + +/* 产品网格 */ +.product-grid { + display: grid; + grid-template-columns: repeat(auto-fill, minmax(250px, 1fr)); + gap: 1.5rem; + margin-top: 2rem; +} + +/* 筛选侧边栏 */ +.filter-sidebar { + background-color: #f8f9fa; + border-radius: 8px; + padding: 1.5rem; +} + +.filter-section { + margin-bottom: 1.5rem; +} + +.filter-section h6 { + color: #495057; + font-weight: 600; + margin-bottom: 0.75rem; +} + +/* 面包屑导航 */ +.breadcrumb { + background-color: transparent; + padding: 0.5rem 0; +} + +/* 徽章样式 */ +.badge { + font-size: 0.75em; +} + +/* 图片懒加载占位符 */ +.image-placeholder { + background-color: #f8f9fa; + display: flex; + align-items: center; + justify-content: center; + color: #6c757d; +} \ No newline at end of file diff --git a/templates/base.html b/templates/base.html new file mode 100644 index 000000000..a6312c0aa --- /dev/null +++ b/templates/base.html @@ -0,0 +1,169 @@ + + + + + + {% block title %}{{ site_settings.site_name|default:"我的网站" }}{% endblock %} + + + + + + + + + {% load static %} + + + {% block extra_css %}{% endblock %} + + {% if site_settings.favicon %} + + {% endif %} + + + + + + +
+ {% if messages %} +
+ {% for message in messages %} + + {% endfor %} +
+ {% endif %} + + {% block content %}{% endblock %} +
+ + +
+
+
+
+
{{ site_settings.site_name|default:"我的网站" }}
+

{{ site_settings.site_description|default:"" }}

+
+
+
联系信息
+ {% if site_settings.contact_email %} +

{{ site_settings.contact_email }}

+ {% endif %} + {% if site_settings.contact_phone %} +

{{ site_settings.contact_phone }}

+ {% endif %} + {% if site_settings.address %} +

{{ site_settings.address }}

+ {% endif %} +
+
+
快速链接
+ +
+
+
+
+

© {% now "Y" %} {{ site_settings.site_name|default:"我的网站" }}. 保留所有权利.

+
+
+
+ + + + {% block extra_js %}{% endblock %} + + {% if site_settings.google_analytics %} + {{ site_settings.google_analytics|safe }} + {% endif %} + + {% if site_settings.baidu_analytics %} + {{ site_settings.baidu_analytics|safe }} + {% endif %} + + \ No newline at end of file diff --git a/templates/core/home.html b/templates/core/home.html new file mode 100644 index 000000000..82b4ddae1 --- /dev/null +++ b/templates/core/home.html @@ -0,0 +1,136 @@ +{% extends 'base.html' %} +{% load static %} + +{% block title %}首页 - {{ site_settings.site_name|default:"我的网站" }}{% endblock %} + +{% block content %} + +{% if banners %} + +{% endif %} + +
+ + {% if categories %} +
+

产品分类

+
+ {% for category in categories %} +
+
+ {% if category.image %} + {{ category.name }} + {% endif %} +
+
{{ category.name }}
+ {% if category.description %} +

{{ category.description|truncatewords:20 }}

+ {% endif %} + 查看产品 +
+
+
+ {% endfor %} +
+
+ 查看所有分类 +
+
+ {% endif %} + + + {% if featured_products %} +
+

推荐产品

+
+ {% for product in featured_products %} +
+
+ {% with product.images.first as first_image %} + {% if first_image %} + {{ product.name }} + {% else %} +
+ +
+ {% endif %} + {% endwith %} +
+
{{ product.name }}
+ {% if product.short_description %} +

{{ product.short_description|truncatewords:15 }}

+ {% endif %} +
+
+ ¥{{ product.price }} + {% if product.category %} + {{ product.category.name }} + {% endif %} +
+ 查看详情 +
+
+
+
+ {% endfor %} +
+
+ 查看所有产品 +
+
+ {% endif %} + + +
+
+
+
+

欢迎来到{{ site_settings.site_name|default:"我的网站" }}

+

{{ site_settings.site_description|default:"这里是网站的简介内容，您可以在管理后台进行修改。" }}

+ 了解更多 +
+
+ {% if site_settings.logo %} + {{ site_settings.site_name }} + {% else %} + + {% endif %} +
+
+
+
+
+{% endblock %} \ No newline at end of file diff --git a/users/__init__.py b/users/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/users/admin.py b/users/admin.py new file mode 100644 index 000000000..4bd5f4a48 --- /dev/null +++ b/users/admin.py @@ -0,0 +1,35 @@ +from django.contrib import admin +from django.contrib.auth.admin import UserAdmin as BaseUserAdmin +from django.utils.html import format_html +from .models import User, UserProfile + +@admin.register(User) +class UserAdmin(BaseUserAdmin): + list_display = ('username', 'email', 'first_name', 'last_name', 'phone', + 'is_verified', 'is_staff', 'is_active', 'date_joined') + list_filter = ('is_staff', 'is_superuser', 'is_active', 'is_verified', + 'gender', 'date_joined') + search_fields = ('username', 'first_name', 'last_name', 'email', 'phone') + ordering = ('-date_joined',) + + fieldsets = BaseUserAdmin.fieldsets + ( + ('扩展信息', { + 'fields': ('phone', 'avatar', 'birth_date', 'gender', 'address', 'is_verified'), + }), + ) + + add_fieldsets = BaseUserAdmin.add_fieldsets + ( + ('扩展信息', { + 'fields': ('phone', 'avatar', 'birth_date', 'gender', 'address'), + }), + ) + + def get_queryset(self, request): + return super().get_queryset(request).select_related('profile') + +@admin.register(UserProfile) +class UserProfileAdmin(admin.ModelAdmin): + list_display = ('user', 'company', 'position', 'website') + search_fields = ('user__username', 'user__email', 'company', 'position') + list_filter = ('company',) + raw_id_fields = ('user',) diff --git a/users/apps.py b/users/apps.py new file mode 100644 index 000000000..72b140106 --- /dev/null +++ b/users/apps.py @@ -0,0 +1,6 @@ +from django.apps import AppConfig + + +class UsersConfig(AppConfig): + default_auto_field = 'django.db.models.BigAutoField' + name = 'users' diff --git a/users/migrations/0001_initial.py b/users/migrations/0001_initial.py new file mode 100644 index 000000000..4fe3e525c --- /dev/null +++ b/users/migrations/0001_initial.py @@ -0,0 +1,69 @@ +# Generated by Django 5.2.5 on 2025-08-12 02:09 + +import django.contrib.auth.models +import django.contrib.auth.validators +import django.db.models.deletion +import django.utils.timezone +from django.conf import settings +from django.db import migrations, models + + +class Migration(migrations.Migration): + + initial = True + + dependencies = [ + ('auth', '0012_alter_user_first_name_max_length'), + ] + + operations = [ + migrations.CreateModel( + name='User', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('password', models.CharField(max_length=128, verbose_name='password')), + ('last_login', models.DateTimeField(blank=True, null=True, verbose_name='last login')), + ('is_superuser', models.BooleanField(default=False, help_text='Designates that this user has all permissions without explicitly assigning them.', verbose_name='superuser status')), + ('username', models.CharField(error_messages={'unique': 'A user with that username already exists.'}, help_text='Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.', max_length=150, unique=True, validators=[django.contrib.auth.validators.UnicodeUsernameValidator()], verbose_name='username')), + ('first_name', models.CharField(blank=True, max_length=150, verbose_name='first name')), + ('last_name', models.CharField(blank=True, max_length=150, verbose_name='last name')), + ('email', models.EmailField(blank=True, max_length=254, verbose_name='email address')), + ('is_staff', models.BooleanField(default=False, help_text='Designates whether the user can log into this admin site.', verbose_name='staff status')), + ('is_active', models.BooleanField(default=True, help_text='Designates whether this user should be treated as active. Unselect this instead of deleting accounts.', verbose_name='active')), + ('date_joined', models.DateTimeField(default=django.utils.timezone.now, verbose_name='date joined')), + ('phone', models.CharField(blank=True, max_length=11, verbose_name='手机号')), + ('avatar', models.ImageField(blank=True, null=True, upload_to='avatars/', verbose_name='头像')), + ('birth_date', models.DateField(blank=True, null=True, verbose_name='出生日期')), + ('gender', models.CharField(blank=True, choices=[('M', '男'), ('F', '女'), ('O', '其他')], max_length=1, verbose_name='性别')), + ('address', models.TextField(blank=True, verbose_name='地址')), + ('is_verified', models.BooleanField(default=False, verbose_name='是否已验证')), + ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')), + ('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')), + ('groups', models.ManyToManyField(blank=True, help_text='The groups this user belongs to. A user will get all permissions granted to each of their groups.', related_name='user_set', related_query_name='user', to='auth.group', verbose_name='groups')), + ('user_permissions', models.ManyToManyField(blank=True, help_text='Specific permissions for this user.', related_name='user_set', related_query_name='user', to='auth.permission', verbose_name='user permissions')), + ], + options={ + 'verbose_name': '用户', + 'verbose_name_plural': '用户', + 'db_table': 'auth_user', + }, + managers=[ + ('objects', django.contrib.auth.models.UserManager()), + ], + ), + migrations.CreateModel( + name='UserProfile', + fields=[ + ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), + ('company', models.CharField(blank=True, max_length=100, verbose_name='公司')), + ('position', models.CharField(blank=True, max_length=50, verbose_name='职位')), + ('bio', models.TextField(blank=True, verbose_name='个人简介')), + ('website', models.URLField(blank=True, verbose_name='个人网站')), + ('user', models.OneToOneField(on_delete=django.db.models.deletion.CASCADE, related_name='profile', to=settings.AUTH_USER_MODEL)), + ], + options={ + 'verbose_name': '用户资料', + 'verbose_name_plural': '用户资料', + }, + ), + ] diff --git a/users/migrations/__init__.py b/users/migrations/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/users/models.py b/users/models.py new file mode 100644 index 000000000..8a4a81e54 --- /dev/null +++ b/users/models.py @@ -0,0 +1,42 @@ +from django.db import models +from django.contrib.auth.models import AbstractUser +from django.utils import timezone + +class User(AbstractUser): + """扩展用户模型""" + phone = models.CharField('手机号', max_length=11, blank=True) + avatar = models.ImageField('头像', upload_to='avatars/', blank=True, null=True) + birth_date = models.DateField('出生日期', blank=True, null=True) + gender_choices = [ + ('M', '男'), + ('F', '女'), + ('O', '其他'), + ] + gender = models.CharField('性别', max_length=1, choices=gender_choices, blank=True) + address = models.TextField('地址', blank=True) + is_verified = models.BooleanField('是否已验证', default=False) + created_at = models.DateTimeField('创建时间', auto_now_add=True) + updated_at = models.DateTimeField('更新时间', auto_now=True) + + class Meta: + verbose_name = '用户' + verbose_name_plural = '用户' + db_table = 'auth_user' + + def __str__(self): + return self.username + +class UserProfile(models.Model): + """用户资料""" + user = models.OneToOneField(User, on_delete=models.CASCADE, related_name='profile') + company = models.CharField('公司', max_length=100, blank=True) + position = models.CharField('职位', max_length=50, blank=True) + bio = models.TextField('个人简介', blank=True) + website = models.URLField('个人网站', blank=True) + + class Meta: + verbose_name = '用户资料' + verbose_name_plural = '用户资料' + + def __str__(self): + return f"{self.user.username}的资料" diff --git a/users/tests.py b/users/tests.py new file mode 100644 index 000000000..7ce503c2d --- /dev/null +++ b/users/tests.py @@ -0,0 +1,3 @@ +from django.test import TestCase + +# Create your tests here. diff --git a/users/views.py b/users/views.py new file mode 100644 index 000000000..91ea44a21 --- /dev/null +++ b/users/views.py @@ -0,0 +1,3 @@ +from django.shortcuts import render + +# Create your views here.