FruitBankHybridApp/CLAUDE.md

2.4 KiB

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.