first push

2026-06-04 16:20:56 -05:00
parent a663de4f29
commit 392ae7bbe3
111 changed files with 5312 additions and 0 deletions
@@ -0,0 +1,82 @@
+---
+type: project
+status: active
+source: git.alwisp.com
+repo: jason/inven
+repo_url: https://git.alwisp.com/jason/inven
+language: TypeScript
+branch: main
+tags: [repo, jason]
+updated: 2026-05-29
+---
+
+# inven
+
+**Repository:** [jason/inven](https://git.alwisp.com/jason/inven) · branch `main` · TypeScript
+
+## Summary
+
+Single-container inventory management for Unraid — parts, assemblies, BOMs, sales/purchase orders, invoicing, and a lightweight accounting journal on SQLite
+
+## Current status
+
+Active. Synced from Gitea on 2026-05-29.
+
+## Documentation overview
+
+# Inven
+
+Inven is a single-container inventory management system for Unraid-style deployments. It manages stocked parts, assemblies built from parts, sales orders and shipping, purchase orders and restocking, customers, vendors, and a lightweight accounting journal on top of SQLite.
+
+## Current Scope
+
+- Parts and assemblies share one item master
+- Assemblies support bill-of-material component definitions
+- Inventory is tracked through a transaction ledger
+- Sales orders can be created and shipped
+- Purchase orders can be created and received
+- Sales orders and purchase orders are created from relational inventory line selections
+- Shipping and receiving are posted from relational order-line quantity controls
+- Sales orders support partial shipments
+- Purchase orders support partial receipts
+- Invoices are generated from shipped sales orders
+- Vendor bills are generated from received purchase orders
+- Customer and vendor payments can clear receivables and payables
+- Customer and vendor directories support the order flows
+- Low-stock and suggested reorder views help drive replenishment
+- A chart of accounts, account balances, and manual journals support the first accounting pass
+- Built-in authentication protects the app with a bootstrap admin login
+
+## Stack
+
+- Next.js App Router
+- TypeScript
+- SQLite via `better-sqlite3`
+- Single Docker container with Next.js standalone output
+
+## Quick Start
+
+1. Install Node.js 22 or newer.
+2. Copy `.env.example` to `.env`.
+3. Set `AUTH_SECRET`, `ADMIN_EMAIL`, and `ADMIN_PASSWORD`.
+4. Update `DATABASE_PATH` if needed.
+5. Install dependencies:
+
+```bash
+npm install
+```
+
+6. Start the development server:
+
+```bash
+npm run dev
+```
+
+7. Open `http://localhost:3000` and sign in with the bootstrap admin credentials.
+
+
+…(truncated — see repo)
+
+## Notes
+
+- Project file auto-created from repo documentation.