# M2: Items CRUD

## Narrative Goal
Implement complete CRUD operations for items, categories, and locations with barcode generation, image handling, and search functionality.

## Definition of Done
The Items module is complete when:
- All CRUD operations work for items, categories, and locations
- Barcodes are auto-generated on item creation
- Images can be uploaded and stored securely
- Search and filtering work on item list
- Low stock alerts are functional

## Milestone Issues

| Issue | Title | Priority | Labels |
|-------|-------|----------|--------|
| #115 | Create ItemService | High | type:feature,module:api |
| #116 | Create CategoryService | High | type:feature,module:api |
| #117 | Create LocationService | High | type:feature,module:api |
| #118 | Implement ItemsApiController | High | type:feature,module:api |
| #119 | Implement CategoriesApiController | High | type:feature,module:api |
| #120 | Implement LocationsApiController | High | type:feature,module:api |
| #121 | Create StoreItemRequest validation | High | type:feature,module:api |
| #122 | Create UpdateItemRequest validation | High | type:feature,module:api |
| #123 | Implement barcode generation | Medium | type:feature,module:api |
| #124 | Implement image upload handling | Medium | type:feature,module:api |
| #125 | Create ItemResource and CategoryResource | Medium | type:feature,module:api |
| #126 | Create ItemController (web) | High | type:feature,module:ui |
| #127 | Create item list view with search | High | type:feature,module:ui |
| #128 | Create item create/edit form | High | type:feature,module:ui |
| #129 | Create item show view | Medium | type:feature,module:ui |
| #130 | Create category management views | Medium | type:feature,module:ui |
| #131 | Create location management views | Medium | type:feature,module:ui |
| #132 | Add low stock indicator | High | type:feature,module:ui |
| #133 | Create ItemFactory for testing | High | type:testing |

**Total Issues:** 19


## Implementation Progress

| Status | Count |
|--------|-------|
| ✅ Completed | 13 |
| ⚠️ Partial | 2 |
| ❌ Pending | 4 |

**Progress:** 68% completed

**Updated:** 2026-03-19 (Services layer added)


## Implementation Progress

| Status | Count |
|--------|-------|
| ✅ Completed | 13 |
| ⚠️ Partial | 1 |
| ❌ Pending | 5 |

**Progress:** 68% completed

**Updated:** 2026-03-19
