# AMADA订单录入系统 (ordr-entry) BlackBox AI 规则配置

## 项目概述
这是一个基于Spring Boot + React的订单录入系统，用于AMADA公司的价格管理和机种选择功能。

## 技术栈
- 后端：Java 8+, Spring Boot, MyBatis, Maven
- 前端：React 18, TypeScript, Material-UI, Ant Design
- 数据库：关系型数据库 (通过MyBatis访问)
- 构建工具：Maven (后端), npm/yarn (前端)

## 开发规范

### 语言要求
- 所有回答和解释请使用中文
- 代码注释采用日文说明
- 变量命名遵循英文规则 并且长度不超过10位 可以使用英文缩写

### 代码风格
- 变量命名遵循英文规则 长度控制在10个字符以内
- TypeScript/React组件使用PascalCase
- 常量使用UPPER_SNAKE_CASE
- 数据库字段使用snake_case

### 项目结构理解
- `src/main/java/jp/amadagp/ordr_entry/` - Java后端代码
  - `controller/` - REST API控制器
  - `service/` - 业务逻辑服务层
  - `dao/mapper/` - MyBatis数据访问层
  - `dto/` - 数据传输对象
  - `validation/` - 自定义验证器
- `client-src/src/` - React前端代码
  - `pages/` - 页面组件
  - `components/` - 通用组件
  - `types/` - TypeScript类型定义

### 主要功能模块
1. **价格检索系统**
   - 本体价格检索 (BodyPrcSrch)
   - 运费价格检索 (CrrgPrcSrch) 
   - 规格价格检索 (SpecPrcSrch)
   - 价格单位检索 (PrcUnitSrch)

2. **机种选择系统**
   - 机种选择 (MchnSlct)
   - 机种价格登录 (MchnPrcLogin)
   - 规格价格登录 (SpecPrcLogin)
   - 费用登录 (FeeLogin)

3. **诸经费管理**
   - 诸经费检索和管理 (ExpnsController)
   - 产品诸经费 (VrsExpns)

### 开发注意事项
- 遵循现有的Git分支策略 (main/dev/feature分支)
- 新功能开发需要创建MergeRequest进行代码审查
- 前端组件需要支持国际化 (i18next)
- 后端API需要遵循RESTful设计原则
- 数据库操作通过MyBatis进行，避免直接SQL

### 编码建议
- 优先使用项目现有的工具类和组件
- 新增功能时考虑多语言支持 (日语/中文/英语)
- 前端状态管理使用React Hooks
- 后端异常处理通过GlobalExceptionHandler统一处理
- 数据验证使用项目自定义的验证器

### 测试要求
- 新功能需要编写相应的单元测试
- 前端组件测试使用React Testing Library
- 后端服务测试使用JUnit

### 部署相关
- 项目使用Docker进行容器化部署
- 支持多环境配置 (local/test/real)
- 前端构建后集成到Spring Boot的static资源中

### 禁止事项
- 不要修改核心框架配置文件
- 不要直接操作数据库，必须通过MyBatis
- 不要在前端硬编码API地址
- 不要忽略现有的验证和权限控制

### AI助手行为准则
- 理解业务需求后再提供技术方案
- 优先复用现有代码和组件
- 提供的代码要符合项目规范
- 考虑代码的可维护性和扩展性
- 注重错误处理和用户体验

Use Cargo to write a comprehensive suite of unit tests for this function