+{% extends 'public_frontend/base.html' %}

+{% load static %}

+{% block title %}{{ service.title }}{% endblock %}

+

+{% block content %}

+<article class="grid gap-6">

+  <header class="bg-white rounded-lg shadow-md p-6 flex items-start gap-4">

+    <img src="{% static 'service_icons/' %}{{ service.image_name }}" alt="{{ service.title }} icon" class="w-16 h-16 object-contain"/>

+    <div>

+      <h1 class="text-3xl font-bold">{{ service.title }}</h1>

+      {% if service.description %}

+        <p class="text-gray-600 mt-1">{{ service.description }}</p>

+      {% endif %}

+    </div>

+  </header>

+

+  {% if service.body_html %}

+    <section class="bg-white rounded-lg shadow-md p-6 prose max-w-none">

+      {{ service.body_html|safe }}

+    </section>

+  {% elif service.body %}

+    <section class="bg-white rounded-lg shadow-md p-6">

+      <pre class="whitespace-pre-wrap text-gray-700">{{ service.body }}</pre>

+    </section>

+  {% endif %}

+

+  <div>

+    <a href="/" class="text-blue-700 hover:underline">← Back to Home</a>

+  </div>

+</article>

+{% endblock %}

+

+    path("services/<int:pk>/", views.service_detail, name="service_detail"),

+# Use Cases for Factory Owner Finding a Recycling Business

+

+This document outlines the primary use cases for a factory owner (or a similar industrial producer of scrap materials) interacting with the public-facing frontend of a recycling business that uses the Ecoloop platform.

+

+## Actors

+

+*   **Factory Owner:** An individual or entity representing a business that generates recyclable scrap materials as a byproduct of its operations.

+*   **Recycling Business:** The organization running this specific instance of the Ecoloop platform, which processes, buys, or manages recyclable materials.

+

+---

+

+### Use Case 1: Discover and Vet a Recycling Partner

+

+**Goal:** The factory owner wants to find a reliable, local recycling business to handle their specific types of industrial scrap.

+

+**Scenario:**

+1.  The factory owner searches online for "recycling services for plastic scrap" and discovers the recycling business's public website (powered by Ecoloop).

+2.  On the homepage, they understand the business's core services: managing recycling, pickups, and material listings.

+3.  They navigate to the **Materials** page to verify that the business handles the materials they produce (e.g., "LDPE Film," "Corrugated Cardboard").

+4.  They browse the **Listings** page to see what materials the business is actively seeking or selling, giving them confidence that this is an active and relevant marketplace.

+5.  Feeling confident, the factory owner decides to initiate contact to discuss a potential partnership.

+

+---

+

+### Use Case 2: Request a One-Time Pickup for Scrap Materials

+

+**Goal:** The factory owner has an accumulation of scrap and needs to schedule a pickup without committing to a long-term contract.

+

+**Scenario:**

+1.  The factory owner lands on the public site and navigates directly to the **"Request Pickup"** page.

+2.  They fill out the pickup request form, providing:

+    *   Their name and contact information (email/phone).

+    *   The factory's address for the pickup.

+    *   A preferred date and time.

+    *   A brief description of the materials to be collected (e.g., "Approx. 2 tons of baled cardboard and 500 lbs of shrink wrap").

+3.  Upon submission, the form is sent to the recycling business as a **Lead**.

+4.  The factory owner sees a success message confirming their request has been submitted and awaits a direct follow-up from the business's staff to finalize logistics.

+

+---

+

+### Use Case 3: Inquire About a Public Listing

+

+**Goal:** The factory owner sees a listing for a material they either have or need and wants to engage with the recycling business.

+

+**Scenario:**

+1.  While browsing the **Listings** page, the factory owner finds a listing of interest, for example, "Wanted: Clean PET plastic regrind."

+2.  They click on the listing to view the **Listing Detail** page, which provides more information about quantity, quality specifications, and terms.

+3.  To act on this listing, the factory owner navigates to the **"Contact"** page.

+4.  They fill out the contact form, mentioning the specific listing in their message (e.g., "Hello, I'm writing in response to your listing for PET regrind. We produce this material and would like to discuss supplying it.").

+5.  This inquiry is captured as a **Lead** for the recycling business, providing their sales or procurement team with a direct, actionable request.

+

+---

+

+### Use Case 4: Gain Knowledge on Recycling Best Practices

+

+**Goal:** The factory owner wants to improve their internal waste sorting and handling processes to increase the value of their scrap.

