utopia-ai
/
Finance-Accounts
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
25 Commits
2 Branches
0 Tags
137 MiB
Python 72.5%
TypeScript 19%
JavaScript 4%
HTML 2.9%
Shell 1.2%
Other 0.3%
 
 
 
 
 
 
Go to file
Talha Ahmed 089f775eeb Recognize 40 more marketplace header variants from the finance reference workbook 
Promotional Discounts (9 marketplaces), German singular credit forms, Belgian
Total Discounts, Italian Marketplace Withheld VAT, the Turkish native headers,
and 8 Transaction Release Date translations. Unmapped amount columns raise
unmapped_amounts errors that block control C2, so these close real gaps.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 		2026-08-24 22:09:48 +05:00
.claude Initial commit: AR aging app with root gitignore. 2026-07-29 18:07:21 +05:00
.gitea/workflows Remove ci.yml - CI/CD is owned by the DevOps pipeline (S3-based delivery) 2026-08-20 16:36:21 +05:00
ar-aging-app Recognize 40 more marketplace header variants from the finance reference workbook 2026-08-24 22:09:48 +05:00
.gitattributes Production readiness: month separation, auth, FX service, AWS deployment 2026-08-19 18:46:47 +05:00
.gitignore fix isuses 2026-08-18 19:37:57 +05:00
README.md Docs: bring both READMEs up to date 2026-08-19 20:07:56 +05:00
plan.md Production readiness: month separation, auth, FX service, AWS deployment 2026-08-19 18:46:47 +05:00

README.md

Finance-Accounts

Finance team tooling for Utopia Brands. The main (currently only) application is the Amazon Accounts Receivable Aging Dashboard — it turns the month's Amazon Custom Unified Transaction exports into the month-end AR workbook, with per-user login (self-service password reset by emailed code), month-end controls, central-bank exchange-rate fetching, and a full audit trail.

Repository layout

ar-aging-app/          The application (FastAPI backend · React frontend)
│
├── backend/           Python API + calculation engine + tests
├── frontend/          React + TypeScript dashboard
├── scripts/           Launchers: start.ps1 / start.bat (Windows) · start.command (macOS)
├── deploy/            Production runbook (DEPLOY.md) + backup script
├── docs/              System guide, AR logic, audit reports
├── docker-compose.yml          local Docker stack (dev)
├── docker-compose.prod.yml     production stack (AWS: HTTPS + MySQL + backups)
└── .env.example       every setting, local + production sections

plan.md                Production-readiness plan (architecture, AWS costs, phases)
sample data (local)    "Test Files/" — real Amazon exports; gitignored, never committed

Quick start

I want to… Do this
Run the app on this PC double-click ar-aging-app/scripts/start.bat → http://localhost:5174
Understand the app ar-aging-app/README.md
Deploy to AWS ar-aging-app/deploy/DEPLOY.md (~$50–55/month)
See how figures are calculated ar-aging-app/docs/system-guide.md
Read the production plan plan.md
Reset a forgotten password login screen → "Forgot password?" (emailed code) — or admin: manage.py set-password
Manage users / fix data python ar-aging-app/backend/manage.py --help

Financial data never enters git: spreadsheets, databases, uploads, and .env* secrets are all ignored (see .gitignore). The only template committed is ar-aging-app/.env.example.