diff --git a/.claude/worktrees/mystifying-wright b/.claude/worktrees/mystifying-wright new file mode 160000 index 0000000..daced2b --- /dev/null +++ b/.claude/worktrees/mystifying-wright @@ -0,0 +1 @@ +Subproject commit daced2b7c9e9ab0eded983f0e4f339787f7e1f68 diff --git a/AGENTS.md b/AGENTS.md index 9aa699e..785c42f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -6,7 +6,7 @@ This file defines project-specific guidance for future contributors and coding a ## Project overview -MRP Codex is a modular Manufacturing Resource Planning platform intended to be a lighter, sleeker alternative to Odoo. The current repository contains the foundation release: +CODEXIUM is a modular Manufacturing Resource Planning platform intended to be a lighter, sleeker alternative to Odoo. The current repository contains the foundation release: - React + Vite + Tailwind frontend - Express + TypeScript backend @@ -18,6 +18,7 @@ MRP Codex is a modular Manufacturing Resource Planning platform intended to be a - inventory items, BOMs, warehouses, locations, transactions, item attachments, and item pricing - inventory transfers, reservations, available-stock visibility, and work-order reservation automation - inventory SKU master builder with family-scoped sequence generation and branch-aware taxonomy management +- inventory thumbnail image staging on create/edit and dedicated thumbnail display on item detail - sales quotes, sales orders, approvals, revision history/comparison, and purchase orders - purchase-order revision history and revision comparison across document and receipt changes - purchase-order supporting documents and vendor-side purchasing visibility @@ -36,6 +37,7 @@ MRP Codex is a modular Manufacturing Resource Planning platform intended to be a - backup/restore guidance, richer startup diagnostics, and exportable support bundles in the admin diagnostics workflow - backup verification checklist and restore-drill runbook in the admin diagnostics workflow - support-log viewing, filtering, retention cleanup, and support debugging helpers in the admin diagnostics workflow +- startup brand-theme hydration so Company Settings colors persist across refresh - Puppeteer PDF foundation - single-container Docker deployment @@ -163,3 +165,4 @@ If you cannot run one of those checks, say so explicitly. - Prisma runtime on Debian bookworm requires `debian-openssl-3.0.x` - `shared` package exports must use Node ESM-compatible `.js` specifiers - Local Docker validation may fail if the Docker daemon is unavailable; distinguish daemon issues from image issues + diff --git a/CHANGELOG.md b/CHANGELOG.md index 1d73094..53ac2af 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,6 @@ # Changelog -This file is the running release and change log for MRP Codex. Keep it updated whenever shipped functionality, architecture expectations, deployment behavior, or operator-facing workflows materially change. +This file is the running release and change log for CODEXIUM. Keep it updated whenever shipped functionality, architecture expectations, deployment behavior, or operator-facing workflows materially change. ## Unreleased @@ -8,6 +8,7 @@ This file is the running release and change log for MRP Codex. Keep it updated w - Inventory SKU master builder with family-level sequence codes, branch-aware taxonomy management, and generated SKU previews on the item form - Thumbnail image attachment staging on inventory item create/edit pages, with upload-on-save and replacement/removal support +- Dedicated inventory-item thumbnail display on the item detail page - Revision comparison views for sales quotes, sales orders, and purchase orders with field- and line-level before/after diffs - Purchase-order revision snapshots covering document edits, status changes, and receipt posting - Session review cues on admin auth sessions, including flagged stale activity, multi-session counts, and multi-IP warnings @@ -60,6 +61,9 @@ This file is the running release and change log for MRP Codex. Keep it updated w ### Changed +- Company theme colors and font now persist correctly across refresh through startup brand-profile hydration in the frontend theme provider +- Demand-planning purchase-order draft generation now links sales-order lines only when the purchase item matches the originating sales item +- Admin user edits now normalize blank passwords to null and surface save failures instead of appearing unresponsive - Fresh bootstrap now creates only minimal system records; operational domains no longer start with seeded demo customers, vendors, inventory, BOMs, or warehouses - Sales and purchasing detail pages now expose revision comparison directly alongside chronological revision history - `ROADMAP.md` now tracks remaining work only, and shipped phase history now lives in `SHIPPED.md` @@ -144,3 +148,4 @@ This file is the running release and change log for MRP Codex. Keep it updated w - Vendor invoice/supporting-document attachments - Sales approvals and document revision history - Projects, manufacturing execution, and planning depth + diff --git a/INSTRUCTIONS.md b/INSTRUCTIONS.md index f0d33f4..c4e7711 100644 --- a/INSTRUCTIONS.md +++ b/INSTRUCTIONS.md @@ -17,6 +17,7 @@ This repository implements the platform foundation milestone: - inventory master data, BOM, warehouse, stock-location, transactions, and item attachments - inventory transfers, reservations, available-stock visibility, and work-order reservation automation - inventory SKU master builder with family-scoped sequence generation and branch-aware taxonomy management +- inventory thumbnail image staging on create/edit and dedicated thumbnail display on item detail - sales quotes and sales orders with quick actions and quote conversion - sales approvals, approval stamps, automatic revision history, and revision comparison on quotes and sales orders - purchase orders with quick actions and searchable vendor/SKU entry @@ -40,6 +41,7 @@ This repository implements the platform foundation milestone: - backup/restore guidance, richer startup diagnostics, and exportable support bundles in diagnostics - backup verification checklist and restore-drill runbook in diagnostics - support-log viewing, filtering, retention cleanup, and support debugging helpers in diagnostics +- startup brand-theme hydration so Company Settings colors persist correctly across refresh - Dockerized single-container deployment - Puppeteer PDF pipeline foundation @@ -77,3 +79,4 @@ This repository implements the platform foundation milestone: - project milestones and project-side rollup visibility - manufacturing routing/work-center depth, labor capture, and capacity-aware execution views + diff --git a/README.md b/README.md index c5c5e98..7622d8f 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# MRP Codex +# CODEXIUM Foundation release for a modular Manufacturing Resource Planning platform built with React, Express, Prisma, SQLite, and a single-container Docker deployment. @@ -10,14 +10,14 @@ Foundation release for a modular Manufacturing Resource Planning platform built Current foundation scope includes: - authentication and RBAC -- company branding and theme settings +- company branding and theme settings, including startup brand-theme hydration across refresh - CRM customers and vendors with create/edit/detail workflows - CRM search, filtering, status tagging, and reseller hierarchy - CRM contact history, account contacts, and shared attachments - inventory item master, BOM, warehouse, stock-location, and stock-transaction flows - inventory transfers, reservations, and available-stock visibility - inventory SKU master builder with family-scoped sequence generation and branch-aware taxonomy management -- staged thumbnail image attachment on inventory item create/edit workflows +- staged thumbnail image attachment on inventory item create/edit workflows, with detail-page thumbnail display - sales quotes and sales orders with searchable customer and SKU entry - sales approvals, approval stamps, automatic revision history, and revision comparison on quotes and sales orders - purchase orders with searchable vendor and SKU entry, restricted to purchasable inventory items @@ -398,3 +398,4 @@ Current follow-up direction: ## PDF Generation Puppeteer is used by the backend to render HTML templates into professional PDFs. The current PDF surface includes the branded company-profile preview, sales quotes, sales orders, purchase orders, shipment packing slips, shipping labels, and bills of lading. The Docker image includes Chromium runtime dependencies required for headless execution. + diff --git a/ROADMAP.md b/ROADMAP.md index 7159586..0772274 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -8,7 +8,7 @@ ## Product direction -MRP Codex is being built as a streamlined, modular manufacturing resource planning platform with strong branding controls, fast operational workflows, and a single-container deployment model that is simple to back up and upgrade. +CODEXIUM is being built as a streamlined, modular manufacturing resource planning platform with strong branding controls, fast operational workflows, and a single-container deployment model that is simple to back up and upgrade. This file tracks work that still needs to be completed. Shipped phase history and completed slices now live in [SHIPPED.md](D:/CODING/mrp-codex/SHIPPED.md). @@ -139,3 +139,4 @@ This file tracks work that still needs to be completed. Shipped phase history an - Local Windows Prisma migration reliability still needs a cleaner documented workflow or tooling wrapper - Some generated document and workflow screens still need additional polish for dense, keyboard-efficient operational use + diff --git a/SHIPPED.md b/SHIPPED.md index f02c4bd..aaf4e90 100644 --- a/SHIPPED.md +++ b/SHIPPED.md @@ -50,6 +50,7 @@ This file tracks roadmap phases, slices, and major foundations that have already - Route-level frontend code-splitting and vendor chunking to keep the initial client payload lighter - SKU-searchable BOM component selection for inventory-scale datasets - Theme persistence fixes and denser responsive workspace layouts +- Startup brand-theme hydration so Company Settings colors and font persist correctly across refresh - Full-site density normalization pass across active CRM, inventory, settings, dashboard, and login screens - Live planning gantt timelines driven by project and manufacturing data - Sales-order demand planning with multi-level BOM explosion, stock/open-supply netting, and build/buy recommendations @@ -122,3 +123,7 @@ This file tracks roadmap phases, slices, and major foundations that have already - Persisted auth-session review filtering and admin-side access review cues - Destructive-action confirmation coverage expanded into project customer/document unlinking and form-row removals in sales, purchasing, inventory, and warehouse editors - Support-log filtering, retention cleanup, and richer filtered support-bundle exports in admin diagnostics +- Inventory thumbnail staging on item create/edit plus dedicated detail-page thumbnail display +- Demand-planning PO draft generation no longer applies mismatched sales-order line links to BOM child buy recommendations +- User-management saves now accept blank-password edits for existing users and surface errors in-page + diff --git a/STRUCTURE.md b/STRUCTURE.md index 1b14f57..b093757 100644 --- a/STRUCTURE.md +++ b/STRUCTURE.md @@ -52,3 +52,4 @@ 3. Add permission keys in `shared/src/auth`. 4. Add frontend route/module under `client/src/modules/`. 5. Register navigation and route guards through the app shell without refactoring existing modules. + diff --git a/UNRAID.md b/UNRAID.md index 6a111ae..1f38b55 100644 --- a/UNRAID.md +++ b/UNRAID.md @@ -7,7 +7,7 @@ ## Purpose -This guide explains how to deploy MRP Codex on an Unraid server using the Unraid Docker GUI rather than command-line Docker management. +This guide explains how to deploy CODEXIUM on an Unraid server using the Unraid Docker GUI rather than command-line Docker management. ## What this container expects @@ -16,7 +16,7 @@ This guide explains how to deploy MRP Codex on an Unraid server using the Unraid - Environment variables for the server port, JWT secret, and SQLite path - Automatic Prisma migration execution during container startup -MRP Codex stores both the SQLite database and uploaded files inside the same persistent container path: +CODEXIUM stores both the SQLite database and uploaded files inside the same persistent container path: - database: `/app/data/prisma/app.db` - uploads: `/app/data/uploads` @@ -25,15 +25,15 @@ MRP Codex stores both the SQLite database and uploaded files inside the same per - Build and push the image to a registry your Unraid server can access, or import it manually if you are self-hosting images - Choose an Unraid share for persistent app data, for example: - - `/mnt/user/appdata/mrp-codex` + - `/mnt/user/appdata/codexium` - Choose the port you want to expose in Unraid, for example: - host port `3000` - container port `3000` ## Recommended Unraid paths -- App data share: `/mnt/user/appdata/mrp-codex` -- Optional backup target: `/mnt/user/backups/mrp-codex` +- App data share: `/mnt/user/appdata/codexium` +- Optional backup target: `/mnt/user/backups/codexium` Keep the entire app data folder together so backups capture both the SQLite database and file attachments. @@ -128,7 +128,7 @@ When you publish a new image: 2. Apply the update from the Unraid GUI 3. Start the container -Because MRP Codex runs `prisma migrate deploy` during startup, committed migrations are applied automatically before the app launches. +Because CODEXIUM runs `prisma migrate deploy` during startup, committed migrations are applied automatically before the app launches. This is especially important now that recent releases added CRM expansion, inventory transactions, sales and purchasing documents, shipping/logistics documents, the inventory `defaultPrice` field, purchasable-only purchase-order item selection, the new projects domain, manufacturing work orders, audit tooling, and persisted auth sessions. Let the container complete startup migrations before testing new screens. @@ -148,7 +148,7 @@ For consistent backups, stop the container before copying the appdata directory. ## Reverse proxy notes -If you place MRP Codex behind Nginx Proxy Manager, Traefik, or another reverse proxy: +If you place CODEXIUM behind Nginx Proxy Manager, Traefik, or another reverse proxy: - keep the Unraid container on `bridge` or your preferred proxy-compatible network - point the proxy at the Unraid host IP and chosen host port @@ -192,3 +192,4 @@ Set `CLIENT_ORIGIN` to the exact URL used by the browser, including protocol and - Env: `DATABASE_URL=file:../../data/prisma/app.db` - Env: `PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium` - Env: `CLIENT_ORIGIN=http://YOUR-UNRAID-IP:3000` +