tfm_ainventory/AGENTS.md

AGENTS.md — Web App Project Rules

Tech Stack

• Frontend: Next.js 15, React 19, TypeScript 5
• Styling: Tailwind CSS v3.4, Lucide React (Icons)
• Backend: Python 3.14, FastAPI, Uvicorn
• Database: SQLite (SQLAlchemy) + Dexie (IndexedDB pentru offline-first)
• AI & Vision: Google Gemini 2.0 (Vision), Tesseract.js (Local OCR)
• Infrastructure: Docker, Caddy (Automatic SSL Reverse Proxy)
• Security: JWT (python-jose), LDAP (Enterprise Integration)

Code Quality

• Keep cyclomatic complexity under 10 per function
• Aim for files under 300 lines

Testing

• Write unit tests for all utility functions
• Minimum 80% coverage on new code
• Use Vitest for unit tests

Security

• Store all secrets in inventory.env — never hardcode credentials
• Never log API keys, tokens or passwords
• Validate all user input before processing

Git Conventions

• Use conventional commits (feat:, fix:, docs:, etc.)
• Keep PRs under 400 lines of diff when possible