# FruitBankHybridApp — Claude Code Instructions

Before writing any code, read these files:
1. `.github/copilot-instructions.md` — Domain rules and critical pitfalls (single source of truth)
2. `docs/GLOSSARY.md` — Domain terms, measurement logic, and common traps
3. `docs/SCHEMA.md` — Full domain model in Toon format
4. The relevant project's `README.md` for folder-specific context

## External Repos

This solution depends on external code in sibling directories. Their **full source code** is available — browse them freely for type definitions, base classes, patterns, and docs:

| Repo | Path (relative to this repo root) | Contains |
|---|---|---|
| **AyCode.Core** | `../../../Aycode/Source/AyCode.Core/` | SignalR base classes, serialization, binary protocol, data sources, logging |
| **AyCode.Blazor** | `../../../Aycode/Source/AyCode.Blazor/` | MgGridBase, MgGridWithInfoPanel, toolbar, layout persistence, Blazor components |
| **Mango.Nop Libraries** | `../NopCommerce.Common/4.70/Libraries/` | Independent shared library with own `.github/copilot-instructions.md` and `docs/`. DTOs, entities, data access, service base classes |
| **FruitBank Plugin** | `../NopCommerce.Common/4.70/Plugins/Nop.Plugin.Misc.AIPlugin/` | nopCommerce 4.80.9 server-side plugin: SignalR hubs, measurement services, DbTable classes, admin controllers, AI services |

Key docs in those repos:
- `../../../Aycode/Source/AyCode.Core/.github/copilot-instructions.md` — core framework rules
- `../../../Aycode/Source/AyCode.Core/docs/ARCHITECTURE.md` — core architecture
- `../../../Aycode/Source/AyCode.Blazor/.github/copilot-instructions.md` — UI framework rules
- `../../../Aycode/Source/AyCode.Blazor/docs/MGGRID.md` — MgGrid technical reference
- `../../../Aycode/Source/AyCode.Blazor/docs/ARCHITECTURE.md` — UI architecture
- `../NopCommerce.Common/4.70/Libraries/.github/copilot-instructions.md` — Mango.Nop library rules
- `../NopCommerce.Common/4.70/Libraries/docs/ARCHITECTURE.md` — library architecture + NopDependencies pattern
- `../NopCommerce.Common/4.70/Plugins/Nop.Plugin.Misc.AIPlugin/README.md` — FruitBank plugin overview

When a type is referenced but not defined in this solution, look it up in AyCode.Core, AyCode.Blazor, or the Mango.Nop Libraries. When a server-side endpoint or service is referenced, look it up in the FruitBank Plugin.

When modifying code, update the corresponding README.md if it becomes out of sync with the code.