Found more code examples from STM. Used claude to generate a summary (CLAUDE.md)

2026-02-11 06:05:20 -05:00
parent cf0edba776
commit c4b970cbde
33 changed files with 6077 additions and 1 deletions
@@ -0,0 +1,80 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Sunbury Textile Mills (STM) enterprise data integration platform. Handles inventory synchronization between AS400 and Jomar ERP, EDI document processing (850/810/856/997) with multiple trading partners, and financial integrations.
+
+**This is a legacy Python 2 codebase.** Use Python 2 conventions (print statements, `basestring`, `ConfigParser`, etc.).
+
+## Running Tests
+
+```bash
+python FTP/tests.py
+# or
+python -m unittest FTP.tests
+```
+
+Tests cover FTP credential loading, Kravet data processing, and item lookup.
+
+## Dependencies
+
+Install manually (no requirements.txt):
+```bash
+pip install schedule paramiko SQLAlchemy
+```
+Also requires: pyodbc (with appropriate ODBC drivers for MS SQL Server and IBM AS400).
+
+## Production Deployment
+
+1. Stop `scheduler.py` running under SUNBURYTEXTILE\Administrator
+2. Delete all `.pyc` files in `\FTP`
+3. `git pull`
+4. Restart `scheduler.py`
+
+Failing to stop the scheduler before pulling means old compiled code continues running.
+
+## Environment Variables
+
+The following environment variables must be set for the scripts to connect to backend systems:
+
+| Variable | Used by | Purpose |
+|---|---|---|
+| `AS400_UID` | 8 files (AS400_Invoice_Interface, Jomar_SO_Auto_Close, FTP/ACF_process, dt_cut, mg_418, mg_810, mg_856, mg_997) | AS400/iSeries login username |
+| `AS400_PWD` | same files | AS400/iSeries login password |
+| `JOMAR_DB_UID` | Finished_Goods_Interface.py | SQL Server username for Jomar ERP |
+| `JOMAR_DB_PWD` | Finished_Goods_Interface.py | SQL Server password for Jomar ERP |
+
+Additional credentials (FTP/SFTP, email) are loaded at runtime from the SQLite vault at `D:\FTP\ftp.db`.
+
+## Architecture
+
+### Root-level interfaces
+- **Finished_Goods_Interface.py** — Processes CSV files from AS400 (D:\INTERFACE) into Jomar inventory transactions. Triggered by PowerShell file watcher (`finishedGoodsStart.ps1`).
+- **AS400_Invoice_Interface.py** — Auto-closes invoices in AS400 based on Jomar data. Uses pyodbc (AS400) + SQLAlchemy (Jomar).
+- **Jomar_SO_Auto_Close.py** — Weekly sales order closure automation.
+
+### FTP package (`/FTP`)
+Central EDI processing system orchestrated by `scheduler.py` (runs continuously as a scheduled job).
+
+**Trading partner modules follow a naming convention: `{partner_code}_{document_type}.py`**
+- **KF** = Kravet, **MF** = Maharam, **MG** = Momentum, **GR** = Glenraven
+- **850** = Purchase Orders (inbound), **810** = Invoices (outbound), **856** = ASN/Ship Notices, **997** = Functional Acknowledgments
+
+**Shared utilities:**
+- `download_transmissions.py` — FTP/SFTP credential management and file transfer operations. Credentials stored in SQLite DB (`D:\FTP\ftp.db`, table `ftp_auth`).
+- `alert.py` — HTML email notifications with attachment support.
+- `wf_assignments.py` — Wells Fargo invoice assignment via SFTP to spscommerce.net.
+
+### Database connections
+- **Jomar ERP:** `mssql+pyodbc://jsisbprod` (SQLAlchemy)
+- **AS400:** iSeries Access ODBC Driver (pyodbc)
+- **Credentials vault:** SQLite at `D:\FTP\ftp.db`
+
+### File system layout (production)
+The codebase assumes `D:` as root. Key paths:
+- `D:\INTERFACE` (+ `\ERRORS`, `\PROCESSED`) — Finished goods CSV staging
+- `D:\FTP\INCOMING` — Inbound EDI documents
+- `D:\FTP\SEND_{KF,MF,MG,WF}` (+ `\SENT`) — Outbound EDI staging per partner
+- `D:\FTP\OLD\{KF,MF,MG,GR}` — Processed document archive