A docassemble extension to utilizing a multi-part interview to create either a 1) Legal, 2) Spanish, 3) FAST, or 4) BHA retainer
Project description
LAWV Retainer Agreement Interview
A Docassemble interview developed by Legal Aid of West Virginia to allow advocates to generate, sign, email, and receive signed retainer agreements from clients. This tool streamlines the process for English, Spanish, FAST, and BHA retainer workflows while ensuring compliance with Legal Aid protocols.
The interview guides advocates and clients through entering required information, reviewing the applicable retainer terms, signing electronically, and automatically distributing completed documents.
Purpose
This tool assists advocates in creating a complete and compliant retainer agreement for Legal Aid of West Virginia clients. It supports multiple program types, sends copies to all required parties, and facilitates digital signatures for both the advocate and the client.
Features
User-Facing Features
- Advocate selects whether signing personally or preparing for another staff member
- Guided entry of advocate, alternate advocate, client, and custodian (if applicable)
- Client citizenship screening with Non‑Citizen Status Questionnaire prompt
- Program‑specific retainer paths:
- English Legal Retainer
- Spanish Legal Retainer
- FAST Advocate Retainer
- BHA Advocate Retainer
- Limited and extended scope options for English/Spanish legal retainers
- FAST and BHA service‑level checklists
- Client and advocate digital signatures
- Automatic email delivery of signed forms
- Ability for client to reject terms, generating notification back to LAWV
Technical Features
- Uses docassemble.LAWVCommon for styling and shared utility functions
- Multi‑party signature workflow (advocate → client)
- Dynamic generation of the correct retainer PDF based on program type
- Conditional logic managing:
- Citizenship rules
- Custodian behavior
- Co‑representation disclosures
- Opt‑out of “Use of Information” terms
- Automatic notification emails using Docassemble templates
- Separate email handling when the retainer is prepared on behalf of another advocate
File Information
This repository includes the primary Docassemble interview file:
retainer.yml— Full interview logic, screens, validations, signature workflow, and document assembly configuration.
The YAML references several templates that must be included in the Docassemble package:
lawv_retainer.pdflawv_retainer_spanish.pdffast.pdfbha.pdf- Optional sample PDFs:
fast_sample.pdfbha_sample.pdflawv_retainer_sample.pdflawv_retainer_spanish_sample.pdf
non_citizen_status_worksheet.pdf
Logic Overview
The interview performs the following key actions:
- Determines whether the advocate is signing personally or preparing the retainer for someone else
- Collects advocate, alternate advocate (if applicable), and client information
- Screens client for citizenship and presents the mandatory non‑citizen questionnaire when needed
- Prompts for retainer type:
- English or Spanish Legal Retainer
- FAST Retainer
- BHA Retainer
- For legal retainers:
- Captures scope: limited or extended
- Provides detailed checklists or fields depending on scope
- For FAST and BHA:
- Guides selection of service levels
- Handles custodian rules for minors or protected persons
- Reviews and displays applicable terms, including required LAWV disclosures
- Captures advocate signature (typed or digital)
- Sends notification email to the client for their signature
- Validates client identity via birthdate challenge
- Presents the client with their portion of the retainer and signature options
- Sends completed documents to both client and advocate(s)
- Handles rejection pathways and notifies LAWV if terms are declined
Output
Depending on the type of retainer selected, the interview generates and emails:
- A completed PDF retainer agreement
- English and/or Spanish versions (for legal retainers)
- FAST or BHA program‑specific PDF retainers
- Copies automatically sent to the advocate, alternate advocate (if applicable), and the client
All personal information is purged once the interview is complete.
Contact
Created by Dane W. Henry, Esq. for Legal Aid of West Virginia.
More information about Legal Aid of West Virginia:
https://legalaidwv.org/
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file docassemble_lawvretainer-2.0.3.tar.gz.
File metadata
- Download URL: docassemble_lawvretainer-2.0.3.tar.gz
- Upload date:
- Size: 4.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cd09c64285cc45208958f8263f21fb435accea5c2e09a9918d83bbdd978b309a
|
|
| MD5 |
9b46800e16242fb24fa95164fc47435d
|
|
| BLAKE2b-256 |
28b143b116eb949164b3cc2da1a985082eb309daeace30bf0593e56e4cd3edb5
|