Merge pull request #99 from ury-erp/doc/add_comprehensive_skills_coverage

Added comprehensive skills coverage

Author: esafwan

AGENTS.md

@@ -303,8 +303,58 @@ Ensure new modules are added to `ury/modules.txt` and run `bench migrate`.
 
 ---
 
+## Skills Directory
+
+URY includes a modular skills system in `skills/` that provides AI agents with contextual knowledge about specific codebase areas.
+
+### Using the Skills Directory
+
+The `skills/_index.json` file contains a machine-readable index of all 18 available skills with metadata including:
+- **name**: Skill identifier
+- **description**: What the skill covers
+- **category**: backend, frontend, features, quality, ui
+- **path**: Location of the skill documentation
+- **key_files**: Important files referenced by this skill
+- **depends_on**: Other skills this one depends on
+- **tags**: Searchable keywords
+
+### Available Skills
+
+| Skill | Category | Description |
+|-------|----------|-------------|
+| `api-client` | frontend | Frappe SDK wrapper for frontend apps |
+| `cart-state` | frontend | Zustand cart state management |
+| `custom-fields` | backend | ERPNext custom field extensions |
+| `customer-api` | backend | Guest-facing ordering APIs |
+| `doctypes` | backend | Core URY data models |
+| `frappe-patterns` | backend | Frappe framework patterns |
+| `kot-generation` | backend | Kitchen Order Ticket system |
+| `menu-hooks` | frontend | React hooks for menu/QR data |
+| `monorepo` | frontend | NPM workspaces structure |
+| `order-hooks` | frontend | Order lifecycle React hooks |
+| `payment-gateway` | backend | Multi-provider payment processing |
+| `realtime` | backend | WebSocket/realtime patterns |
+| `staff-pos-api` | backend | Staff POS operations APIs |
+| `testing` | quality | Testing patterns and workflows |
+| `ui-components` | ui | React UI component library |
+| `table-order-app` | features | QR Table Ordering application |
+| `customer-order-app` | features | Online pickup/delivery ordering |
+| `kiosk-app` | features | Self-service kiosk ordering |
+
+### Skill File Format
+
+Each skill is documented in `skills/<skill-name>/SKILL.md` with:
+- **Key Files**: Important source files
+- **How It Works**: Core patterns and flow
+- **Extension Points**: Where to add new functionality
+- **Dependencies**: Required packages/modules
+- **Gotchas**: Common pitfalls and solutions
+
+---
+
 ## Contact & Support
 
 - **Repository**: https://github.com/ury-erp/ury
 - **Issues**: Create GitHub issue
 - **Documentation**: See `planning/` directory
+- **Skills Index**: See `skills/_index.json` for the complete catalog of 18 skills

FEATURES.md

@@ -1,12 +1,93 @@
 # Features of URY App
 
-It's important to note that if no POS Opening entry is created for the day, URY will not allow table selection, ensuring accurate tracking of operations.
-A POS Closing Entry must be created at the end of each day to complete the daily operations.
+URY is a comprehensive restaurant management system with multi-channel ordering capabilities.
+
+## Multi-App Architecture
+
+URY now supports multiple customer-facing applications in addition to the staff POS:
+
+### Staff Applications
+- **POS v2** (`/pos/`) - Desktop/tablet cashier interface
+- **POS v1** (`/urypos/`) - Mobile order-taker interface (legacy)
+- **Mosaic KDS** (`/URYMosaic/`) - Kitchen Display System
+
+### Customer Applications
+- **QR Table Ordering** (`/order/t/<token>`) - Customers scan QR codes to order from tables
+- **Online Ordering** (`/menu/<slug>`) - Remote pickup/delivery ordering
+- **Kiosk Mode** (`/kiosk/<device>`) - Self-service ordering on touch screens
+
+### Key Features Across All Apps
+- Unified menu management
+- Real-time order status updates
+- Automatic KOT generation
+- Integrated payment processing
+
+---
 
 > :information_source: **Note**  
-> This version is currently designed for **POS machines/Desktop** to handle **cashiers and fast checkout**.  
+> It's important to note that if no POS Opening entry is created for the day, URY will not allow table selection, ensuring accurate tracking of operations.
+> A POS Closing Entry must be created at the end of each day to complete the daily operations.
+
+> :information_source: **Note**  
+> The POS v2 is currently designed for **POS machines/Desktop** to handle **cashiers and fast checkout**.  
 > For **order takers and mobile support**, use **Version 1 POS**, which is available at the path `/urypos/Table`.
 
+---
+
+## QR Table Ordering
+
+Customers scan QR codes at their tables to place orders directly.
+
+- **QR Code Generation**: Staff generate QR codes for each table with configurable expiry
+- **Token-Based Access**: Secure JWT tokens encode restaurant and table context
+- **Mobile-Optimized Menu**: Browse menu by categories, view item images and descriptions
+- **Cart Management**: Add/remove items, adjust quantities
+- **Guest Checkout**: No account required - just name and optional phone
+- **Real-Time Status**: Track order status from Placed → Confirmed → Preparing → Ready → Served
+- **Call Waiter**: Button to notify staff for assistance
+- **Pay at Counter**: Payment handled traditionally after meal
+
+## Online Customer Ordering
+
+Remote ordering for pickup, delivery, or curbside.
+
+- **Restaurant Discovery**: Access via unique slug (`/menu/restaurant-name`)
+- **Order Types**: Pickup, Delivery, or Curbside
+- **Scheduled Orders**: Order now for pickup later (up to 7 days)
+- **Time Slot Selection**: 15-minute interval slots based on restaurant hours
+- **Guest Checkout**: Phone-based order tracking, no account needed
+- **Order History**: View past orders by phone number
+- **Real-Time Tracking**: Live order status updates
+- **Payment Integration**: Stripe and Razorpay support
+
+## Kiosk Self-Service
+
+In-store ordering on large touch screens.
+
+- **Attract Screen**: Eye-catching welcome with animations, auto-reset after timeout
+- **Large Touch Targets**: Minimum 64px buttons for easy interaction
+- **Category Ribbon**: Quick navigation between menu categories
+- **Full-Screen Item View**: Large images and descriptions
+- **Always-Visible Cart**: Side panel showing current order
+- **Dine-In / Takeaway**: Simple selection with large buttons
+- **Inactivity Timeout**: 90-second auto-reset to attract screen
+- **Order Confirmation**: Large order number display with QR for tracking
+- **Device Authentication**: One-time setup with device token
+
+## Payment Gateway
+
+Integrated payment processing for online orders.
+
+- **Multiple Providers**: Stripe and Razorpay supported
+- **Payment Methods**: Cards, UPI, wallets (provider-dependent)
+- **Webhook Handling**: Automatic payment confirmation
+- **Secure**: PCI-compliant hosted checkout
+- **Test Mode**: Sandbox support for development
+
+---
+
+## Staff POS v2 Features
+
 - **Key Features**
 	- All Major POS Features from Version 1 Retained
 	- Core functionalities from the previous version are preserved for consistency.
@@ -221,4 +302,4 @@ A POS Closing Entry must be created at the end of each day to complete the daily
 	14. Time Wise Sales
 
 - **Customizable Branch Timings:**
-	- URY allows you to set varying branch timings in the URY Report settings, including extended hours. This feature ensures that your reports accurately reflect the operational hours of your restaurant.
+	- URY allows you to set varying branch timings in the URY Report settings, including extended hours. This feature ensures that your reports accurately reflect the operational hours of your restaurant.