Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve Quality Control Process & Printout Formatting #445

Open
JohnMwashuma opened this issue Feb 6, 2025 · 0 comments
Open

Improve Quality Control Process & Printout Formatting #445

JohnMwashuma opened this issue Feb 6, 2025 · 0 comments

Comments

@JohnMwashuma
Copy link
Member

JohnMwashuma commented Feb 6, 2025

Context

During the previous election, several forms were mistakenly archived instead of being sent for audit after failing Quarantine checks. The primary causes of this issue were:

  • Small font size for the "Next Steps" recommendation on the QC printout, making it difficult to read.
  • Incorrect Arabic translations for key instructions on the printout.
  • Lack of clear visual distinction between forms that should go to Audit vs. Archive.

To resolve these issues, adjustments to the QC process and QC printout formatting are required.


Proposed Changes

1️⃣ Improve Printout Formatting for Clarity

  • Increase the font size for the Next Steps (Destination) section in the QC printout.
  • Apply bold and high-contrast styling for the form destination text.
  • Ensure proper spacing and alignment for readability.

2️⃣ Review and correct any Arabic Translations issues on the Printout

  • Review and correct any Arabic translations issues for "Next Steps" and other key instructions.
  • Ensure proper text direction (RTL - Right-to-Left) support for Arabic text.

3️⃣ Add a Visual Indicator for Audit vs. Archive

  • Use distinct labels or color indicators for forms marked for:
    • ✅ Archiving
    • ❌ Audit (Correction Required)

Acceptance Criteria

✅ The QC printout clearly shows the destination of a form using a larger, bold font.
✅ Arabic translations are corrected and properly formatted for clarity.
✅ Printout includes distinct visual markers (labels or colors) for Audit vs. Archive.


Implementation Plan

1️⃣ Update QC Print Cover Template

  • Modify print_cover.html:
    • Increase font size & bold styling for "Next Steps."
    • Apply correct Arabic translations and RTL support.
    • Add visual markers (labels or colors) for Audit vs. Archive.

2️⃣ Update Print Cover Generation Logic

  • Modify quality_control.py:
    • Ensure that the form's next step is clearly displayed on the printout.
    • Apply conditional styling based on form status.

3️⃣ Testing & Validation

  • ✅ Verify that printout formatting is clear and readable.
  • ✅ Ensure Arabic translations are accurate and displayed correctly.
  • ✅ Test Audit vs. Archive labeling for different form statuses.

Estimated Level of Effort (LOE)

Task Complexity Estimated Time
1. Update QC Print Cover Template 🟡 Medium 8-12 hours (1-1.5 days)
2. Update Print Cover Generation Logic 🟡 Medium 8-12 hours (1-1.5 days)
3. Unit Tests & Update Existing Tests 🟠 High 12-16 hours (1.5-2 days)
4. QA & UAT (User Testing & Validation) 🟠 High 12-16 hours (1.5-2 days)
5. Deployment & Documentation 🟢 Low 6-8 hours (0.5-1 day)

Total Estimated LOE: ~46-64 hours (~6-8 working days / ~1.5 weeks)

🚀 Effort Level: 🟡 Medium Complexity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant