rebrand CODEXIUM

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
+

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
+

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
+

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.
+

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
+

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
+

STRUCTURE.md

@@ -52,3 +52,4 @@
 3. Add permission keys in `shared/src/auth`.
 4. Add frontend route/module under `client/src/modules/<domain>`.
 5. Register navigation and route guards through the app shell without refactoring existing modules.
+

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`
+