Daniel Bedeleanu
f0a9d28abb
Phase 9: Design Color System Enforcement This commit creates mandatory design rules to prevent future hardcoded colors: 1. DESIGN_COLOR_RULES.md - MANDATORY REFERENCE FOR ALL FUTURE UI/UX WORK - Establishes that NO arbitrary Tailwind colors are allowed - Defines semantic color mapping (success, error, warning, info) - Provides quick reference guide for color selection - Includes enforcement rules for AI agents and developers - Maps 20+ hardcoded colors to DESIGN.md equivalents 2. dev_docs/DESIGN_COMPLIANCE_FIX_PLAN.md - DETAILED IMPLEMENTATION GUIDE - Comprehensive fix plan with line-by-line changes for 20 files - 44+ color corrections identified and documented - Step-by-step instructions for each file modification - Includes before/after code snippets - Implementation checklist for tracking progress 3. CLAUDE.md - UPDATED WITH MANDATORY COLOR RULES - Added reference to DESIGN_COLOR_RULES.md as required reading - Added critical color rule section at top - Semantic color mapping quick reference for AI agents - Linked related documentation COLOR MAPPING ENFORCED: - Success/Healthy: tertiary (#00e639) - Error/Destructive: error (#ffb4ab) - Warning/Caution: primary (#ffb781) - Info/Secondary: secondary (#c8c6c5) - Muted/Disabled: muted (#474746) HARDCODED COLORS IDENTIFIED (44+ instances): - Indigo (3 instances) → primary/secondary - Green (12 instances) → tertiary - Red/Rose (20 instances) → error - Amber/Sky (9 instances) → primary/secondary All future UI/UX work MUST follow DESIGN_COLOR_RULES.md. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
TFM aInventory (2026 Edition)
A unified, offline-first Inventory Management System built as a Progressive Web App (PWA). Features include AI-powered label extraction (OCR), local barcode/QR scanning, and multi-user authentication with LDAP support.
🚀 Quick Start (Production)
For production environments, Docker is the recommended deployment method:
git clone <repository-url> tfm-inventory
cd tfm-inventory
# [D-08] Configuration - Copy examples to actual config files
for f in config/*.yaml.example; do cp "$f" "${f%.example}"; done
# Edit config/secrets.yaml with your JWT_SECRET_KEY and AI keys
nano config/secrets.yaml
# Deploy using the new Python deployment script
python3 scripts/deploy.py production
- Frontend: http://localhost:3000 (or https://localhost:8919 via proxy)
- Backend API: http://localhost:8000/docs
For detailed configuration reference, see config/README.md. For detailed deployment instructions (Docker vs Standalone), see DEPLOYMENT.md.
🏗 Technical Overview
- Backend: FastAPI (Python 3.12+)
- Frontend: Next.js 15+ (React PWA) with responsive Tailwind CSS
- Database: SQLite (SQLAlchemy) with Dexie.js (IndexedDB) for client-side sync.
- AI Engine: Google Gemini (Primary) & Anthropic Claude (Fallback).
- Configuration: [D-07] Consolidated YAML-based config in
config/directory.
For more details on system logic, see PROJECT_ARCHITECTURE.md.
🔐 Security & Constraints
AI agents and developers MUST strictly follow the rules defined in AI_RULES.md.
- No Uppercase UI: All labels/headers must be normal case.
- No Bold Fonts: Text hierarchy is achieved through size and color.
- Offline-First: All features must function without an active network connection.
📦 Production Distribution
To generate a clean production package:
python3 scripts/save_version.py --patch (or --minor/--major)
Last Updated: 2026-04-25
Version: 1.14.25 (Phase 7.1)