new

.gitignore

@@ -93,7 +93,7 @@ ehthumbs.db
 *.3g2
 *.asf
 *.rm
-*.rmvb
+*.rmVB
 *.vob
 *.mpg
 *.mpeg

README.md

@@ -1,220 +0,0 @@
-# 量极AI硬件商城
-
-一个基于React和Django的AI硬件在线商城系统，提供硬件配置展示、订单管理和支付功能。
-
-## 🚀 项目概述
-
-量极AI硬件商城是一个全栈Web应用程序，专注于AI硬件产品的在线销售。系统采用前后端分离架构，前端使用React + Vite + Ant Design，后端使用Django REST Framework。
-
-## 📋 功能特性
-
-### 前端功能
-- 🛍️ 硬件配置展示和选择
-- 🛒 购物车功能
-- 📋 订单创建和管理
-- 💳 支付流程集成
-- 🔗 推广码支持
-- 📱 响应式设计
-
-### 后端功能
-- 🏪 产品配置管理
-- 📦 订单处理
-- 💰 支付接口
-- 👥 用户管理
-- 📊 数据统计
-
-## 🛠️ 技术栈
-
-### 前端技术
-- **React 19** - 现代化UI库
-- **Vite** - 快速构建工具
-- **Ant Design** - 企业级UI组件库
-- **React Router** - 路由管理
-- **Axios** - HTTP客户端
-
-### 后端技术
-- **Django 6.0** - Python Web框架
-- **Django REST Framework** - RESTful API
-- **PostgreSQL** - 数据库
-- **CORS Headers** - 跨域支持
-
-## 📁 项目结构
-
-```
-Quant-Speed_ai_hardware/
-├── frontend/                 # React前端应用
-│   ├── src/
-│   │   ├── components/        # React组件
-│   │   │   └── HardwareShop.jsx
-│   │   ├── App.jsx           # 主应用组件
-│   │   ├── api.js            # API接口封装
-│   │   └── main.jsx          # 应用入口
-│   ├── package.json          # 前端依赖配置
-│   └── vite.config.js        # Vite配置
-├── backend/                   # Django后端应用
-│   ├── config/               # Django配置
-│   │   ├── settings.py       # 主配置文件
-│   │   ├── urls.py           # URL路由配置
-│   │   └── wsgi.py         # WSGI配置
-│   ├── shop/                 # 商城应用
-│   │   ├── models.py         # 数据模型
-│   │   ├── views.py          # 视图函数
-│   │   ├── serializers.py    # 序列化器
-│   │   └── urls.py           # 应用路由
-│   ├── manage.py             # Django管理脚本
-│   └── populate_db.py        # 数据库初始化脚本
-└── README.md
-```
-
-## 🚀 快速开始
-
-### 环境要求
-- Node.js 18+ 
-- Python 3.8+
-- PostgreSQL 12+
-
-### 前端安装
-
-```bash
-# 进入前端目录
-cd frontend
-
-# 安装依赖
-npm install
-
-# 启动开发服务器
-npm run dev
-
-# 构建生产版本
-npm run build
-```
-
-### 后端安装
-
-```bash
-# 进入后端目录
-cd backend
-
-# 创建虚拟环境
-python -m venv venv
-
-# 激活虚拟环境
-# Windows
-venv\Scripts\activate
-# macOS/Linux
-source venv/bin/activate
-
-# 安装依赖
-pip install django djangorestframework django-cors-headers psycopg2-binary
-
-# 数据库配置
-# 编辑 config/settings.py 中的数据库配置
-
-# 运行数据库迁移
-python manage.py migrate
-
-# 创建超级用户
-python manage.py createsuperuser
-
-# 启动开发服务器
-python manage.py runserver
-```
-
-### 数据库初始化
-
-```bash
-# 运行数据库填充脚本
-python populate_db.py
-```
-### admin账户:
-‘
-jeremygan2021
-qweasdzxc1
-’
-
-## 🔧 配置说明
-
-### 前端配置
-- **Vite配置**: `frontend/vite.config.js`
-- **环境变量**: 支持 `.env` 文件配置
-
-### 后端配置
-- **Django设置**: `backend/config/settings.py`
-- **数据库**: PostgreSQL配置
-- **CORS**: 跨域请求配置
-- **国际化**: 中文支持
-
-## 📡 API接口
-
-### 硬件配置接口
-- `GET /api/configs/` - 获取硬件配置列表
-- `GET /api/configs/{id}/` - 获取特定配置详情
-
-### 订单接口
-- `POST /api/orders/` - 创建订单
-- `GET /api/orders/{id}/` - 获取订单详情
-- `POST /api/orders/{id}/pay/` - 订单支付
-
-### 支付接口
-- `POST /api/payments/initiate/` - 发起支付
-- `POST /api/payments/confirm/` - 确认支付
-
-
-## 上传图片接口  不要乱传文件，造成oss存储费用增加
-### 上传硬件的3D文件（小智参数）    zip压缩包，包含3文件和材质文件
-- `POST https://tangledup-ai-staging.oss-cn-shanghai.aliyuncs.com/market_page/hardware_xiaozhi/product_3D_image` - 上传3D文件
-
-### 上传硬件的图片（小智参数）    单张图片
-- `POST https://tangledup-ai-staging.oss-cn-shanghai.aliyuncs.com/market_page/hardware_xiaozhi/product_image` - 上传图片
-
-## 🎯 使用说明
-
-### 推广码功能
-系统支持URL推广码参数，格式：`?ref=推广码`
-
-### 支付流程
-1. 选择硬件配置
-2. 填写订单信息
-3. 发起支付请求
-4. 确认支付结果
-5. 订单完成
-
-## 🔒 安全说明
-
-- 生产环境请修改 `SECRET_KEY`
-- 配置HTTPS证书
-- 设置适当的CORS白名单
-- 定期备份数据库
-
-## 🐛 常见问题
-
-### 跨域问题
-确保后端CORS配置正确，开发环境可设置为允许所有来源。
-
-### 数据库连接失败
-检查PostgreSQL服务状态和连接配置。
-
-### 前端构建失败
-检查Node.js版本和依赖包完整性。
-
-## 📞 联系方式
-
-如有问题或建议，请通过以下方式联系：
-- 邮箱：support@Quant-Speed-ai.com
-- 电话：400-123-4567
-
-## 📄 许可证
-
-本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件
-
-## 🙏 致谢
-
-感谢以下开源项目的支持：
-- [React](https://reactjs.org/)
-- [Django](https://www.djangoproject.com/)
-- [Ant Design](https://ant.design/)
-- [Vite](https://vitejs.dev/)
-
----
-
-**⭐ 如果这个项目对您有帮助，请给我们一个星标！**

backend/check_urls.py

@@ -0,0 +1,30 @@
+import os
+import django
+from django.urls import reverse
+from django.conf import settings
+
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'config.settings')
+django.setup()
+
+links = [
+    "admin:shop_wechatuser_changelist",
+    "admin:shop_salesperson_changelist",
+    "admin:shop_distributor_changelist",
+    "admin:shop_esp32config_changelist",
+    "admin:shop_service_changelist",
+    "admin:shop_VBcourse_changelist",
+    "admin:shop_order_changelist",
+    "admin:shop_serviceorder_changelist",
+    "admin:shop_withdrawal_changelist",
+    "admin:shop_commissionlog_changelist",
+    "admin:shop_wechatpayconfig_changelist",
+    "admin:auth_user_changelist",
+]
+
+print("Checking URL patterns...")
+for link in links:
+    try:
+        url = reverse(link)
+        print(f"[OK] {link} -> {url}")
+    except Exception as e:
+        print(f"[ERROR] {link}: {e}")

backend/community/admin.py

@@ -0,0 +1,162 @@
+from django.contrib import admin
+from django.utils.html import format_html
+from unfold.admin import ModelAdmin, TabularInline
+from unfold.decorators import display
+from .models import Activity, ActivitySignup, Topic, Reply, TopicMedia
+
+class ActivitySignupInline(TabularInline):
+    model = ActivitySignup
+    extra = 0
+    readonly_fields = ('signup_time',)
+    fields = ('user', 'status', 'signup_time')
+    autocomplete_fields = ['user']
+    can_delete = True
+    show_change_link = True
+
+class ReplyInline(TabularInline):
+    model = Reply
+    extra = 0
+    readonly_fields = ('created_at',)
+    fields = ('content', 'author', 'created_at')
+    can_delete = True
+    show_change_link = True
+
+class TopicMediaInline(TabularInline):
+    model = TopicMedia
+    extra = 0
+    fields = ('file', 'media_type', 'created_at')
+    readonly_fields = ('created_at',)
+    can_delete = True
+
+@admin.register(Activity)
+class ActivityAdmin(ModelAdmin):
+    list_display = ('title', 'banner_display', 'start_time', 'location', 'signup_count', 'is_active', 'created_at')
+    list_filter = ('is_active', 'start_time')
+    search_fields = ('title', 'location')
+    inlines = [ActivitySignupInline]
+    
+    fieldsets = (
+        ('基本信息', {
+            'fields': ('title', 'description', 'banner', 'banner_url', 'is_active')
+        }),
+        ('时间与地点', {
+            'fields': ('start_time', 'end_time', 'location'),
+            'classes': ('tab',)
+        }),
+        ('报名设置', {
+            'fields': ('max_participants',)
+        }),
+    )
+
+    @display(description="Banner")
+    def banner_display(self, obj):
+        if obj.banner:
+            return format_html('<img src="{}" height="50" style="border-radius: 4px;" />', obj.banner.url)
+        elif obj.banner_url:
+            return format_html('<img src="{}" height="50" style="border-radius: 4px;" />', obj.banner_url)
+        return "暂无"
+
+    @display(description="报名人数")
+    def signup_count(self, obj):
+        return obj.signups.count()
+
+@admin.register(ActivitySignup)
+class ActivitySignupAdmin(ModelAdmin):
+    list_display = ('activity', 'user', 'signup_time', 'status_label')
+    list_filter = ('status', 'signup_time', 'activity')
+    search_fields = ('user__nickname', 'activity__title')
+    autocomplete_fields = ['activity', 'user']
+    
+    fieldsets = (
+        ('报名详情', {
+            'fields': ('activity', 'user', 'status')
+        }),
+        ('时间信息', {
+            'fields': ('signup_time',),
+            'classes': ('collapse',)
+        }),
+    )
+    readonly_fields = ('signup_time',)
+
+    @display(
+        description="状态",
+        label={
+            "pending": "warning",
+            "confirmed": "success",
+            "cancelled": "danger",
+        }
+    )
+    def status_label(self, obj):
+        return obj.status
+
+@admin.register(Topic)
+class TopicAdmin(ModelAdmin):
+    list_display = ('title', 'author', 'get_related_item', 'reply_count', 'view_count', 'is_pinned', 'created_at')
+    list_filter = ('is_pinned', 'created_at', 'related_product', 'related_service', 'related_course')
+    search_fields = ('title', 'content', 'author__nickname')
+    autocomplete_fields = ['author', 'related_product', 'related_service', 'related_course']
+    inlines = [TopicMediaInline, ReplyInline]
+    
+    fieldsets = (
+        ('帖子内容', {
+            'fields': ('title', 'content', 'is_pinned')
+        }),
+        ('关联信息', {
+            'fields': ('author', 'related_product', 'related_service', 'related_course'),
+            'description': '可关联 硬件、服务 或 课程，用于技术求助或讨论'
+        }),
+        ('统计数据', {
+            'fields': ('view_count', 'created_at', 'updated_at'),
+            'classes': ('collapse',)
+        }),
+    )
+    readonly_fields = ('created_at', 'updated_at')
+
+    @display(description="关联项目")
+    def get_related_item(self, obj):
+        if obj.related_product:
+            return f"[硬件] {obj.related_product.name}"
+        if obj.related_service:
+            return f"[服务] {obj.related_service.title}"
+        if obj.related_course:
+            return f"[课程] {obj.related_course.title}"
+        return "-"
+
+    @display(description="回复数")
+    def reply_count(self, obj):
+        return obj.replies.count()
+
+@admin.register(Reply)
+class ReplyAdmin(ModelAdmin):
+    list_display = ('short_content', 'topic', 'author', 'created_at')
+    list_filter = ('created_at',)
+    search_fields = ('content', 'author__nickname', 'topic__title')
+    autocomplete_fields = ['author', 'topic', 'reply_to']
+    inlines = [TopicMediaInline]
+    
+    fieldsets = (
+        ('回复内容', {
+            'fields': ('topic', 'reply_to', 'content')
+        }),
+        ('发布信息', {
+            'fields': ('author', 'created_at')
+        }),
+    )
+    readonly_fields = ('created_at',)
+
+    @display(description="内容摘要")
+    def short_content(self, obj):
+        return obj.content[:30] + '...' if len(obj.content) > 30 else obj.content
+
+@admin.register(TopicMedia)
+class TopicMediaAdmin(ModelAdmin):
+    list_display = ('id', 'media_type', 'file_preview', 'topic', 'reply', 'created_at')
+    list_filter = ('media_type', 'created_at')
+    search_fields = ('file', 'topic__title')
+    autocomplete_fields = ['topic', 'reply']
+    
+    @display(description="预览")
+    def file_preview(self, obj):
+        if obj.media_type == 'image':
+            return format_html('<img src="{}" height="50" style="border-radius: 4px;" />', obj.file.url)
+        return obj.file.name

backend/community/apps.py

@@ -0,0 +1,5 @@
+from django.apps import AppConfig
+
+
+class CommunityConfig(AppConfig):
+    name = 'community'

backend/community/migrations/0001_initial.py

@@ -0,0 +1,85 @@
+# Generated by Django 6.0.1 on 2026-02-11 06:43
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('shop', '0025_vccourse_alter_courseenrollment_course_and_more'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Activity',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('title', models.CharField(max_length=100, verbose_name='活动标题')),
+                ('description', models.TextField(verbose_name='活动详情')),
+                ('banner', models.ImageField(upload_to='activities/banners/', verbose_name='活动Banner图')),
+                ('start_time', models.DateTimeField(verbose_name='开始时间')),
+                ('end_time', models.DateTimeField(verbose_name='结束时间')),
+                ('location', models.CharField(max_length=100, verbose_name='活动地点')),
+                ('max_participants', models.IntegerField(default=50, 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='Topic',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('title', models.CharField(max_length=200, verbose_name='标题')),
+                ('content', models.TextField(verbose_name='内容')),
+                ('view_count', models.IntegerField(default=0, verbose_name='浏览量')),
+                ('is_pinned', 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='更新时间')),
+                ('author', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='topics', to='shop.wechatuser', verbose_name='作者')),
+                ('related_product', models.ForeignKey(blank=True, help_text='如果是技术求助，请选择关联的硬件', null=True, on_delete=django.db.models.deletion.SET_NULL, to='shop.esp32config', verbose_name='关联硬件')),
+            ],
+            options={
+                'verbose_name': '论坛帖子',
+                'verbose_name_plural': '论坛帖子管理',
+                'ordering': ['-is_pinned', '-created_at'],
+            },
+        ),
+        migrations.CreateModel(
+            name='Reply',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('content', models.TextField(verbose_name='回复内容')),
+                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='回复时间')),
+                ('author', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='replies', to='shop.wechatuser', verbose_name='回复者')),
+                ('reply_to', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='children', to='community.reply', verbose_name='回复楼层')),
+                ('topic', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='replies', to='community.topic', verbose_name='所属帖子')),
+            ],
+            options={
+                'verbose_name': '帖子回复',
+                'verbose_name_plural': '帖子回复管理',
+                'ordering': ['created_at'],
+            },
+        ),
+        migrations.CreateModel(
+            name='ActivitySignup',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('signup_time', models.DateTimeField(auto_now_add=True, verbose_name='报名时间')),
+                ('status', models.CharField(choices=[('pending', '审核中'), ('confirmed', '报名成功'), ('cancelled', '已取消')], default='confirmed', max_length=20, verbose_name='状态')),
+                ('activity', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='signups', to='community.activity', verbose_name='活动')),
+                ('user', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='activity_signups', to='shop.wechatuser', verbose_name='报名用户')),
+            ],
+            options={
+                'verbose_name': '活动报名',
+                'verbose_name_plural': '活动报名管理',
+                'unique_together': {('activity', 'user')},
+            },
+        ),
+    ]

backend/community/migrations/0002_topic_related_course_topic_related_service_and_more.py

@@ -0,0 +1,30 @@
+# Generated by Django 6.0.1 on 2026-02-11 06:48
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('community', '0001_initial'),
+        ('shop', '0025_vccourse_alter_courseenrollment_course_and_more'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='topic',
+            name='related_course',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, to='shop.vccourse', verbose_name='关联课程'),
+        ),
+        migrations.AddField(
+            model_name='topic',
+            name='related_service',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, to='shop.service', verbose_name='关联服务'),
+        ),
+        migrations.AlterField(
+            model_name='topic',
+            name='related_product',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, to='shop.esp32config', verbose_name='关联硬件'),
+        ),
+    ]

backend/community/migrations/0003_alter_reply_content_alter_topic_content_topicmedia.py

@@ -0,0 +1,39 @@
+# Generated by Django 6.0.1 on 2026-02-11 06:57
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('community', '0002_topic_related_course_topic_related_service_and_more'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='reply',
+            name='content',
+            field=models.TextField(help_text='支持Markdown格式', verbose_name='回复内容'),
+        ),
+        migrations.AlterField(
+            model_name='topic',
+            name='content',
+            field=models.TextField(help_text='支持Markdown格式，支持插入图片', verbose_name='内容'),
+        ),
+        migrations.CreateModel(
+            name='TopicMedia',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('file', models.FileField(upload_to='community/media/', verbose_name='文件')),
+                ('media_type', models.CharField(choices=[('image', '图片'), ('video', '视频'), ('file', '文件')], default='image', max_length=10, verbose_name='媒体类型')),
+                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='上传时间')),
+                ('reply', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='media', to='community.reply', verbose_name='所属回复')),
+                ('topic', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='media', to='community.topic', verbose_name='所属帖子')),
+            ],
+            options={
+                'verbose_name': '论坛媒体资源',
+                'verbose_name_plural': '论坛媒体资源管理',
+            },
+        ),
+    ]

backend/community/migrations/0004_activity_banner_url_alter_activity_banner.py

@@ -0,0 +1,23 @@
+# Generated by Django 6.0.1 on 2026-02-11 07:00
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('community', '0003_alter_reply_content_alter_topic_content_topicmedia'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='activity',
+            name='banner_url',
+            field=models.URLField(blank=True, help_text='可直接填写图片链接，若同时上传图片，将优先显示上传的图片', null=True, verbose_name='活动Banner链接'),
+        ),
+        migrations.AlterField(
+            model_name='activity',
+            name='banner',
+            field=models.ImageField(blank=True, null=True, upload_to='activities/banners/', verbose_name='活动Banner图'),
+        ),
+    ]

backend/community/models.py

@@ -0,0 +1,174 @@
+from django.db import models
+from shop.models import WeChatUser, ESP32Config, Order, Service, VCCourse, ServiceOrder
+
+class Activity(models.Model):
+    """
+    社区活动模型
+    """
+    title = models.CharField(max_length=100, verbose_name="活动标题")
+    description = models.TextField(verbose_name="活动详情")
+    banner = models.ImageField(upload_to='activities/banners/', verbose_name="活动Banner图", null=True, blank=True)
+    banner_url = models.URLField(verbose_name="活动Banner链接", null=True, blank=True, help_text="可直接填写图片链接，若同时上传图片，将优先显示上传的图片")
+    start_time = models.DateTimeField(verbose_name="开始时间")
+    end_time = models.DateTimeField(verbose_name="结束时间")
+    location = models.CharField(max_length=100, verbose_name="活动地点")
+    max_participants = models.IntegerField(default=50, verbose_name="最大报名人数")
+    is_active = models.BooleanField(default=True, verbose_name="是否启用")
+    created_at = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")
+
+    def clean(self):
+        from django.core.exceptions import ValidationError
+        if not self.banner and not self.banner_url:
+            raise ValidationError("Banner图片和Banner链接必须至少填写一项")
+
+    def save(self, *args, **kwargs):
+        self.clean()
+        super().save(*args, **kwargs)
+
+    @property
+    def display_banner_url(self):
+        """
+        获取Banner显示的URL，优先使用上传的图片
+        """
+        if self.banner:
+            return self.banner.url
+        return self.banner_url
+
+    def __str__(self):
+        return self.title
+
+    class Meta:
+        verbose_name = "社区活动"
+        verbose_name_plural = "社区活动管理"
+
+
+class ActivitySignup(models.Model):
+    """
+    活动报名记录
+    """
+    STATUS_CHOICES = (
+        ('pending', '审核中'),
+        ('confirmed', '报名成功'),
+        ('cancelled', '已取消'),
+    )
+
+    activity = models.ForeignKey(Activity, on_delete=models.CASCADE, related_name='signups', verbose_name="活动")
+    user = models.ForeignKey(WeChatUser, on_delete=models.CASCADE, related_name='activity_signups', verbose_name="报名用户")
+    signup_time = models.DateTimeField(auto_now_add=True, verbose_name="报名时间")
+    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='confirmed', verbose_name="状态")
+
+    def __str__(self):
+        return f"{self.user.nickname} - {self.activity.title}"
+
+    class Meta:
+        verbose_name = "活动报名"
+        verbose_name_plural = "活动报名管理"
+        unique_together = ('activity', 'user')
+
+
+class Topic(models.Model):
+    """
+    论坛帖子/主题
+    """
+    title = models.CharField(max_length=200, verbose_name="标题")
+    content = models.TextField(verbose_name="内容", help_text="支持Markdown格式，支持插入图片")
+    author = models.ForeignKey(WeChatUser, on_delete=models.CASCADE, related_name='topics', verbose_name="作者")
+    
+    # 关联对象：硬件、服务、课程
+    related_product = models.ForeignKey(ESP32Config, on_delete=models.SET_NULL, null=True, blank=True, verbose_name="关联硬件")
+    related_service = models.ForeignKey(Service, on_delete=models.SET_NULL, null=True, blank=True, verbose_name="关联服务")
+    related_course = models.ForeignKey(VCCourse, on_delete=models.SET_NULL, null=True, blank=True, verbose_name="关联课程")
+    
+    view_count = models.IntegerField(default=0, verbose_name="浏览量")
+    is_pinned = 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="更新时间")
+
+    def __str__(self):
+        return self.title
+
+    @property
+    def is_verified_owner(self):
+        """
+        判断作者是否为关联项目（硬件/服务/课程）的已购用户（Verified Owner）
+        """
+        # 1. 验证硬件
+        if self.related_product:
+            if Order.objects.filter(
+                wechat_user=self.author,
+                config=self.related_product,
+                status__in=['paid', 'shipped']
+            ).exists():
+                return True
+        
+        # 2. 验证课程
+        if self.related_course:
+            if Order.objects.filter(
+                wechat_user=self.author,
+                course=self.related_course,
+                status__in=['paid', 'shipped']
+            ).exists():
+                return True
+        
+        # 3. 验证服务
+        if self.related_service:
+            # ServiceOrder 模型中没有 direct link to WeChatUser (only phone/name), 
+            # 但我们假设通过手机号或未来关联来验证，目前先检查 ServiceOrder 是否有对应记录。
+            # 由于 ServiceOrder 目前设计没有直接关联 WeChatUser 字段，我们暂时尝试通过名字或后续改进。
+            # 经检查 shop/models.py, ServiceOrder 确实只有 customer_name/phone_number. 
+            # 这里为了严谨，我们暂时仅对有关联的进行检查，或者需要改进 ServiceOrder。
+            # 鉴于当前任务范围，如果 ServiceOrder 没有 user 字段，我们可能无法精确验证，
+            # 除非我们假设用户填写的手机号与微信用户关联。
+            # *修正*: 为了快速实现，我们先跳过 ServiceOrder 的精确验证，或者仅仅返回 False，
+            # 等待后续 ServiceOrder 添加 wechat_user 字段。
+            pass
+            
+        return False
+
+    class Meta:
+        verbose_name = "论坛帖子"
+        verbose_name_plural = "论坛帖子管理"
+        ordering = ['-is_pinned', '-created_at']
+
+
+class Reply(models.Model):
+    """
+    帖子回复
+    """
+    topic = models.ForeignKey(Topic, on_delete=models.CASCADE, related_name='replies', verbose_name="所属帖子")
+    content = models.TextField(verbose_name="回复内容", help_text="支持Markdown格式")
+    author = models.ForeignKey(WeChatUser, on_delete=models.CASCADE, related_name='replies', verbose_name="回复者")
+    reply_to = models.ForeignKey('self', on_delete=models.SET_NULL, null=True, blank=True, related_name='children', verbose_name="回复楼层")
+    created_at = models.DateTimeField(auto_now_add=True, verbose_name="回复时间")
+
+    def __str__(self):
+        return f"回复: {self.topic.title}"
+
+    class Meta:
+        verbose_name = "帖子回复"
+        verbose_name_plural = "帖子回复管理"
+        ordering = ['created_at']
+
+
+class TopicMedia(models.Model):
+    """
+    论坛多媒体资源（图片/视频/文件）
+    """
+    MEDIA_TYPE_CHOICES = (
+        ('image', '图片'),
+        ('video', '视频'),
+        ('file', '文件'),
+    )
+
+    topic = models.ForeignKey(Topic, on_delete=models.CASCADE, related_name='media', verbose_name="所属帖子", null=True, blank=True)
+    reply = models.ForeignKey(Reply, on_delete=models.CASCADE, related_name='media', verbose_name="所属回复", null=True, blank=True)
+    file = models.FileField(upload_to='community/media/', verbose_name="文件")
+    media_type = models.CharField(max_length=10, choices=MEDIA_TYPE_CHOICES, default='image', verbose_name="媒体类型")
+    created_at = models.DateTimeField(auto_now_add=True, verbose_name="上传时间")
+
+    def __str__(self):
+        return f"{self.media_type} - {self.file.name}"
+
+    class Meta:
+        verbose_name = "论坛媒体资源"
+        verbose_name_plural = "论坛媒体资源管理"

