docs: add comprehensive project README.md v1.3.3

README.md

@@ -0,0 +1,53 @@
+# 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.
+
+---
+
+## 🛠 Project Modes
+
+This project supports three distinct operational modes:
+
+### 1. 🚀 Development Mode (Bare-Metal)
+Ideal for local development on macOS/Linux.
+*   **Command:** `./start_server.sh`
+*   **Details:** Runs FastAPI (backend) and Next.js (frontend) in development mode. Uses `local-ssl-proxy` for HTTPS.
+*   **Backend:** http://localhost:8000
+*   **Frontend:** https://localhost:3003
+
+### 2. 🐳 Docker Mode (Recommended for Production)
+Isolated and portable container stack.
+*   **Command:** `docker-compose up -d --build`
+*   **Details:** Uses Caddy as a reverse proxy for HTTPS. Persistent data and logs are mapped to `./data` and `./logs`.
+*   **Access:** https://localhost:3003
+
+### 3. 🐧 Standalone Linux Mode (Systemd)
+Native Linux installation (Alma/Debian/Ubuntu) without Docker dependencies.
+*   **Installation:** `sudo ./install_service.sh`
+*   **Execution:** `sudo systemctl start inventory`
+*   **Details:** Compiles the frontend for production and manages the entire stack as a system service.
+*   **Access:** https://<SERVER-IP>:3003
+
+---
+
+## 📦 Production Distribution
+To generate a clean production package without AI-agent metadata or development artifacts:
+1.  Run `./export_prod.sh`
+2.  A `.zip` archive will be created (e.g., `aInventory-PROD-v1.3.2.zip`).
+3.  This archive contains a specialized `README.txt` with deployment-only instructions.
+
+---
+
+## 🏗 Technical Overview
+*   **Backend:** FastAPI (Python 3.12+)
+*   **Frontend:** Next.js 15+ (React PWA)
+*   **Database:** SQLite (SQLAlchemy) with Dexie.js (IndexedDB) for client-side sync.
+*   **Proxy:** Caddy (Docker) or local-ssl-proxy (Standalone/Dev).
+*   **AI Engine:** Google Gemini (Generative AI SDK).
+
+For more details, see [PROJECT_ARCHITECTURE.md](PROJECT_ARCHITECTURE.md).
+
+---
+
+## 📜 AI Operational Rules
+AI agents working on this project MUST follow the guidelines in [AI_RULES.md](AI_RULES.md).