Democracy SMART-D Requirements Details — Operations and Administration Requirements V1

Purpose

This reviewer-facing page defines SMART-D details for the Democracy requirement group: Operations and Administration Requirements.

Phase Boundary: Requirements review only. Metrics scoring, report-card use, legislative mapping, issue grades, member grades, rollups, leaderboards, and action tools are disabled for this reviewer-facing page.

Color Rule

Red text = bad current value, bad trend, missing critical data, or unfavorable gap. Green text = favorable value or improving trend. Amber text = context-dependent, incomplete, or source-method review needed. Neutral/gray text = descriptive value that is not inherently good or bad.

SMART-D Requirements Matrix

RequirementMetric / MeasurementTop Countries / SourcesValue to the American PeopleGap / Target / Timeframe
DEM-OPS-001: Operations and Administration Requirements
Requirement: The public Democracy folders shall contain only necessary public files, data files, and support files. Drafts, reviews, scripts, and work products shall be stored under support or ETL folders.
Verification: Architecture audit.
Review Status: Draft / source-method review required
Current Metric: Candidate issue-operations, backup, audit-readiness, and maintainability indicator set; source-method review required.
Current Value: Not yet approved for scoring.
Current Trend: Not yet approved for scoring.
Automation Feasibility: To be assessed during metrics development.
Trend Meaning: No trend should be interpreted until the source, formula, baseline period, and limitations are approved.
Source-Method Review: Required
Source families and approved datasets must be selected during source-method review before public scoring.
Comparator Caution: Democracy comparators are useful for context but should not be treated as one-to-one targets without method review.
Keeps the Democracy issue maintainable, auditable, backed up, and separated between public and support files. Gap: No approved public baseline yet.
Target: Approved requirement text, approved metric candidate, source registry entry, formula, limitations, update frequency, and review decision before scoring.
Timeframe: Complete during requirements and metrics review before public report-card promotion.
DEM-OPS-002: Operations and Administration Requirements
Requirement: The Democracy issue shall include an _issue_support folder for source definitions, review files, metric catalogs, audit outputs, and draft materials not intended for direct public navigation.
Verification: Folder inventory review.
Review Status: Draft / source-method review required
Current Metric: Candidate issue-operations, backup, audit-readiness, and maintainability indicator set; source-method review required.
Current Value: Not yet approved for scoring.
Current Trend: Not yet approved for scoring.
Automation Feasibility: To be assessed during metrics development.
Trend Meaning: No trend should be interpreted until the source, formula, baseline period, and limitations are approved.
Source-Method Review: Required
Source families and approved datasets must be selected during source-method review before public scoring.
Comparator Caution: Democracy comparators are useful for context but should not be treated as one-to-one targets without method review.
Keeps the Democracy issue maintainable, auditable, backed up, and separated between public and support files. Gap: No approved public baseline yet.
Target: Approved requirement text, approved metric candidate, source registry entry, formula, limitations, update frequency, and review decision before scoring.
Timeframe: Complete during requirements and metrics review before public report-card promotion.
DEM-OPS-003: Operations and Administration Requirements
Requirement: The system shall support a Democracy architecture audit that inventories folders, files, ZIPs, dependencies, admin gaps, public files, App_Data, includes, scripts, and unusual files.
Verification: Audit script output review.
Review Status: Draft / source-method review required
Current Metric: Candidate issue-operations, backup, audit-readiness, and maintainability indicator set; source-method review required.
Current Value: Not yet approved for scoring.
Current Trend: Not yet approved for scoring.
Automation Feasibility: To be assessed during metrics development.
Trend Meaning: No trend should be interpreted until the source, formula, baseline period, and limitations are approved.
Source-Method Review: Required
Source families and approved datasets must be selected during source-method review before public scoring.
Comparator Caution: Democracy comparators are useful for context but should not be treated as one-to-one targets without method review.
Keeps the Democracy issue maintainable, auditable, backed up, and separated between public and support files. Gap: No approved public baseline yet.
Target: Approved requirement text, approved metric candidate, source registry entry, formula, limitations, update frequency, and review decision before scoring.
Timeframe: Complete during requirements and metrics review before public report-card promotion.
DEM-OPS-004: Operations and Administration Requirements
Requirement: Before significant Democracy folder reorganization or file replacement, the operator shall create or verify a dated backup root using the established backup pattern.
Verification: Backup folder existence check.
Review Status: Draft / source-method review required
Current Metric: Candidate issue-operations, backup, audit-readiness, and maintainability indicator set; source-method review required.
Current Value: Not yet approved for scoring.
Current Trend: Not yet approved for scoring.
Automation Feasibility: To be assessed during metrics development.
Trend Meaning: No trend should be interpreted until the source, formula, baseline period, and limitations are approved.
Source-Method Review: Required
Source families and approved datasets must be selected during source-method review before public scoring.
Comparator Caution: Democracy comparators are useful for context but should not be treated as one-to-one targets without method review.
Keeps the Democracy issue maintainable, auditable, backed up, and separated between public and support files. Gap: No approved public baseline yet.
Target: Approved requirement text, approved metric candidate, source registry entry, formula, limitations, update frequency, and review decision before scoring.
Timeframe: Complete during requirements and metrics review before public report-card promotion.
DEM-OPS-005: Operations and Administration Requirements
Requirement: ZIP files shall be inventoried before movement, deletion, or archival.
Verification: ZIP inventory report.
Review Status: Draft / source-method review required
Current Metric: Candidate issue-operations, backup, audit-readiness, and maintainability indicator set; source-method review required.
Current Value: Not yet approved for scoring.
Current Trend: Not yet approved for scoring.
Automation Feasibility: To be assessed during metrics development.
Trend Meaning: No trend should be interpreted until the source, formula, baseline period, and limitations are approved.
Source-Method Review: Required
Source families and approved datasets must be selected during source-method review before public scoring.
Comparator Caution: Democracy comparators are useful for context but should not be treated as one-to-one targets without method review.
Keeps the Democracy issue maintainable, auditable, backed up, and separated between public and support files. Gap: No approved public baseline yet.
Target: Approved requirement text, approved metric candidate, source registry entry, formula, limitations, update frequency, and review decision before scoring.
Timeframe: Complete during requirements and metrics review before public report-card promotion.
DEM-OPS-006: Operations and Administration Requirements
Requirement: Data ingestion, scoring, audit, source processing, and report generation shall be handled by Python scripts where practical.
Verification: Script inventory, ETL test.
Review Status: Draft / source-method review required
Current Metric: Candidate issue-operations, backup, audit-readiness, and maintainability indicator set; source-method review required.
Current Value: Not yet approved for scoring.
Current Trend: Not yet approved for scoring.
Automation Feasibility: To be assessed during metrics development.
Trend Meaning: No trend should be interpreted until the source, formula, baseline period, and limitations are approved.
Source-Method Review: Required
Source families and approved datasets must be selected during source-method review before public scoring.
Comparator Caution: Democracy comparators are useful for context but should not be treated as one-to-one targets without method review.
Keeps the Democracy issue maintainable, auditable, backed up, and separated between public and support files. Gap: No approved public baseline yet.
Target: Approved requirement text, approved metric candidate, source registry entry, formula, limitations, update frequency, and review decision before scoring.
Timeframe: Complete during requirements and metrics review before public report-card promotion.
DEM-OPS-007: Operations and Administration Requirements
Requirement: ASPX/JScript pages shall focus on display, controls, simple public rendering, and admin trigger interfaces rather than complex data transformation.
Verification: Code review.
Review Status: Draft / source-method review required
Current Metric: Candidate issue-operations, backup, audit-readiness, and maintainability indicator set; source-method review required.
Current Value: Not yet approved for scoring.
Current Trend: Not yet approved for scoring.
Automation Feasibility: To be assessed during metrics development.
Trend Meaning: No trend should be interpreted until the source, formula, baseline period, and limitations are approved.
Source-Method Review: Required
Source families and approved datasets must be selected during source-method review before public scoring.
Comparator Caution: Democracy comparators are useful for context but should not be treated as one-to-one targets without method review.
Keeps the Democracy issue maintainable, auditable, backed up, and separated between public and support files. Gap: No approved public baseline yet.
Target: Approved requirement text, approved metric candidate, source registry entry, formula, limitations, update frequency, and review decision before scoring.
Timeframe: Complete during requirements and metrics review before public report-card promotion.
DEM-OPS-008: Operations and Administration Requirements
Requirement: Python-generated Democracy outputs intended for public display shall be written as JSON files consumable by ASPX/JScript pages.
Verification: JSON schema validation, page load test.
Review Status: Draft / source-method review required
Current Metric: Candidate issue-operations, backup, audit-readiness, and maintainability indicator set; source-method review required.
Current Value: Not yet approved for scoring.
Current Trend: Not yet approved for scoring.
Automation Feasibility: To be assessed during metrics development.
Trend Meaning: No trend should be interpreted until the source, formula, baseline period, and limitations are approved.
Source-Method Review: Required
Source families and approved datasets must be selected during source-method review before public scoring.
Comparator Caution: Democracy comparators are useful for context but should not be treated as one-to-one targets without method review.
Keeps the Democracy issue maintainable, auditable, backed up, and separated between public and support files. Gap: No approved public baseline yet.
Target: Approved requirement text, approved metric candidate, source registry entry, formula, limitations, update frequency, and review decision before scoring.
Timeframe: Complete during requirements and metrics review before public report-card promotion.
DEM-OPS-009: Operations and Administration Requirements
Requirement: CSV files shall be used where practical for human-editable source review, manual overrides, promotion decisions, and metric review checklists.
Verification: CSV audit, import test.
Review Status: Draft / source-method review required
Current Metric: Candidate issue-operations, backup, audit-readiness, and maintainability indicator set; source-method review required.
Current Value: Not yet approved for scoring.
Current Trend: Not yet approved for scoring.
Automation Feasibility: To be assessed during metrics development.
Trend Meaning: No trend should be interpreted until the source, formula, baseline period, and limitations are approved.
Source-Method Review: Required
Source families and approved datasets must be selected during source-method review before public scoring.
Comparator Caution: Democracy comparators are useful for context but should not be treated as one-to-one targets without method review.
Keeps the Democracy issue maintainable, auditable, backed up, and separated between public and support files. Gap: No approved public baseline yet.
Target: Approved requirement text, approved metric candidate, source registry entry, formula, limitations, update frequency, and review decision before scoring.
Timeframe: Complete during requirements and metrics review before public report-card promotion.