backend/community/serializers.py

@@ -0,0 +1,51 @@
+from rest_framework import serializers
+from .models import Activity, ActivitySignup, Topic, Reply, TopicMedia
+from shop.serializers import WeChatUserSerializer, ESP32ConfigSerializer, ServiceSerializer, VCCourseSerializer
+
+class ActivitySerializer(serializers.ModelSerializer):
+    display_banner_url = serializers.ReadOnlyField()
+    
+    class Meta:
+        model = Activity
+        fields = '__all__'
+
+class ActivitySignupSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = ActivitySignup
+        fields = ['id', 'activity', 'user', 'signup_time', 'status']
+        read_only_fields = ['signup_time', 'status']
+
+class TopicMediaSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = TopicMedia
+        fields = ['id', 'file', 'media_type', 'created_at']
+
+class ReplySerializer(serializers.ModelSerializer):
+    author_info = WeChatUserSerializer(source='author', read_only=True)
+    media = TopicMediaSerializer(many=True, read_only=True)
+
+    class Meta:
+        model = Reply
+        fields = ['id', 'topic', 'content', 'author', 'author_info', 'reply_to', 'media', 'created_at']
+
+class TopicSerializer(serializers.ModelSerializer):
+    author_info = WeChatUserSerializer(source='author', read_only=True)
+    replies = ReplySerializer(many=True, read_only=True)
+    media = TopicMediaSerializer(many=True, read_only=True)
+    is_verified_owner = serializers.BooleanField(read_only=True)
+    
+    product_info = ESP32ConfigSerializer(source='related_product', read_only=True)
+    service_info = ServiceSerializer(source='related_service', read_only=True)
+    course_info = VCCourseSerializer(source='related_course', read_only=True)
+
+    class Meta:
+        model = Topic
+        fields = [
+            'id', 'title', 'content', 'author', 'author_info', 
+            'related_product', 'product_info', 
+            'related_service', 'service_info',
+            'related_course', 'course_info',
+            'view_count', 'is_pinned', 'created_at', 'updated_at', 
+            'is_verified_owner', 'replies', 'media'
+        ]
+        read_only_fields = ['view_count', 'created_at', 'updated_at', 'is_verified_owner']

backend/community/tests.py

@@ -0,0 +1,3 @@
+from django.test import TestCase
+
+# Create your tests here.

backend/community/urls.py

@@ -0,0 +1,13 @@
+from django.urls import path, include
+from rest_framework.routers import DefaultRouter
+from .views import ActivityViewSet, TopicViewSet, ReplyViewSet, TopicMediaViewSet
+
+router = DefaultRouter()
+router.register(r'activities', ActivityViewSet)
+router.register(r'topics', TopicViewSet)
+router.register(r'replies', ReplyViewSet)
+router.register(r'media', TopicMediaViewSet)
+
+urlpatterns = [
+    path('', include(router.urls)),
+]

backend/community/views.py

@@ -0,0 +1,118 @@
+from rest_framework import viewsets, status, mixins, parsers
+from rest_framework.decorators import action
+from rest_framework.response import Response
+from rest_framework import serializers
+from django.core.signing import TimestampSigner, BadSignature, SignatureExpired
+from drf_spectacular.utils import extend_schema
+
+from shop.models import WeChatUser
+from .models import Activity, ActivitySignup, Topic, Reply, TopicMedia
+from .serializers import ActivitySerializer, ActivitySignupSerializer, TopicSerializer, ReplySerializer, TopicMediaSerializer
+
+def get_current_wechat_user(request):
+    """
+    根据 Authorization 头获取当前微信用户 (复用 shop app 的逻辑)
+    """
+    auth_header = request.headers.get('Authorization')
+    if not auth_header or not auth_header.startswith('Bearer '):
+        return None
+    token = auth_header.split(' ')[1]
+    signer = TimestampSigner()
+    try:
+        # 签名包含 openid
+        openid = signer.unsign(token, max_age=86400 * 30) # 30天有效
+        return WeChatUser.objects.filter(openid=openid).first()
+    except (BadSignature, SignatureExpired):
+        return None
+
+class ActivityViewSet(viewsets.ReadOnlyModelViewSet):
+    """
+    社区活动接口
+    """
+    queryset = Activity.objects.filter(is_active=True).order_by('-created_at')
+    serializer_class = ActivitySerializer
+
+    @extend_schema(summary="报名活动")
+    @action(detail=True, methods=['post'])
+    def signup(self, request, pk=None):
+        user = get_current_wechat_user(request)
+        if not user:
+            return Response({'error': '请先登录'}, status=401)
+        
+        activity = self.get_object()
+        
+        # Check if already signed up
+        if ActivitySignup.objects.filter(activity=activity, user=user).exists():
+            return Response({'error': '您已报名该活动'}, status=400)
+        
+        if activity.signups.count() >= activity.max_participants:
+             return Response({'error': '活动名额已满'}, status=400)
+            
+        signup = ActivitySignup.objects.create(activity=activity, user=user)
+        serializer = ActivitySignupSerializer(signup)
+        return Response(serializer.data, status=201)
+
+    @extend_schema(summary="我的报名记录")
+    @action(detail=False, methods=['get'])
+    def my_signups(self, request):
+        user = get_current_wechat_user(request)
+        if not user:
+            return Response({'error': '请先登录'}, status=401)
+        signups = ActivitySignup.objects.filter(user=user).order_by('-signup_time')
+        serializer = ActivitySignupSerializer(signups, many=True)
+        return Response(serializer.data)
+
+class TopicViewSet(viewsets.ModelViewSet):
+    """
+    技术论坛帖子接口
+    """
+    queryset = Topic.objects.all()
+    serializer_class = TopicSerializer
+
+    def perform_create(self, serializer):
+        user = get_current_wechat_user(self.request)
+        # Auth check is done in create or permission, but here we need user for save
+        if user:
+            serializer.save(author=user)
+    
+    def create(self, request, *args, **kwargs):
+        user = get_current_wechat_user(request)
+        if not user:
+            return Response({'error': '请先登录'}, status=401)
+        return super().create(request, *args, **kwargs)
+
+class ReplyViewSet(viewsets.ModelViewSet):
+    """
+    帖子回复接口
+    """
+    queryset = Reply.objects.all()
+    serializer_class = ReplySerializer
+
+    def perform_create(self, serializer):
+        user = get_current_wechat_user(self.request)
+        if user:
+            serializer.save(author=user)
+
+    def create(self, request, *args, **kwargs):
+        user = get_current_wechat_user(request)
+        if not user:
+            return Response({'error': '请先登录'}, status=401)
+        return super().create(request, *args, **kwargs)
+
+class TopicMediaViewSet(viewsets.GenericViewSet, mixins.CreateModelMixin):
+    """
+    论坛多媒体资源上传接口
+    """
+    queryset = TopicMedia.objects.all()
+    serializer_class = TopicMediaSerializer
+    parser_classes = [parsers.MultiPartParser, parsers.FormParser]
+
+    @extend_schema(summary="上传媒体文件 (返回URL用于Markdown)")
+    def create(self, request, *args, **kwargs):
+        user = get_current_wechat_user(request)
+        if not user:
+            return Response({'error': '请先登录'}, status=401)
+            
+        # 允许上传时不关联 Topic (发帖前上传)，或后续关联
+        # 主要是返回 url
+        return super().create(request, *args, **kwargs)

backend/config/settings.py

@@ -44,6 +44,7 @@ INSTALLED_APPS = [
     'drf_spectacular',  # Swagger文档生成
     'drf_spectacular_sidecar',
     'shop',
+    'community',
 ]
 
 MIDDLEWARE = [
@@ -170,26 +171,144 @@ SPECTACULAR_SETTINGS = {
     'REDOC_DIST': 'SIDECAR',
 }
 
+from django.urls import reverse_lazy
+
 # django-unfold配置
 UNFOLD = {
-    "SITE_TITLE": "科技公司产品管理",
-    "SITE_HEADER": "科技公司产品购买系统",
+    "SITE_TITLE": "量迹AI后台",
+    "SITE_HEADER": "量迹AI科技硬件/服务商场后台",
     "SITE_URL": "/",
     "COLORS": {
         "primary": {
-            "50": "rgb(240 249 255)",
-            "100": "rgb(224 242 254)",
-            "200": "rgb(186 230 253)",
-            "300": "rgb(125 211 252)",
-            "400": "rgb(56 189 248)",
-            "500": "rgb(14 165 233)",
-            "600": "rgb(2 132 199)",
-            "700": "rgb(3 105 161)",
-            "800": "rgb(7 89 133)",
-            "900": "rgb(12 74 110)",
-            "950": "rgb(8 47 73)",
+            "50": "rgb(236 254 255)",
+            "100": "rgb(207 250 254)",
+            "200": "rgb(165 243 252)",
+            "300": "rgb(103 232 249)",
+            "400": "rgb(34 211 238)",
+            "500": "rgb(6 182 212)",
+            "600": "rgb(8 145 178)",
+            "700": "rgb(14 116 144)",
+            "800": "rgb(21 94 117)",
+            "900": "rgb(22 78 99)",
+            "950": "rgb(8 51 68)",
         },
     },
+    "SIDEBAR": {
+        "show_search": True,
+        "show_all_applications": False,
+        "navigation": [
+            {
+                "title": "用户管理",
+                "separator": True,
+                "items": [
+                    {
+                        "title": "微信用户",
+                        "icon": "people",
+                        "link": reverse_lazy("admin:shop_wechatuser_changelist"),
+                    },
+                    {
+                        "title": "分销员管理",
+                        "icon": "supervisor_account",
+                        "link": reverse_lazy("admin:shop_salesperson_changelist"),
+                    },
+                    {
+                        "title": "小程序分销员",
+                        "icon": "groups",
+                        "link": reverse_lazy("admin:shop_distributor_changelist"),
+                    },
+                ],
+            },
+            {
+                "title": "商品管理",
+                "separator": True,
+                "items": [
+                    {
+                        "title": "硬件配置 (小智参数)",
+                        "icon": "hardware",
+                        "link": reverse_lazy("admin:shop_esp32config_changelist"),
+                    },
+                    {
+                        "title": "AI服务",
+                        "icon": "smart_toy",
+                        "link": reverse_lazy("admin:shop_service_changelist"),
+                    },
+                    {
+                        "title": "VC课程",
+                        "icon": "school",
+                        "link": reverse_lazy("admin:shop_vccourse_changelist"),
+                    },
+                ],
+            },
+            {
+                "title": "交易管理",
+                "separator": True,
+                "items": [
+                    {
+                        "title": "订单列表",
+                        "icon": "shopping_cart",
+                        "link": reverse_lazy("admin:shop_order_changelist"),
+                    },
+                    {
+                        "title": "服务订单",
+                        "icon": "assignment",
+                        "link": reverse_lazy("admin:shop_serviceorder_changelist"),
+                    },
+                    {
+                        "title": "提现管理",
+                        "icon": "account_balance_wallet",
+                        "link": reverse_lazy("admin:shop_withdrawal_changelist"),
+                    },
+                    {
+                        "title": "佣金记录",
+                        "icon": "monetization_on",
+                        "link": reverse_lazy("admin:shop_commissionlog_changelist"),
+                    },
+                ],
+            },
+            {
+                "title": "社区与论坛",
+                "separator": True,
+                "items": [
+                    {
+                        "title": "活动管理",
+                        "icon": "event",
+                        "link": reverse_lazy("admin:community_activity_changelist"),
+                    },
+                    {
+                        "title": "活动报名",
+                        "icon": "how_to_reg",
+                        "link": reverse_lazy("admin:community_activitysignup_changelist"),
+                    },
+                    {
+                        "title": "技术论坛帖子",
+                        "icon": "forum",
+                        "link": reverse_lazy("admin:community_topic_changelist"),
+                    },
+                    {
+                        "title": "帖子回复",
+                        "icon": "chat_bubble",
+                        "link": reverse_lazy("admin:community_reply_changelist"),
+                    },
+                ],
+            },
+            {
+                "title": "系统配置",
+                "separator": True,
+                "items": [
+                    {
+                        "title": "微信支付配置",
+                        "icon": "payment",
+                        "link": reverse_lazy("admin:shop_wechatpayconfig_changelist"),
+                    },
+                    {
+                        "title": "用户认证",
+                        "icon": "security",
+                        "link": reverse_lazy("admin:auth_user_changelist"),
+                    },
+                ],
+            },
+        ],
+    },
 }
 
 # 重新启用自动补齐斜杠，方便 Admin 使用

backend/config/urls.py

@@ -7,6 +7,7 @@ from drf_spectacular.views import SpectacularAPIView, SpectacularSwaggerView, Sp
 urlpatterns = [
     path('admin/', admin.site.urls),
     path('api/', include('shop.urls')),
+    path('api/community/', include('community.urls')),
     
     # Swagger文档路由
     path('api/schema/', SpectacularAPIView.as_view(), name='schema'),

backend/requirements.txt

@@ -19,3 +19,4 @@ uritemplate==4.2.0
 wechatpayv3==2.0.1
 drf-spectacular-sidecar==2026.1.1
 gunicorn==21.2.0
+requests

backend/shop/admin.py

@@ -4,13 +4,13 @@ from django.db.models import Sum
 from django import forms
 from unfold.admin import ModelAdmin, TabularInline
 from unfold.decorators import display
-from .models import ESP32Config, Order, Salesperson, WeChatPayConfig, Service, ARService, ProductFeature
+from .models import ESP32Config, Order, Salesperson, WeChatPayConfig, Service, VCCourse, ProductFeature, CommissionLog, WeChatUser, Distributor, Withdrawal, ServiceOrder, CourseEnrollment
 import qrcode
 from io import BytesIO
 import base64
 
 # 自定义后台标题
-admin.site.site_header = "量迹AI硬件销售管理后台"
+admin.site.site_header = "量迹AI科技硬件/服务商场后台"
 admin.site.site_title = "量迹AI后台"
 admin.site.index_title = "欢迎使用量迹AI管理系统"
 
@@ -19,11 +19,11 @@ class ExternalUploadWidget(forms.URLInput):
         super().__init__(*args, **kwargs)
         self.upload_url = upload_url
         self.attrs.update({
-            'class': 'upload-url-input',
+            'class': 'upload-url-input vTextField',
             'data-upload-url': upload_url,
             'data-accept': accept,
-            'readonly': 'readonly',
-            'placeholder': '上传文件后自动生成URL'
+            'placeholder': '上传文件后自动生成URL',
+            'style': 'width: 100%;'
         })
 
     class Media:
@@ -77,13 +77,13 @@ class WeChatPayConfigAdmin(ModelAdmin):
 @admin.register(ESP32Config)
 class ESP32ConfigAdmin(ModelAdmin):
     form = ESP32ConfigAdminForm
-    list_display = ('name', 'chip_type', 'price', 'has_camera', 'has_microphone')
+    list_display = ('name', 'chip_type', 'price', 'stock', 'has_camera', 'has_microphone')
     list_filter = ('chip_type', 'has_camera')
     search_fields = ('name', 'description')
     inlines = [ProductFeatureInline]
     fieldsets = (
         ('基本信息', {
-            'fields': ('name', 'price', 'description')
+            'fields': ('name', 'price', 'stock', 'commission_rate', 'description')
         }),
         ('硬件参数', {
             'fields': ('chip_type', 'flash_size', 'ram_size', 'has_camera', 'has_microphone')
@@ -122,18 +122,67 @@ class ServiceAdmin(ModelAdmin):
         }),
     )
 
-@admin.register(ARService)
-class ARServiceAdmin(ModelAdmin):
-    list_display = ('title', 'created_at')
-    search_fields = ('title', 'description')
+@admin.register(ServiceOrder)
+class ServiceOrderAdmin(ModelAdmin):
+    list_display = ('id', 'customer_name', 'service', 'total_price', 'status', 'salesperson', 'created_at')
+    list_filter = ('status', 'service', 'salesperson', 'created_at')
+    search_fields = ('id', 'customer_name', 'phone_number', 'email')
+    readonly_fields = ('total_price', 'created_at', 'updated_at')
+    
+    fieldsets = (
+        ('订单信息', {
+            'fields': ('service', 'status', 'total_price', 'created_at')
+        }),
+        ('客户信息', {
+            'fields': ('customer_name', 'company_name', 'phone_number', 'email', 'requirements')
+        }),
+        ('销售归属', {
+            'fields': ('salesperson',)
+        }),
+    )
+
+@admin.register(VCCourse)
+class VCCourseAdmin(ModelAdmin):
+    list_display = ('title', 'course_type', 'price', 'tag', 'instructor', 'lesson_count', 'duration', 'created_at')
+    search_fields = ('title', 'description', 'instructor', 'tag')
+    list_filter = ('course_type', 'instructor', 'tag')
     fieldsets = (
         ('基本信息', {
-            'fields': ('title', 'description')
+            'fields': ('title', 'description', 'course_type', 'tag', 'price')
         }),
-        ('封面/长图', {
+        ('讲师信息', {
+            'fields': ('instructor', 'instructor_title', 'instructor_desc', 'instructor_avatar', 'instructor_avatar_url'),
+            'description': '讲师头像上传和URL二选一，优先使用URL'
+        }),
+        ('课程详情', {
+            'fields': ('duration', 'lesson_count', 'content')
+        }),
+        ('封面', {
             'fields': ('cover_image', 'cover_image_url'),
             'description': '图片上传和URL二选一，优先使用URL'
         }),
+        ('详情页长图', {
+            'fields': ('detail_image', 'detail_image_url'),
+            'description': '图片上传和URL二选一，优先使用URL'
+        }),
+    )
+
+@admin.register(CourseEnrollment)
+class CourseEnrollmentAdmin(ModelAdmin):
+    list_display = ('customer_name', 'course', 'phone_number', 'status', 'created_at')
+    list_filter = ('status', 'course', 'created_at')
+    search_fields = ('customer_name', 'phone_number', 'wechat_id')
+    
+    fieldsets = (
+        ('报名信息', {
+            'fields': ('course', 'status', 'created_at')
+        }),
+        ('客户资料', {
+            'fields': ('customer_name', 'phone_number', 'wechat_id', 'email', 'message')
+        }),
+        ('销售归属', {
+            'fields': ('salesperson', 'distributor')
+        }),
     )
 
 @admin.register(Salesperson)
@@ -160,8 +209,8 @@ class SalespersonAdmin(ModelAdmin):
     total_sales_display.short_description = "累计销售额 (已支付)"
 
     def promotion_url(self, obj):
-        # 假设前端部署在 localhost:15173，生产环境需配置
-        base_url = "http://localhost:15173" 
+        # 生产环境配置
+        base_url = "https://market.quant-speed.com" 
         return f"{base_url}/?ref={obj.code}"
 
     @display(description="推广链接")
@@ -205,26 +254,138 @@ class SalespersonAdmin(ModelAdmin):
         ('业绩统计', {
             'fields': ('total_sales_display',)
         }),
+        ('分销设置', {
+            'fields': ('parent', 'commission_rate', 'second_level_rate'),
+            'description': '设置上级分销员及各级分润比例'
+        }),
+    )
+
+@admin.register(CommissionLog)
+class CommissionLogAdmin(ModelAdmin):
+    list_display = ('id', 'salesperson', 'distributor', 'amount', 'level', 'status', 'created_at')
+    list_filter = ('status', 'level', 'salesperson', 'distributor', 'created_at')
+    search_fields = ('salesperson__name', 'distributor__user__nickname', 'order__id')
+    readonly_fields = ('amount', 'level', 'created_at')
+    
+    fieldsets = (
+        ('基本信息', {
+            'fields': ('salesperson', 'distributor', 'order', 'amount', 'level')
+        }),
+        ('状态管理', {
+            'fields': ('status', 'created_at')
+        }),
     )
 
 @admin.register(Order)
 class OrderAdmin(ModelAdmin):
-    list_display = ('id', 'customer_name', 'config', 'total_price', 'status', 'salesperson', 'created_at')
-    list_filter = ('status', 'salesperson', 'created_at')
+    list_display = ('id', 'customer_name', 'get_item_name', 'total_price', 'status', 'salesperson', 'distributor', 'created_at')
+    list_filter = ('status', 'salesperson', 'distributor', 'created_at')
     search_fields = ('id', 'customer_name', 'phone_number', 'wechat_trade_no')
     readonly_fields = ('total_price', 'created_at', 'wechat_trade_no')
     
+    def get_item_name(self, obj):
+        if obj.config:
+            return f"[硬件] {obj.config.name}"
+        if obj.course:
+            return f"[课程] {obj.course.title}"
+        return "未知商品"
+    get_item_name.short_description = "购买商品"
+
     fieldsets = (
         ('订单信息', {
-            'fields': ('config', 'quantity', 'total_price', 'status', 'created_at')
+            'fields': ('config', 'course', 'quantity', 'total_price', 'status', 'created_at')
         }),
         ('客户信息', {
-            'fields': ('customer_name', 'phone_number', 'shipping_address')
+            'fields': ('customer_name', 'phone_number', 'shipping_address', 'wechat_user')
+        }),
+        ('物流信息', {
+            'fields': ('courier_name', 'tracking_number')
         }),
         ('销售归属', {
-            'fields': ('salesperson',)
+            'fields': ('salesperson', 'distributor')
         }),
         ('支付信息', {
             'fields': ('wechat_trade_no',)
         }),
     )
+
+@admin.register(WeChatUser)
+class WeChatUserAdmin(ModelAdmin):
+    list_display = ('nickname', 'avatar_display', 'gender_display', 'province', 'city', 'created_at')
+    search_fields = ('nickname', 'openid')
+    list_filter = ('gender', 'province', 'city', 'created_at')
+    readonly_fields = ('openid', 'unionid', 'session_key', 'created_at', 'updated_at')
+
+    def avatar_display(self, obj):
+        if obj.avatar_url:
+            return format_html('<img src="{}" width="50" height="50" style="border-radius: 50%;" />', obj.avatar_url)
+        return "暂无"
+    avatar_display.short_description = "头像"
+
+    def gender_display(self, obj):
+        choices = {0: '未知', 1: '男', 2: '女'}
+        return choices.get(obj.gender, '未知')
+    gender_display.short_description = "性别"
+
+    fieldsets = (
+        ('基本信息', {
+            'fields': ('user', 'nickname', 'avatar_url', 'gender')
+        }),
+        ('位置信息', {
+            'fields': ('country', 'province', 'city')
+        }),
+        ('认证信息', {
+            'fields': ('openid', 'unionid', 'session_key'),
+            'classes': ('collapse',)
+        }),
+        ('时间信息', {
+            'fields': ('created_at', 'updated_at')
+        }),
+    )
+
+@admin.register(Distributor)
+class DistributorAdmin(ModelAdmin):
+    list_display = ('get_nickname', 'level', 'status', 'total_earnings', 'withdrawable_balance', 'invite_code', 'created_at')
+    search_fields = ('user__nickname', 'invite_code')
+    list_filter = ('status', 'level', 'created_at')
+    readonly_fields = ('total_earnings', 'withdrawable_balance', 'qr_code_url', 'created_at', 'updated_at')
+    autocomplete_fields = ['user', 'parent']
+
+    def get_nickname(self, obj):
+        return obj.user.nickname
+    get_nickname.short_description = "微信昵称"
+    get_nickname.admin_order_field = 'user__nickname'
+
+    fieldsets = (
+        ('分销员信息', {
+            'fields': ('user', 'parent', 'level', 'status')
+        }),
+        ('收益概览', {
+            'fields': ('commission_rate', 'total_earnings', 'withdrawable_balance')
+        }),
+        ('推广信息', {
+            'fields': ('invite_code', 'qr_code_url')
+        }),
+        ('时间信息', {
+            'fields': ('created_at', 'updated_at')
+        }),
+    )
+
+@admin.register(Withdrawal)
+class WithdrawalAdmin(ModelAdmin):
+    list_display = ('get_distributor', 'amount', 'status', 'created_at')
+    list_filter = ('status', 'created_at')
+    search_fields = ('distributor__user__nickname',)
+    
+    def get_distributor(self, obj):
+        return obj.distributor.user.nickname
+    get_distributor.short_description = "分销员"
+
+    fieldsets = (
+        ('提现详情', {
+            'fields': ('distributor', 'amount', 'status', 'remark')
+        }),
+        ('时间信息', {
+            'fields': ('created_at', 'updated_at')
+        }),
+    )

backend/shop/migrations/0014_esp32config_stock_order_courier_name_and_more.py

@@ -0,0 +1,28 @@
+# Generated by Django 6.0.1 on 2026-02-10 15:16
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('shop', '0013_order_out_trade_no'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='esp32config',
+            name='stock',
+            field=models.IntegerField(default=0, verbose_name='库存数量'),
+        ),
+        migrations.AddField(
+            model_name='order',
+            name='courier_name',
+            field=models.CharField(blank=True, max_length=50, null=True, verbose_name='快递公司'),
+        ),
+        migrations.AddField(
+            model_name='order',
+            name='tracking_number',
+            field=models.CharField(blank=True, max_length=100, null=True, verbose_name='快递单号'),
+        ),
+    ]

backend/shop/migrations/0015_esp32config_commission_rate_and_more.py

@@ -0,0 +1,50 @@
+# Generated by Django 6.0.1 on 2026-02-10 15:48
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('shop', '0014_esp32config_stock_order_courier_name_and_more'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='esp32config',
+            name='commission_rate',
+            field=models.DecimalField(decimal_places=4, default=0.0, help_text='例如 0.10 表示 10%，优先级高于销售员默认比例', max_digits=5, verbose_name='产品分润比例'),
+        ),
+        migrations.AddField(
+            model_name='salesperson',
+            name='commission_rate',
+            field=models.DecimalField(decimal_places=4, default=0.1, help_text='例如 0.10 表示 10%', max_digits=5, verbose_name='默认分润比例'),
+        ),
+        migrations.AddField(
+            model_name='salesperson',
+            name='parent',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='children', to='shop.salesperson', verbose_name='上级分销员'),
+        ),
+        migrations.AddField(
+            model_name='salesperson',
+            name='second_level_rate',
+            field=models.DecimalField(decimal_places=4, default=0.02, help_text='作为上级时可获得的分润比例，例如 0.02 表示 2%', max_digits=5, verbose_name='二级分销比例'),
+        ),
+        migrations.CreateModel(
+            name='CommissionLog',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('amount', models.DecimalField(decimal_places=2, max_digits=10, verbose_name='佣金金额')),
+                ('level', models.IntegerField(default=1, help_text='1: 直接销售, 2: 二级分销', verbose_name='分销层级')),
+                ('status', models.CharField(choices=[('pending', '待结算'), ('settled', '已结算'), ('cancelled', '已取消')], default='pending', max_length=20, verbose_name='状态')),
+                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')),
+                ('order', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='commissions', to='shop.order', verbose_name='关联订单')),
+                ('salesperson', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='commissions', to='shop.salesperson', verbose_name='获佣销售员')),
+            ],
+            options={
+                'verbose_name': '佣金记录',
+                'verbose_name_plural': '佣金结算',
+            },
+        ),
+    ]

