# 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