What TraceFlow does
NC Subsidized Child Care Assistance (SCCA) is run county by county. Income is documented and calculated in different ways, files are named and stored differently, and problems are often found after payment decisions. TraceFlow sits on top of the existing state and county systems (it doesn't replace them) and makes that work consistent, explainable and auditable.
| Today | With TraceFlow |
|---|---|
| Each county calculates income by hand in its own way | Standard income rules turn every pay type and frequency into a monthly baseline, with the formula shown |
Files named PayStub1.pdf, scan0003.pdf… | Every upload is classified, renamed [CaseID]_[DocType]_[YYYYMMDD] and filed in a standard folder |
| Missing, unsigned or out-of-date evidence found late | Automated checks run on every upload and explain each issue |
| Hard to see why a case was flagged or who decided | Routing rules, two approval levels and an append-only audit trail |
| Little statewide visibility | Dashboards and reports by county, period, exception and outcome |
One connected workspace
- Core
Eligibility & filing
Standard intake, income normalization, document naming, filing and routing.
- Checks
Compliance screening
Automated pre-review checks and explained flags. A State Admin can switch screening on county by county.
- Families
Family portal
Families apply and renew online with an electronic signature, upload requested documents and follow their status.
Decision support only. Calculations and flags never approve or deny a case on their own. An authorized staff member always makes the decision and records a reason.
Getting started
Sign in
| Person | Email (username) | Role | Sees |
|---|---|---|---|
| Alex Williams | alex.williams@traceflow.demo | Caseworker | Mecklenburg County |
| Dana Patel | dana.patel@traceflow.demo | Supervisor | Mecklenburg County |
| Renee Morgan | renee.morgan@traceflow.demo | State Admin | Statewide |
| Kendra Ellis | kendra.ellis@traceflow.demo | Auditor (read-only) | Statewide |
| Jasmine Reed | jasmine.reed@family.demo | Family | Her own application (under review) |
| Monique Harris | monique.harris@family.demo | Family | Renewal due: renews online |
| Marcus Bell | marcus.bell@family.demo | Family | New applicant: applies online |
Sign in
Go to Sign in, enter your email and password, or pick a demo account from the list. Sign out is at the bottom of the left sidebar.
Switch person (demo)
In the demonstration, select your name at the top right (in the top bar, or in the family portal header) to see TraceFlow as any of the people above, staff or family. With real sign-in turned on, it only shows who is signed in.
Staff start on the Operations dashboard, on its My work tab: the Your work tiles (different for each role, each linking to the right queue) and Next up, the cases to open next. Caseworkers see their open and returned cases; supervisors see cases awaiting their decision. The Program overview tab has the program-wide picture. Families start on the Portal.
Back to topHow the workflow works
Every application follows the same path in every county. The diagram shows the case statuses and who moves a case between them.
The same workflow in words
- New intake. A caseworker enters the standard application (or it arrives from the county system or the API) and submits it.
- Under review. TraceFlow calculates income, runs every check and applies the routing rules. The caseworker reviews the case.
- Pending docs. If documents are needed, the caseworker requests them. The family is notified, and the case returns to review automatically when those documents arrive.
- Decide or escalate. A clean, low-risk case can be approved by the caseworker (level 1). Anything else is escalated to the supervisor (level 2).
- Supervisor decision. The supervisor approves, denies (with a policy reason), or sends it back with specific revision items.
- Revise and resubmit. The caseworker answers each item, makes the changes and resubmits. The supervisor sees exactly what changed.
- Renewal. Near the renewal date, the case becomes Renewal due, the family is reminded, and a new review starts.
Who can approve? Routing rules set the approval level. Once a supervisor has been involved (escalated or sent back), a case stays at level 2 until it is decided. Every action records who did it and why.
Start a new application
Sign in as a caseworker (for example Alex Williams) and choose New intake in the sidebar, or the New intake button on Case management.
- Application. Check the county (it's set by your role), the application date, and enter the home address.
- Household. Add each member with name, relationship and date of birth. Exactly one person is the applicant, and at least one child must need care.
- Income. Add each source with its type (wages, gig, child support, self-employment, seasonal…), frequency and amount. The panel on the right shows the formula, the monthly baseline and % of the poverty guideline as you type. For example, $1,240 bi-weekly is $1,240 × 26 ÷ 12 = $2,686.67 a month.
- Review. Check the summary. Any problems are listed in plain language (for example "Household member › At least one child must need care").
- Save. Choose Save & submit for review to calculate, check and route the case right away. Missing documents are flagged immediately. Or choose Save as new intake to keep it as a draft.
Next, add documents (section 5) or Request documents from the family.
Back to topDocuments and checks
Upload on the case's Documents tab, on Document management, through the family portal or through the API. Any file name works. Every file follows the same steps, and the screen shows each step as it happens.
Sample documents for demos: on a case's Documents tab (and in the family portal), open Sample documents for this case. Twelve PDFs are generated with that family's name, employer and amounts. Six pass every check and six each trigger one check: duplicate, missing signature, outside the verification period, income mismatch, unreadable scan and unknown type. Download one and upload it, or press Upload to send it straight through the pipeline.
- ReceiveStored and fingerprinted
- ExtractText read from the PDF
- ClassifyPay stub, ID, lease…
- Key fieldsDate, amount, signature
- Rename
[CaseID]_[DocType]_[Date] - FileCounty / case / type folder
- CheckAll case checks re-run
- Auto-routed or reviewedClean files skip review; flagged files go to a person
What the checks look for
| Flag | Raised when | Severity |
|---|---|---|
| Missing income verification / document; Unverified address | A required document for this household isn't on file | High / Medium |
| Outside verification period | Income evidence dated more than 30 days from the application | High |
| Reported income does not match document | Document amount differs from what was reported by more than 10% | High |
| Significant income change | Income changed more than 20% from the prior period | High |
| Needs classification | The document type couldn't be identified with confidence | Medium |
| Unreadable upload | Text quality below the minimum (for example a photo without text) | Medium |
| Missing signature | A document that must be signed isn't | Medium |
| Duplicate file | The same file was already uploaded | Medium |
| Inconsistent case records | Household size doesn't match the members listed | Medium |
| Repeated return | The case has been sent back 3 times | Medium |
Each flag shows the rule and version that raised it and a plain-language reason. A flag clears automatically when a re-check passes, for example after a better document is uploaded. Otherwise a person acknowledges it with a reason, or asks a supervisor for an override.
Actions on a document
- View file: opens the stored file. Every view is logged.
- Accept: accepts the document despite its flags; a reason is required.
- Request new copy: tells the family what's wrong; their next upload becomes version 2.
- Reclassify: corrects the type; the file is renamed and re-checked.
- Document history: every step that happened to this file.
Review and decisions
| Action | What it does | Who |
|---|---|---|
| Approve | Records the decision and reason; sets the renewal date. Locked while issues are open. The reason is shown under the buttons. | Caseworker (level 1) · Supervisor (level 2) |
| Needs review | Records what needs a closer look as a note. From Pending docs it resumes the review. | Caseworker, Supervisor |
| Request documents | Asks the family for specific documents; the case waits until they arrive. | Caseworker, Supervisor |
| Escalate to supervisor | Sends the case for a level-2 decision. | Caseworker |
| Send back for revision | Returns the case with specific revision items (pre-filled from open flags). | Supervisor |
| Resubmit to supervisor | Available once every revision item has a response. | Caseworker |
| Deny | Requires a policy basis and a reason; the family is notified. | Supervisor |
| Reassign | Moves the case to another worker (also available as a bulk action). | Supervisor |
| Acknowledge / Request override | Accept a flag with a reason, or ask the supervisor to set a finding aside. | Caseworker (medium/low flags), Supervisor (any) |
What supervisors see on resubmission: "Changes since this case was returned" lists the response to each revision item, every field change (before → after) and any new documents.
Features by screen
Operations dashboard
Two tabs. My work: your "Your work" tiles and Next up, the highest-priority cases to open. Program overview: period comparison (7/30/90 days or 12 months vs the previous period), eligibility pipeline, document quality, county performance against the 14-day goal, and issues needing attention. Hover the i on a card to see how a number is calculated; click a number to open the cases behind it.
Work queue
Everything routed to you, highest priority first, with why it's here and the routing rule. Tabs include returned cases, documents to review, the county intake queue, override requests and notifications.
Case management
Case list with search, status, risk and date filters; names masked in lists; bulk export and reassign; CSV export.
Case record
Tabs for Overview (next step, open exceptions, household, document checklist), Income (formulas, % FPL, rule version, history), Documents, Exceptions (each flag with action, owner and source), History (review rounds and audit) and Notes, and the action bar.
Document management
Upload, every filed document with its standardized name and folder, check pass rates, priority items, auto-routing time and estimated staff time saved.
Compliance & exceptions
Open issues by category, an example flag fully explained, and recent audit events.
Reports & analytics
Missing evidence, exception causes, aging work, override activity, county variation and resolution outcomes. Each exports to CSV.
Audit trail
Every action, sign-in and export, with filters and CSV export. The database blocks edits and deletions.
Ask TraceFlow (assistant)
The Ask TraceFlow button at the bottom right of every screen. It knows which page you are on: on a case, ask "Why is this case flagged?" or "What's the next step on this case?" without typing the case ID; on any screen, ask "What can I do on this page?". It is also a guide: ask "How does TraceFlow work, step by step?" or "Where do I upload a document?" and it answers in steps, names the screen and who does each step, and links each step to that page. Every answer shows its sources. It is read-only, sees only what your role can see, and every question is recorded in the audit trail.
Family portal
Apply online and renew online with an electronic signature (typed name, plus an optional drawn signature); status, the exact documents requested, a checklist, uploads and messages. The signed form is filed on the case and passes the same signature check as any upload. Piloted in Mecklenburg.
Roles and views
Each role sees its own "Your work" summary, navigation and "Your work" summary. Screens outside a role's view are blocked on the server, not just hidden.
| Role | Home | Scope | Main tasks |
|---|---|---|---|
| Caseworker | Dashboard → My queue | Own county | Intake, documents, income edits, level-1 approvals, escalations, revisions |
| Supervisor | Dashboard → Awaiting decision | Own county | Level-2 decisions, send-backs, denials, overrides, reassignment, reports |
| State Admin | Dashboard (statewide) | Statewide | Policy rules, routing rules, county rollout, integrations, reports |
| Auditor | Dashboard → Audit trail | Statewide | Read-only review of every record, decision, rule change and report |
| Family | Portal | Own application | Apply or renew online and sign electronically, check status, upload requested documents, read messages |
Key ideas
Standardized income
| Frequency | Formula |
|---|---|
| Weekly | amount × 52 ÷ 12 |
| Bi-weekly | amount × 26 ÷ 12 |
| Semi-monthly | amount × 24 ÷ 12 |
| Monthly | amount |
| Annual | amount ÷ 12 |
| Seasonal | 12-month total ÷ 12 |
| Self-employment | (12-month gross − expenses) ÷ 12 |
| Irregular (gig) | average of the last 3 months |
Risk, approval levels and routing
- Risk is the most serious open flag. Acknowledged flags don't count.
- Level 1: a caseworker may approve a clean, low-risk case. Level 2: a supervisor decides.
- Routing rules run in priority order; the first match sets the queue, priority and approval level. The case shows which rule applied and why.
| Rule | When | Goes to |
|---|---|---|
| R-001 | Risk is high, or an override is requested | Supervisor · level 2 · high priority |
| R-002 | Income changed by more than 20% | Supervisor · level 2 · high priority |
| R-003 | Unreadable, unsigned or unclassified document | Caseworker · medium priority |
| R-004 | New intake in Mecklenburg (pilot) | Mecklenburg intake queue |
| R-999 | Everything else | Assigned caseworker · low priority |
Versions and the audit trail
Rules are versioned: publishing a change never rewrites earlier results, and open cases show a banner offering to re-run under the new rules. The audit trail is add-only and records every upload, rename, check, flag, routing decision, decision, override, rule change, export, sign-in and record view.
Back to topRules, rollout and integrations
- State Admin
Policy rules
Change a value → Preview impact (how many open cases would change; nothing saved) → add the policy reason → Publish new version. History shows field-by-field changes.
- State Admin
Routing rules
Edit or add rules using county, stage, risk, flags, income change and overrides. Test a case shows which rule applies and why.
- State Admin
County rollout
Switch compliance screening and the family portal on statewide or in pilot counties. Pilot feedback is collected here.
- State Admin
Integrations & API
Pull applications from the county system, push decisions to the state system, and run renewal notices. Each run keeps a log. The REST API uses an
x-api-key.
Training exercises
Each exercise has an expected result to check against. The sample files are in the sample document kit on the portal and on each case's upload panel.
| # | As | Do this | You should see |
|---|---|---|---|
| 1 | Alex | New intake: 1 adult and 1 child, wages $1,240 bi-weekly. Save & submit. | Baseline $2,686.67; case Under review with "Missing…" flags |
| 2 | Alex | On that case, upload PayStub1.pdf. | Renamed …_PayStub_…; amount mismatch ($565 vs $1,240) routes it to the supervisor |
| 3 | Alex | Upload PayStub1 (copy).pdf to the same case. | Duplicate file flag |
| 4 | Alex | Upload scan0003.pdf. | Unreadable upload and Needs classification; listed under Documents to review |
| 5 | Alex | Reclassify the scan as Proof of residency. | Renamed …_ProofOfResidency_…; classification flag cleared |
| 6 | Alex | Request documents (Proof of residency) on a clean case. | Pending docs, with an outstanding request panel |
| 7 | Alex | Upload any sample file with Document type = Proof of residency. | Back to Under review automatically; request closed |
| 8 | Dana | Send one case back three times. | Repeated return flag |
| 9 | Dana | Case management → Status = Under review → select 3 → Reassign selected to Jordan Lee. | "Reassigned 3 case(s)" |
| 10 | Renee | Exception criteria → income change 30% → Preview impact. | Fewer income-change findings; nothing saved |
| 11 | Renee, then a Wake caseworker | County rollout → Compliance screening = pilot: Mecklenburg; upload to a Wake case as Amari Hickle; set it back to statewide afterwards. | Upload status "filed" (not screened) |
| 12 | Kendra | Audit trail → category Sessions. | Every sign-in, failed sign-in and role switch |
Troubleshooting and FAQ
A page says "Something went wrong loading this page"
TraceFlow couldn't reach its data. Nothing was changed. Select Try again; if it keeps happening, contact your TraceFlow administrator.
I can't sign in
Check the email and password. Emails are not case-sensitive. If it still fails, contact your TraceFlow administrator.
Why is Approve locked?
The reason is shown under the action buttons, for example "Routing requires supervisor (level 2) approval" or "2 open flag(s) must be resolved or acknowledged". Escalate the case, or resolve the flags.
"View file" is greyed out on a document
Seeded records describe documents but don't include real files. Upload a file to view it.
An upload was rejected
Only PDF, JPG and PNG files up to 15 MB are accepted. Decided (approved or denied) cases don't accept uploads.
Does Ask TraceFlow know what page I'm on?
Yes. It receives the page you're on (for example a case and its tab, or the dashboard with your county filter), so "this case" and "this page" work. It still checks your role for every lookup: opening another county's case in the address bar doesn't let the assistant show it to you.
How do I learn the TraceFlow process?
Ask TraceFlow "How does TraceFlow work, step by step?" or "How do I …?". It walks you through the steps for your role and links each step to the screen where you do it. The Help & guidance page has the same tasks as checklists.
The REST API returns 401
Send the header x-api-key with the API key your TraceFlow administrator issued.
Glossary
| Term | Meaning |
|---|---|
| FPL | Federal Poverty Level guideline for the household size (2025 HHS values in this prototype) |
| Baseline | Standardized monthly income after applying the income rules |
| Flag | An issue raised by an automated check, with its rule, version and reason |
| Acknowledge | Accept a flag with a recorded reason (a supervisor for high-risk flags) |
| Override | A caseworker's request for a supervisor to set aside a check's finding |
| Approval level | 1 = a caseworker may approve; 2 = a supervisor must decide |
| Routing rule | A configurable rule that sets the queue, priority and approval level |
| Review round | One pass of review; each send-back starts a new round |
| Revision item | A specific change the supervisor requires before resubmission |
| Pilot county | A county where a capability is switched on before statewide rollout |