utopia-ai
/
Finance-Accounts
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
28 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 f46fc69562
Deploy to S3 / deploy (push) Successful in 28s Details
Convert at the transaction date's FX rate, auto-fetched from the API 
Processing now seeds fx_rates_daily from the provider (Frankfurter) over the
closing's actual transaction span, and the AR Ledger / daily FX table convert
each dated movement at the rate effective on its own date: exact fixing, else
the previous banking day's fixing (weekends/holidays), else the month rate.
Manual daily overrides are preserved by the auto-fetch and never carry forward.
Provider outages never block the close - they surface as a warning exception.
New AR_FX_AUTO_DAILY env toggle (default on; forced off in tests).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 		2026-08-25 15:23:59 +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 Convert at the transaction date's FX rate, auto-fetched from the API 2026-08-25 15:23:59 +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.