backend/shop/migrations/0016_wechatuser_distributor_order_wechat_user.py

@@ -0,0 +1,64 @@
+# Generated by Django 6.0.1 on 2026-02-10 16:35
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('shop', '0015_esp32config_commission_rate_and_more'),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='WeChatUser',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('openid', models.CharField(max_length=64, unique=True, verbose_name='OpenID')),
+                ('unionid', models.CharField(blank=True, db_index=True, max_length=64, null=True, verbose_name='UnionID')),
+                ('session_key', models.CharField(blank=True, max_length=64, verbose_name='SessionKey')),
+                ('nickname', models.CharField(blank=True, max_length=64, verbose_name='昵称')),
+                ('avatar_url', models.URLField(blank=True, verbose_name='头像URL')),
+                ('gender', models.IntegerField(default=0, help_text='0:未知, 1:男, 2:女', verbose_name='性别')),
+                ('country', models.CharField(blank=True, max_length=64, verbose_name='国家')),
+                ('province', models.CharField(blank=True, max_length=64, verbose_name='省份')),
+                ('city', models.CharField(blank=True, max_length=64, verbose_name='城市')),
+                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')),
+                ('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')),
+                ('user', models.OneToOneField(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='wechat_profile', to=settings.AUTH_USER_MODEL, verbose_name='关联系统用户')),
+            ],
+            options={
+                'verbose_name': '微信用户',
+                'verbose_name_plural': '微信用户管理',
+            },
+        ),
+        migrations.CreateModel(
+            name='Distributor',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('level', models.IntegerField(default=1, verbose_name='分销等级')),
+                ('commission_rate', models.DecimalField(decimal_places=4, default=0.1, help_text='例如 0.10 表示 10%', max_digits=5, verbose_name='分佣比例')),
+                ('total_earnings', models.DecimalField(decimal_places=2, default=0.0, max_digits=12, verbose_name='累计收益')),
+                ('withdrawable_balance', models.DecimalField(decimal_places=2, default=0.0, max_digits=12, verbose_name='可提现余额')),
+                ('status', models.CharField(choices=[('pending', '审核中'), ('active', '正常'), ('disabled', '已禁用')], default='pending', max_length=20, verbose_name='状态')),
+                ('invite_code', models.CharField(blank=True, max_length=20, unique=True, verbose_name='邀请码')),
+                ('qr_code_url', models.URLField(blank=True, verbose_name='推广二维码URL')),
+                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='申请时间')),
+                ('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')),
+                ('parent', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='children', to='shop.distributor', verbose_name='上级分销员')),
+                ('user', models.OneToOneField(on_delete=django.db.models.deletion.CASCADE, related_name='distributor', to='shop.wechatuser', verbose_name='关联微信用户')),
+            ],
+            options={
+                'verbose_name': '分销员',
+                'verbose_name_plural': '分销员管理',
+            },
+        ),
+        migrations.AddField(
+            model_name='order',
+            name='wechat_user',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='orders', to='shop.wechatuser', verbose_name='下单微信用户'),
+        ),
+    ]

backend/shop/migrations/0017_withdrawal.py

@@ -0,0 +1,30 @@
+# Generated by Django 6.0.1 on 2026-02-10 16:35
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('shop', '0016_wechatuser_distributor_order_wechat_user'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Withdrawal',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('amount', models.DecimalField(decimal_places=2, max_digits=10, verbose_name='提现金额')),
+                ('status', models.CharField(choices=[('pending', '审核中'), ('approved', '已打款'), ('rejected', '已拒绝')], default='pending', max_length=20, verbose_name='状态')),
+                ('remark', 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='更新时间')),
+                ('distributor', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='withdrawals', to='shop.distributor', verbose_name='分销员')),
+            ],
+            options={
+                'verbose_name': '提现记录',
+                'verbose_name_plural': '提现管理',
+            },
+        ),
+    ]

backend/shop/migrations/0018_vbcourse_delete_arservice.py

@@ -0,0 +1,35 @@
+# Generated by Django 6.0.1 on 2026-02-10 18:48
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('shop', '0017_withdrawal'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='VBCourse',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('title', models.CharField(max_length=100, verbose_name='课程名称')),
+                ('description', models.TextField(verbose_name='课程简介')),
+                ('course_type', models.CharField(choices=[('software', '软件课程'), ('hardware', '硬件课程')], default='software', max_length=20, verbose_name='课程类型')),
+                ('duration', models.CharField(default='30分钟', help_text='例如: 30分钟', max_length=50, verbose_name='课程时长')),
+                ('lesson_count', models.IntegerField(default=1, verbose_name='课时数量')),
+                ('instructor', models.CharField(default='VB讲师', max_length=50, verbose_name='讲师')),
+                ('cover_image', models.ImageField(blank=True, null=True, upload_to='courses/covers/', verbose_name='封面图 (上传)')),
+                ('cover_image_url', models.URLField(blank=True, null=True, verbose_name='封面图 (URL)')),
+                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')),
+            ],
+            options={
+                'verbose_name': 'VB课程',
+                'verbose_name_plural': 'VB课程管理',
+            },
+        ),
+        migrations.DeleteModel(
+            name='ARService',
+        ),
+    ]

backend/shop/migrations/0019_vbcourse_detail_image_vbcourse_detail_image_url_and_more.py

@@ -0,0 +1,28 @@
+# Generated by Django 6.0.1 on 2026-02-10 18:55
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('shop', '0018_vbcourse_delete_arservice'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='vbcourse',
+            name='detail_image',
+            field=models.ImageField(blank=True, null=True, upload_to='courses/details/', verbose_name='详情页长图 (上传)'),
+        ),
+        migrations.AddField(
+            model_name='vbcourse',
+            name='detail_image_url',
+            field=models.URLField(blank=True, help_text='如果填写了URL，将优先使用URL', null=True, verbose_name='详情页长图 (URL)'),
+        ),
+        migrations.AddField(
+            model_name='vbcourse',
+            name='tag',
+            field=models.CharField(blank=True, help_text='例如: 热门, 推荐, 进阶', max_length=20, verbose_name='标签'),
+        ),
+    ]

backend/shop/migrations/0020_alter_vbcourse_course_type.py

@@ -0,0 +1,18 @@
+# Generated by Django 6.0.1 on 2026-02-10 18:58
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('shop', '0019_vbcourse_detail_image_vbcourse_detail_image_url_and_more'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='vbcourse',
+            name='course_type',
+            field=models.CharField(choices=[('software', '软件课程'), ('hardware', '硬件课程'), ('incubation', '产品商业孵化')], default='software', max_length=20, verbose_name='课程类型'),
+        ),
+    ]

backend/shop/migrations/0021_commissionlog_distributor_order_distributor_and_more.py

@@ -0,0 +1,29 @@
+# Generated by Django 6.0.1 on 2026-02-10 19:08
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('shop', '0020_alter_vbcourse_course_type'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='commissionlog',
+            name='distributor',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='commissions', to='shop.distributor', verbose_name='获佣分销员'),
+        ),
+        migrations.AddField(
+            model_name='order',
+            name='distributor',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='orders', to='shop.distributor', verbose_name='所属分销员'),
+        ),
+        migrations.AlterField(
+            model_name='commissionlog',
+            name='salesperson',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, related_name='commissions', to='shop.salesperson', verbose_name='获佣销售员'),
+        ),
+    ]

backend/shop/migrations/0022_vbcourse_content_vbcourse_price_courseenrollment.py

@@ -0,0 +1,45 @@
+# Generated by Django 6.0.1 on 2026-02-10 19:20
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('shop', '0021_commissionlog_distributor_order_distributor_and_more'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='vbcourse',
+            name='content',
+            field=models.TextField(blank=True, help_text='支持Markdown或HTML', verbose_name='详细内容'),
+        ),
+        migrations.AddField(
+            model_name='vbcourse',
+            name='price',
+            field=models.DecimalField(decimal_places=2, default=0, help_text='0表示免费', max_digits=10, verbose_name='价格'),
+        ),
+        migrations.CreateModel(
+            name='CourseEnrollment',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('customer_name', models.CharField(max_length=100, verbose_name='姓名')),
+                ('phone_number', models.CharField(max_length=20, verbose_name='联系电话')),
+                ('email', models.EmailField(blank=True, max_length=254, verbose_name='电子邮箱')),
+                ('wechat_id', models.CharField(blank=True, max_length=50, verbose_name='微信号')),
+                ('message', models.TextField(blank=True, verbose_name='留言/备注')),
+                ('status', models.CharField(choices=[('pending', '待联系'), ('contacted', '已联系'), ('completed', '已完成'), ('cancelled', '已取消')], default='pending', max_length=20, verbose_name='状态')),
+                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='提交时间')),
+                ('updated_at', models.DateTimeField(auto_now=True, verbose_name='更新时间')),
+                ('course', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='enrollments', to='shop.vbcourse', verbose_name='咨询课程')),
+                ('distributor', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, to='shop.distributor', verbose_name='所属分销员')),
+                ('salesperson', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, to='shop.salesperson', verbose_name='所属销售员')),
+            ],
+            options={
+                'verbose_name': '课程报名',
+                'verbose_name_plural': '课程报名管理',
+            },
+        ),
+    ]

backend/shop/migrations/0023_order_course_alter_order_config.py

@@ -0,0 +1,24 @@
+# Generated by Django 6.0.1 on 2026-02-10 19:23
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('shop', '0022_vbcourse_content_vbcourse_price_courseenrollment'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='order',
+            name='course',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='orders', to='shop.vbcourse', verbose_name='所选课程'),
+        ),
+        migrations.AlterField(
+            model_name='order',
+            name='config',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, to='shop.esp32config', verbose_name='所选配置'),
+        ),
+    ]

backend/shop/migrations/0024_vbcourse_instructor_avatar_and_more.py

@@ -0,0 +1,33 @@
+# Generated by Django 6.0.1 on 2026-02-10 19:28
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('shop', '0023_order_course_alter_order_config'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='vbcourse',
+            name='instructor_avatar',
+            field=models.ImageField(blank=True, null=True, upload_to='instructors/avatars/', verbose_name='讲师头像 (上传)'),
+        ),
+        migrations.AddField(
+            model_name='vbcourse',
+            name='instructor_avatar_url',
+            field=models.URLField(blank=True, null=True, verbose_name='讲师头像 (URL)'),
+        ),
+        migrations.AddField(
+            model_name='vbcourse',
+            name='instructor_desc',
+            field=models.TextField(blank=True, default='拥有多年开发经验，擅长...', verbose_name='讲师简介'),
+        ),
+        migrations.AddField(
+            model_name='vbcourse',
+            name='instructor_title',
+            field=models.CharField(default='资深讲师', max_length=50, verbose_name='讲师头衔'),
+        ),
+    ]

backend/shop/migrations/0025_vccourse_alter_courseenrollment_course_and_more.py

@@ -0,0 +1,55 @@
+# Generated by Django 6.0.1 on 2026-02-10 19:44
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('shop', '0024_vbcourse_instructor_avatar_and_more'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='VCCourse',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('title', models.CharField(max_length=100, verbose_name='课程名称')),
+                ('description', models.TextField(verbose_name='课程简介')),
+                ('course_type', models.CharField(choices=[('software', '软件课程'), ('hardware', '硬件课程'), ('incubation', '产品商业孵化')], default='software', max_length=20, verbose_name='课程类型')),
+                ('duration', models.CharField(default='30分钟', help_text='例如: 30分钟', max_length=50, verbose_name='课程时长')),
+                ('lesson_count', models.IntegerField(default=1, verbose_name='课时数量')),
+                ('instructor', models.CharField(default='VC讲师', max_length=50, verbose_name='讲师')),
+                ('instructor_title', models.CharField(default='资深讲师', max_length=50, verbose_name='讲师头衔')),
+                ('instructor_avatar', models.ImageField(blank=True, null=True, upload_to='instructors/avatars/', verbose_name='讲师头像 (上传)')),
+                ('instructor_avatar_url', models.URLField(blank=True, null=True, verbose_name='讲师头像 (URL)')),
+                ('instructor_desc', models.TextField(blank=True, default='拥有多年开发经验，擅长...', verbose_name='讲师简介')),
+                ('tag', models.CharField(blank=True, help_text='例如: 热门, 推荐, 进阶', max_length=20, verbose_name='标签')),
+                ('price', models.DecimalField(decimal_places=2, default=0, help_text='0表示免费', max_digits=10, verbose_name='价格')),
+                ('content', models.TextField(blank=True, help_text='支持Markdown或HTML', verbose_name='详细内容')),
+                ('cover_image', models.ImageField(blank=True, null=True, upload_to='courses/covers/', verbose_name='封面图 (上传)')),
+                ('cover_image_url', models.URLField(blank=True, null=True, verbose_name='封面图 (URL)')),
+                ('detail_image', models.ImageField(blank=True, null=True, upload_to='courses/details/', verbose_name='详情页长图 (上传)')),
+                ('detail_image_url', models.URLField(blank=True, help_text='如果填写了URL，将优先使用URL', null=True, verbose_name='详情页长图 (URL)')),
+                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='创建时间')),
+            ],
+            options={
+                'verbose_name': 'VC课程',
+                'verbose_name_plural': 'VC课程管理',
+            },
+        ),
+        migrations.AlterField(
+            model_name='courseenrollment',
+            name='course',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='enrollments', to='shop.vccourse', verbose_name='咨询课程'),
+        ),
+        migrations.AlterField(
+            model_name='order',
+            name='course',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='orders', to='shop.vccourse', verbose_name='所选课程'),
+        ),
+        migrations.DeleteModel(
+            name='VBCourse',
+        ),
+    ]

backend/shop/migrations/0026_wechatuser_phone_number.py

@@ -0,0 +1,18 @@
+# Generated by Django 6.0.1 on 2026-02-11 07:18
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('shop', '0025_vccourse_alter_courseenrollment_course_and_more'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='wechatuser',
+            name='phone_number',
+            field=models.CharField(blank=True, max_length=20, null=True, unique=True, verbose_name='手机号'),
+        ),
+    ]

backend/shop/models.py

@@ -3,6 +3,87 @@ from django.utils.html import format_html
 import qrcode
 from io import BytesIO
 import base64
+from django.contrib.auth.models import User
+
+class WeChatUser(models.Model):
+    """
+    微信小程序用户模型
+    """
+    user = models.OneToOneField(User, on_delete=models.CASCADE, null=True, blank=True, related_name='wechat_profile', verbose_name="关联系统用户")
+    openid = models.CharField(max_length=64, unique=True, verbose_name="OpenID")
+    unionid = models.CharField(max_length=64, blank=True, null=True, verbose_name="UnionID", db_index=True)
+    session_key = models.CharField(max_length=64, verbose_name="SessionKey", blank=True)
+    nickname = models.CharField(max_length=64, verbose_name="昵称", blank=True)
+    phone_number = models.CharField(max_length=20, unique=True, null=True, blank=True, verbose_name="手机号")
+    avatar_url = models.URLField(verbose_name="头像URL", blank=True)
+    gender = models.IntegerField(default=0, verbose_name="性别", help_text="0:未知, 1:男, 2:女")
+    country = models.CharField(max_length=64, verbose_name="国家", blank=True)
+    province = models.CharField(max_length=64, verbose_name="省份", blank=True)
+    city = models.CharField(max_length=64, verbose_name="城市", blank=True)
+    created_at = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")
+    updated_at = models.DateTimeField(auto_now=True, verbose_name="更新时间")
+
+    def __str__(self):
+        return self.nickname or self.openid
+
+    class Meta:
+        verbose_name = "微信用户"
+        verbose_name_plural = "微信用户管理"
+
+
+class Distributor(models.Model):
+    """
+    分销员模型 (替代原 Salesperson 或与其并存，此处为新系统)
+    """
+    STATUS_CHOICES = (
+        ('pending', '审核中'),
+        ('active', '正常'),
+        ('disabled', '已禁用'),
+    )
+
+    user = models.OneToOneField(WeChatUser, on_delete=models.CASCADE, related_name='distributor', verbose_name="关联微信用户")
+    parent = models.ForeignKey('self', on_delete=models.SET_NULL, null=True, blank=True, related_name='children', verbose_name="上级分销员")
+    level = models.IntegerField(default=1, verbose_name="分销等级")
+    commission_rate = models.DecimalField(max_digits=5, decimal_places=4, default=0.10, verbose_name="分佣比例", help_text="例如 0.10 表示 10%")
+    total_earnings = models.DecimalField(max_digits=12, decimal_places=2, default=0.00, verbose_name="累计收益")
+    withdrawable_balance = models.DecimalField(max_digits=12, decimal_places=2, default=0.00, verbose_name="可提现余额")
+    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='pending', verbose_name="状态")
+    invite_code = models.CharField(max_length=20, unique=True, blank=True, verbose_name="邀请码")
+    qr_code_url = models.URLField(blank=True, verbose_name="推广二维码URL")
+    created_at = models.DateTimeField(auto_now_add=True, verbose_name="申请时间")
+    updated_at = models.DateTimeField(auto_now=True, verbose_name="更新时间")
+
+    def __str__(self):
+        return f"{self.user.nickname} - {self.get_status_display()}"
+
+    class Meta:
+        verbose_name = "分销员"
+        verbose_name_plural = "分销员管理"
+
+
+class Withdrawal(models.Model):
+    """
+    提现记录
+    """
+    STATUS_CHOICES = (
+        ('pending', '审核中'),
+        ('approved', '已打款'),
+        ('rejected', '已拒绝'),
+    )
+    
+    distributor = models.ForeignKey(Distributor, on_delete=models.CASCADE, related_name='withdrawals', verbose_name="分销员")
+    amount = models.DecimalField(max_digits=10, decimal_places=2, verbose_name="提现金额")
+    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='pending', verbose_name="状态")
+    remark = 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="更新时间")
+
+    def __str__(self):
+        return f"{self.distributor.user.nickname} - ¥{self.amount}"
+
+    class Meta:
+        verbose_name = "提现记录"
+        verbose_name_plural = "提现管理"
 
 class ESP32Config(models.Model):
     """
@@ -15,7 +96,9 @@ class ESP32Config(models.Model):
     ram_size = models.IntegerField(verbose_name="PSRAM大小(MB)", default=2)
     has_camera = models.BooleanField(default=False, verbose_name="是否包含摄像头")
     has_microphone = models.BooleanField(default=False, verbose_name="是否包含麦克风")
+    stock = models.IntegerField(default=0, verbose_name="库存数量")
     price = models.DecimalField(max_digits=10, decimal_places=2, verbose_name="价格")
+    commission_rate = models.DecimalField(max_digits=5, decimal_places=4, default=0.00, verbose_name="产品分润比例", help_text="例如 0.10 表示 10%，优先级高于销售员默认比例")
     description = models.TextField(verbose_name="描述", blank=True)
     detail_image = models.ImageField(upload_to='products/details/', blank=True, null=True, verbose_name="详情页长图 (上传)")
     detail_image_url = models.URLField(blank=True, null=True, verbose_name="详情页长图 (URL)", help_text="如果填写了URL，将优先使用URL")
@@ -57,6 +140,11 @@ class Salesperson(models.Model):
     """
     name = models.CharField(max_length=50, verbose_name="销售员姓名")
     code = models.CharField(max_length=20, unique=True, verbose_name="推广码", help_text="唯一的推广标识码，如: zhangsan01")
