For large, member-driven organizations like a national union, the democratic process of proposing, debating, and voting on initiatives is a cornerstone of their governance. We were tasked with transforming this traditionally paper-based and time-consuming process into a secure, transparent, and efficient digital platform our client’s existing Drupal website.

The Challenge: From Manual Process to Digital Platform

The client's existing process for managing member-submitted initiatives was manual and fragmented, relying on emails, spreadsheets, and paper forms. This created several significant challenges:

• High Barrier to Entry: The process for a member to submit an initiative was unclear and cumbersome, discouraging participation.

• Lack of Transparency: Members had no easy way to see which initiatives had been submitted by their peers or to show their support for ideas they believed in.

• Intense Administrative Burden: Staff spent hundreds of hours manually collecting, tracking, ranking, and preparing initiatives for official review and voting.

• Security and Eligibility: Ensuring that only eligible, active members could participate in the process was a constant and critical concern.

Our Solution: A Custom Drupal Module for End-to-End Initiative Management

We engineered a comprehensive, multi-stage initiative management system as a custom Drupal module. This platform digitizes the entire lifecycle of an initiative, from initial submission and community endorsement to administrative ranking and final approval.

How We Accomplished This

Our solution was built as a series of interconnected features that map directly to the client's real-world democratic process.

1. Secure and Controlled Initiative Submission

The first step was to create a secure and user-friendly way for members to submit their ideas.

What it Does: Eligible members are presented with a simple, guided form to create a new initiative. The system enforces strict deadlines, only allowing submissions within a specific time window defined by administrators.

How We Built It:

• We created a dedicated initiative content type in Drupal with specific fields for the proposal text, rationale, and submitter information.

• Access to the creation form is controlled by a custom Drupal permission, ensuring only authenticated members with the correct role can submit.

• The submission window is managed by a custom service (initiativesService.php) that checks the current date against administrator-defined start and end dates. The form is only accessible during this window.

2. Community Endorsements

To ensure that only popular and relevant initiatives move forward, we built a system for members to endorse submissions from their peers.

What it Does: After an initiative is submitted, other eligible members can view it and click an "Endorse" button. This acts as a digital signature of support. The system tracks the total number of endorsements for each initiative.

How We Built It:

• We created a custom endorsement entity that links a user to an initiative, ensuring a member can only endorse a specific initiative once.

• The "Endorse" button is rendered via a custom block. When clicked, it makes an AJAX call to a dedicated controller endpoint.

• This controller verifies the user's eligibility and creates the endorsement entity. The block then dynamically updates on the page to show the new total and change the button to a "You have endorsed this" state, providing immediate feedback to the user.

3. A Digital Ballot Box

To provide deeper insights beyond a simple "thumbs-up" endorsement, we built an interactive ranking system that allows members to weigh in on which proposals matter most to them.

What it Does: After the endorsement period, members are directed to a dedicated ranking page. Here, they are presented with the list of all eligible initiatives and a fixed budget of "points" (e.g., 100) to allocate. Using a drag-and-drop interface and sliders, members can distribute their points among the initiatives, assigning more points to the ones they feel are most important. This creates a detailed, personalized ballot that reflects the nuances of their support.

How We Built It:

• A Custom React Application: To create a fluid and intuitive user experience, we built the ranking interface as a React application. This allowed us to implement complex client-side features like drag-and-drop reordering and real-time calculation of remaining points, which would be impossible with standard Drupal forms.

• A Dedicated API Endpoint: The React application communicates with Drupal via a dedicated API endpoint. When a member submits their ranking, the frontend sends a clean JSON payload to a custom controller.

• Robust Backend Validation: The Drupal controller is responsible for validating every submission. It confirms that the user is eligible to rank, has not already submitted a ranking, and has not allocated more points than the maximum allowed. This server-side validation is critical for maintaining the integrity of the process.

• Custom Service for Data Storage: Upon successful validation, the controller passes the data to a dedicated service (initiativesService.php) which saves the member's specific point allocation for each initiative into a custom database table. This keeps the ranking data structured, secure, and ready for analysis.

4. Final Voting and Approval

The final stage is preparing the ranked initiatives for the official vote.

What it Does: The system allows administrators to mark initiatives with their final status (e.g., "Approved," "Rejected," "Out of Order") and publish the official, ranked list for the membership to see.

How We Built It:

• We added a "Final Status" field to the initiative content type.

• Access to edit this field is restricted to administrators via hook_entity_field_access().

• A separate public-facing View displays only the initiatives that have been given a final rank and status, providing a clean, official list for the general membership.

The Business Impact: A More Democratic and Efficient Process

• Increased Member Engagement: By making the submission and endorsement process simple and transparent, we lowered the barrier to entry, encouraging more members to participate in their organization's governance.

• Drastically Reduced Administrative Overhead: The automated system eliminated hundreds of hours of manual data entry, tracking, and reporting, allowing staff to focus on the substance of the initiatives rather than the logistics.

• Enhanced Security and Integrity: The platform ensures that every step of the process—from submission to endorsement to ranking—is governed by strict, role-based permissions, guaranteeing the integrity of the democratic process.

• A Single Source of Truth: The Drupal module is now the definitive system of record for all member-submitted initiatives, providing a clear and auditable history.