ahasani
5ce560ce97
- Updated `findAll` method in `CustomersController` to accept filtering parameters. - Implemented filtering logic in `CustomersService` to retrieve customers based on type and search query. - Added `PosCustomerFilterDto` for query validation. - Updated customer-related DTOs to make fields optional and added length validation where necessary. - Modified customer-related logic in `sales-invoice-tsp.utils.ts` to accommodate new DTO structure. - Added unique constraints to `customer_individuals` and `customer_legal` tables in the database migration. - Removed commented-out code in `PosMiddleware` for cleaner codebase. - Set default value for `is_default_guild_good` to false in `OwnedGoodsService`.
183 lines
3.1 KiB
Markdown
183 lines
3.1 KiB
Markdown
# AGENTS.md
|
||
|
||
## Stack
|
||
|
||
- NestJS
|
||
- Prisma
|
||
- TypeScript
|
||
- pnpm
|
||
- RTK enabled
|
||
|
||
---
|
||
|
||
# Core Rules
|
||
|
||
- Keep changes minimal.
|
||
- Do not touch unrelated files.
|
||
- Prefer existing patterns over new abstractions.
|
||
- Preserve API behavior unless requested otherwise.
|
||
- Prefer forward Prisma migrations.
|
||
- Never edit applied migrations in shared environments.
|
||
|
||
---
|
||
|
||
# EXECUTION RULES
|
||
|
||
- Keep responses short.
|
||
- Do not narrate thoughts.
|
||
- Do not explain obvious steps.
|
||
- Do not create plans for simple tasks.
|
||
- Prefer implementation over exploration.
|
||
|
||
Avoid:
|
||
|
||
- “I think…”
|
||
- “Let me check…”
|
||
- “I should inspect…”
|
||
- “I’m going to…”
|
||
|
||
---
|
||
|
||
# RTK Rules
|
||
|
||
Always prefer RTK commands.
|
||
|
||
Use:
|
||
|
||
- `rtk ls`
|
||
- `rtk grep`
|
||
- `rtk smart`
|
||
- `rtk read`
|
||
- `rtk git diff`
|
||
- `rtk git status`
|
||
|
||
Avoid raw:
|
||
|
||
- `cat`
|
||
- `grep`
|
||
- `rg`
|
||
- `git diff`
|
||
- recursive repository scans
|
||
|
||
---
|
||
|
||
# Reading Strategy
|
||
|
||
1. `rtk grep`
|
||
2. `rtk smart`
|
||
3. `rtk read`
|
||
|
||
Rules:
|
||
|
||
- Read only necessary files.
|
||
- Do not read sibling files unless needed.
|
||
- Do not reread unchanged files.
|
||
- Stop searching once target location is found.
|
||
- Edit quickly after locating target.
|
||
|
||
Avoid:
|
||
|
||
- opening entire modules
|
||
- multi-file chained reads
|
||
- large diff dumps
|
||
- exploratory scans
|
||
|
||
---
|
||
|
||
# Forbidden Paths
|
||
|
||
Do not inspect unless required:
|
||
|
||
- `node_modules/`
|
||
- `dist/`
|
||
- `coverage/`
|
||
- `.prisma/`
|
||
- `prisma/migrations/`
|
||
|
||
---
|
||
|
||
# Prisma Rules
|
||
|
||
- Use transactions for multi-step writes.
|
||
- Prefer explicit `select/include`.
|
||
- Normalize `Decimal` values with `Number(...)`.
|
||
- Keep migrations forward-safe.
|
||
- Use:
|
||
- `pnpm prisma migrate dev --name <name>` for new local migrations
|
||
- `pnpm prisma migrate deploy` for applying existing migrations
|
||
|
||
---
|
||
|
||
# NestJS Rules
|
||
|
||
- Keep layering:
|
||
- controller
|
||
- service
|
||
- prisma/shared service
|
||
|
||
- Reuse shared services.
|
||
- Keep DTO validation strict.
|
||
- Avoid `any`.
|
||
|
||
---
|
||
|
||
# Validation
|
||
|
||
Typecheck before handoff:
|
||
|
||
```bash
|
||
pnpm -s tsc --noEmit
|
||
```
|
||
|
||
# INVESTIGATION LIMITS
|
||
|
||
For localized fixes:
|
||
|
||
- maximum 3 file reads before first edit
|
||
- maximum 1 related-file read unless required
|
||
- maximum 5 total file reads before implementation
|
||
|
||
Stop searching once the target service, controller, DTO, schema, or repository method is identified.
|
||
|
||
# TARGETED READ RULES
|
||
|
||
Do not read files larger than 300 lines unless required.
|
||
|
||
For known symbols:
|
||
|
||
1. rtk grep
|
||
2. rtk smart
|
||
3. read only the relevant section
|
||
|
||
Avoid opening entire services, modules, or controllers for localized changes.
|
||
|
||
Prefer symbol-level inspection.
|
||
|
||
# REVIEW MODE
|
||
|
||
During reviews:
|
||
|
||
- inspect changed files only
|
||
- avoid repository-wide searches
|
||
- avoid architecture exploration
|
||
- avoid reading unrelated modules
|
||
|
||
Review only code affected by the diff.
|
||
|
||
# HARD TOKEN LIMITS
|
||
|
||
For localized fixes:
|
||
|
||
- Never read more than 5 files before the first edit.
|
||
- Never read a file larger than 300 lines unless the target symbol cannot be isolated.
|
||
- Never open an entire service, controller, or module when a symbol-level read is possible.
|
||
- Never reread a file already summarized by `rtk smart` unless implementation details are required.
|
||
|
||
When a file exceeds 300 lines:
|
||
|
||
1. rtk grep
|
||
2. rtk smart
|
||
3. read only the required section
|
||
|
||
Avoid full-file reads.
|