+

+**Scenario:**

+1.  The factory owner explores the site and clicks on the **"Blog"** section.

+2.  They find and read an article titled, for example, "5 Ways to Reduce Contamination in Your Plastic Waste Stream."

+3.  The article provides valuable insights that help the owner implement better sorting practices at their factory.

+4.  This knowledge empowers the factory owner to produce higher-quality scrap, making them a more valuable supplier for recycling businesses.

+from recycle_core.models import ProvidedService

+

+    materials_qs = Material.objects.all().order_by("name")

+    if org is not None:

+        materials_qs = materials_qs.filter(organization=org)

+    materials = materials_qs[:12]

+

+    services_qs = ProvidedService.objects.none()

+    if org is not None:

+        services_qs = ProvidedService.objects.filter(organization=org, is_enabled=True).order_by("display_order", "id")

+    services = list(services_qs)

+

+    pickup_form = PickupRequestForm()

+    contact_form = ContactForm()

+

+    return render(

+        request,

+        "public_frontend/home.html",

+        {

+            "posts": posts,

+            "listings": listings,

+            "materials": materials,

+            "services": services,

+            "pickup_form": pickup_form,

+            "contact_form": contact_form,

+            "org": org,

+        },

+    )

+def service_detail(request, pk: int):

+    org = getattr(request, "org", None)

+    base_qs = ProvidedService.objects.filter(is_enabled=True)

+    if org is not None:

+        base_qs = base_qs.filter(organization=org)

+    service = get_object_or_404(base_qs, pk=pk)

+    return render(request, "public_frontend/service_detail.html", {"service": service, "org": org})

+

+

+

+

+@admin.register(models.ProvidedService)

+class ProvidedServiceAdmin(OrgScopedAdmin):

+    list_display = ("title", "organization", "is_enabled", "display_order", "created_at")

+    list_filter = ("organization", "is_enabled")

+    search_fields = ("title", "description")

+    ordering = ("organization", "display_order", "id")

+    ProvidedService,

+from markdownfield.widgets import MDEWidget

+class ProvidedServiceForm(forms.ModelForm):

+    class Meta:

+        model = ProvidedService

+        fields = ["title", "description", "body", "display_order", "is_enabled"]

+        widgets = {

+            "description": forms.Textarea(attrs={"rows": 3}),

+            "body": MDEWidget(),

+        }

+

+

+    ProvidedService,

+        # Provided services for the public website

+        demo_services = [

+            ("Pickup & Logistics", "Scheduled and on-demand scrap pickups handled safely and on time.",

+             "We provide reliable pickup scheduling, routing, and documentation for your facilities.\n\n- Route planning and dispatch\n- On-demand requests\n- Driver assignments and tracking"),

+            ("Material Sorting", "Sorting and consolidation to maximize recycling value.",

+             "Our team sorts materials to your specifications to improve purity and value.\n\n- On-site sorting support\n- Bale and bag standards\n- Quality checks"),

+            ("Weighing & Ticketing", "Accurate weighing with digital tickets and audit trail.",

+             "Every pickup is weighed with calibrated equipment and recorded.\n\n- Calibrated scale records\n- Digital weigh tickets\n- Audit logs"),

+            ("Invoicing & Payouts", "Transparent invoices and fast payouts.",

+             "Automated invoicing and payouts reduce admin overhead.\n\n- Invoice generation\n- Payment tracking\n- Reconciliations"),

+            ("Reporting & Analytics", "Reports that track volumes, value, and sustainability.",

+             "Dashboards keep stakeholders informed.\n\n- Material volumes\n- Revenue and cost\n- ESG metrics"),

+            ("Marketplace & Bidding", "Invite vetted recyclers and get competitive bids.",

+             "Run open or sealed listings to find the best offer.\n\n- Public or invite-only\n- Bid history\n- Award workflows"),

+            ("Compliance & Audits", "Documentation and controls for compliance.",

+             "Stay compliant with audit-ready records.\n\n- Document control\n- Chain of custody\n- Access controls"),

+            ("Consulting & Training", "Best practices and training for your team.",

+             "Improve recycling outcomes with training and SOPs.\n\n- SOP development\n- Staff workshops\n- Continuous improvement"),

+        ]

+

+        for idx, (title, desc, body) in enumerate(demo_services):

+            ProvidedService.objects.get_or_create(

+                organization=org,

+                title=title,

+                defaults={

+                    "description": desc,

+                    "body": body,

+                    "display_order": idx,

+                    "is_enabled": True,

+                },

+            )