+    parent = models.ForeignKey('self', on_delete=models.SET_NULL, null=True, blank=True, related_name='children', verbose_name="上级分销员")
+    
+    commission_rate = models.DecimalField(max_digits=5, decimal_places=4, default=0.10, verbose_name="默认分润比例", help_text="例如 0.10 表示 10%")
+    second_level_rate = models.DecimalField(max_digits=5, decimal_places=4, default=0.02, verbose_name="二级分销比例", help_text="作为上级时可获得的分润比例，例如 0.02 表示 2%")
+    
     created_at = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")
 
     def __str__(self):
@@ -67,6 +155,32 @@ class Salesperson(models.Model):
         verbose_name_plural = "销售员管理"
 
 
+class CommissionLog(models.Model):
+    """
+    佣金结算记录
+    """
+    STATUS_CHOICES = (
+        ('pending', '待结算'),
+        ('settled', '已结算'),
+        ('cancelled', '已取消'),
+    )
+
+    order = models.ForeignKey('Order', on_delete=models.CASCADE, verbose_name="关联订单", related_name='commissions')
+    salesperson = models.ForeignKey(Salesperson, on_delete=models.CASCADE, verbose_name="获佣销售员", related_name='commissions', null=True, blank=True)
+    distributor = models.ForeignKey(Distributor, on_delete=models.CASCADE, verbose_name="获佣分销员", related_name='commissions', null=True, blank=True)
+    amount = models.DecimalField(max_digits=10, decimal_places=2, verbose_name="佣金金额")
+    level = models.IntegerField(default=1, verbose_name="分销层级", help_text="1: 直接销售, 2: 二级分销")
+    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='pending', verbose_name="状态")
+    created_at = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")
+
+    class Meta:
+        verbose_name = "佣金记录"
+        verbose_name_plural = "佣金结算"
+
+    def __str__(self):
+        return f"{self.salesperson.name} - ¥{self.amount} ({self.get_status_display()})"
+
+
 class WeChatPayConfig(models.Model):
     """
     微信支付配置模型
@@ -107,19 +221,28 @@ class Order(models.Model):
         ('cancelled', '已取消'),
     )
 
-    config = models.ForeignKey(ESP32Config, on_delete=models.CASCADE, verbose_name="所选配置")
+    config = models.ForeignKey(ESP32Config, on_delete=models.CASCADE, verbose_name="所选配置", null=True, blank=True)
+    course = models.ForeignKey('VCCourse', on_delete=models.SET_NULL, null=True, blank=True, verbose_name="所选课程", related_name='orders')
     quantity = models.IntegerField(default=1, verbose_name="数量")
     total_price = models.DecimalField(max_digits=10, decimal_places=2, verbose_name="总价")
     status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='pending', verbose_name="订单状态")
     
     # 销售归属
     salesperson = models.ForeignKey(Salesperson, on_delete=models.SET_NULL, null=True, blank=True, verbose_name="所属销售员", related_name='orders')
+    distributor = models.ForeignKey(Distributor, on_delete=models.SET_NULL, null=True, blank=True, verbose_name="所属分销员", related_name='orders')
+    
+    # 关联微信用户
+    wechat_user = models.ForeignKey(WeChatUser, on_delete=models.SET_NULL, null=True, blank=True, verbose_name="下单微信用户", related_name='orders')
 
     # 用户信息
     customer_name = models.CharField(max_length=100, verbose_name="收货人姓名", default="")
     phone_number = models.CharField(max_length=20, verbose_name="联系电话", default="")
     shipping_address = models.TextField(verbose_name="发货地址", default="")
 
+    # 物流信息
+    courier_name = models.CharField(max_length=50, blank=True, null=True, verbose_name="快递公司")
+    tracking_number = models.CharField(max_length=100, blank=True, null=True, verbose_name="快递单号")
+
     # 微信支付相关字段
     out_trade_no = models.CharField(max_length=100, blank=True, null=True, verbose_name="商户订单号")
     wechat_trade_no = models.CharField(max_length=100, blank=True, null=True, verbose_name="微信支付单号")
@@ -193,19 +316,78 @@ class ServiceOrder(models.Model):
         verbose_name_plural = "服务订单列表"
 
 
-class ARService(models.Model):
+class VCCourse(models.Model):
     """
-    AR体验服务模型
+    VC (VB Coding) 课程模型
     """
-    title = models.CharField(max_length=100, verbose_name="体验名称")
-    description = models.TextField(verbose_name="简介")
-    cover_image = models.ImageField(upload_to='ar/covers/', blank=True, null=True, verbose_name="封面/长图 (上传)")
-    cover_image_url = models.URLField(blank=True, null=True, verbose_name="封面/长图 (URL)")
+    COURSE_TYPE_CHOICES = (
+        ('software', '软件课程'),
+        ('hardware', '硬件课程'),
+        ('incubation', '产品商业孵化'),
+    )
+
+    title = models.CharField(max_length=100, verbose_name="课程名称")
+    description = models.TextField(verbose_name="课程简介")
+    course_type = models.CharField(max_length=20, choices=COURSE_TYPE_CHOICES, default='software', verbose_name="课程类型")
+    duration = models.CharField(max_length=50, verbose_name="课程时长", help_text="例如: 30分钟", default="30分钟")
+    lesson_count = models.IntegerField(default=1, verbose_name="课时数量")
+    instructor = models.CharField(max_length=50, verbose_name="讲师", default="VC讲师")
+    instructor_title = models.CharField(max_length=50, verbose_name="讲师头衔", default="资深讲师")
+    instructor_avatar = models.ImageField(upload_to='instructors/avatars/', blank=True, null=True, verbose_name="讲师头像 (上传)")
+    instructor_avatar_url = models.URLField(blank=True, null=True, verbose_name="讲师头像 (URL)")
+    instructor_desc = models.TextField(blank=True, verbose_name="讲师简介", default="拥有多年开发经验，擅长...")
+    
+    tag = models.CharField(max_length=20, blank=True, verbose_name="标签", help_text="例如: 热门, 推荐, 进阶")
+    
+    price = models.DecimalField(max_digits=10, decimal_places=2, default=0, verbose_name="价格", help_text="0表示免费")
+    content = models.TextField(blank=True, verbose_name="详细内容", help_text="支持Markdown或HTML")
+
+    cover_image = models.ImageField(upload_to='courses/covers/', blank=True, null=True, verbose_name="封面图 (上传)")
+    cover_image_url = models.URLField(blank=True, null=True, verbose_name="封面图 (URL)")
+    
+    detail_image = models.ImageField(upload_to='courses/details/', blank=True, null=True, verbose_name="详情页长图 (上传)")
+    detail_image_url = models.URLField(blank=True, null=True, verbose_name="详情页长图 (URL)", help_text="如果填写了URL，将优先使用URL")
+    
     created_at = models.DateTimeField(auto_now_add=True, verbose_name="创建时间")
 
     def __str__(self):
         return self.title
 
     class Meta:
-        verbose_name = "AR体验"
-        verbose_name_plural = "AR体验管理"
+        verbose_name = "VC课程"
+        verbose_name_plural = "VC课程管理"
+
+
+class CourseEnrollment(models.Model):
+    """
+    课程报名/咨询记录
+    """
+    STATUS_CHOICES = (
+        ('pending', '待联系'),
+        ('contacted', '已联系'),
+        ('completed', '已完成'),
+        ('cancelled', '已取消'),
+    )
+
+    course = models.ForeignKey(VCCourse, on_delete=models.CASCADE, verbose_name="咨询课程", related_name='enrollments')
+    customer_name = models.CharField(max_length=100, verbose_name="姓名")
+    phone_number = models.CharField(max_length=20, verbose_name="联系电话")
+    email = models.EmailField(blank=True, verbose_name="电子邮箱")
+    wechat_id = models.CharField(max_length=50, blank=True, verbose_name="微信号")
+    message = models.TextField(blank=True, verbose_name="留言/备注")
+    
+    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='pending', verbose_name="状态")
+    
+    # 销售归属
+    salesperson = models.ForeignKey(Salesperson, on_delete=models.SET_NULL, null=True, blank=True, verbose_name="所属销售员")
+    distributor = models.ForeignKey(Distributor, on_delete=models.SET_NULL, null=True, blank=True, verbose_name="所属分销员")
+    
+    created_at = models.DateTimeField(auto_now_add=True, verbose_name="提交时间")
+    updated_at = models.DateTimeField(auto_now=True, verbose_name="更新时间")
+
+    def __str__(self):
+        return f"{self.customer_name} - {self.course.title}"
+
+    class Meta:
+        verbose_name = "课程报名"
+        verbose_name_plural = "课程报名管理"

backend/shop/serializers.py

@@ -1,5 +1,43 @@
 from rest_framework import serializers
-from .models import ESP32Config, Order, Salesperson, Service, ARService, ProductFeature, ServiceOrder
+from .models import ESP32Config, Order, Salesperson, Service, VCCourse, ProductFeature, ServiceOrder, WeChatUser, Distributor, Withdrawal, CommissionLog, CourseEnrollment
+
+class CommissionLogSerializer(serializers.ModelSerializer):
+    """
+    佣金记录序列化器
+    """
+    order_info = serializers.SerializerMethodField()
+    
+    class Meta:
+        model = CommissionLog
+        fields = ['id', 'amount', 'level', 'status', 'created_at', 'order_info']
+        read_only_fields = ['id', 'amount', 'level', 'status', 'created_at', 'order_info']
+
+    def get_order_info(self, obj):
+        return {
+            'order_id': obj.order.id,
+            'total_price': obj.order.total_price,
+            'customer_name': obj.order.customer_name
+        }
+
+class WeChatUserSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = WeChatUser
+        fields = ['id', 'nickname', 'avatar_url', 'gender', 'country', 'province', 'city', 'phone_number']
+        read_only_fields = ['id', 'phone_number']
+
+class DistributorSerializer(serializers.ModelSerializer):
+    user_info = WeChatUserSerializer(source='user', read_only=True)
+    
+    class Meta:
+        model = Distributor
+        fields = ['id', 'user_info', 'level', 'commission_rate', 'total_earnings', 'withdrawable_balance', 'status', 'invite_code', 'qr_code_url']
+        read_only_fields = ['level', 'commission_rate', 'total_earnings', 'withdrawable_balance', 'status', 'invite_code', 'qr_code_url']
+
+class WithdrawalSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = Withdrawal
+        fields = ['id', 'amount', 'status', 'remark', 'created_at']
+        read_only_fields = ['status', 'created_at', 'remark']
 
 class ProductFeatureSerializer(serializers.ModelSerializer):
     """
@@ -49,6 +87,37 @@ class ServiceSerializer(serializers.ModelSerializer):
             return obj.detail_image.url
         return None
 
+class CourseEnrollmentSerializer(serializers.ModelSerializer):
+    """
+    课程报名序列化器
+    """
+    course_title = serializers.CharField(source='course.title', read_only=True)
+    ref_code = serializers.CharField(write_only=True, required=False, allow_blank=True)
+
+    class Meta:
+        model = CourseEnrollment
+        fields = ['id', 'course', 'course_title', 'customer_name', 'phone_number', 'email', 'wechat_id', 'message', 'status', 'created_at', 'ref_code']
+        read_only_fields = ['status', 'created_at']
+
+    def create(self, validated_data):
+        ref_code = validated_data.pop('ref_code', None)
+        
+        # 尝试关联销售员或分销员
+        if ref_code:
+            try:
+                salesperson = Salesperson.objects.get(code=ref_code)
+                validated_data['salesperson'] = salesperson
+            except Salesperson.DoesNotExist:
+                pass
+            
+            try:
+                distributor = Distributor.objects.get(invite_code=ref_code)
+                validated_data['distributor'] = distributor
+            except Distributor.DoesNotExist:
+                pass
+                
+        return super().create(validated_data)
+
 class ServiceOrderSerializer(serializers.ModelSerializer):
     """
     AI服务订单序列化器
@@ -81,14 +150,16 @@ class ServiceOrderSerializer(serializers.ModelSerializer):
 
         return super().create(validated_data)
 
-class ARServiceSerializer(serializers.ModelSerializer):
+class VCCourseSerializer(serializers.ModelSerializer):
     """
-    AR服务序列化器
+    VC课程序列化器
     """
     display_cover_image = serializers.SerializerMethodField()
+    display_detail_image = serializers.SerializerMethodField()
+    course_type_display = serializers.CharField(source='get_course_type_display', read_only=True)
 
     class Meta:
-        model = ARService
+        model = VCCourse
         fields = '__all__'
     
     def get_display_cover_image(self, obj):
@@ -98,6 +169,13 @@ class ARServiceSerializer(serializers.ModelSerializer):
             return obj.cover_image.url
         return None
 
+    def get_display_detail_image(self, obj):
+        if obj.detail_image_url:
+            return obj.detail_image_url
+        if obj.detail_image:
+            return obj.detail_image.url
+        return None
+
 class ESP32ConfigSerializer(serializers.ModelSerializer):
     """
     ESP32配置序列化器
@@ -122,37 +200,85 @@ class OrderSerializer(serializers.ModelSerializer):
     订单序列化器
     """
     config_name = serializers.CharField(source='config.name', read_only=True)
+    course_title = serializers.CharField(source='course.title', read_only=True)
+    config_image = serializers.SerializerMethodField()
+    salesperson_name = serializers.CharField(source='salesperson.name', read_only=True)
+    salesperson_code = serializers.CharField(source='salesperson.code', read_only=True)
     # 接收前端传来的 ref_code，用于查找 Salesperson
     ref_code = serializers.CharField(write_only=True, required=False, allow_blank=True)
     
     class Meta:
         model = Order
-        fields = ['id', 'config', 'config_name', 'quantity', 'total_price', 'status', 'created_at', 'wechat_trade_no', 
-                  'customer_name', 'phone_number', 'shipping_address', 'ref_code']
-        read_only_fields = ['total_price', 'status', 'wechat_trade_no', 'created_at']
+        fields = ['id', 'config', 'config_name', 'config_image', 'course', 'course_title', 'quantity', 'total_price', 'status', 'created_at', 'updated_at', 'wechat_trade_no', 
+                  'customer_name', 'phone_number', 'shipping_address', 'ref_code', 'salesperson_name', 'salesperson_code', 'courier_name', 'tracking_number']
+        read_only_fields = ['total_price', 'status', 'wechat_trade_no', 'created_at', 'updated_at']
         extra_kwargs = {
             'customer_name': {'required': True},
             'phone_number': {'required': True},
-            'shipping_address': {'required': True},
         }
 
+    def validate(self, data):
+        # 如果是部分更新 (PATCH)，可能不需要校验所有字段，但这里主要用于创建
+        if self.instance:
+            return data
+
+        config = data.get('config')
+        course = data.get('course')
+
+        if not config and not course:
+             raise serializers.ValidationError("必须选择一种商品（硬件配置或课程）")
+        
+        if config and course:
+             raise serializers.ValidationError("一次只能购买一种类型的商品")
+
+        if config and not data.get('shipping_address'):
+             raise serializers.ValidationError({"shipping_address": "购买硬件产品需要填写收货地址"})
+        
+        return data
+
+    def get_config_image(self, obj):
+        if obj.config:
+            if obj.config.static_image_url:
+                return obj.config.static_image_url
+            if obj.config.detail_image_url:
+                return obj.config.detail_image_url
+            if obj.config.detail_image:
+                return obj.config.detail_image.url
+        elif obj.course:
+            if obj.course.cover_image_url:
+                return obj.course.cover_image_url
+            if obj.course.cover_image:
+                return obj.course.cover_image.url
+        return None
+
     def create(self, validated_data):
         """
-        重写创建方法，自动计算总价并关联销售员
+        重写创建方法，自动计算总价并关联销售员/分销员
         """
         config = validated_data.get('config')
+        course = validated_data.get('course')
         quantity = validated_data.get('quantity', 1)
         ref_code = validated_data.pop('ref_code', None)
 
-        validated_data['total_price'] = config.price * quantity
-
-        # 尝试关联销售员
+        if config:
+            validated_data['total_price'] = config.price * quantity
+        elif course:
+            validated_data['total_price'] = course.price * quantity
+        
+        # 尝试关联销售员或分销员
         if ref_code:
+            # 1. 尝试查找旧版销售员
             try:
                 salesperson = Salesperson.objects.get(code=ref_code)
                 validated_data['salesperson'] = salesperson
             except Salesperson.DoesNotExist:
-                # 如果找不到对应的销售员，忽略该推广码，仍继续创建订单（算作自然流量）
+                pass
+
+            # 2. 尝试查找新版分销员
+            try:
+                distributor = Distributor.objects.get(invite_code=ref_code)
+                validated_data['distributor'] = distributor
+            except Distributor.DoesNotExist:
                 pass
 
         return super().create(validated_data)

backend/shop/urls.py

@@ -2,20 +2,28 @@ from django.urls import path, include, re_path
 from rest_framework.routers import DefaultRouter
 from .views import (
     ESP32ConfigViewSet, OrderViewSet, order_check_view, 
-    ServiceViewSet, ARServiceViewSet, ServiceOrderViewSet, 
-    payment_finish, pay
+    ServiceViewSet, VCCourseViewSet, ServiceOrderViewSet, 
+    payment_finish, pay, send_sms_code, wechat_login, update_user_info, DistributorViewSet,
+    CourseEnrollmentViewSet, phone_login, bind_phone
 )
 
 router = DefaultRouter()
 router.register(r'configs', ESP32ConfigViewSet)
 router.register(r'orders', OrderViewSet)
 router.register(r'services', ServiceViewSet)
-router.register(r'ar', ARServiceViewSet)
+router.register(r'courses', VCCourseViewSet)
+router.register(r'course-enrollments', CourseEnrollmentViewSet)
 router.register(r'service-orders', ServiceOrderViewSet)
+router.register(r'distributor', DistributorViewSet, basename='distributor')
 
 urlpatterns = [
     re_path(r'^finish/?$', payment_finish, name='payment-finish'),
     re_path(r'^pay/?$', pay, name='wechat-pay-v3'),
+    path('auth/send-sms/', send_sms_code, name='send-sms'),
+    path('wechat/login/', wechat_login, name='wechat-login'),
+    path('auth/phone-login/', phone_login, name='phone-login'),
+    path('auth/bind-phone/', bind_phone, name='bind-phone'),
+    path('wechat/update/', update_user_info, name='wechat-update'),
     path('page/check-order/', order_check_view, name='check-order-page'),
     path('', include(router.urls)),
 ]

backend/shop/views.py

@@ -5,8 +5,10 @@ from django.shortcuts import render
 from django.views.decorators.csrf import csrf_exempt
 from django.http import HttpResponse
 from drf_spectacular.utils import extend_schema, extend_schema_view, OpenApiParameter, OpenApiExample
-from .models import ESP32Config, Order, WeChatPayConfig, Service, ARService, ServiceOrder
-from .serializers import ESP32ConfigSerializer, OrderSerializer, ServiceSerializer, ARServiceSerializer, ServiceOrderSerializer
+from .models import ESP32Config, Order, WeChatPayConfig, Service, VCCourse, ServiceOrder, Salesperson, CommissionLog, WeChatUser, Distributor, Withdrawal, CourseEnrollment
+from .serializers import ESP32ConfigSerializer, OrderSerializer, ServiceSerializer, VCCourseSerializer, ServiceOrderSerializer, WeChatUserSerializer, DistributorSerializer, WithdrawalSerializer, CommissionLogSerializer, CourseEnrollmentSerializer
+from django.core.signing import TimestampSigner, BadSignature, SignatureExpired
+from django.contrib.auth.models import User
 from wechatpayv3 import WeChatPay, WeChatPayType
 from wechatpayv3.core import Core
 import xml.etree.ElementTree as ET
@@ -18,6 +20,11 @@ import os
 import base64
 from cryptography.hazmat.primitives.ciphers.aead import AESGCM
 from django.conf import settings
+import requests
+import random
+import threading
+from django.core.cache import cache
+from time import sleep
 
 # 猴子补丁：绕过微信支付响应签名验证
 # 原因是：在开发环境或证书未能正确下载时，SDK 会因为无法验证微信返回的签名而抛出异常。
@@ -108,6 +115,63 @@ def get_wechat_pay_client():
     except Exception as e:
         return None, str(e)
 
+@extend_schema(
+    summary="发送短信验证码",
+    description="发送6位数字验证码到指定手机号",
+    request={
+        'application/json': {
+            'type': 'object',
+            'properties': {
+                'phone_number': {'type': 'string', 'description': '手机号码'},
+            },
+            'required': ['phone_number']
+        }
+    },
+    responses={
+        200: OpenApiExample('成功', value={'message': '验证码已发送'}),
+        400: OpenApiExample('失败', value={'error': '手机号不能为空'})
+    }
+)
+@api_view(['POST'])
+def send_sms_code(request):
+    phone = request.data.get('phone_number')
+    if not phone:
+        return Response({'error': '手机号不能为空'}, status=status.HTTP_400_BAD_REQUEST)
+
+    # 生成6位验证码
+    code = ''.join([str(random.randint(0, 9)) for _ in range(6)])
+    
+    # 缓存验证码 (5分钟有效)
+    cache_key = f"sms_code_{phone}"
+    cache.set(cache_key, code, timeout=300)
+    
+    # 异步发送短信
+    def _send_async():
+        try:
+            api_url = "https://data.tangledup-ai.com/api/send-sms"
+            payload = {
+                "phone_number": phone,
+                "code": code,
+                "template_code": "SMS_493295002",
+                "sign_name": "叠加态科技云南",
+                "additionalProp1": {}
+            }
+            headers = {
+                "Content-Type": "application/json",
+                "accept": "application/json"
+            }
+            response = requests.post(api_url, json=payload, headers=headers, timeout=15)
+            print(f"短信异步发送请求已发出: {phone} -> {code}")
+            print(f"API响应: {response.status_code} - {response.text}")
+        except Exception as e:
+            print(f"异步发送短信异常: {str(e)}")
+
+
+    threading.Thread(target=_send_async).start()
+    sleep(2)
+    # 立即返回成功，无需等待外部API响应
+    return Response({'message': '验证码已发送'})
+
 @extend_schema(
     summary="微信支付 V3 Native 下单",
     description="创建订单并获取微信支付二维码链接(code_url)。参数包括商品ID、数量、客户信息等。",
@@ -153,6 +217,7 @@ def pay(request):
 
     # 1. 获取并验证请求参数
     good_id = request.data.get('goodid')
+    order_type = request.data.get('type', 'config')  # 默认为 config
     quantity = int(request.data.get('quantity', 1))
     customer_name = request.data.get('customer_name')
     phone_number = request.data.get('phone_number')
@@ -175,11 +240,23 @@ def pay(request):
         return Response({'error': f'支付配置错误: {error_msg}'}, status=status.HTTP_400_BAD_REQUEST)
 
     # 3. 查找商品和销售员，创建订单
-    try:
-        product = ESP32Config.objects.get(id=good_id)
-    except ESP32Config.DoesNotExist:
-        print(f"商品不存在: {good_id}")
-        return Response({'error': f'找不到 ID 为 {good_id} 的商品'}, status=status.HTTP_404_NOT_FOUND)
+    product = None
+    if order_type == 'course':
+        try:
+            product = VBCourse.objects.get(id=good_id)
+        except VBCourse.DoesNotExist:
+            print(f"课程不存在: {good_id}")
+            return Response({'error': f'找不到 ID 为 {good_id} 的课程'}, status=status.HTTP_404_NOT_FOUND)
+    else:
+        try:
+            product = ESP32Config.objects.get(id=good_id)
+        except ESP32Config.DoesNotExist:
+            print(f"商品不存在: {good_id}")
+            return Response({'error': f'找不到 ID 为 {good_id} 的商品'}, status=status.HTTP_404_NOT_FOUND)
+
+        # 检查库存 (仅针对硬件)
+        if product.stock < quantity:
+            return Response({'error': f'库存不足，仅剩 {product.stock} 件'}, status=status.HTTP_400_BAD_REQUEST)
 
     salesperson = None
     if ref_code:
@@ -189,20 +266,34 @@ def pay(request):
     total_price = product.price * quantity
     amount_in_cents = int(total_price * 100)
 
-    order = Order.objects.create(
-        config=product,
-        quantity=quantity,
-        total_price=total_price,
-        customer_name=customer_name,
-        phone_number=phone_number,
-        shipping_address=shipping_address,
-        salesperson=salesperson,
-        status='pending'
-    )
+    order_kwargs = {
+        'quantity': quantity,
+        'total_price': total_price,
+        'customer_name': customer_name,
+        'phone_number': phone_number,
+        'shipping_address': shipping_address,
+        'salesperson': salesperson,
+        'status': 'pending'
+    }
+    
+    if order_type == 'course':
+        order_kwargs['course'] = product
+    else:
+        order_kwargs['config'] = product
+
+    order = Order.objects.create(**order_kwargs)
+
+    # 扣减库存 (仅针对硬件)
+    if order_type != 'course':
+        product.stock -= quantity
+        product.save()
 
     # 4. 调用微信支付接口
     out_trade_no = f"PAY{order.id}T{int(time.time())}"
-    description = f"购买 {product.name} x {quantity}"
+    if order_type == 'course':
+        description = f"报名 {product.title}"
+    else:
+        description = f"购买 {product.name} x {quantity}"
     
     # 保存商户订单号到数据库，方便后续查询
     order.out_trade_no = out_trade_no
@@ -388,6 +479,102 @@ def payment_finish(request):
                     order.wechat_trade_no = transaction_id
                     order.save()
                     print(f"订单 {order.id} 状态已更新")
+
+                    # 计算佣金 (旧版销售员系统)
+                    try:
+                        salesperson = order.salesperson
+                        if salesperson:
+                            # 1. 计算直接佣金 (一级)
+                            # 优先级: 产品独立分润比例 > 销售员个人分润比例
+                            rate_1 = 0
+                            if order.config:
+                                rate_1 = order.config.commission_rate if order.config.commission_rate > 0 else salesperson.commission_rate
+                            elif order.course:
+                                # 课程暂时使用销售员默认比例
+                                rate_1 = salesperson.commission_rate
+                                
+                            amount_1 = order.total_price * rate_1
+                            
+                            if amount_1 > 0:
+                                CommissionLog.objects.create(
+                                    order=order,
+                                    salesperson=salesperson,
+                                    amount=amount_1,
+                                    level=1,
+                                    status='pending'
+                                )
+                                print(f"生成一级佣金(Salesperson): {salesperson.name} - {amount_1}")
+
+                            # 2. 计算上级佣金 (二级)
+                            parent = salesperson.parent
+                            if parent:
+                                rate_2 = parent.second_level_rate
+                                amount_2 = order.total_price * rate_2
+                                
+                                if amount_2 > 0:
+                                    CommissionLog.objects.create(
+                                        order=order,
+                                        salesperson=parent,
+                                        amount=amount_2,
+                                        level=2,
+                                        status='pending'
+                                    )
+                                    print(f"生成二级佣金(Salesperson): {parent.name} - {amount_2}")
+
+                        # 计算佣金 (新版分销员系统)
+                        distributor = order.distributor
+                        if distributor:
+                            # 1. 计算直接佣金 (一级)
+                            # 优先级: 产品独立分润比例 > 分销员个人分润比例
+                            rate_1 = 0
+                            if order.config:
+                                rate_1 = order.config.commission_rate if order.config.commission_rate > 0 else distributor.commission_rate
+                            elif order.course:
+                                # 课程暂时使用分销员默认比例
+                                rate_1 = distributor.commission_rate
+
+                            amount_1 = order.total_price * rate_1
+
+                            if amount_1 > 0:
+                                CommissionLog.objects.create(
+                                    order=order,
+                                    distributor=distributor,
+                                    amount=amount_1,
+                                    level=1,
+                                    status='settled' # 简化流程，直接结算到余额
+                                )
+                                # 更新余额
+                                distributor.total_earnings += amount_1
+                                distributor.withdrawable_balance += amount_1
+                                distributor.save()
+                                print(f"生成一级佣金(Distributor): {distributor.user.nickname} - {amount_1}")
+
+                            # 2. 计算上级佣金 (二级)
+                            parent = distributor.parent
+                            if parent:
+                                # 二级固定比例 2% (0.02)
+                                rate_2 = 0.02 
+                                amount_2 = order.total_price * models.DecimalField(max_digits=5, decimal_places=4).to_python(rate_2)
+
+                                if amount_2 > 0:
+                                    CommissionLog.objects.create(
+                                        order=order,
+                                        distributor=parent,
+                                        amount=amount_2,
+                                        level=2,
+                                        status='settled'
+                                    )
+                                    # 更新余额
+                                    parent.total_earnings += amount_2
+                                    parent.withdrawable_balance += amount_2
+                                    parent.save()
+                                    print(f"生成二级佣金(Distributor): {parent.user.nickname} - {amount_2}")
+
+                    except Exception as e:
+                        print(f"佣金计算失败: {str(e)}")
+                        import traceback
+                        traceback.print_exc()
+
             except Exception as e:
                 print(f"订单更新失败: {str(e)}")
         
@@ -400,15 +587,22 @@ def payment_finish(request):
         return HttpResponse(str(e), status=500)
 
 @extend_schema_view(
-    list=extend_schema(summary="获取AR服务列表", description="获取所有可用的AR服务"),
-    retrieve=extend_schema(summary="获取AR服务详情", description="获取指定AR服务的详细信息")
+    list=extend_schema(summary="获取VC课程列表", description="获取所有可用的VC课程"),
+    retrieve=extend_schema(summary="获取VC课程详情", description="获取指定VC课程的详细信息")
 )
-class ARServiceViewSet(viewsets.ReadOnlyModelViewSet):
+class VCCourseViewSet(viewsets.ReadOnlyModelViewSet):
     """
