What To Watch
Real-Life Direction
Municipal Housing Choice Voucher A.I. Processing App
A municipal operations platform for Housing Choice Voucher intake, placement, inspections, maintenance, and provider coordination that helps reduce delay, improve visibility, and preserve human review.
Executive Overview
Improve municipal office efficiency for Housing Choice Voucher intake, placement, inspections, and resident support
Built for municipal housing departments and aligned to current CHA-style operations, this platform helps staff reduce backlog, organize provider activity, track inspections, and keep resident cases moving with clearer visibility across the office.
Perspective Dashboard
Homepage dashboard for the current user
This section changes with the signed-in user so each audience sees the most relevant work, responsibilities, and next actions first.
Next Actions
HCV participant next steps
Go straight to listings, application autofill, maintenance requests, and appeal-aware workflow guidance.
Owner and property onboarding
Open ownership verification, W-9 submission, walkthrough upload, and inspection-readiness workflows from one place.
Municipal staff and CHA Housing Director paths
Jump directly into municipal oversight, live queue review, appeals, and delegated operations coverage.
Public Service Standards
What residents and providers should expect from this system
Welcome
A warmer front door for a complicated process
This homepage is meant to improve office efficiency without losing the human side of the process. Residents should see that help, appeal pathways, and maintenance follow-through exist. Providers should see what is required to participate well. Municipal leaders should quickly see what needs intervention now.
Operational focus
Why This Homepage Leads With Operations
Every major workflow is visible from the first screen
The homepage previews how the platform balances fit, public-source availability, inspection readiness, and fair-housing protections before a unit is surfaced to staff or a household.
Housing Spotlight
Listings and availability cues visible from the homepage
A housing-first landing page should show real placement momentum, not just admin tooling. These spotlight cards preview which homes are ready, which need follow-up, and why.
Public CHA Snapshot
Waitlist and housing discovery signals
Official Housing Sources
Where staff and residents can look next
End-To-End Workflow
How the platform moves a household from upload to placement
Priority Cases
Cases needing attention now
Review Queue
Human checkpoints
Why providers participate
Reliable subsidy flow, reduced re-entry, inspection prep guidance, clearer onboarding, and direct API paths make voucher participation easier to sustain.
Review and appeal stay open
If AI helps approve or flag a case, residents and staff can still ask for human review. Optional photos stay walled off from screening, ranking, exports, and partner APIs.
Compliance stays visible
The homepage keeps discrimination rules, source-of-income protections, blind review expectations, and auditability visible instead of burying them deep in settings.
Director Dashboard
CHA Housing Director view across approvals, high-risk reviews, appeals, and operational pressure
This dashboard acts as the CHA Housing Director role, giving the municipal administrator one place to understand queue health, decision risk, staffing pressure, and cases that need intervention.
Municipal Identity + Budget
Rename the platform for your municipality and set budget assumptions
The Housing Director can set the municipality name, local platform name, fiscal-year budget, issued voucher count, and average annual voucher cost so budget pressure stays tied to active obligations.
Budget Snapshot
Balance budget against issued vouchers and outside support
Funding Documents
Add new funding support and update the budget automatically
Funding uploads should create an auditable funding record and update the budget snapshot without requiring separate spreadsheet work.
Public + Private Donations
Record donations and generate automatic receipts
Each donation should update the budget snapshot, classify public or private support, and create a downloadable receipt for finance records.
Placement Analytics
Voucher pipeline and readiness
Provider Risk
Onboarding, ownership, and supplier pressure
Inspection Operations
Remote follow-up and field workload
Affordable Housing Delivery
Chicago new-build obligation tracking
Fair Housing Watch
Blind review, owner patterns, and discrimination safeguards
Bedroom Demand vs Supply
Applications compared to available units by bedroom request
Use this view to spot where HCV participant demand is outpacing the current listing supply for studio, 1, 2, 3, and 4+ bedroom needs.
Trend Watch
Recent movement across intake, approvals, and delivery
These trends compare the most recent 7-day window to the 7 days before it so the CHA Housing Director can see whether pressure is building or improving.
Queue Health
Review status breakdown
Appeals
Appeal status breakdown
Priority Reviews
Cases most likely to need director attention
Upcoming Deadlines
Reviews with the nearest SLA deadlines
Recent Appeals
Most recent appeal activity
Director Notes
Key oversight reminders
Inspection Operations
Scheduled and flagged inspections
Remote Review
When to use Zoom inspections
Uploaded Files
Files the HCV program director can download
Every user-uploaded file stays visible to the director with case context, uploader identity, timestamp, and a direct download action.
Provider Ownership Queue
New properties waiting for onboarding decisions
This queue helps the HCV director confirm ownership, review W-9 materials, and decide whether a new property can enter the listing library.
Staff Roles
Municipal staff who can assist the CHA Housing Director
Delegations
Temporary or queue-based coverage
Role Assignment
Assign data access and functions
Delegation
Delegate temporary responsibility
AI Reference Governance
Trusted CHA and policy sources
Source Controls
Add or review a trusted source
Case Review Queue
Review queue, approval, reversal, and appeal workflows for the full municipal implementation
This console is designed for the full backend implementation. It gives Municipal Staff a clear review queue, human-review workflow, and appeal pathway while preserving CHA Housing Director oversight.
Backend Status
Checking service...
The full backend can be installed for a scheduled demo or municipal deployment. When connected, this panel shows whether the live service is available.
Quick Actions
Operations shortcuts
Use these controls to refresh connected data or load a demonstration case for scheduled walkthroughs and office-efficiency review.
Human Oversight
Decision rule
AI may provisionally approve a low-risk review if the workflow allows it, but Municipal Staff can still reopen that review later and record a human appeal decision.
Reviews
Live backend review queue
Appeals
Live appeal queue
Review Action
Approve, reject, AI-approve, or reopen a review
Appeal Action
Submit or decide an appeal
File Upload
Upload a director-downloadable user file
Director Access
Download access without losing oversight
The director can download every uploaded file from the admin dashboard for audit, appeal, fraud review, and escalation work. Access should still be role-logged, time-stamped, and reversible if a file needs to be reclassified or restricted later.
Eligibility + Document Review
Flag suspicious vouchers and uploads before they affect placement
The safest operating model is not to auto-reject suspicious documents. Instead, combine verification rules, AI extraction, duplicate detection, manual review escalation, and limited AI approval for low-risk cases that can still be reviewed or reversed later.
Verification Pipeline
Recommended Flag Rules
AI Approval Policy
How backlog prevention should work
Appeals
How a decision gets challenged
Live Queue
Verification cases
Official CHA Library
Public documents approved for AI reference and Municipal Staff review
This library should be versioned and reviewed by Municipal Staff before any document becomes a trusted AI reference source for voucher verification or inspection support.
Official HCV Document Recognition
How the AI should recognize official CHA Housing Choice Voucher materials
The AI should only treat a document as an official CHA HCV-style record when it matches a trusted public source family, expected field set, and known workflow context. Unsupported or drifted layouts should be flagged for human review, not auto-cleared.
Participant Services
Track your housing search, update your profile, and apply with one saved record
This workspace keeps the resident side clear and reusable: city HCV ID verification, proof-of-income updates, listing search, walkthrough review, and one-click application drafting from the saved profile.
My Dashboard
Resident status and next steps
City Verification
HCV participant ID and verification status
Update Profile
Keep household, income, and contact details current
My Applications
Track property applications and review stages
Proof Of Income Upload
Upload current income proof directly from the resident workspace
Latest Income Proof
Current resident income-proof record
Property Search
Search listings matched for HCV participants
Walkthroughs
Review uploaded walkthroughs before applying
Apply From Workspace
Submit a listing application with your saved profile
Autofill Notes
How the workspace uses your profile
Placement Pipeline
Match households to units without exposing protected traits
Matching should optimize for voucher fit, geography, accessibility, transit, and provider responsiveness while keeping resident identity exposure as limited as possible.
Use mobility area status, transit access, accessibility fit, inspection history, provider responsiveness, and payment-standard fit before recommending a home.
Suggested Listings
Blind-matched unit queue
Current CHA Status
Public waitlist and housing availability snapshot
Official Housing Sources
Where current public CHA housing data can be pulled from
Fair Application Handling
How the platform handles multiple applications fairly
Fair Housing Rules
Federal, Illinois, and Chicago reminders shown in-app
Chicago New-Build Affordable Housing
Affordable Requirements Ordinance intake support for new developments
This is an intake-aligned ARO support tool for providers and developers. It should help teams prepare for Chicago affordability obligations, but final legal compliance still depends on City review.
ARO Estimator
Estimate affordable unit obligations using the current City intake options
HCV Participant Profile
Resident profile and employment proof
Owner Profiles
Owner history and latest walkthroughs
Apply To Listing
Auto-fill a property application from the HCV participant profile
Application Queue
Submitted listing applications
Owner Or Municipal Staff Decision
Advance, request contact release, approve, or decline with a compliant code
Owner Queue Rules
Session-backed fair-review reminders
Provider Onboarding
Add a new property with ownership and W-9 verification
Ownership Queue
AI-assisted provider verification status
Inspection Readiness
Use AI to summarize evidence and surface checklist risks
This workflow is based on current CHA-published inspection materials. AI should point inspectors to possible issues, not independently fail a home.
Inspection Evidence Model
Checklist Areas Used for Flagging
AI Review Queue
Inspections needing human confirmation
Property Manager Upload
Upload a walkthrough video for AI checklist analysis
Walkthrough Queue
AI-flagged uploads from property managers
Inspection Calendar
Scheduled in-person and Zoom inspections
Inspection Scheduling
Create or escalate an inspection
Notification History
Zoom invite and operations notifications
Resident Repair Requests
Track your repair requests, entry scheduling, and completion proof
This workspace is for HCV participants who need to report repair issues, follow scheduling updates, and make sure habitability concerns are actually resolved.
My Repair Requests
Open issues, vendor timing, and proof status
Property Operations
Report tenant issues, manage repairs, and coordinate vendors
This workspace keeps tenant conduct issues, repair execution, vendor scheduling, quotes, and billing together so property-side teams can act without losing CHA visibility.
Tenant Issues
Cases waiting on outreach, correction, or resolution
Repair Workflow
Requests, entry coordination, and repair progress
Vendor Jobs
Assigned work, quotes, invoices, and payment readiness
Vendor Operations
Maintain certification, pick up jobs, and submit proof for payment
This workspace is for approved or applying repair vendors who need a clean job board, quote path, proof-of-repair submission, and invoice/payment workflow.
My Vendor Profile
Certification, specialties, and contract status
My Jobs
Pickup, repair proof, invoice, and payment status
Maintenance Coordination
Monitor registrations, tenant issues, repairs, vendor approval, and payments
This workspace is for Municipal Staff and the CHA Housing Director to keep repair operations moving while preserving documentation, entry expectations, escalation, and payment controls.
Registration Oversight
Requests waiting for access review
Vendor Approval
Vendor certifications and contract status
Tenant Issues
Correction plans and unresolved escalations
Repair And Payment Oversight
Repairs, invoices, and payment approvals
Maintenance
Run registrations, tenant issues, repairs, and vendor jobs in one workflow
Residents can report repairs, property managers can report tenant issues, vendors can submit certifications and pick up jobs, and CHA can monitor deadlines, quotes, repairs, invoices, and payment approval.
Portal Focus
Shared operations view
Registration Hub
Register a new participant, property, manager, broker, or vendor
Registration Queue
Requests waiting for CHA review
Property Manager Issue Report
Report tenant issues for CHA correction and follow-up
Tenant Issue Queue
Cases for CHA follow-up and correction
Resident Maintenance Request
Submit repair issues with entry and coverage details
Property Manager Repair Update
Submit quotes, scheduling, proof, and bills
Maintenance Queue
Open repairs, scheduling, and billing follow-up
Vendor Portal
Register or update approved vendor certification
Vendor Approval Queue
Approved or pending repair vendors
Vendor Job Routing
Create or assign a repair job
Vendor Job Board
Jobs available for pickup, quote, repair, and billing
Provider Readiness
Track ownership review, ARO readiness, and listing activation
This portal gives property owners, managers, and CHA reviewers a cleaner view of provider onboarding, ownership verification, required documents, and listing readiness.
Quick Start
Open property onboarding
Go straight to the property intake form with ownership, W-9, ARO, and listing-readiness fields.
Ownership Check
Run ownership verification
Jump to the ownership-check fields to compare claimed ownership against approved public-record sources.
Walkthrough Upload
Send a readiness walkthrough
Open the walkthrough upload form so a property manager can submit a unit video summary for AI checklist review.
Onboarding Queue
Properties waiting on verification or activation
Listing Readiness
Which units are ready to match and which still need work
Inspection Scheduling
Run walkthrough review, follow-up scheduling, and inspection clearance
This portal focuses the inspection workflow for owners, property managers, inspectors, and CHA reviewers without making them work through unrelated screens.
Walkthrough Review
Uploads and AI flags that still need action
Appointment Calendar
Zoom follow-ups, in-person visits, and completion status
Participant Housing Search
Search listings that fit HCV size, neighborhood, and accessibility needs
This portal gives HCV participants a cleaner view of likely-fit housing, active applications, and walkthrough availability without requiring them to work through staff-facing placement tools.
Portal Apply
Apply from resident search
Portal Guidance
How search and apply work together
Likely-Fit Listings
Listings filtered to the resident profile and current search settings
My Placement Activity
Applications, blind review stage, and current readiness
Placement Decisions
Review supply, blind applications, and activation readiness
This portal focuses placement work for owners, providers, and Municipal Staff so listing readiness and blind-review decisions can be managed without bouncing between unrelated screens.
Application Review Queue
Blind-review applications waiting on the next compliant step
Placement-Ready Supply
Listings and onboarding signals that affect placement speed
Verification Workflow
Work the HCV verification queue, risk flags, and resident readiness
This portal gives Municipal Staff and the CHA Housing Director a tighter view of suspicious uploads, auto-eligible low-risk cases, and residents who still need verification follow-up.
Priority Verification Queue
Uploads and cases that still need human or AI-assisted action
Resident Readiness Signals
Profiles with missing verification, income proof, or city ID support
Participant Appeals
Track review outcomes, appeals, and reversible decisions tied to your HCV case
This portal gives HCV participants a direct view of review decisions, submitted appeals, and whether any AI-assisted action can still be revisited by a human reviewer.
My Review Decisions
Case reviews affecting readiness, uploads, or placement progression
My Appeals
Appeals submitted, decision status, and next step visibility
Review Resolution Portal
Resolve queued reviews, reversals, and appeals without leaving the case workflow
This portal gives Municipal Staff a concentrated view of active review work, provisional AI approvals, reopened items, and appeals that still need resolution.
Review Action
Resolve a review from this portal
Appeal Action
Resolve an appeal from this portal
Active Reviews
Pending, reopened, and high-risk reviews waiting on action
Appeal Resolution Queue
Appeals that need a decision, reversal, or resident follow-up
Director Case Oversight
See backlog pressure, reversible AI decisions, and appeal escalation in one place
This portal gives the CHA Housing Director a tighter oversight view of review backlog, pending appeals, reopened cases, and recent supporting documents without replacing the broader Municipal Admin Dashboard.
Priority Reviews
High-risk, expiring, or reopened reviews needing director attention
Appeals + Evidence
Pending appeals and recent files supporting director decisions
Participant Documents + Notices
See your HCV uploads, readiness files, and program notices in one place
This portal gives HCV participants a clearer record of what they uploaded, what notices have been sent, and what still needs a response or additional document.
Upload Income Proof
Send a new proof-of-income file
Portal Notes
How resident uploads are used
My Files
Income proof, case uploads, and supporting documents tied to the resident case
My Notices
Messages, reminders, and next-step communications
Provider Documents + Notices
Track ownership files, W-9s, walkthrough evidence, and provider notices
This portal keeps provider-side uploads and follow-up messages together so onboarding, inspections, and repair coordination do not disappear into separate queues.
Provider Upload
Send W-9s, ownership proof, and walkthrough evidence
Portal Guidance
How provider documents are handled
Provider Files
Ownership proof, W-9s, walkthrough uploads, and supporting evidence
Provider Notices
Inspection updates, onboarding follow-up, and scheduling messages
Municipal Records Center
Monitor intake, downloads, and communications across resident and provider workflows
This portal gives Municipal Staff and the CHA Housing Director a focused place to watch incoming files, communication activity, and cross-workflow document follow-up without relying only on the larger admin dashboard.
Municipal Intake
Create a municipal document record from this portal
Municipal Notes
What belongs in this intake lane
Recent Files
Latest resident, provider, inspection, and maintenance uploads
Recent Notices
Operational messages and follow-up communications requiring attention
Provider Automation
Connect provider systems for listings, onboarding, inspections, and notices
This portal gives providers, owners, and property managers a clearer view of which workflows can be automated safely, what data can be shared, and which readiness steps still need a person in the loop.
Provider Connectors
Listing, ownership, inspection, and maintenance automations
Automation Readiness
What providers should complete before opening API access
Vendor Automation
Connect vendors for job pickup, repair proof, invoicing, and payment updates
This portal gives repair vendors a simpler automation path around certification, work assignment, repair evidence, billing, and payment status without exposing unrelated housing data.
Vendor Connectors
Repair-job, invoice, and certification data-sharing targets
Vendor Readiness
Conditions for approved vendor automation and payment flow
Partner Management
Oversee broker, provider, vendor, and municipal API access from one place
This portal gives Municipal Staff and the CHA Housing Director a focused partner-automation hub for scope design, connector targeting, and oversight of which outside parties should be allowed to automate each workflow.
Partner Connector Targets
Current data-sharing and integration priorities
Oversight Controls
Scope, audit, and human-review conditions for partner automation
Fair Housing + Oversight
Modernize the workflow without automating bias
Every consequential workflow should have a defined human owner, a reason code system, a clear appeal path, and a reversible AI approval fallback when staffing gaps occur.
Guardrails
Modernization Recommendations
Integrations + Data Sharing
Let providers, brokers, and partners automate safely
The API should expose only what each party needs, with scope-based permissions, event logging, and revocable access.