+

+# Generated by Django 4.2.24 on 2025-09-22 08:26

+

+from django.db import migrations, models

+import django.db.models.deletion

+

+

+class Migration(migrations.Migration):

+

+    dependencies = [

+        ('orgs', '0006_delete_providedservice'),

+        ('recycle_core', '0001_initial'),

+    ]

+

+    operations = [

+        migrations.CreateModel(

+            name='ProvidedService',

+            fields=[

+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),

+                ('created_at', models.DateTimeField(auto_now_add=True)),

+                ('updated_at', models.DateTimeField(auto_now=True)),

+                ('title', models.CharField(choices=[('Pickup & Logistics', 'Pickup & Logistics'), ('Material Sorting', 'Material Sorting'), ('Weighing & Ticketing', 'Weighing & Ticketing'), ('Invoicing & Payouts', 'Invoicing & Payouts'), ('Reporting & Analytics', 'Reporting & Analytics'), ('Marketplace & Bidding', 'Marketplace & Bidding'), ('Compliance & Audits', 'Compliance & Audits'), ('Consulting & Training', 'Consulting & Training')], max_length=100)),

+                ('description', models.TextField()),

+                ('display_order', models.PositiveIntegerField(default=0)),

+                ('organization', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='services', to='orgs.organization')),

+            ],

+            options={

+                'ordering': ['display_order'],

+            },

+        ),

+    ]

+# Generated by Django 4.2.24 on 2025-09-22 08:30

+

+from django.db import migrations

+import markdownfield.models

+

+

+class Migration(migrations.Migration):

+

+    dependencies = [

+        ('recycle_core', '0002_providedservice'),

+    ]

+

+    operations = [

+        migrations.AddField(

+            model_name='providedservice',

+            name='description_html',

+            field=markdownfield.models.RenderedMarkdownField(null=True),

+        ),

+        migrations.AlterField(

+            model_name='providedservice',

+            name='description',

+            field=markdownfield.models.MarkdownField(rendered_field='description_html'),

+        ),

+    ]

+# Generated by Django 4.2.24 on 2025-09-22 08:34

+

+from django.db import migrations, models

+import markdownfield.models

+

+

+class Migration(migrations.Migration):

+

+    dependencies = [

+        ('recycle_core', '0003_providedservice_description_html_and_more'),

+    ]

+

+    operations = [

+        migrations.RenameField(

+            model_name='providedservice',

+            old_name='description_html',

+            new_name='body_html',

+        ),

+        migrations.AddField(

+            model_name='providedservice',

+            name='body',

+            field=markdownfield.models.MarkdownField(blank=True, null=True, rendered_field='body_html'),

+        ),

+        migrations.AlterField(

+            model_name='providedservice',

+            name='description',

+            field=models.TextField(),

+        ),

+    ]

+# Generated by Django 4.2.24 on 2025-09-22 08:43

+

+from django.db import migrations, models

+

+

+class Migration(migrations.Migration):

+

+    dependencies = [

+        ('recycle_core', '0004_rename_description_html_providedservice_body_html_and_more'),

+    ]

+

+    operations = [

+        migrations.AddField(

+            model_name='providedservice',

+            name='is_enabled',

+            field=models.BooleanField(default=True),

+        ),

+    ]

+from markdownfield.models import MarkdownField, RenderedMarkdownField

+from markdownfield.validators import VALIDATOR_STANDARD

+class ProvidedService(TimestampedModel):

+    organization = models.ForeignKey(Organization, on_delete=models.CASCADE, related_name="services")

+    TITLE_CHOICES = (

+        ("Pickup & Logistics", "Pickup & Logistics"),

+        ("Material Sorting", "Material Sorting"),

+        ("Weighing & Ticketing", "Weighing & Ticketing"),

+        ("Invoicing & Payouts", "Invoicing & Payouts"),

+        ("Reporting & Analytics", "Reporting & Analytics"),

+        ("Marketplace & Bidding", "Marketplace & Bidding"),

+        ("Compliance & Audits", "Compliance & Audits"),

+        ("Consulting & Training", "Consulting & Training"),

+    )

+    title = models.CharField(max_length=100, choices=TITLE_CHOICES)

+    # Short summary text

+    description = models.TextField()

+    # Long-form markdown body

+    body = MarkdownField(rendered_field="body_html", validator=VALIDATOR_STANDARD, blank=True, null=True)