-    AR服务列表和详情
+    VC课程列表和详情
     """
-    queryset = ARService.objects.all().order_by('-created_at')
-    serializer_class = ARServiceSerializer
+    queryset = VCCourse.objects.all().order_by('-created_at')
+    serializer_class = VCCourseSerializer
+
+class CourseEnrollmentViewSet(viewsets.ModelViewSet):
+    """
+    课程报名管理
+    """
+    queryset = CourseEnrollment.objects.all().order_by('-created_at')
+    serializer_class = CourseEnrollmentSerializer
 
 def order_check_view(request):
     """
@@ -454,6 +648,96 @@ class OrderViewSet(viewsets.ModelViewSet):
     queryset = Order.objects.all()
     serializer_class = OrderSerializer
 
+    def get_queryset(self):
+        """
+        如果用户已通过微信登录，只返回自己的订单
+        否则（如管理员）返回所有订单
+        """
+        queryset = super().get_queryset()
+        user = get_current_wechat_user(self.request)
+        if user:
+            return queryset.filter(wechat_user=user).order_by('-created_at')
+        return queryset.order_by('-created_at')
+
+    @action(detail=True, methods=['post'])
+    def prepay_miniprogram(self, request, pk=None):
+        """
+        小程序支付下单 (返回 wx.requestPayment 所需参数)
+        """
+        order = self.get_object()
+        if order.status == 'paid':
+            return Response({'error': '订单已支付'}, status=status.HTTP_400_BAD_REQUEST)
+
+        user = get_current_wechat_user(request)
+        if not user:
+             return Response({'error': 'Unauthorized'}, status=401)
+        
+        # 绑定用户
+        if not order.wechat_user:
+            order.wechat_user = user
+            order.save()
+
+        wechat_config = WeChatPayConfig.objects.filter(is_active=True).first()
+        if not wechat_config:
+             return Response({'error': '支付系统维护中'}, status=status.HTTP_503_SERVICE_UNAVAILABLE)
+
+        # 初始化支付客户端
+        wxpay, error_msg = get_wechat_pay_client()
+        if not wxpay:
+            return Response({'error': error_msg}, status=500)
+
+        amount_in_cents = int(order.total_price * 100)
+        out_trade_no = f"PAY{order.id}T{int(time.time())}"
+        order.out_trade_no = out_trade_no
+        order.save()
+
+        try:
+            # 统一下单 (JSAPI)
+            code, message = wxpay.pay(
+                description=f"购买 {order.config.name} x {order.quantity}",
+                out_trade_no=out_trade_no,
+                amount={'total': amount_in_cents, 'currency': 'CNY'},
+                payer={'openid': user.openid}, # 小程序支付必须传 openid
+                notify_url=wechat_config.notify_url
+            )
+            
+            result = json.loads(message)
+            if code in range(200, 300):
+                prepay_id = result.get('prepay_id')
+                
+                # 生成小程序调起支付所需的参数
+                timestamp = str(int(time.time()))
+                nonce_str = str(uuid.uuid4()).replace('-', '')
+                package = f"prepay_id={prepay_id}"
+                
+                # 再次签名 (小程序端需要的签名)
+                # 注意：WeChatPayV3 SDK 可能没有直接提供生成小程序签名的 helper，需手动计算
+                # 签名串格式：appId\ntimeStamp\nnonceStr\npackage\n
+                message_build = f"{wechat_config.app_id}\n{timestamp}\n{nonce_str}\n{package}\n"
+                
+                # 使用商户私钥签名
+                # 这里的私钥加载逻辑需复用 get_wechat_pay_client 中的逻辑，或者直接从 wxpay 实例获取 (如果它暴露了)
+                # 简单起见，我们重新加载私钥
+                private_key_str = wxpay._private_key # 假设 SDK 内部存储了 private_key (通常是 obj)
+                # 由于 SDK 内部处理复杂，我们尝试用 cryptography 库签名
+                
+                # 实际上 wechatpayv3 库提供了 sign 方法
+                signature = wxpay.sign(message_build)
+
+                return Response({
+                    'timeStamp': timestamp,
+                    'nonceStr': nonce_str,
+                    'package': package,
+                    'signType': 'RSA',
+                    'paySign': signature,
+                    'out_trade_no': out_trade_no
+                })
+            else:
+                return Response({'error': '微信下单失败', 'detail': result}, status=400)
+
+        except Exception as e:
+            return Response({'error': str(e)}, status=500)
+
     @action(detail=False, methods=['get'])
     def lookup(self, request):
         """
@@ -469,6 +753,48 @@ class OrderViewSet(viewsets.ModelViewSet):
         serializer = self.get_serializer(orders, many=True)
         return Response(serializer.data)
 
+    @action(detail=False, methods=['post'], authentication_classes=[], permission_classes=[])
+    def my_orders(self, request):
+        """
+        查询我的订单
+        需要提供手机号和验证码
+        """
+        phone = request.data.get('phone_number')
+        code = request.data.get('code')
+        
+        # 兼容已登录用户直接查询
+        user = get_current_wechat_user(request)
+        if user and not code:
+             # 如果已登录且未传验证码，校验手机号是否匹配
+             if phone and user.phone_number != phone:
+                 return Response({'error': '无权查询该手机号的订单'}, status=status.HTTP_403_FORBIDDEN)
+             # 返回当前用户的订单
+             orders = Order.objects.filter(wechat_user=user).order_by('-created_at')
+             serializer = self.get_serializer(orders, many=True)
+             return Response(serializer.data)
+
+        if not phone or not code:
+            return Response({'error': '请提供手机号和验证码'}, status=status.HTTP_400_BAD_REQUEST)
+            
+        # 验证验证码
+        cache_key = f"sms_code_{phone}"
+        cached_code = cache.get(cache_key)
+        
+        # 开发/测试方便，如果验证码是 888888 且没有缓存，允许通过（可选，但为了演示方便）
+        # if code == '888888': pass 
+        
+        if not cached_code or cached_code != code:
+            return Response({'error': '验证码错误或已过期'}, status=status.HTTP_400_BAD_REQUEST)
+            
+        # 查询订单
+        orders = Order.objects.filter(phone_number=phone).order_by('-created_at')
+        serializer = self.get_serializer(orders, many=True)
+        
+        # 验证通过后清除验证码 (防止重放)
+        cache.delete(cache_key)
+        
+        return Response(serializer.data)
+
     @action(detail=True, methods=['post'])
     def initiate_payment(self, request, pk=None):
         """
@@ -583,3 +909,403 @@ class OrderViewSet(viewsets.ModelViewSet):
         order.wechat_trade_no = f"WX_{str(uuid.uuid4())[:18]}"
         order.save()
         return Response({'status': 'success', 'message': '支付成功'})
+
+def get_current_wechat_user(request):
+    """
+    根据 Authorization 头获取当前微信用户
+    """
+    auth_header = request.headers.get('Authorization')
+    if not auth_header or not auth_header.startswith('Bearer '):
+        return None
+    token = auth_header.split(' ')[1]
+    signer = TimestampSigner()
+    try:
+        # 签名包含 openid
+        openid = signer.unsign(token, max_age=86400 * 30) # 30天有效
+        return WeChatUser.objects.filter(openid=openid).first()
+    except (BadSignature, SignatureExpired):
+        return None
+
+@extend_schema(
+    summary="微信小程序登录",
+    request={
+        'application/json': {
+            'properties': {'code': {'type': 'string', 'description': 'wx.login获取的code'}},
+            'required': ['code']
+        }
+    },
+    responses={200: {'properties': {'token': {'type': 'string'}, 'openid': {'type': 'string'}}}}
+)
+@api_view(['POST'])
+def wechat_login(request):
+    code = request.data.get('code')
+    if not code:
+        return Response({'error': 'Code is required'}, status=400)
+
+    config = WeChatPayConfig.objects.filter(is_active=True).first()
+    if not config or not config.app_id or not config.app_secret:
+        return Response({'error': 'WeChat config missing'}, status=500)
+
+    # 换取 OpenID
+    url = f"https://api.weixin.qq.com/sns/jscode2session?appid={config.app_id}&secret={config.app_secret}&js_code={code}&grant_type=authorization_code"
+    try:
+        res = requests.get(url, timeout=10)
+        data = res.json()
+    except Exception as e:
+        return Response({'error': str(e)}, status=500)
+
+    if 'errcode' in data and data['errcode'] != 0:
+        return Response({'error': data.get('errmsg')}, status=400)
+
+    openid = data.get('openid')
+    session_key = data.get('session_key')
+    unionid = data.get('unionid')
+
+    # 创建或更新用户
+    user, created = WeChatUser.objects.update_or_create(
+        openid=openid,
+        defaults={
+            'session_key': session_key,
+            'unionid': unionid
+        }
+    )
+
+    # 生成 Token
+    signer = TimestampSigner()
+    token = signer.sign(openid)
+
+    return Response({
+        'token': token,
+        'openid': openid,
+        'is_new': created,
+        'nickname': user.nickname
+    })
+
+@extend_schema(
+    summary="更新微信用户信息",
+    request=WeChatUserSerializer,
+)
+@api_view(['POST'])
+def update_user_info(request):
+    user = get_current_wechat_user(request)
+    if not user:
+        return Response({'error': 'Unauthorized'}, status=401)
+    
+    serializer = WeChatUserSerializer(user, data=request.data, partial=True)
+    if serializer.is_valid():
+        serializer.save()
+        return Response(serializer.data)
+    return Response(serializer.errors, status=400)
+
+
+@extend_schema(
+    summary="手机号验证码登录 (Web端)",
+    description="通过手机号和验证码登录，支持Web端用户创建及与小程序用户合并",
+    request={
+        'application/json': {
+            'type': 'object',
+            'properties': {
+                'phone_number': {'type': 'string', 'description': '手机号码'},
+                'code': {'type': 'string', 'description': '验证码'}
+            },
+            'required': ['phone_number', 'code']
+        }
+    },
+    responses={
+        200: OpenApiExample(
+            '成功',
+            value={
+                'token': 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
+                'openid': 'web_13800138000',
+                'nickname': 'User_8000',
+                'is_new': False
+            }
+        ),
+        400: OpenApiExample('失败', value={'error': '验证码错误'})
+    }
+)
+@api_view(['POST'])
+def phone_login(request):
+    phone = request.data.get('phone_number')
+    code = request.data.get('code')
+    
+    if not phone or not code:
+        return Response({'error': '手机号和验证码不能为空'}, status=status.HTTP_400_BAD_REQUEST)
+
+    # 验证验证码 (模拟环境允许 888888)
+    cache_key = f"sms_code_{phone}"
+    cached_code = cache.get(cache_key)
+    
+    if code != '888888': # 开发测试后门
+        if not cached_code or cached_code != code:
+            return Response({'error': '验证码错误或已过期'}, status=status.HTTP_400_BAD_REQUEST)
+    
+    # 验证通过，清除验证码
+    cache.delete(cache_key)
+    
+    # 查找或创建用户
+    # 1. 查找是否已有绑定该手机号的用户 (可能是 MP 用户绑定了手机，或者是 Web 用户)
+    user = WeChatUser.objects.filter(phone_number=phone).first()
+    created = False
+    
+    if not user:
+        # 2. 如果不存在，创建 Web 用户
+        # 生成唯一的 Web OpenID
+        web_openid = f"web_{phone}"
+        user, created = WeChatUser.objects.get_or_create(
+            openid=web_openid,
+            defaults={
+                'phone_number': phone,
+                'nickname': f"User_{phone[-4:]}",
+                'avatar_url': 'https://api.dicebear.com/7.x/avataaars/svg?seed=' + phone # 默认头像
+            }
+        )
+    
+    # 生成 Token
+    signer = TimestampSigner()
+    token = signer.sign(user.openid)
+    
+    return Response({
+        'token': token,
+        'openid': user.openid,
+        'nickname': user.nickname,
+        'avatar_url': user.avatar_url,
+        'phone_number': user.phone_number,
+        'is_new': created
+    })
+
+
+@extend_schema(
+    summary="绑定手机号 (小程序端)",
+    description="小程序用户绑定手机号，如果手机号已存在 Web 用户，则合并数据",
+    request={
+        'application/json': {
+            'type': 'object',
+            'properties': {
+                'phone_number': {'type': 'string', 'description': '手机号码'},
+                'code': {'type': 'string', 'description': '验证码'}
+            },
+            'required': ['phone_number', 'code']
+        }
+    },
+    responses={
+        200: OpenApiExample('成功', value={'message': '绑定成功', 'merged': True})
+    }
+)
+@api_view(['POST'])
+def bind_phone(request):
+    current_user = get_current_wechat_user(request)
+    if not current_user:
+        return Response({'error': 'Unauthorized'}, status=401)
+        
+    phone = request.data.get('phone_number')
+    code = request.data.get('code')
+    
+    if not phone or not code:
+        return Response({'error': '手机号和验证码不能为空'}, status=status.HTTP_400_BAD_REQUEST)
+        
+    # 验证验证码
+    cache_key = f"sms_code_{phone}"
+    cached_code = cache.get(cache_key)
+    if code != '888888' and (not cached_code or cached_code != code):
+        return Response({'error': '验证码错误'}, status=status.HTTP_400_BAD_REQUEST)
+    cache.delete(cache_key)
+    
+    # 检查手机号是否已被占用
+    existing_user = WeChatUser.objects.filter(phone_number=phone).first()
+    
+    if existing_user:
+        if existing_user.id == current_user.id:
+            return Response({'message': '已绑定该手机号'})
+            
+        # 发现冲突，需要合并
+        # 策略：保留 current_user (MP User, with real OpenID)，合并 existing_user (Web User) 的数据
+        # 仅当 existing_user 是 Web 用户 (openid startswith 'web_') 时才合并
+        # 如果 existing_user 也是 MP 用户 (real openid)，则提示冲突，不允许绑定
+        
+        if not existing_user.openid.startswith('web_'):
+             return Response({'error': '该手机号已被其他微信账号绑定，无法重复绑定'}, status=status.HTTP_409_CONFLICT)
+             
+        # 执行合并
+        from django.db import transaction
+        with transaction.atomic():
+            # 1. 迁移订单
+            Order.objects.filter(wechat_user=existing_user).update(wechat_user=current_user)
+            # 2. 迁移社区 ActivitySignup
+            from community.models import ActivitySignup, Topic, Reply
+            ActivitySignup.objects.filter(user=existing_user).update(user=current_user)
+            # 3. 迁移 Topic
+            Topic.objects.filter(author=existing_user).update(author=current_user)
+            # 4. 迁移 Reply
+            Reply.objects.filter(author=existing_user).update(author=current_user)
+            # 5. 迁移 Distributor (如果 Web 用户注册了分销员，且 MP 用户未注册)
+            if hasattr(existing_user, 'distributor') and not hasattr(current_user, 'distributor'):
+                 dist = existing_user.distributor
+                 dist.user = current_user
+                 dist.save()
+            
+            # 删除旧 Web 用户
+            existing_user.delete()
+            
+            # 更新当前用户手机号
+            current_user.phone_number = phone
+            current_user.save()
+            
+        return Response({'message': '绑定成功，账号数据已合并', 'merged': True})
+    
+    else:
+        # 无冲突，直接绑定
+        current_user.phone_number = phone
+        current_user.save()
+        return Response({'message': '绑定成功', 'merged': False})
+
+
+class DistributorViewSet(viewsets.GenericViewSet):
+    """
+    分销员接口
+    """
+    queryset = Distributor.objects.all()
+    serializer_class = DistributorSerializer
+
+    @action(detail=False, methods=['post'])
+    def register(self, request):
+        user = get_current_wechat_user(request)
+        if not user:
+            return Response({'error': 'Unauthorized'}, status=401)
+        
+        if hasattr(user, 'distributor'):
+            return Response({'error': 'Already registered'}, status=400)
+        
+        # 检查是否有关联上级 (通过 invite_code)
+        parent = None
+        invite_code = request.data.get('invite_code')
+        if invite_code:
+            parent = Distributor.objects.filter(invite_code=invite_code).first()
+        
+        # 生成自己的邀请码
+        my_invite_code = str(uuid.uuid4())[:8]
+
+        distributor = Distributor.objects.create(
+            user=user,
+            parent=parent,
+            invite_code=my_invite_code,
+            status='pending' # 需要审核
+        )
+        
+        return Response(DistributorSerializer(distributor).data)
+
+    @action(detail=False, methods=['get'])
+    def info(self, request):
+        user = get_current_wechat_user(request)
+        if not user:
+            return Response({'error': 'Unauthorized'}, status=401)
+        
+        if not hasattr(user, 'distributor'):
+            return Response({'error': 'Not a distributor'}, status=404)
+            
+        return Response(DistributorSerializer(user.distributor).data)
+
+    @action(detail=False, methods=['post'])
+    def invite(self, request):
+        """生成小程序码"""
+        user = get_current_wechat_user(request)
+        if not user or not hasattr(user, 'distributor'):
+            return Response({'error': 'Unauthorized'}, status=401)
+        
+        distributor = user.distributor
+        if distributor.qr_code_url:
+            return Response({'qr_code_url': distributor.qr_code_url})
+            
+        # 调用微信接口生成小程序码 (wxacode.getUnlimited)
+        # 这里简化处理，返回模拟URL或需要实现具体逻辑
+        # 实际逻辑需要获取 AccessToken 然后调用 API
+        return Response({'qr_code_url': 'https://placeholder.com/qrcode.png'})
+
+    @action(detail=False, methods=['post'])
+    def withdraw(self, request):
+        user = get_current_wechat_user(request)
+        if not user or not hasattr(user, 'distributor'):
+            return Response({'error': 'Unauthorized'}, status=401)
+            
+        amount = float(request.data.get('amount', 0))
+        if amount <= 0:
+            return Response({'error': 'Invalid amount'}, status=400)
+            
+        distributor = user.distributor
+        if distributor.withdrawable_balance < amount:
+            return Response({'error': 'Insufficient balance'}, status=400)
+            
+        # 创建提现记录
+        Withdrawal.objects.create(
+            distributor=distributor,
+            amount=amount,
+            status='pending'
+        )
+        
+        # 扣减余额
+        distributor.withdrawable_balance -=  models.DecimalField(max_digits=12, decimal_places=2).to_python(amount)
+        distributor.save()
+        
+        return Response({'message': 'Withdrawal request submitted'})
+
+    @action(detail=False, methods=['get'])
+    def earnings(self, request):
+        """查看个人分销金额及明细"""
+        user = get_current_wechat_user(request)
+        if not user or not hasattr(user, 'distributor'):
+            return Response({'error': 'Unauthorized'}, status=401)
+            
+        distributor = user.distributor
+        logs = CommissionLog.objects.filter(distributor=distributor).order_by('-created_at')
+        
+        page = self.paginate_queryset(logs)
+        if page is not None:
+            serializer = CommissionLogSerializer(page, many=True)
+            return self.get_paginated_response(serializer.data)
+
+        serializer = CommissionLogSerializer(logs, many=True)
+        return Response(serializer.data)
+
+    @action(detail=False, methods=['get'])
+    def team(self, request):
+        """查看团队（二级分销情况）"""
+        user = get_current_wechat_user(request)
+        if not user or not hasattr(user, 'distributor'):
+            return Response({'error': 'Unauthorized'}, status=401)
+            
+        distributor = user.distributor
+        
+        # 直推下级
+        children = Distributor.objects.filter(parent=distributor)
+        children_data = DistributorSerializer(children, many=True).data
+        
+        # 二级分销收益统计
+        second_level_earnings = CommissionLog.objects.filter(distributor=distributor, level=2).aggregate(total=models.Sum('amount'))['total'] or 0
+        
+        return Response({
+            'children_count': children.count(),
+            'children': children_data,
+            'second_level_earnings': second_level_earnings
+        })
+        
+    @action(detail=False, methods=['get'])
+    def orders(self, request):
+        """查看分销订单"""
+        user = get_current_wechat_user(request)
+        if not user or not hasattr(user, 'distributor'):
+            return Response({'error': 'Unauthorized'}, status=401)
+            
+        distributor = user.distributor
+        # 查找我赚了钱的订单
+        commission_logs = CommissionLog.objects.filter(distributor=distributor).select_related('order')
+        order_ids = commission_logs.values_list('order_id', flat=True)
+        orders = Order.objects.filter(id__in=order_ids).order_by('-created_at')
+        
+        page = self.paginate_queryset(orders)
+        if page is not None:
+            serializer = OrderSerializer(page, many=True)
+            return self.get_paginated_response(serializer.data)
+            
+        serializer = OrderSerializer(orders, many=True)
+        return Response(serializer.data)
+

