Stefan
9c0bf76a05
Playwright Tests / test (push) Has been cancelled
Added detailed instruction files for configuration, controller structure, C# standards, OCORE library usage, ImageSharp licensing, and testing. These documents define rules for settings, DI, file layout, package management, and test practices to ensure consistency and compliance during the .NET 10 migration.
1.7 KiB
1.7 KiB
applyTo
| applyTo |
|---|
| Fuchs/**,Fuchs_DataService/**,OCORE/**,OCORE_web/**,OCORE_web_pdf/** |
OCORE Libraries Instructions
Preferred Libraries
- Make use of OCORE / OCORE_web libraries wherever possible for common tasks: logging, configuration, data access, web helpers, and security.
- For PDF-related work, prefer OCORE_web_pdf / OCORE PDF functions over rewriting from scratch.
- Do not use OCMS or OCMS_sharp. Use only OCORE or OCORE_web. In particular, never use
OCMS.ocms_debug.debug_log.
Common OCORE Entry Points
| Area | Namespace / helper |
|---|---|
| SQL access | OCORE.SQL.sql (getSQLDatatable_async, getSQLValue_async, SQL_VarChar, ...) |
| Async MVC/JSON | OCORE.web.mvc_helper_async (JSONAsync, ...) |
| Security | OCORE.security (DatabaseSecurity, ...) |
| Dictionaries/commons | OCORE.commons, OCORE.OCORE_dictionaries |
| Web bootstrapping | OCORE_web app-builder / middleware helpers |
| Secret management | OCORE_web.Secrets.SecretManagementWebExtensions |
SQL Helper Conventions
- Pass parameters using
SQL_VarChar(...)and the controllerStdParamlist(...)helpers (auto-injects@authuser). - Always pass
Security: DbSecandoptions: SqlOpt(fn, id, code)to the OCORE SQL helpers. - Prefer the
_asyncvariants for all database I/O.
Repository Sync
- OCORE, OCORE_web, OCORE_web_pdf, and OCORE_Charting are separate git repositories pulled alongside Fuchs.
- After pulling OCORE* updates, rebuild and re-run tests, and re-check shared dependency versions (e.g., MailKit/MimeKit) for
NU1605downgrade conflicts.
ImageSharp (used transitively by OCORE/OCORE_web)
- See
imagesharp.instructions.mdfor license handling and the v4.0.0 namespace changes.