+    body_html = RenderedMarkdownField(blank=True, null=True)

+    display_order = models.PositiveIntegerField(default=0)

+    is_enabled = models.BooleanField(default=True)

+

+    IMAGE_NAME_MAP = {

+        "Pickup & Logistics": "pickup-logistics.png",

+        "Material Sorting": "material-sorting.png",

+        "Weighing & Ticketing": "weighing-ticketing.png",

+        "Invoicing & Payouts": "invoicing-payouts.png",

+        "Reporting & Analytics": "reporting-analytics.png",

+        "Marketplace & Bidding": "marketplace-bidding.png",

+        "Compliance & Audits": "compliance-audits.png",

+        "Consulting & Training": "consulting-training.png",

+    }

+

+    @property

+    def image_name(self) -> str:

+        return self.IMAGE_NAME_MAP.get(self.title, "default-service.png")

+

+    class Meta:

+        ordering = ["display_order"]

+

+    def __str__(self) -> str:

+        return self.title

+

+

+{% extends 'admin_frontend/base.html' %}

+{% load crispy_forms_tags breadcrumbs %}

+{% block title %}{% if item %}Edit Service{% else %}New Service{% endif %}{% endblock %}

+{% block content %}

+{% render_breadcrumbs breadcrumbs %}

+<div class="flex items-center justify-between mb-4">

+  <h1 class="text-xl font-semibold">{% if item %}Edit Service{% else %}New Service{% endif %}</h1>

+  <a href="{% url 'recycle_core:services_list' %}" class="btn-outline">Back</a>