frontend/src/App.jsx

@@ -1,29 +1,36 @@
 import React from 'react'
 import { BrowserRouter, Routes, Route } from 'react-router-dom';
+import { AuthProvider } from './context/AuthContext';
 import Layout from './components/Layout';
 import Home from './pages/Home';
 import ProductDetail from './pages/ProductDetail';
 import Payment from './pages/Payment';
 import AIServices from './pages/AIServices';
 import ServiceDetail from './pages/ServiceDetail';
-import ARExperience from './pages/ARExperience';
+import VCCourses from './pages/VCCourses';
+import VCCourseDetail from './pages/VCCourseDetail';
+import MyOrders from './pages/MyOrders';
 import 'antd/dist/reset.css';
 import './App.css';
 
 function App() {
   return (
-    <BrowserRouter>
-      <Layout>
-        <Routes>
-          <Route path="/" element={<Home />} />
-          <Route path="/services" element={<AIServices />} />
-          <Route path="/services/:id" element={<ServiceDetail />} />
-          <Route path="/ar" element={<ARExperience />} />
-          <Route path="/product/:id" element={<ProductDetail />} />
-          <Route path="/payment/:orderId" element={<Payment />} />
-        </Routes>
-      </Layout>
-    </BrowserRouter>
+    <AuthProvider>
+      <BrowserRouter>
+        <Layout>
+          <Routes>
+            <Route path="/" element={<Home />} />
+            <Route path="/services" element={<AIServices />} />
+            <Route path="/services/:id" element={<ServiceDetail />} />
+            <Route path="/courses" element={<VCCourses />} />
+            <Route path="/courses/:id" element={<VCCourseDetail />} />
+            <Route path="/my-orders" element={<MyOrders />} />
+            <Route path="/product/:id" element={<ProductDetail />} />
+            <Route path="/payment/:orderId" element={<Payment />} />
+          </Routes>
+        </Layout>
+      </BrowserRouter>
+    </AuthProvider>
   )
 }
 

frontend/src/api.js

@@ -2,12 +2,23 @@ import axios from 'axios';
 
 const api = axios.create({
     baseURL: import.meta.env.VITE_API_URL || 'http://localhost:8000/api',
-    timeout: 5000,
+    timeout: 8000, // 增加超时时间到 10秒
     headers: {
         'Content-Type': 'application/json',
     }
 });
 
+// 请求拦截器：自动附加 Token
+api.interceptors.request.use((config) => {
+    const token = localStorage.getItem('token');
+    if (token) {
+        config.headers.Authorization = `Bearer ${token}`;
+    }
+    return config;
+}, (error) => {
+    return Promise.reject(error);
+});
+
 export const getConfigs = () => api.get('/configs/');
 export const createOrder = (data) => api.post('/orders/', data);
 export const nativePay = (data) => api.post('/pay/', data);
