Draft flow of VDP as of 9/29/2026

 

VDP Strategy Builder

Strategy Builder in VDP

Select a box to open its documentation placeholder. Solid arrows are established relationships. Dashed arrows are proposed integrations.


  
VDP-04 is the strategy Markdown export. VDP-05 is the issue packet that would feed the Virtual Voter.

  

    
Back to chart

    
VDP-01

    
Citizens and issue analysts

    
People define issues, provide concerns, and review evidence.

    
Status: Input

    
Technical documentation

    
Placeholder: Roles, consent, input validation, provenance, and access boundaries.

    
End-user documentation

    
Placeholder: How a citizen or analyst opens an issue, contributes context, and reviews a draft.

    
Source documents and links

    
Placeholder: Participant workflow and role permissions.

  

  

    
Back to chart

    
VDP-02

    
Sources, bills, votes, and legislators

    
External material and legislative records used to ground an issue.

    
Status: Source inputs

    
Technical documentation

    
Placeholder: Source adapters, citation IDs, retrieval timestamps, record normalization, and audit history.

    
End-user documentation

    
Placeholder: How to inspect a cited source and report an error.

    
Source documents and links

    
Placeholder: Source register; PA legislative data model.

  

  

    
Back to chart

    
VDP-03

    
Strategy Builder

    
The 21-section workspace for framing an issue and developing a strategy.

    
Status: Working increment

    
Technical documentation

    
Placeholder: Flask routes, SQLite models, section schema, export handlers, and Dashboard Button11 launcher.

    
End-user documentation

    
Placeholder: Issue analyst/facilitator guide: create, edit, review, and export a strategy.

    
Source documents and links

    
Placeholder: Strategy Workbench code and run instructions.

  

  

    
Back to chart

    
VDP-04

    
Strategy Markdown export

    
Human-readable strategy document, such as strategy-2.md.

    
Status: Working export

    
Technical documentation

    
Placeholder: Export format, field mapping, file naming, and round-trip limitations.

    
End-user documentation

    
Placeholder: How to read and share a strategy draft.

    
Source documents and links

    
Placeholder: Sample strategy-2.md.

  

  

    
Back to chart

    
VDP-05

    
VDP Issue Packet

    
Issue packet export, such as ISSUE_PACKET_002.md, intended to carry reviewed issue context downstream.

    
Status: Working export; downstream contract proposed

    
Technical documentation

    
Placeholder: Versioned schema, stable issue ID, claims, evidence citations, dates, and validation rules need definition.

    
End-user documentation

    
Placeholder: How to review packet contents and distinguish fact, interpretation, and proposal.

    
Source documents and links

    
Placeholder: Sample ISSUE_PACKET_002.md; proposed HL7-inspired record specification.

  

  

    
Back to chart

    
VDP-06

    
Virtual Voter

    
Models a citizen's expressed priorities and reasoning for a particular issue.

    
Status: VDP design component

    
Technical documentation

    
Placeholder: Preference representation, authorization, scope limits, explainability, and protection against proxy hijack.

    
End-user documentation

    
Placeholder: How to configure, inspect, challenge, and revoke a voter proxy.

    
Source documents and links

    
Placeholder: Virtual Voter design and Citizen's Oath.

  

  

    
Back to chart

    
VDP-07

    
Elected Official Proxy

    
Represents documented positions and voting records of an elected official.

    
Status: VDP design component

    
Technical documentation

    
Placeholder: Record matching, temporal validity, source attribution, and uncertainty handling.

    
End-user documentation

    
Placeholder: How to see the official's evidence and dispute an incorrect characterization.

    
Source documents and links

    
Placeholder: Legislator and vote data model.

  

  

    
Back to chart

    
VDP-08

    
Comparison and simulation

    
Compares positions and explores outcomes and tradeoffs.

    
Status: Prototype route exists; integration proposed

    
Technical documentation

    
Placeholder: Simulation inputs, trial counts, rate limiting, reproducibility, and confidence boundaries.

    
End-user documentation

    
Placeholder: How to interpret comparison output and its uncertainty.

    
Source documents and links

    
Placeholder: /vdp/demo/api/simulate; issue packet interface.

  

  

    
Back to chart

    
VDP-09

    
Explained findings and publications

    
Presents results, evidence, disagreements, and unresolved questions.

    
Status: Output concept; publishing workflows exist

    
Technical documentation

    
Placeholder: Publication approval, redaction, attribution, accessible rendering, and version history.

    
End-user documentation

    
Placeholder: How to read findings, follow citations, and submit corrections.

    
Source documents and links

    
Placeholder: VDP demo; Blogger and other publication workflow.

  

  

    
Back to chart

    
VDP-10

    
Citizen-to-representative feedback

    
Carries grounded constituent concerns and responses back into issue analysis.

    
Status: Proposed loop

    
Technical documentation

    
Placeholder: Delivery channels, recipient verification, consent, abuse controls, and response tracking.

    
End-user documentation

    
Placeholder: How participants submit feedback and see whether it was delivered or answered.

    
Source documents and links

    
Placeholder: Feedback-loop policy and workflow.

  






































Comments











Post a Comment
























Popular posts from this blog









Feature Deprecated, DB connections from HTML and Presentation




















Image







 First an image of new code and the HTML as it is presented: Since the last entry I've been looking for a way to take data and write it out to the MySQL DB. I created a page Threeindex.html. I have added to buttons and to the menu/nav bar at the top. Only the NavBar at the top gets to the page. I've got the page to work with 2 different platforrms. Tried following the video from UDEMY, but it turns out the Radiobutton and Selectfield methods are deprecated or obsolete in some fashion. Something about FlaskForm/wtforms that is a problem. That took a while to settle that was the issue. I did manage to add error trapping. The "Learn more" buttons for Threeindex demonstrate that feature My continuing to connect what is typed into the HTML in Threeindex to the MySQL. The page Twoindex.html accessed through Flask_app.py code adds the same record - but there is no interaction








Read more










Successful connection to MySQL from HTML




















Image







 Found a page: https://www.geeksforgeeks.org/retrieving-html-from-data-using-flask/ with a screen shot that parallels what I want to do - in terms of connecting to the DB.  Below is the screen shot that I was able to implement in FLASH_APP.PY and ThreeIndex.html in VDP. Below is the Threeindex routine from FLASK_APP.py: @app.route('/Threeindex', methods =["GET", "POST"]) def Threeindex():     """Renders the home page."""     from datetime import date, datetime, timedelta     import mysql.connector     import sys     if request.method == "POST":        # getting input with name = fname in HTML form        first_name = request.form.get("fname")        print('InfoForm a debugginng  message 2 ', file=sys.stderr)        print(first_name, file=sys.stderr)        # getting input with name = lname in HTML form     ...








Read more










Coding paused due and restored





















 A couple of weeks ago I started getting an "Internal Server Error" when I attempted to post a question.  The error log - https://www.pythonanywhere.com/user/BenConnolly/files/var/log/benconnolly.pythonanywhere.com.error.log  reported the following: 2023-04-09 12:11:19,223: error_code=None error_message='You exceeded your current quota, please check your plan and billing details.' error_param=None error_type=insufficient_quota message='OpenAI API error received' stream_error=False I debated with myself if I should sign up for the API Key subscription. Over the weekend the CBS show called 60 Minutes dedicated 2 segment on Artificial Intellience.  This was an inspiration -  I signed up for a pay as you go plan yesterday. 








Read more