+  <style>.btn-outline{border:1px solid #cbd5e1;padding:.375rem .5rem;border-radius:.375rem}</style>

+</div>

+

+{% include 'admin_frontend/_form.html' with form=form cancel_url=cancel_url submit_label='Save' %}

+{% endblock %}

+{% extends 'admin_frontend/base.html' %}

+{% load breadcrumbs %}

+{% block title %}Provided Services{% endblock %}

+{% block content %}

+{% render_breadcrumbs breadcrumbs %}

+<div class="flex items-center justify-between mb-4">

+  <h1 class="text-xl font-semibold">Provided Services</h1>

+  <a href="{% url 'recycle_core:service_create' %}" class="btn-outline">New Service</a>

+  <style>.btn-outline{border:1px solid #cbd5e1;padding:.375rem .5rem;border-radius:.375rem}</style>

+</div>

+

+<div class="bg-white rounded shadow overflow-hidden">

+  <table class="min-w-full text-sm">

+    <thead class="bg-gray-50 text-left">

+      <tr>

+        <th class="px-4 py-2 w-16">Order</th>

+        <th class="px-4 py-2">Title</th>

+        <th class="px-4 py-2">Description</th>

+        <th class="px-4 py-2 w-24">Status</th>

+        <th class="px-4 py-2 w-48">Actions</th>

+      </tr>

+    </thead>

+    <tbody>

+      {% for s in services %}

+      <tr class="border-t">

+        <td class="px-4 py-2 text-gray-600">{{ s.display_order }}</td>

+        <td class="px-4 py-2 font-medium">{{ s.title }}</td>

+        <td class="px-4 py-2 text-gray-700">{{ s.description|truncatechars:140 }}</td>

+        <td class="px-4 py-2">

+          {% if s.is_enabled %}

+            <span class="inline-flex items-center rounded bg-green-50 text-green-700 px-2 py-0.5 text-xs">Enabled</span>

+          {% else %}

+            <span class="inline-flex items-center rounded bg-gray-100 text-gray-600 px-2 py-0.5 text-xs">Disabled</span>

+          {% endif %}

+        </td>

+        <td class="px-4 py-2">

+          <div class="flex items-center gap-3">

+            <a href="{% url 'recycle_core:service_edit' s.pk %}" class="text-blue-600 hover:text-blue-700">Edit</a>

+            <form method="post" action="{% url 'recycle_core:service_toggle_enabled' s.pk %}">

+              {% csrf_token %}

+              <button type="submit" class="text-gray-700 hover:text-gray-900">{% if s.is_enabled %}Disable{% else %}Enable{% endif %}</button>

+            </form>

+            <form method="post" action="{% url 'recycle_core:service_delete' s.pk %}" onsubmit="return confirm('Delete this service?');">

+              {% csrf_token %}

+              <button type="submit" class="text-red-600 hover:text-red-700">Delete</button>

+            </form>

+          </div>

+        </td>

+      </tr>

+      {% empty %}

+      <tr>

+        <td colspan="4" class="px-4 py-6 text-center text-gray-500">No services yet. Click New Service to add one.</td>

+      </tr>

+      {% endfor %}

+    </tbody>

+  </table>

+  <div class="px-4 py-3 text-xs text-gray-500 border-t">Sorted by display order ascending.</div>

+  <style>

+    .btn{background:#1d4ed8;color:#fff;padding:.5rem .75rem;border-radius:.375rem}

+  </style>

+</div>

+{% endblock %}

+    # Services

+    path("services/", views.services_list, name="services_list"),

+    path("services/new/", views.service_create, name="service_create"),

+    path("services/<int:pk>/edit/", views.service_edit, name="service_edit"),

+    path("services/<int:pk>/delete/", views.service_delete, name="service_delete"),

+    path("services/<int:pk>/toggle-enabled/", views.service_toggle_enabled, name="service_toggle_enabled"),

+    ProvidedService,

+from .forms import (

+    MaterialForm,

+    MaterialCategoryForm,

+    CustomerForm,

+    PickupAssignForm,

+    PickupStatusForm,

+    PaymentForm,

+    DocumentForm,

+    ProvidedServiceForm,

+)

+@staff_member_required

+@public_route(label="Provided Services", order=15, icon="sparkles")

+@breadcrumbs(label="Provided Services", name="rc_services")

+def services_list(request):

+    if not request.user.is_authenticated or not getattr(request.user, "is_staff", False):

+        from django.contrib.auth.views import redirect_to_login

+        return redirect_to_login(request.get_full_path(), login_url=reverse("admin_frontend:login"))

+    org = getattr(request, "org", None)

+    services = ProvidedService.objects.filter(organization=org).order_by("display_order", "id")

+    return render(request, "recycle_core/services_list.html", {"nav": _nav_items(), "services": services})

+

+

+@breadcrumbs(label="New Service", parent="rc_services")

+@owner_required

+def service_create(request):

+    if request.method == "POST":

+        form = ProvidedServiceForm(request.POST)

+        if form.is_valid():

+            obj = form.save(commit=False)

+            obj.organization = getattr(request, "org", None)

+            obj.save()

+            messages.success(request, "Service created.")

+            return redirect("recycle_core:services_list")

+        messages.error(request, "Please correct the errors below.")

+    else:

+        form = ProvidedServiceForm()

+    return render(request, "recycle_core/service_form.html", {"nav": _nav_items(), "form": form, "cancel_url": reverse("recycle_core:services_list")})

+

+

+@breadcrumbs(label="Edit Service", parent="rc_services")

+@owner_required

+def service_edit(request, pk: int):

+    org = getattr(request, "org", None)

+    item = ProvidedService.objects.filter(organization=org).filter(pk=pk).first()

+    if not item:

+        messages.error(request, "Service not found.")

+        return redirect("recycle_core:services_list")

+    if request.method == "POST":

+        form = ProvidedServiceForm(request.POST, instance=item)

+        if form.is_valid():

+            obj = form.save(commit=False)

+            obj.organization = org

+            obj.save()

+            messages.success(request, "Service updated.")

+            return redirect("recycle_core:service_edit", pk=item.pk)

+        messages.error(request, "Please correct the errors below.")

+    else:

+        form = ProvidedServiceForm(instance=item)

+    return render(request, "recycle_core/service_form.html", {"nav": _nav_items(), "item": item, "form": form, "cancel_url": reverse("recycle_core:services_list")})

+

+

+@require_POST

+@owner_required

+def service_delete(request, pk: int):

+    org = getattr(request, "org", None)

+    item = ProvidedService.objects.filter(organization=org).filter(pk=pk).first()

+    if not item:

+        messages.error(request, "Service not found.")

+    else:

+        item.delete()

+        messages.success(request, "Service deleted.")

+    return redirect("recycle_core:services_list")

+

+

+@require_POST

+@owner_required

+def service_toggle_enabled(request, pk: int):

+    org = getattr(request, "org", None)

+    item = ProvidedService.objects.filter(organization=org).filter(pk=pk).first()

+    if not item:

+        messages.error(request, "Service not found.")

+    else:

+        item.is_enabled = not item.is_enabled

+        item.save(update_fields=["is_enabled"])

+        messages.success(request, f"Service '{item.title}' {'enabled' if item.is_enabled else 'disabled'}.")

+    return redirect("recycle_core:services_list")

+django-npm