@@ -19,6 +30,21 @@ export const confirmPayment = (orderId) => api.post(`/orders/${orderId}/confirm_
 export const getServices = () => api.get('/services/');
 export const getServiceDetail = (id) => api.get(`/services/${id}/`);
 export const createServiceOrder = (data) => api.post('/service-orders/', data);
-export const getARServices = () => api.get('/ar/');
+export const getVCCourses = () => api.get('/courses/');
+export const getVCCourseDetail = (id) => api.get(`/courses/${id}/`);
+export const enrollCourse = (data) => api.post('/course-enrollments/', data);
+
+export const sendSms = (data) => api.post('/auth/send-sms/', data);
+export const queryMyOrders = (data) => api.post('/orders/my_orders/', data);
+export const phoneLogin = (data) => api.post('/auth/phone-login/', data);
+export const getUserInfo = () => {
+    const token = localStorage.getItem('token');
+    // 如果没有获取用户信息的接口，可以暂时从本地解析或依赖 update_user_info 的返回
+    // 但后端有 /wechat/update/ 可以返回用户信息，或者我们可以加一个 /auth/me/
+    // 目前 phone_login 返回了用户信息，前端可以保存。
+    // 如果需要刷新，可以复用 update_user_info（虽然名字叫update，但传空通常返回当前信息，需确认后端逻辑）
+    // 查看后端逻辑：update_user_info 是 patch 更新，如果 data 为空，update 不会执行但会返回 serializer.data
+    return api.post('/wechat/update/', {}); 
+};
 
 export default api;

frontend/src/components/Layout.jsx

@@ -1,16 +1,47 @@
-import React, { useState } from 'react';
-import { Layout as AntLayout, Menu, ConfigProvider, theme, Drawer, Button } from 'antd';
-import { RobotOutlined, MenuOutlined, AppstoreOutlined, EyeOutlined } from '@ant-design/icons';
-import { useNavigate, useLocation } from 'react-router-dom';
+import React, { useState, useEffect } from 'react';
+import { Layout as AntLayout, Menu, ConfigProvider, theme, Drawer, Button, Avatar, Dropdown } from 'antd';
+import { RobotOutlined, MenuOutlined, AppstoreOutlined, EyeOutlined, SearchOutlined, UserOutlined, LogoutOutlined, WechatOutlined } from '@ant-design/icons';
+import { useNavigate, useLocation, useSearchParams } from 'react-router-dom';
 import ParticleBackground from './ParticleBackground';
+import LoginModal from './LoginModal';
 import { motion, AnimatePresence } from 'framer-motion';
+import { useAuth } from '../context/AuthContext';
 
 const { Header, Content, Footer } = AntLayout;
 
 const Layout = ({ children }) => {
   const navigate = useNavigate();
   const location = useLocation();
+  const [searchParams] = useSearchParams();
   const [mobileMenuOpen, setMobileMenuOpen] = useState(false);
+  const [loginVisible, setLoginVisible] = useState(false);
+  
+  const { user, login, logout } = useAuth();
+
+  // 全局监听并持久化 ref 参数
+  useEffect(() => {
+    const ref = searchParams.get('ref');
+    if (ref) {
+      console.log('[Layout] Capturing sales ref code:', ref);
+      localStorage.setItem('ref_code', ref);
+    }
+  }, [searchParams]);
+
+  const handleLogout = () => {
+    logout();
+    navigate('/');
+  };
+
+  const userMenu = {
+    items: [
+      {
+        key: 'logout',
+        label: '退出登录',
+        icon: <LogoutOutlined />,
+        onClick: handleLogout
+      }
+    ]
+  };
 
   const items = [
     {
@@ -24,18 +55,18 @@ const Layout = ({ children }) => {
       label: 'AI 服务',
     },
     {
-      key: '/ar',
+      key: '/courses',
       icon: <EyeOutlined />,
-      label: 'AR 体验',
+      label: 'VC 课程',
     },
     {
-      key: 'more',
-      label: '...',
+      key: '/my-orders',
+      icon: <SearchOutlined />,
+      label: '我的订单',
     },
   ];
 
   const handleMenuClick = (key) => {
-    if (key === 'more') return;
     navigate(key);
     setMobileMenuOpen(false);
   };
@@ -97,7 +128,7 @@ const Layout = ({ children }) => {
           </motion.div>
 
           {/* Desktop Menu */}
-          <div className="desktop-menu" style={{ display: 'none', flex: 1 }}>
+          <div className="desktop-menu" style={{ display: 'none', flex: 1, justifyContent: 'flex-end', alignItems: 'center' }}>
             <Menu
               theme="dark"
               mode="horizontal"
@@ -109,13 +140,37 @@ const Layout = ({ children }) => {
                 borderBottom: 'none', 
                 display: 'flex', 
                 justifyContent: 'flex-end',
-                minWidth: '400px'
+                minWidth: '400px',
+                marginRight: '20px'
               }}
             />
+            
+            {user ? (
+              <div style={{ display: 'flex', alignItems: 'center', gap: 15 }}>
+                {/* 小程序图标状态 */}
+                <WechatOutlined 
+                  style={{ 
+                    fontSize: 24, 
+                    color: user.openid && !user.openid.startsWith('web_') ? '#07c160' : '#666',
+                    cursor: 'help'
+                  }} 
+                  title={user.openid && !user.openid.startsWith('web_') ? '已绑定微信小程序' : '未绑定微信小程序'}
+                />
+                
+                <Dropdown menu={userMenu}>
+                  <div style={{ display: 'flex', alignItems: 'center', cursor: 'pointer', color: '#fff' }}>
+                    <Avatar src={user.avatar_url} icon={<UserOutlined />} style={{ marginRight: 8 }} />
+                    <span>{user.nickname}</span>
+                  </div>
+                </Dropdown>
+              </div>
+            ) : (
+              <Button type="primary" onClick={() => setLoginVisible(true)}>登录</Button>
+            )}
           </div>
           <style>{`
             @media (min-width: 768px) {
-              .desktop-menu { display: block !important; }
+              .desktop-menu { display: flex !important; }
               .mobile-menu-btn { display: none !important; }
             }
           `}</style>
@@ -138,6 +193,17 @@ const Layout = ({ children }) => {
           open={mobileMenuOpen}
           styles={{ body: { padding: 0, background: '#111' }, header: { background: '#111', borderBottom: '1px solid #333' }, wrapper: { width: 250 } }}
         >
+          <div style={{ padding: '20px', textAlign: 'center', borderBottom: '1px solid #333' }}>
+            {user ? (
+               <div style={{ color: '#fff' }}>
+                 <Avatar src={user.avatar_url} icon={<UserOutlined />} size="large" style={{ marginBottom: 10 }} />
+                 <div>{user.nickname}</div>
+                 <Button type="link" danger onClick={handleLogout} style={{ marginTop: 10 }}>退出登录</Button>
+               </div>
+            ) : (
+              <Button type="primary" block onClick={() => { setLoginVisible(true); setMobileMenuOpen(false); }}>登录 / 注册</Button>
+            )}
+          </div>
           <Menu
             theme="dark"
             mode="vertical"
@@ -148,6 +214,12 @@ const Layout = ({ children }) => {
           />
         </Drawer>
 
+        <LoginModal 
+          visible={loginVisible} 
+          onClose={() => setLoginVisible(false)}
+          onLoginSuccess={(userData) => login(userData)}
+        />
+
         <Content style={{ marginTop: 72, padding: '40px 20px', overflowX: 'hidden' }}>
           <div style={{ 
             maxWidth: '1200px', 

frontend/src/components/LoginModal.jsx

@@ -0,0 +1,122 @@
+import React, { useState } from 'react';
+import { Modal, Form, Input, Button, message } from 'antd';
+import { UserOutlined, LockOutlined, MobileOutlined } from '@ant-design/icons';
+import { sendSms, phoneLogin } from '../api';
+
+const LoginModal = ({ visible, onClose, onLoginSuccess }) => {
+  const [form] = Form.useForm();
+  const [loading, setLoading] = useState(false);
+  const [countdown, setCountdown] = useState(0);
+
+  const handleSendCode = async () => {
+    try {
+      const phone = form.getFieldValue('phone_number');
+      if (!phone) {
+        message.error('请输入手机号');
+        return;
+      }
+      
+      // 简单的手机号校验
+      if (!/^1[3-9]\d{9}$/.test(phone)) {
+        message.error('请输入有效的手机号');
+        return;
+      }
+
+      await sendSms({ phone_number: phone });
+      message.success('验证码已发送');
+      
+      setCountdown(60);
+      const timer = setInterval(() => {
+        setCountdown((prev) => {
+          if (prev <= 1) {
+            clearInterval(timer);
+            return 0;
+          }
+          return prev - 1;
+        });
+      }, 1000);
+      
+    } catch (error) {
+      console.error(error);
+      message.error('发送失败: ' + (error.response?.data?.error || '网络错误'));
+    }
+  };
+
+  const handleSubmit = async (values) => {
+    setLoading(true);
+    try {
+      const res = await phoneLogin(values);
+      
+      message.success('登录成功');
+      onLoginSuccess(res.data);
+      onClose();
+    } catch (error) {
+      console.error(error);
+      message.error('登录失败: ' + (error.response?.data?.error || '网络错误'));
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <Modal
+      title="用户登录 / 注册"
+      open={visible}
+      onCancel={onClose}
+      footer={null}
+      destroyOnClose
+    >
+      <Form
+        form={form}
+        name="login_form"
+        onFinish={handleSubmit}
+        layout="vertical"
+        style={{ marginTop: 20 }}
+      >
+        <Form.Item
+          name="phone_number"
+          rules={[{ required: true, message: '请输入手机号' }]}
+        >
+          <Input 
+            prefix={<MobileOutlined />} 
+            placeholder="手机号码" 
+            size="large"
+          />
+        </Form.Item>
+
+        <Form.Item
+          name="code"
+          rules={[{ required: true, message: '请输入验证码' }]}
+        >
+          <div style={{ display: 'flex', gap: 10 }}>
+            <Input 
+              prefix={<LockOutlined />} 
+              placeholder="验证码" 
+              size="large"
+            />
+            <Button 
+              size="large" 
+              onClick={handleSendCode}
+              disabled={countdown > 0}
+            >
+              {countdown > 0 ? `${countdown}s` : '获取验证码'}
+            </Button>
+          </div>
+        </Form.Item>
+
+        <Form.Item>
+          <Button type="primary" htmlType="submit" block size="large" loading={loading}>
+            登录
+          </Button>
+        </Form.Item>
+        
+        <div style={{ textAlign: 'center', color: '#999', fontSize: 12 }}>
+          未注册的手机号验证后将自动创建账号<br/>
+          已在小程序绑定的手机号将自动同步身份
+        </div>
+      </Form>
+    </Modal>
+  );
+};
+
+export default LoginModal;

frontend/src/context/AuthContext.jsx

@@ -0,0 +1,49 @@
+import React, { createContext, useState, useEffect, useContext } from 'react';
+
+const AuthContext = createContext(null);
+
+export const AuthProvider = ({ children }) => {
+  const [user, setUser] = useState(null);
+  const [loading, setLoading] = useState(true);
+
+  useEffect(() => {
+    const storedUser = localStorage.getItem('user');
+    if (storedUser) {
+      try {
+        setUser(JSON.parse(storedUser));
+      } catch (e) {
+        console.error("Failed to parse user from storage", e);
+        localStorage.removeItem('user');
+      }
+    }
+    setLoading(false);
+  }, []);
+
+  const login = (userData) => {
+    setUser(userData);
+    localStorage.setItem('user', JSON.stringify(userData));
+    if (userData.token) {
+        localStorage.setItem('token', userData.token);
+    }
+  };
+
+  const logout = () => {
+    setUser(null);
+    localStorage.removeItem('user');
+    localStorage.removeItem('token');
+  };
+  
+  const updateUser = (data) => {
+      const newUser = { ...user, ...data };
+      setUser(newUser);
+      localStorage.setItem('user', JSON.stringify(newUser));
+  };
+
+  return (
+    <AuthContext.Provider value={{ user, login, logout, updateUser, loading }}>
+      {children}
+    </AuthContext.Provider>
+  );
+};
+
+export const useAuth = () => useContext(AuthContext);

frontend/src/pages/MyOrders.jsx

@@ -0,0 +1,284 @@
+import React, { useState, useEffect } from 'react';
+import { Form, Input, Button, Card, List, Tag, Typography, message, Space, Statistic, Divider, Modal, Descriptions } from 'antd';
+import { MobileOutlined, LockOutlined, SearchOutlined, CarOutlined, InboxOutlined, SafetyCertificateOutlined, CheckCircleOutlined, ClockCircleOutlined, CloseCircleOutlined, UserOutlined, EnvironmentOutlined, PhoneOutlined } from '@ant-design/icons';
+import { queryMyOrders } from '../api';
+import { motion } from 'framer-motion';
+import LoginModal from '../components/LoginModal';
+import { useAuth } from '../context/AuthContext';
+
+const { Title, Text, Paragraph } = Typography;
+
+const MyOrders = () => {
+  const [loading, setLoading] = useState(false);
+  const [orders, setOrders] = useState([]);
+  const [modalVisible, setModalVisible] = useState(false);
+  const [currentOrder, setCurrentOrder] = useState(null);
+  const [loginVisible, setLoginVisible] = useState(false);
+  
+  const { user, login } = useAuth();
+
+  useEffect(() => {
+    if (user) {
+      // 如果已登录，自动查询订单
+      if (user.phone_number) {
+        handleQueryOrders(user.phone_number);
+      }
+    } else {
+      // Don't auto-show login modal on mount if not logged in, just show the "Please login" UI
+      // setLoginVisible(true); 
+    }
+  }, [user]);
+
+  const showDetail = (order) => {
+    setCurrentOrder(order);
+    setModalVisible(true);
+  };
+
+  const handleQueryOrders = async (phone) => {
+    setLoading(true);
+    try {
+      // 使用 queryMyOrders 接口，这里我们需要调整该接口以支持仅传手机号（如果已登录）
+      // 或者，既然已登录，后端应该能通过 Token 知道是谁，直接查这个人的订单
+      // 但目前的 queryMyOrders 是 POST {phone_number, code}，这主要用于免登录查询
+      // 我们应该使用 OrderViewSet 的 list 方法，它已经支持 filter(wechat_user=user)
+      // 但前端 api.js 中 getOrder 是查单个，我们需要一个 getMyOrders 接口
+      
+      // 修改策略：如果已登录，直接调用 queryMyOrders，但不需要 code？
+      // 后端 my_orders 接口目前强制需要 code。
+      // 应该使用 OrderViewSet 的标准 list 接口，它会根据 Token 返回自己的订单。
+      // api.js 中没有导出 getOrders list 接口，我们可以临时用 queryMyOrders 但绕过 code 检查？
+      // 不，最好的方式是使用标准的 GET /orders/，后端 OrderViewSet.get_queryset 已经处理了 get_current_wechat_user
+      
+      // 让我们先用 GET /orders/ 试试，需要在 api.js 确认是否有 export
+      // 检查 api.js 发现没有 getOrderList， 只有 getOrder(id)
+      // 我们需要修改 api.js 或在此处直接调用
+      
+      // 为了不修改 api.js 太多，我们引入 axios 实例自己发请求，或者假设 api.js 有一个 getMyOrderList
+      // 实际上，查看 api.js， queryMyOrders 是 POST /orders/my_orders/，这是免登录版本
+      // 我们应该用 GET /orders/，因为 get_queryset 已经过滤了。
+      
+      // 临时引入 api 实例
+      const { default: api } = await import('../api');
+      const response = await api.get('/orders/');
+      setOrders(response.data);
+      if (response.data.length === 0) {
+        message.info('您暂时没有订单');
+      }
+    } catch (error) {
+      console.error(error);
+      message.error('查询出错');
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  const getStatusTag = (status) => {
+    switch (status) {
+      case 'paid': return <Tag icon={<CheckCircleOutlined />} color="success">已支付</Tag>;
+      case 'pending': return <Tag icon={<ClockCircleOutlined />} color="warning">待支付</Tag>;
+      case 'shipped': return <Tag icon={<CarOutlined />} color="processing">已发货</Tag>;
+      case 'cancelled': return <Tag icon={<CloseCircleOutlined />} color="default">已取消</Tag>;
+      default: return <Tag>{status}</Tag>;
+    }
+  };
+
+  return (
+    <div style={{ 
+      minHeight: '80vh', 
+      display: 'flex', 
+      alignItems: 'center', 
+      justifyContent: 'center',
+      padding: '20px'
+    }}>
+      <div style={{ width: '100%', maxWidth: 1200 }}>
+        <div style={{ textAlign: 'center', marginBottom: 40 }}>
+           <SafetyCertificateOutlined style={{ fontSize: 48, color: '#00b96b', marginBottom: 20 }} />
+           <Title level={2} style={{ color: '#fff', margin: 0, fontFamily: "'Orbitron', sans-serif" }}>我的订单</Title>
+           <Text style={{ color: '#666' }}>Secure Order Verification System</Text>
+        </div>
+      
+        {!user ? (
+           <div style={{ textAlign: 'center', padding: 40, background: 'rgba(0,0,0,0.5)', borderRadius: 16 }}>
+             <Text style={{ color: '#fff', fontSize: 18, display: 'block', marginBottom: 20 }}>请先登录以查看您的订单</Text>
+             <Button type="primary" size="large" onClick={() => setLoginVisible(true)}>立即登录</Button>
+           </div>
+        ) : (
+          <motion.div initial={{ opacity: 0 }} animate={{ opacity: 1 }}>
+            <div style={{ marginBottom: 20, textAlign: 'right', color: '#fff' }}>
+               当前登录用户: <span style={{ color: '#00b96b', fontWeight: 'bold', marginRight: 10 }}>{user.nickname}</span>
+               <Button 
+                 onClick={() => handleQueryOrders(user.phone_number)}
+                 loading={loading}
+                 icon={<SearchOutlined />}
+               >
+                 刷新订单
+               </Button>
+            </div>
+            
+            <List
+            grid={{ gutter: 24, xs: 1, sm: 1, md: 2, lg: 2, xl: 3, xxl: 3 }}
+            dataSource={orders}
+            loading={loading}
+            renderItem={order => (
+                <List.Item>
+                  <Card 
+                    hoverable
+                    onClick={() => showDetail(order)}
+                    title={<Space><span style={{ color: '#fff' }}>订单号: {order.id}</span> {getStatusTag(order.status)}</Space>}
+                    style={{ 
+                      background: 'rgba(0,0,0,0.6)', 
+                      border: '1px solid rgba(255,255,255,0.1)', 
+                      marginBottom: 10,
+                      backdropFilter: 'blur(10px)'
+                    }}
+                    headStyle={{ borderBottom: '1px solid rgba(255,255,255,0.1)' }}
+                    bodyStyle={{ padding: '20px' }}
+                  >
+                    <div style={{ color: '#ccc' }}>
+                      <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: 10 }}>
+                         <Text strong style={{ color: '#00b96b', fontSize: 16 }}>{order.total_price} 元</Text>
+                         <Text style={{ color: '#888' }}>{new Date(order.created_at).toLocaleString()}</Text>
+                      </div>
+                      
+                      <div style={{ background: 'rgba(255,255,255,0.05)', padding: 15, borderRadius: 8, marginBottom: 15 }}>
+                         <Space align="center" size="middle">
+                            {order.config_image ? (
+                                <img 
+                                    src={order.config_image} 
+                                    alt={order.config_name} 
+                                    style={{ width: 60, height: 60, objectFit: 'cover', borderRadius: 8, border: '1px solid rgba(255,255,255,0.1)' }} 
+                                />
+                            ) : (
+                                <div style={{ 
+                                    width: 60, 
+                                    height: 60, 
+                                    background: 'rgba(24,144,255,0.1)', 
+                                    borderRadius: 8, 
+                                    display: 'flex', 
+                                    alignItems: 'center', 
+                                    justifyContent: 'center',
+                                    border: '1px solid rgba(24,144,255,0.2)'
+                                }}>
+                                    <InboxOutlined style={{ fontSize: 24, color: '#1890ff' }} />
+                                </div>
+                            )}
+                            <div>
+                              <div style={{ color: '#fff', fontSize: 16, fontWeight: '500', marginBottom: 4 }}>{order.config_name || `商品 ID: ${order.config}`}</div>
+                              <div style={{ color: '#888' }}>数量: <span style={{ color: '#00b96b' }}>x{order.quantity}</span></div>
+                            </div>
+                         </Space>
+                      </div>
+
+                      {(order.courier_name || order.tracking_number) && (
+                        <div style={{ background: 'rgba(24,144,255,0.1)', padding: 15, borderRadius: 8, border: '1px solid rgba(24,144,255,0.3)' }}>
+                          <Space direction="vertical" style={{ width: '100%' }}>
+                             <Space>
+                               <CarOutlined style={{ color: '#1890ff', fontSize: 18 }} />
+                               <Text style={{ color: '#fff', fontSize: 16 }}>物流信息</Text>
+                             </Space>
+                             <Divider style={{ margin: '8px 0', borderColor: 'rgba(255,255,255,0.1)' }} />
+                             <div style={{ display: 'flex', justifyContent: 'space-between' }}>
+                                <span style={{ color: '#aaa' }}>快递公司:</span>
+                                <span style={{ color: '#fff' }}>{order.courier_name || '未知'}</span>
+                             </div>
+                             <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center' }}>
+                                <span style={{ color: '#aaa' }}>快递单号:</span>
+                                {order.tracking_number ? (
+                                    <div onClick={(e) => e.stopPropagation()}>
+                                        <Paragraph 
+                                            copyable={{ text: order.tracking_number, tooltips: ['复制', '已复制'] }} 
+                                            style={{ color: '#fff', fontFamily: 'monospace', fontSize: 16, margin: 0 }}
+                                        >
+                                            {order.tracking_number}
+                                        </Paragraph>
+                                    </div>
+                                ) : (
+                                    <span style={{ color: '#fff', fontFamily: 'monospace', fontSize: 16 }}>暂无单号</span>
+                                )}
+                             </div>
+                          </Space>
+                        </div>
+                      )}
+                    </div>
+                  </Card>
+                </List.Item>
+              )}
+              locale={{ emptyText: <div style={{ color: '#888', padding: 40, textAlign: 'center' }}>暂无订单信息</div> }}
+            />
+          </motion.div>
+        )}
+        
+        <Modal
+            title={<Title level={4} style={{ margin: 0 }}>订单详情</Title>}
+            open={modalVisible}
+            onCancel={() => setModalVisible(false)}
+            footer={[
+                <Button key="close" onClick={() => setModalVisible(false)}>
+                关闭
+                </Button>
+            ]}
+            width={600}
+            centered
+        >
+            {currentOrder && (
+                <Descriptions column={1} bordered size="middle" labelStyle={{ width: '140px', fontWeight: 'bold' }}>
+                    <Descriptions.Item label="订单号">
+                        <Paragraph copyable={{ text: currentOrder.id }} style={{ marginBottom: 0 }}>{currentOrder.id}</Paragraph>
+                    </Descriptions.Item>
+                    <Descriptions.Item label="商品名称">{currentOrder.config_name}</Descriptions.Item>
+                    <Descriptions.Item label="下单时间">{new Date(currentOrder.created_at).toLocaleString()}</Descriptions.Item>
+                    <Descriptions.Item label="状态更新时间">{new Date(currentOrder.updated_at).toLocaleString()}</Descriptions.Item>
+                    <Descriptions.Item label="当前状态">{getStatusTag(currentOrder.status)}</Descriptions.Item>
+                    <Descriptions.Item label="订单总价">
+                        <Text strong style={{ color: '#00b96b' }}>¥{currentOrder.total_price}</Text>
+                    </Descriptions.Item>
+                    
+                    <Descriptions.Item label="收件人信息">
+                        <Space direction="vertical" size={0}>
+                            <Space><UserOutlined /> {currentOrder.customer_name}</Space>
+                            <Space><PhoneOutlined /> {currentOrder.phone_number}</Space>
+                            <Space align="start"><EnvironmentOutlined /> {currentOrder.shipping_address}</Space>
+                        </Space>
+                    </Descriptions.Item>
+                    
+                    {currentOrder.salesperson_name && (
+                        <Descriptions.Item label="订单推荐员">
+                            <Space>
+                                {currentOrder.salesperson_name} 
+                                {currentOrder.salesperson_code && <Tag color="blue">{currentOrder.salesperson_code}</Tag>}
+                            </Space>
+                        </Descriptions.Item>
+                    )}
+
+                    {(currentOrder.status === 'shipped' || currentOrder.courier_name) && (
+                        <>
+                            <Descriptions.Item label="快递公司">{currentOrder.courier_name || '未知'}</Descriptions.Item>
+                            <Descriptions.Item label="快递单号">
+                                {currentOrder.tracking_number ? (
+                                    <Paragraph copyable={{ text: currentOrder.tracking_number }} style={{ marginBottom: 0 }}>
+                                        {currentOrder.tracking_number}
+                                    </Paragraph>
+                                ) : '暂无单号'}
+                            </Descriptions.Item>
+                        </>
+                    )}
+                </Descriptions>
+            )}
+        </Modal>
+
+        <LoginModal 
+          visible={loginVisible} 
+          onClose={() => setLoginVisible(false)}
+          onLoginSuccess={(userData) => {
+            login(userData);
+            if (userData.phone_number) {
+               handleQueryOrders(userData.phone_number);
+            }
+          }}
+        />
+      </div>
+    </div>
+  );
+};
+
+export default MyOrders;

frontend/src/pages/ProductDetail.jsx

@@ -1,9 +1,10 @@
 import React, { useEffect, useState } from 'react';
 import { useParams, useNavigate, useSearchParams } from 'react-router-dom';
-import { Button, Row, Col, Tag, Statistic, Modal, Form, Input, InputNumber, message, Spin, Descriptions, Radio } from 'antd';
+import { Button, Row, Col, Tag, Statistic, Modal, Form, Input, InputNumber, message, Spin, Descriptions, Radio, Alert } from 'antd';
 import { ShoppingCartOutlined, SafetyCertificateOutlined, ThunderboltOutlined, EyeOutlined, StarOutlined } from '@ant-design/icons';
 import { getConfigs, createOrder, nativePay } from '../api';
 import ModelViewer from '../components/ModelViewer';
+import { useAuth } from '../context/AuthContext';
 import './ProductDetail.css';
 
 const ProductDetail = () => {
@@ -16,7 +17,25 @@ const ProductDetail = () => {
   const [submitting, setSubmitting] = useState(false);
   const [form] = Form.useForm();
   
-  const refCode = searchParams.get('ref') || 'flw666';
+  const { user } = useAuth();
+
+  // 优先从 URL 获取，如果没有则从 localStorage 获取，不再默认绑定 flw666
+  const refCode = searchParams.get('ref') || localStorage.getItem('ref_code');
+
+  useEffect(() => {
+    // 自动填充用户信息
+    if (user) {
+        form.setFieldsValue({
+            phone_number: user.phone_number,
+            // 如果后端返回了地址信息，这里也可以填充
+            // shipping_address: user.shipping_address 
+        });
+    }
+  }, [isModalOpen, user]); // 当弹窗打开或用户状态变化时填充
+
+  useEffect(() => {
+    console.log('[ProductDetail] Current ref_code:', refCode);
+  }, [refCode]);
 
   useEffect(() => {
     fetchProduct();
@@ -146,12 +165,28 @@ const ProductDetail = () => {
             {product.has_microphone && <Tag color="purple" style={{ background: 'rgba(114,46,209,0.1)', border: '1px solid #722ed1', padding: '4px 12px', fontSize: '14px', margin: 0 }}>阵列麦克风</Tag>}
           </div>
 
-          <div style={{ display: 'flex', alignItems: 'flex-end', gap: 20, marginBottom: 40 }}>
+          <div style={{ display: 'flex', alignItems: 'flex-end', gap: 20, marginBottom: 20 }}>
              <Statistic title="售价" value={product.price} prefix="¥" valueStyle={{ color: '#00b96b', fontSize: 36 }} titleStyle={{ color: '#888' }} />
+             <Statistic title="库存" value={product.stock} suffix="件" valueStyle={{ color: product.stock < 5 ? '#ff4d4f' : '#fff', fontSize: 20 }} titleStyle={{ color: '#888' }} />
           </div>
 
-          <Button type="primary" size="large" icon={<ShoppingCartOutlined />} onClick={() => setIsModalOpen(true)} style={{ height: 50, padding: '0 40px', fontSize: 18 }}>
-            立即购买
+          {product.stock < 5 && product.stock > 0 && (
+            <Alert message={`库存紧张，仅剩 ${product.stock} 件！`} type="warning" showIcon style={{ marginBottom: 20, background: 'rgba(250, 173, 20, 0.1)', border: '1px solid #faad14', color: '#faad14' }} />
+          )}
+
+          {product.stock === 0 && (
+             <Alert message="该商品暂时缺货" type="error" showIcon style={{ marginBottom: 20 }} />
+          )}
+
+          <Button 
+            type="primary" 
+            size="large" 
+            icon={<ShoppingCartOutlined />} 
+            onClick={() => setIsModalOpen(true)} 
+            disabled={product.stock === 0}
+            style={{ height: 50, padding: '0 40px', fontSize: 18 }}
+          >
+            {product.stock === 0 ? '暂时缺货' : '立即购买'}
           </Button>
         </Col>
       </Row>

frontend/src/pages/ServiceDetail.jsx

@@ -16,8 +16,13 @@ const ServiceDetail = () => {
   const [isModalOpen, setIsModalOpen] = useState(false);
   const [submitting, setSubmitting] = useState(false);
   const [form] = Form.useForm();
+  
+  // 优先从 URL 获取，如果没有则从 localStorage 获取
+  const refCode = searchParams.get('ref') || localStorage.getItem('ref_code');
 
-  const refCode = searchParams.get('ref') || 'flw666';
+  useEffect(() => {
+    console.log('[ServiceDetail] Current ref_code:', refCode);
+  }, [refCode]);
 
   useEffect(() => {
     const fetchDetail = async () => {

frontend/src/pages/VCCourseDetail.jsx

@@ -0,0 +1,285 @@
+import React, { useEffect, useState } from 'react';
+import { useParams, useNavigate, useSearchParams } from 'react-router-dom';
+import { Typography, Button, Spin, Empty, Descriptions, Tag, Row, Col, Modal, Form, Input, message } from 'antd';
+import { ArrowLeftOutlined, ClockCircleOutlined, UserOutlined, BookOutlined, FormOutlined } from '@ant-design/icons';
+import { getVCCourseDetail, createOrder } from '../api';
+import { motion } from 'framer-motion';
+
+const { Title, Paragraph } = Typography;
+
+const VCCourseDetail = () => {
+  const { id } = useParams();
+  const navigate = useNavigate();
+  const [searchParams] = useSearchParams();
+  const [course, setCourse] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [isModalOpen, setIsModalOpen] = useState(false);
+  const [submitting, setSubmitting] = useState(false);
+  const [form] = Form.useForm();
+  
+  // 优先从 URL 获取，如果没有则从 localStorage 获取
+  const refCode = searchParams.get('ref') || localStorage.getItem('ref_code');
+
+  useEffect(() => {
+    const fetchDetail = async () => {
+      try {
+        const response = await getVCCourseDetail(id);
+        setCourse(response.data);
+      } catch (error) {
+        console.error("Failed to fetch course detail:", error);
+      } finally {
+        setLoading(false);
+      }
+    };
+    fetchDetail();
+  }, [id]);
+
+  const handleEnroll = async (values) => {
+      setSubmitting(true);
+      try {
+          const orderData = {
+              course: course.id,
+              customer_name: values.customer_name,
+              phone_number: values.phone_number,
+              ref_code: refCode,
+              quantity: 1,
+              // 将其他信息放入收货地址字段中
+              shipping_address: `[课程报名] 微信号: ${values.wechat_id || '无'}, 邮箱: ${values.email || '无'}, 备注: ${values.message || '无'}`
+          };
+          
+          await createOrder(orderData);
+          message.success('报名咨询已提交，我们的课程顾问将尽快与您联系！');
+          setIsModalOpen(false);
+      } catch (error) {
+          console.error(error);
+          message.error('提交失败，请重试');
+      } finally {
+          setSubmitting(false);
+      }
+  };
+
+  if (loading) {
+    return (
+        <div style={{ textAlign: 'center', padding: '100px 0' }}>
+            <Spin size="large" tip="Loading..." />
+        </div>
+    );
+  }
+
+  if (!course) {
+    return (
+        <div style={{ textAlign: 'center', padding: '100px 0' }}>
+            <Empty description="Course not found" />
+            <Button type="primary" onClick={() => navigate('/courses')} style={{ marginTop: 20 }}>
+                Return to Courses
+            </Button>
+        </div>
+    );
+  }
+
+  return (
+    <div style={{ padding: '20px 0', minHeight: '80vh' }}>
+      <Button 
+        type="text" 
+        icon={<ArrowLeftOutlined />} 
+        style={{ color: '#fff', marginBottom: 20 }}
+        onClick={() => navigate('/courses')}
+      >
+        返回课程列表
+      </Button>
+
+      <motion.div
+        initial={{ opacity: 0, y: 20 }}
+        animate={{ opacity: 1, y: 0 }}
+        transition={{ duration: 0.5 }}
+      >
+        <Row gutter={[40, 40]}>
+            <Col xs={24} md={16}>
+                <div style={{ textAlign: 'left', marginBottom: 40 }}>
+                    <div style={{ display: 'flex', gap: '10px', marginBottom: 10 }}>
+                        {course.tag && <Tag color="volcano">{course.tag}</Tag>}
+                        <Tag color={course.course_type === 'hardware' ? 'purple' : 'cyan'}>
+                            {course.course_type_display || (course.course_type === 'hardware' ? '硬件课程' : '软件课程')}
+                        </Tag>
+                    </div>
+                    <Title level={1} style={{ color: '#fff', marginTop: 0 }}>
+                        {course.title}
+                    </Title>
+                    <Paragraph style={{ color: '#888', fontSize: 18 }}>
+                        {course.description}
+                    </Paragraph>
+                    
+                    <div style={{ 
+                        marginTop: 30, 
+                        background: 'rgba(255,255,255,0.03)', 
+                        padding: '24px', 
+                        borderRadius: 16, 
+                        border: '1px solid rgba(255,255,255,0.08)',
+                        backdropFilter: 'blur(10px)',
+                        boxShadow: '0 8px 32px rgba(0,0,0,0.2)'
+                    }}>
+                        <Title level={4} style={{ color: '#fff', marginBottom: 20, display: 'flex', alignItems: 'center' }}>
+                            <div style={{ width: 4, height: 18, background: '#00f0ff', marginRight: 10, borderRadius: 2 }} />
+                            课程信息
+                        </Title>
+                        <Descriptions 
+                            column={{ xs: 1, sm: 2, md: 3 }} 
+                            labelStyle={{ color: '#888', fontWeight: 'normal' }} 
+                            contentStyle={{ color: '#fff', fontWeight: '500' }}
+                        >
+                            <Descriptions.Item label={<span style={{ display: 'flex', alignItems: 'center' }}><UserOutlined style={{ marginRight: 8, color: '#00f0ff' }} /> 讲师</span>}>
+                                <div style={{ display: 'flex', alignItems: 'center' }}>
+                                    {course.instructor_avatar_url && (
+                                        <img src={course.instructor_avatar_url} alt="avatar" style={{ width: 24, height: 24, borderRadius: '50%', marginRight: 8, objectFit: 'cover' }} />
+                                    )}
+                                    <span>{course.instructor}</span>
+                                    {course.instructor_title && (
+                                        <span style={{ 
+                                            fontSize: 12, 
+                                            background: 'rgba(0, 240, 255, 0.1)', 
+                                            color: '#00f0ff', 
+                                            padding: '2px 6px', 
+                                            borderRadius: 4, 
+                                            marginLeft: 8 
+                                        }}>
+                                            {course.instructor_title}
+                                        </span>
+                                    )}
+                                </div>
+                            </Descriptions.Item>
+                            <Descriptions.Item label={<span style={{ display: 'flex', alignItems: 'center' }}><ClockCircleOutlined style={{ marginRight: 8, color: '#00f0ff' }} /> 时长</span>}>
+                                {course.duration}
+                            </Descriptions.Item>
+                            <Descriptions.Item label={<span style={{ display: 'flex', alignItems: 'center' }}><BookOutlined style={{ marginRight: 8, color: '#00f0ff' }} /> 课时</span>}>
+                                {course.lesson_count} 课时
+                            </Descriptions.Item>
+                        </Descriptions>
+                        
+                        {/* 讲师简介 */}
+                        {course.instructor_desc && (
+                             <div style={{ marginTop: 20, paddingTop: 20, borderTop: '1px solid rgba(255,255,255,0.05)', color: '#aaa', fontSize: 14 }}>
+                                 <span style={{ color: '#666', marginRight: 10 }}>讲师简介:</span>
+                                 {course.instructor_desc}
+                             </div>
+                        )}
+                    </div>
+
+                    {/* 课程详细内容区域 */}
+                    {course.content && (
+                        <div style={{ marginTop: 40 }}>
+                             <Title level={3} style={{ color: '#fff', marginBottom: 20 }}>课程大纲与详情</Title>
+                             <div style={{ color: '#ccc', lineHeight: '1.8', fontSize: '16px', whiteSpace: 'pre-line' }}>
+                                 {course.content}
+                             </div>
+                        </div>
+                    )}
+                </div>
+
+                {course.display_detail_image ? (
+                    <div style={{ 
+                        width: '100%', 
+                        maxWidth: '900px',
+                        margin: '40px auto 0',
+                        background: '#111', 
+                        borderRadius: 12, 
+                        overflow: 'hidden',
+                        boxShadow: `0 10px 40px rgba(0, 240, 255, 0.1)`,
+                        border: `1px solid rgba(0, 240, 255, 0.2)`
+                    }}>
+                        <img 
+                            src={course.display_detail_image} 
+                            alt={course.title} 
+                            style={{ width: '100%', display: 'block', height: 'auto' }} 
+                        />
+                    </div>
+                ) : null}
+            </Col>
+            
+            <Col xs={24} md={8}>
+                <div style={{ position: 'sticky', top: 100 }}>
+                    <div style={{ 
+                        background: '#1f1f1f', 
+                        padding: 30, 
+                        borderRadius: 16, 
+                        border: `1px solid rgba(0, 240, 255, 0.2)`,
+                        boxShadow: `0 0 20px rgba(0, 240, 255, 0.05)`
+                    }}>
+                        <Title level={3} style={{ color: '#fff', marginTop: 0 }}>报名咨询</Title>
+                        
+                        <div style={{ display: 'flex', alignItems: 'baseline', marginBottom: 20 }}>
+                            {parseFloat(course.price) > 0 ? (
+                                <>
+                                    <span style={{ fontSize: 36, color: '#00f0ff', fontWeight: 'bold' }}>¥{course.price}</span>
+                                </>
+                            ) : (
+                                <span style={{ fontSize: 36, color: '#00f0ff', fontWeight: 'bold' }}>免费咨询</span>
+                            )}
+                        </div>
+
+                        <Button 
+                            type="primary" 
+                            size="large" 
+                            block 
+                            icon={<FormOutlined />}
+                            style={{ 
+                                height: 50, 
+                                background: '#00f0ff', 
+                                borderColor: '#00f0ff',
+                                color: '#000',
+                                fontWeight: 'bold',
+                                fontSize: '16px'
+                            }}
+                            onClick={() => setIsModalOpen(true)}
+                        >
+                            立即报名 / 咨询
+                        </Button>
+                        <p style={{ color: '#666', marginTop: 15, fontSize: 12, textAlign: 'center' }}>
+                            * 提交后我们的顾问将尽快与您联系确认
+                        </p>
+                    </div>
+                </div>
+            </Col>
+        </Row>
+      </motion.div>
+
+      {/* Enroll Modal */}
+      <Modal
+        title={`报名/咨询 - ${course.title}`}
+        open={isModalOpen}
+        onCancel={() => setIsModalOpen(false)}
+        footer={null}
+        destroyOnHidden
+      >
+        <p style={{ marginBottom: 20, color: '#666' }}>请填写您的联系方式，我们将为您安排课程顾问。</p>
+        <Form
+          form={form}
+          layout="vertical"
+          onFinish={handleEnroll}
+        >
+          <Form.Item label="您的姓名" name="customer_name" rules={[{ required: true, message: '请输入姓名' }]}>
+            <Input placeholder="例如：李同学" />
+          </Form.Item>
+          <Form.Item label="联系电话" name="phone_number" rules={[{ required: true, message: '请输入电话' }]}>
+            <Input placeholder="13800000000" />
+          </Form.Item>
+          <Form.Item label="微信号" name="wechat_id">
+            <Input placeholder="选填，方便微信沟通" />
+          </Form.Item>
+          <Form.Item label="电子邮箱" name="email" rules={[{ type: 'email' }]}>
+            <Input placeholder="example@email.com" />
+          </Form.Item>
+          <Form.Item label="备注/留言" name="message">
+            <Input.TextArea rows={4} placeholder="您想了解的任何问题..." />
+          </Form.Item>
+          
+          <div style={{ display: 'flex', justifyContent: 'flex-end', gap: 10, marginTop: 20 }}>
+            <Button onClick={() => setIsModalOpen(false)}>取消</Button>
+            <Button type="primary" htmlType="submit" loading={submitting}>提交报名</Button>
+          </div>
+        </Form>
+      </Modal>
+    </div>
+  );
+};
+
+export default VCCourseDetail;

frontend/src/pages/VCCourses.jsx

@@ -1,28 +1,29 @@
 import React, { useState, useEffect } from 'react';
+import { useNavigate } from 'react-router-dom';
 import { motion } from 'framer-motion';
-import { Button, Typography, Spin, Row, Col, Empty } from 'antd';
-import { ScanOutlined } from '@ant-design/icons';
-import { getARServices } from '../api';
+import { Button, Typography, Spin, Row, Col, Empty, Tag } from 'antd';
+import { ReadOutlined, ClockCircleOutlined, UserOutlined, BookOutlined } from '@ant-design/icons';
+import { getVCCourses } from '../api';
 
 const { Title, Paragraph } = Typography;
 
-const ARExperience = () => {
-  const [scanning, setScanning] = useState(true);
-  const [arServices, setArServices] = useState([]);
+const VCCourses = () => {
+  const [courses, setCourses] = useState([]);
   const [loading, setLoading] = useState(true);
+  const navigate = useNavigate();
 
   useEffect(() => {
-    const fetchAR = async () => {
+    const fetchCourses = async () => {
         try {
-            const res = await getARServices();
-            setArServices(res.data);
+            const res = await getVCCourses();
+            setCourses(res.data);
         } catch (error) {
-            console.error("Failed to fetch AR services:", error);
+            console.error("Failed to fetch VC Courses:", error);
         } finally {
             setLoading(false);
         }
     }
-    fetchAR();
+    fetchCourses();
   }, []);
 
   if (loading) return <div style={{ textAlign: 'center', padding: 100 }}><Spin size="large" /></div>;
@@ -31,46 +32,63 @@ const ARExperience = () => {
     <div style={{ padding: '40px 0', minHeight: '80vh', position: 'relative' }}>
         <div style={{ textAlign: 'center', marginBottom: 60, position: 'relative', zIndex: 2 }}>
             <Title level={1} style={{ color: '#fff', letterSpacing: 4 }}>
-                AR <span style={{ color: '#00f0ff' }}>UNIVERSE</span>
+                VC <span style={{ color: '#00f0ff' }}>CODING COURSES</span>
             </Title>
             <Paragraph style={{ color: '#aaa', fontSize: 18, maxWidth: 600, margin: '0 auto' }}>
-                探索全息增强现实体验。请佩戴您的设备，或使用移动端摄像头扫描空间。
+                探索 VB Coding 软件与硬件课程，开启您的编程之旅。
             </Paragraph>
         </div>
 
-        {arServices.length === 0 ? (
+        {courses.length === 0 ? (
             <div style={{ textAlign: 'center', marginTop: 100, zIndex: 2, position: 'relative' }}>
-                <Empty description={<span style={{ color: '#666' }}>暂无 AR 体验内容</span>} />
+                <Empty description={<span style={{ color: '#666' }}>暂无课程内容</span>} />
             </div>
         ) : (
             <Row gutter={[32, 32]} justify="center" style={{ padding: '0 20px', position: 'relative', zIndex: 2 }}>
-                {arServices.map((item, index) => (
+                {courses.map((item, index) => (
                     <Col xs={24} md={12} lg={8} key={item.id}>
                         <motion.div
                             initial={{ opacity: 0, y: 30 }}
                             animate={{ opacity: 1, y: 0 }}
                             transition={{ delay: index * 0.1 }}
                             whileHover={{ scale: 1.02 }}
+                            onClick={() => navigate(`/courses/${item.id}`)}
+                            style={{ cursor: 'pointer' }}
                         >
                             <div style={{ 
                                 background: 'rgba(255,255,255,0.05)', 
                                 border: '1px solid rgba(0,240,255,0.2)',
                                 borderRadius: 12,
                                 overflow: 'hidden',
-                                height: '100%'
+                                height: '100%',
+                                display: 'flex',
+                                flexDirection: 'column'
                             }}>
-                                <div style={{ height: 200, background: '#000', overflow: 'hidden', display: 'flex', alignItems: 'center', justifyContent: 'center' }}>
+                                <div style={{ height: 200, background: '#000', overflow: 'hidden', display: 'flex', alignItems: 'center', justifyContent: 'center', position: 'relative' }}>
                                     {item.display_cover_image ? (
                                         <img src={item.display_cover_image} alt={item.title} style={{ width: '100%', height: '100%', objectFit: 'cover' }} />
                                     ) : (
-                                        <ScanOutlined style={{ fontSize: 40, color: '#333' }} />
+                                        <ReadOutlined style={{ fontSize: 40, color: '#333' }} />
                                     )}
+                                    <div style={{ position: 'absolute', top: 10, right: 10, display: 'flex', gap: '5px' }}>
+                                        {item.tag && (
+                                            <Tag color="volcano" style={{ marginRight: 0 }}>{item.tag}</Tag>
+                                        )}
+                                        <Tag color={item.course_type === 'hardware' ? 'purple' : 'cyan'}>
+                                            {item.course_type_display || (item.course_type === 'hardware' ? '硬件课程' : '软件课程')}
+                                        </Tag>
+                                    </div>
                                 </div>
-                                <div style={{ padding: 20 }}>
-                                    <h3 style={{ color: '#fff', fontSize: 20 }}>{item.title}</h3>
-                                    <p style={{ color: '#888', marginBottom: 20, minHeight: 44 }}>{item.description}</p>
+                                <div style={{ padding: 20, flex: 1, display: 'flex', flexDirection: 'column' }}>
+                                    <h3 style={{ color: '#fff', fontSize: 20, marginBottom: 10 }}>{item.title}</h3>
+                                    <div style={{ color: '#888', marginBottom: 15, fontSize: 14 }}>
+                                        <span style={{ marginRight: 15 }}><UserOutlined /> {item.instructor}</span>
+                                        <span style={{ marginRight: 15 }}><ClockCircleOutlined /> {item.duration}</span>
+                                        <span><BookOutlined /> {item.lesson_count} 课时</span>
+                                    </div>
+                                    <p style={{ color: '#aaa', marginBottom: 20, flex: 1 }}>{item.description}</p>
                                     <Button type="primary" block ghost style={{ borderColor: '#00f0ff', color: '#00f0ff' }}>
-                                        启动体验
+                                        开始学习
                                     </Button>
                                 </div>
                             </div>
@@ -108,4 +126,4 @@ const ARExperience = () => {
   );
 };
 
-export default ARExperience;
+export default VCCourses;

miniprogram/API.md

@@ -0,0 +1,37 @@
+# Mini Program API Documentation
+
+## Authentication
+### Login
+- **URL**: `/api/wechat/login/`
+- **Method**: `POST`
+- **Body**: `{ "code": "wx_login_code" }`
+- **Response**: `{ "token": "...", "openid": "..." }`
+
+### Update User Info
+- **URL**: `/api/wechat/update/`
+- **Method**: `POST`
+- **Header**: `Authorization: Bearer <token>`
+- **Body**: `{ "nickname": "...", "avatar_url": "..." }`
+
+## Distributor
+### Register
+- **URL**: `/api/distributor/register/`
+- **Method**: `POST`
+- **Body**: `{ "invite_code": "optional" }`
+
+### Info
+- **URL**: `/api/distributor/info/`
+- **Method**: `GET`
+- **Response**: `{ "level": 1, "commission_rate": 0.1, ... }`
+
+### Withdraw
+- **URL**: `/api/distributor/withdraw/`
+- **Method**: `POST`
+- **Body**: `{ "amount": 100 }`
+
+## Orders & Payment
+### Prepay (Mini Program)
+- **URL**: `/api/orders/{id}/prepay_miniprogram/`
+- **Method**: `POST`
+- **Response**: `{ "timeStamp": "...", "nonceStr": "...", "package": "...", "paySign": "..." }`
+- **Use with**: `wx.requestPayment`

miniprogram/DEPLOY.md

@@ -0,0 +1,16 @@
+# Deployment Guide
+
+## Backend (Django)
+1. **Migrations**: Run `python manage.py migrate shop` to create `WeChatUser`, `Distributor` tables.
+2. **Config**: Ensure `WeChatPayConfig` is active in Admin Panel with correct `AppID`, `MchID`, `APIv3 Key`, and `Certificates`.
+3. **Domain**: Add `https://market.quant-speed.com` to WeChat Admin -> Development Settings -> Server Domain.
+
+## Frontend (Taro Mini Program)
+1. **Install**: `npm install` in `market_page/miniprogram`.
+2. **Build**: `npm run build:weapp`.
+3. **Upload**: Open `dist/` in WeChat Developer Tools.
+4. **AppID**: Ensure `project.config.json` has the correct AppID.
+
+## WeChat Admin Configuration
+1. **Request Domain**: Add `https://market.quant-speed.com`.
+2. **Payment**: Link the Mini Program AppID to the Merchant ID in WeChat Pay Platform.

miniprogram/README.md

@@ -0,0 +1,86 @@
+# Market Miniprogram
+
+Taro + React + TypeScript 微信小程序项目，对接 Django 后端，支持 AI 服务、AR 体验、硬件商品购买及分销功能。
+
+## 目录结构
+
+- `src/pages`: 主包页面 (首页、商品、订单、AI服务、AR体验)
+- `src/subpackages`: 分包页面 (分销中心)
+- `src/api`: API 定义
+- `src/utils`: 工具函数
+- `src/assets`: 静态资源
+
+## 技术栈
+
+- **框架**: Taro 3.6 (React)
+- **语言**: TypeScript
+- **样式**: SCSS
+- **UI**: Taro UI / Ant Design (Design Reference)
+- **后端**: Django REST Framework
+
+## 快速开始
+
+### 1. 环境准备
+
+确保已安装 Node.js (>=16) 和 npm。
+
+### 2. 安装依赖
+
+```bash
+npm install --legacy-peer-deps
+```
+
+### 3. 配置环境
+
+复制 `.env` 模板并配置后端地址：
+
+```bash
+# .env
+TARO_APP_API_URL=http://localhost:8000/api
+```
+
+### 4. 启动开发
+
+```bash
+# 微信小程序开发
+npm run dev:weapp
+```
+
+启动后打开 **微信开发者工具**，导入 `dist` 目录即可预览。
+
+## 功能列表
+
+1.  **商品交易**: 浏览 ESP32 硬件配置，下单购买，微信支付。
+2.  **AI 服务**: 浏览 AI 解决方案，提交定制需求。
+3.  **AR 体验**: 展示 AR 案例，模拟启动体验。
+4.  **分销中心**: 申请成为分销员，生成推广码，查看收益，申请提现。
+
+## 测试指南
+
+### 支付测试
+- 确保后端 `WeChatPayConfig` 已配置有效的沙箱或正式参数。
+- 在小程序中下单后，点击支付将调用 `wx.requestPayment`。
+- 本地开发需确保手机与电脑在同一局域网，并将后端地址改为局域网 IP。
+
+### 分销测试
+1.  进入 "我的" -> "分销中心"。
+2.  点击 "立即申请" (后端自动通过或需审核)。
+3.  进入分销中心，点击 "推广二维码" 获取小程序码。
+4.  模拟下单：在其他账号下单时填写 `ref_code` (或通过带参二维码进入)。
+5.  查看收益：订单支付后，分销中心自动更新余额。
+
+## 常见问题
+
+**Q: 依赖安装失败？**
+A: 使用 `npm install --legacy-peer-deps` 忽略版本冲突。
+
+**Q: 接口请求 404/Network Error？**
+A: 检查 `.env` 中的 `TARO_APP_API_URL` 是否正确，真机调试时请勿使用 `localhost`，应使用本机局域网 IP (如 `192.168.1.x`)，并确保手机能访问该 IP。
+
+## 贡献指南
+
+1.  Fork 本仓库
+2.  新建特性分支 `git checkout -b feature/AmazingFeature`
+3.  提交修改 `git commit -m 'Add some AmazingFeature'`
+4.  推送到分支 `git push origin feature/AmazingFeature`
+5.  提交 Pull Request

miniprogram/babel.config.js

@@ -0,0 +1,9 @@
+// babel.config.js
+module.exports = {
+  presets: [
+    ['taro', {
+      framework: 'react',
+      ts: true
+    }]
+  ]
+}

miniprogram/config/dev.js

@@ -0,0 +1,9 @@
+module.exports = {
+  env: {
+    NODE_ENV: '"development"'
+  },
+  defineConstants: {
+  },
+  mini: {},
+  h5: {}
+}

miniprogram/config/index.js

@@ -0,0 +1,75 @@
+const config = {
+  projectName: 'market-miniprogram',
+  date: '2023-10-27',
+  designWidth: 750,
+  deviceRatio: {
+    640: 2.34 / 2,
+    750: 1,
+    828: 1.81 / 2
+  },
+  sourceRoot: 'src',
+  outputRoot: 'dist',
+  plugins: [],
+  defineConstants: {
+  },
+  copy: {
+    patterns: [
+      { from: 'src/assets', to: 'dist/assets' }
+    ],
+    options: {
+    }
+  },
+  framework: 'react',
+  compiler: 'webpack5',
+  cache: {
+    enable: true // Enable cache for better build performance
+  },
+  mini: {
+    postcss: {
+      pxtransform: {
+        enable: true,
+        config: {
+
+        }
+      },
+      url: {
+        enable: true,
+        config: {
+          limit: 1024 // 设定转换尺寸上限
+        }
+      },
+      cssModules: {
+        enable: false, // 默认为 false，如需使用 css modules 功能，则设为 true
+        config: {
+          namingPattern: 'module', // 转换模式，取值为 global/module
+          generateScopedName: '[name]__[local]___[hash:base64:5]'
+        }
+      }
+    }
+  },
+  h5: {
+    publicPath: '/',
+    staticDirectory: 'static',
+    postcss: {
+      autoprefixer: {
+        enable: true,
+        config: {
+        }
+      },
+      cssModules: {
+        enable: false, // 默认为 false，如需使用 css modules 功能，则设为 true
+        config: {
+          namingPattern: 'module', // 转换模式，取值为 global/module
+          generateScopedName: '[name]__[local]___[hash:base64:5]'
+        }
+      }
+    }
+  }
+}
+
+module.exports = function (merge) {
+  if (process.env.NODE_ENV === 'development') {
+    return merge({}, config, require('./dev'))
+  }
+  return merge({}, config, require('./prod'))
+}

miniprogram/config/prod.js

@@ -0,0 +1,18 @@
+module.exports = {
+  env: {
+    NODE_ENV: '"production"'
+  },
+  defineConstants: {
+  },
+  mini: {},
+  h5: {
+    /**
+     * 如果h5端编译后体积过大，可以使用webpack-bundle-analyzer插件对打包体积进行分析。
+     * 参考代码如下：
+     * webpackChain (chain) {
+     *   chain.plugin('analyzer')
+     *     .use(require('webpack-bundle-analyzer').BundleAnalyzerPlugin, [])
+     * }
+     */
+  }
+}

miniprogram/e2e/home.spec.js

@@ -0,0 +1,22 @@
+const automator = require('miniprogram-automator')
+
+describe('Home Page', () => {
+  let miniProgram
+
+  beforeAll(async () => {
+    miniProgram = await automator.launch({
+      projectPath: '../' // Relative path to miniprogram root
+    })
+  }, 30000)
+
+  afterAll(async () => {
+    await miniProgram.close()
+  })
+
+  it('should render title', async () => {
+    const page = await miniProgram.reLaunch('/pages/index/index')
+    await page.waitFor(2000)
+    const element = await page.$('.title-text')
+    expect(await element.text()).toContain('未来已来') // Assuming typed text starts or contains this
+  })
+})

miniprogram/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "market-miniprogram",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Quant Speed Market Mini Program",
+  "templateInfo": {
+    "name": "default-ts",
+    "typescript": true,
+    "css": "sass"
+  },
+  "scripts": {
+    "build:weapp": "taro build --type weapp",
+    "build:swan": "taro build --type swan",
+    "build:alipay": "taro build --type alipay",
+    "build:tt": "taro build --type tt",
+    "build:h5": "taro build --type h5",
+    "build:rn": "taro build --type rn",
+    "build:qq": "taro build --type qq",
+    "build:quickapp": "taro build --type quickapp",
+    "dev:weapp": "npm run build:weapp -- --watch",
+    "dev:swan": "npm run build:swan -- --watch",
+    "dev:alipay": "npm run build:alipay -- --watch",
+    "dev:tt": "npm run build:tt -- --watch",
+    "dev:h5": "npm run build:h5 -- --watch",
+    "dev:rn": "npm run build:rn -- --watch",
+    "dev:qq": "npm run build:qq -- --watch",
+    "dev:quickapp": "npm run build:quickapp -- --watch"
+  },
+  "browserslist": [
+    "last 3 versions",
+    "Android >= 4.1",
+    "ios >= 8"
+  ],
+  "author": "",
+  "dependencies": {
+    "@babel/runtime": "^7.7.7",
+    "@tarojs/components": "3.6.20",
+    "@tarojs/helper": "3.6.20",
+    "@tarojs/plugin-framework-react": "3.6.20",
+    "@tarojs/plugin-platform-weapp": "3.6.20",
+    "@tarojs/react": "3.6.20",
+    "@tarojs/runtime": "3.6.20",
+    "@tarojs/shared": "3.6.20",
+    "@tarojs/taro": "3.6.20",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "taro-ui": "^3.0.0-alpha.10"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.8.0",
+    "@tarojs/cli": "3.6.20",
+    "@tarojs/mini-runner": "3.6.20",
+    "@tarojs/webpack5-runner": "3.6.20",
+    "@types/react": "^18.0.0",
+    "@types/webpack-env": "^1.13.6",
+    "@typescript-eslint/eslint-plugin": "^5.20.0",
+    "@typescript-eslint/parser": "^5.20.0",
+    "babel-preset-taro": "3.6.20",
+    "eslint": "^8.12.0",
+    "eslint-config-taro": "3.6.20",
+    "eslint-plugin-react": "^7.8.2",
+    "eslint-plugin-react-hooks": "^4.2.0",
+    "stylelint": "^14.4.0",
+    "typescript": "^4.1.0",
+    "webpack": "^5.78.0"
+  }
+}

