Skip to content
Zp1021Public

About

Bilingual (English/Spanish) web app that finds credit report errors and drafts dispute letters. In progress.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CreditFix

A bilingual (English / Spanish) web app that helps people find errors in their credit reports and write dispute letters.

Status: Phase 0 — planning and project setup (started October 2026). The architecture, folder layout and roadmap are in place. Feature code is built in phases, listed below.


The problem

Errors on credit reports are common: wrong balances, accounts that are not yours, late payments that were paid on time, and old debts that should have aged off. Fixing them means reading a long report line by line and writing a formal dispute letter. That is hard for anyone, and harder still for people whose first language is not English.

What CreditFix will do

  1. Read a credit report that the user uploads.
  2. Flag likely errors, for example:
    • balances or dates that don't agree across the report
    • duplicate accounts
    • negative items older than the reporting period allows
    • accounts or inquiries the user marks as "not mine"
  3. Explain each flag in plain English or Spanish.
  4. Draft a dispute letter for each issue, ready to print and mail to the credit bureau or the company that reported it.

CreditFix is an educational tool. It does not give legal advice.

Planned architecture

 Browser (React, English/Spanish)
          │
          ▼
 API server (Go) ───────► PostgreSQL
          │
          ├──► Analyzer (Python): reads the report and extracts accounts
          │
          └──► Rule engine (C++): runs the error checks quickly
Folder Language Planned role
frontend/ React (JavaScript) Upload page, results page and letter preview, in English and Spanish
api/ Go REST API that connects the frontend to the analyzer, the rule engine and the database
analyzer/ Python Turns an uploaded report into structured account data
engine/ C++17 Runs the error-checking rules on the structured data
infra/ AWS Deployment setup
docs/ — Roadmap and design notes
samples/ — Made-up sample reports for testing (never real personal data)

Roadmap

Phase What gets built Status
0 — Setup Repository, architecture, folder layout, roadmap In progress
1 — Core app Upload a report → see flagged errors → download a dispute letter (English and Spanish) Planned
2 — Testing Unit tests for each part and automated test runs on every push Planned
3 — Deployment Live on AWS Planned
4 — Documentation Public API documentation and a user guide Planned

See docs/ROADMAP.md for the detailed plan.

Privacy

Credit reports contain sensitive personal information. CreditFix is designed so that:

  • real reports are never committed to this repository (only made-up samples in samples/)
  • uploaded files are processed and then deleted, not stored
  • no data is shared with third parties

Author

Zavier A. Paulino — github.com/zp1021 · linkedin.com/in/zavier-paulino

License

MIT — see LICENSE.

About

Bilingual (English/Spanish) web app that finds credit report errors and drafts dispute letters. In progress.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors