Dovodi_Backend/templates/docs.html

{% extends 'admin/base_site.html' %}

{% block title %}
    {{ title }} | {{ site_title|default:_('Django site adminssss') }}
{% endblock %}

{% block contentwrap %}
    <div class="content">
        <div class="row">
            <div class="col-6">
                <div class="card">
                    <div class="card-header bg-light header-elements-inline">
                        آموزش ساختار کلی ادمین
                    </div>
                    <div class="card-body">
                        <video width="100%" height="240" controls>
                            <source src="https://file.nwhco.ir/filebrowser/api/public/dl/6aehmyLB"
                                    type="video/mp4">
                            Your browser does not support the video tag.
                        </video>
                    </div>
                </div>
            </div>
            <div class="col-6">
                <div class="card">
                    <div class="card-header bg-light header-elements-inline">
                        آموزش بخش تقویم
                    </div>
                    <div class="card-body">
                        <video width="100%" height="240" controls>
                            <source src="https://file.nwhco.ir/filebrowser/api/public/dl/RTwSpkoZ"
                                    type="video/mp4">
                            Your browser does not support the video tag.
                        </video>
                    </div>
                </div>
            </div>

            <div class="col-6">
                <div class="card">
                    <div class="card-header bg-light header-elements-inline">
                        آموزش بخش مفاتیح
                    </div>
                    <div class="card-body">
                        <video width="100%" height="240" controls>
                            <source src="https://file.nwhco.ir/filebrowser/api/public/dl/R4O8Rxnq"
                                    type="video/mp4">
                            Your browser does not support the video tag.
                        </video>
                    </div>
                </div>
            </div>
            <div class="col-6">
                <div class="card">
                    <div class="card-header bg-light header-elements-inline">
                        آموزش بخش احکام
                    </div>
                    <div class="card-body">
                        <video width="100%" height="240" controls>
                            <source src="https://file.nwhco.ir/filebrowser/api/public/dl/pr5u4MtD"
                                    type="video/mp4">
                            Your browser does not support the video tag.
                        </video>
                    </div>
                </div>
            </div>

            <div class="col-12">
                <div class="card">
                    <div class="card-header bg-light header-elements-inline">
                        مستندات API تراکنش‌ها و رسیدهای پرداخت
                    </div>
                    <div class="card-body">
                        <h4>🔹 ثبت‌نام در دوره و ایجاد تراکنش</h4>
                        <p><strong>Endpoint:</strong> <code>POST /api/transactions/&lt;slug&gt;/join/</code></p>
                        <p>این API برای ثبت‌نام کاربر در دوره و ایجاد تراکنش استفاده می‌شود.</p>
                        <ul>
                            <li>برای دوره‌های رایگان، تراکنش به صورت خودکار تایید می‌شود</li>
                            <li>برای دوره‌های پولی، تراکنش با وضعیت <code>pending</code> ایجاد می‌شود</li>
                        </ul>
                        <hr>

                        <h4>🔹 آپلود رسید پرداخت</h4>
                        <p><strong>Endpoint:</strong> <code>POST /api/transactions/&lt;transaction_id&gt;/receipts/upload/</code></p>
                        <p>برای آپلود رسید پرداخت دوره‌های پولی استفاده می‌شود.</p>
                        <ul>
                            <li>حداکثر 10 فایل قابل آپلود در هر درخواست</li>
                            <li>حداکثر حجم هر فایل: 10 مگابایت</li>
                            <li>پس از آپلود موفق، وضعیت تراکنش به <code>waiting_approval</code> تغییر می‌کند</li>
                        </ul>
                        <hr>

                        <h4>🔹 مشاهده رسیدهای یک تراکنش</h4>
                        <p><strong>Endpoint:</strong> <code>GET /api/transactions/&lt;transaction_id&gt;/receipts/</code></p>
                        <p>برای دریافت لیست تمام رسیدهای آپلود شده برای یک تراکنش.</p>
                        <hr>

                        <h4>🔹 لیست تراکنش‌های کاربر</h4>
                        <p><strong>Endpoint:</strong> <code>GET /api/transactions/list/</code></p>
                        <p>برای دریافت لیست تمام تراکنش‌های کاربر احراز هویت شده.</p>
                        <hr>

                        <h4>🔹 وضعیت‌های تراکنش</h4>
                        <table class="table table-bordered">
                            <thead>
                                <tr>
                                    <th>وضعیت</th>
                                    <th>توضیحات</th>
                                </tr>
                            </thead>
                            <tbody>
                                <tr>
                                    <td><span class="badge badge-warning">pending</span></td>
                                    <td>در انتظار پرداخت - کاربر باید رسید را آپلود کند</td>
                                </tr>
                                <tr>
                                    <td><span class="badge badge-info">waiting_approval</span></td>
                                    <td>در انتظار تایید - رسید آپلود شده و منتظر تایید ادمین</td>
                                </tr>
                                <tr>
                                    <td><span class="badge badge-success">success</span></td>
                                    <td>پرداخت موفق و تایید شده - کاربر به دوره دسترسی دارد</td>
                                </tr>
                                <tr>
                                    <td><span class="badge badge-danger">failed</span></td>
                                    <td>پرداخت ناموفق یا رد شده</td>
                                </tr>
                            </tbody>
                        </table>
                        <hr>

                        <h4>📌 نکات مهم برای ادمین</h4>
                        <ul>
                            <li>زمانی که کاربر رسید آپلود می‌کند، وضعیت تراکنش به <code>waiting_approval</code> تغییر می‌کند</li>
                            <li>ادمین باید رسیدها را در پنل ادمین بررسی کرده و وضعیت را به <code>success</code> یا <code>failed</code> تغییر دهد</li>
                            <li>زمانی که وضعیت به <code>success</code> تغییر کند، کاربر به صورت خودکار به عنوان دانشجو در دوره ثبت می‌شود</li>
                            <li>تمام رسیدهای آپلود شده در پنل ادمین قابل مشاهده هستند</li>
                        </ul>

                        <p class="mt-3">
                            <a href="/swagger/" target="_blank" class="btn btn-primary">مشاهده مستندات کامل Swagger</a>
                        </p>
                    </div>
                </div>
            </div>
        </div>
    </div>
{% endblock %}