miniprogram/project.config.json

@@ -0,0 +1,63 @@
+{
+  "miniprogramRoot": "dist/",
+  "projectname": "market-miniprogram",
+  "description": "Quant Speed Market Mini Program",
+  "appid": "wxdf2ca73e6c0929f0",
+  "setting": {
+    "urlCheck": true,
+    "es6": false,
+    "enhancement": false,
+    "postcss": false,
+    "preloadBackgroundData": false,
+    "minified": false,
+    "newFeature": true,
+    "coverView": true,
+    "nodeModules": false,
+    "autoAudits": false,
+    "showShadowRootInWxmlPanel": true,
+    "scopeDataCheck": false,
+    "uglifyFileName": false,
+    "checkInvalidKey": true,
+    "checkSiteMap": true,
+    "uploadWithSourceMap": true,
+    "compileHotReLoad": false,
+    "lazyloadPlaceholderEnable": false,
+    "useMultiFrameRuntime": true,
+    "useApiHook": true,
+    "useApiHostProcess": true,
+    "babelSetting": {
+      "ignore": [],
+      "disablePlugins": [],
+      "outputPath": ""
+    },
+    "enableEngineNative": false,
+    "useIsolateContext": true,
+    "userConfirmedBundleSwitch": false,
+    "packNpmManually": false,
+    "packNpmRelationList": [],
+    "minifyWXSS": true,
+    "disableUseStrict": false,
+    "minifyWXML": true,
+    "showES6CompileOption": false,
+    "useCompilerPlugins": false,
+    "ignoreUploadUnusedFiles": true,
+    "compileWorklet": false,
+    "enhance": false,
+    "localPlugins": false,
+    "condition": false,
+    "swc": false,
+    "disableSWC": true
+  },
+  "compileType": "miniprogram",
+  "libVersion": "2.25.1",
+  "srcMiniprogramRoot": "src/",
+  "packOptions": {
+    "ignore": [],
+    "include": []
+  },
+  "editorSetting": {
+    "tabIndent": "insertSpaces",
+    "tabSize": 2
+  },
+  "simulatorPluginLibVersion": {}
+}

miniprogram/project.private.config.json

@@ -0,0 +1,22 @@
+{
+  "libVersion": "3.13.1",
+  "projectname": "miniprogram",
+  "setting": {
+    "urlCheck": true,
+    "coverView": true,
+    "lazyloadPlaceholderEnable": false,
+    "skylineRenderEnable": false,
+    "preloadBackgroundData": false,
+    "autoAudits": false,
+    "useApiHook": true,
+    "showShadowRootInWxmlPanel": true,
+    "useStaticServer": false,
+    "useLanDebug": false,
+    "showES6CompileOption": false,
+    "compileHotReLoad": true,
+    "checkInvalidKey": true,
+    "ignoreDevUnusedFiles": true,
+    "bigPackageSizeSupport": false,
+    "useIsolateContext": true
+  }
+}

miniprogram/src/api/index.ts

@@ -0,0 +1,33 @@
+import { request } from '../utils/request'
+
+// Configs / Products
+export const getConfigs = () => request({ url: '/configs/' })
+export const getConfigDetail = (id: number) => request({ url: `/configs/${id}/` })
+
+// Orders
+export const createOrder = (data: any) => request({ url: '/orders/', method: 'POST', data })
+export const getOrder = (id: number) => request({ url: `/orders/${id}/` })
+export const getMyOrders = () => request({ url: '/orders/' }) 
+export const prepayMiniprogram = (orderId: number) => request({ url: `/orders/${orderId}/prepay_miniprogram/`, method: 'POST' })
+
+// AI Services
+export const getServices = () => request({ url: '/services/' })
+export const getServiceDetail = (id: number) => request({ url: `/services/${id}/` })
+export const createServiceOrder = (data: any) => request({ url: '/service-orders/', method: 'POST', data })
+
+// VB Courses
+export const getVBCourses = () => request({ url: '/courses/' })
+export const getVBCourseDetail = (id: number) => request({ url: `/courses/${id}/` })
+
+// Distributor
+export const distributorRegister = (data: any) => request({ url: '/distributor/register/', method: 'POST', data })
+export const distributorInfo = () => request({ url: '/distributor/info/' })
+export const distributorInvite = () => request({ url: '/distributor/invite/', method: 'POST' })
+export const distributorWithdraw = (amount: number) => request({ url: '/distributor/withdraw/', method: 'POST', data: { amount } })
+// TODO: Verify if these exist in the API docs
+// export const distributorTeam = () => request({ url: '/distributor/team/' })
+// export const distributorHistory = () => request({ url: '/distributor/history/' })
+
+// User
+export const updateUserInfo = (data: any) => request({ url: '/wechat/update/', method: 'POST', data })
+export const wechatLogin = (code: string) => request({ url: '/wechat/login/', method: 'POST', data: { code } })

miniprogram/src/app.config.ts

@@ -0,0 +1,73 @@
+export default defineAppConfig({
+  pages: [
+    'pages/index/index',
+    'pages/services/index',
+    'pages/services/detail',
+    'pages/courses/index',
+    'pages/courses/detail',
+    'pages/goods/detail',
+    'pages/cart/cart',
+    'pages/order/checkout',
+    'pages/order/payment',
+    'pages/order/list',
+    'pages/user/index'
+  ],
+  subPackages: [
+    {
+      root: 'subpackages/distributor',
+      pages: [
+        'index',
+        'register',
+        'invite',
+        'withdraw'
+      ]
+    }
+  ],
+  window: {
+    backgroundTextStyle: 'light',
+    navigationBarBackgroundColor: '#000000',
+    navigationBarTitleText: 'Quant Speed Market',
+    navigationBarTextStyle: 'white'
+  },
+  tabBar: {
+    color: "#666666",
+    selectedColor: "#00b96b",
+    backgroundColor: "#000000",
+    borderStyle: "black",
+    list: [
+      {
+        pagePath: "pages/index/index",
+        text: "首页",
+        iconPath: "./assets/home.png",
+        selectedIconPath: "./assets/home_active.png"
+      },
+      {
+        pagePath: "pages/services/index",
+        text: "AI服务",
+        iconPath: "./assets/AI_service.png",
+        selectedIconPath: "./assets/AI_service_active.png"
+      },
+      {
+        pagePath: "pages/courses/index",
+        text: "VB课程",
+        iconPath: "./assets/VR.png",
+        selectedIconPath: "./assets/VR_active.png"
+      },
+      {
+        pagePath: "pages/cart/cart",
+        text: "购物车",
+        iconPath: "./assets/cart.png",
+        selectedIconPath: "./assets/cart_active.png"
+      },
+      {
+        pagePath: "pages/user/index",
+        text: "我的",
+        iconPath: "./assets/user.png",
+        selectedIconPath: "./assets/user_active.png"
+      }
+    ]
+  },
+  requiredPrivateInfos: [
+    "chooseAddress"
+  ]
+})

miniprogram/src/app.scss

@@ -0,0 +1,20 @@
+page {
+  --primary-cyan: #00f0ff;
+  --primary-green: #00b96b;
+  --primary-purple: #bd00ff;
+  --bg-dark: #050505;
+  --card-bg: rgba(255, 255, 255, 0.03);
+  --glass-border: rgba(255, 255, 255, 0.08);
+  --text-main: #ffffff;
+  --text-secondary: rgba(255, 255, 255, 0.7);
+  
+  background-color: var(--bg-dark);
+  font-family: -apple-system, BlinkMacSystemFont, 'Helvetica Neue', Helvetica,
+    Segoe UI, Arial, Roboto, 'PingFang SC', 'miui', 'Hiragino Sans GB', 'Microsoft Yahei',
+    sans-serif;
+  color: var(--text-main);
+}
+
+.container {
+  padding: 20px;
+}

miniprogram/src/app.ts

@@ -0,0 +1,21 @@
+import { PropsWithChildren } from 'react'
+import { useLaunch } from '@tarojs/taro'
+import { login } from './utils/request'
+import './app.scss'
+
+function App({ children }: PropsWithChildren<any>) {
+
+  useLaunch(() => {
+    console.log('App launched.')
+    // Auto login
+    login().then(res => {
+        console.log('Logged in as:', res?.nickname)
+    }).catch(err => {
+        console.log('Auto login failed', err)
+    })
+  })
+
+  return children
+}
+
+export default App