oracle-ords-ptbrlisted
Install: claude install-skill Maxwbh/oracle-skills-ptbr
# oracle-ords-ptbr — v2.0.0
Oracle REST Data Services — padrões de desenvolvimento e dicionário completo de views de metadados.
**Desenvolvido por:** Maxwell da Silva Oliveira — [M&S do Brasil LTDA](https://msbrasil.inf.br)
## Áreas cobertas
| Área | Reference | Assets |
|---|---|---|
| **REST services** | `references/ords-rest-services.md` | `ords_module.sql`, `ords_handler.sql` |
| **ORDS Data Dictionary** | `references/ords-data-dictionary-ptbr.md` | (queries embutidas no reference) |
## Quando ativar
- `ORDS.define_module`, `ORDS.define_template`, `ORDS.define_handler`
- `ORDS.enable_schema`, `ORDS.enable_object` (AutoREST)
- `ORDS_SECURITY.create_client`, `ORDS_SECURITY_ADMIN.*` (24.4+)
- `OAUTH.*` ou `OAUTH_ADMIN.*` → alertar depreciação (removidos em ORDS 25.3)
- `ORDS_PAR` — Pre-Authenticated Requests (24.4+)
- `ORDS_EXPORT.export_schema` — backup/deploy de configuração
- `USER_ORDS_MODULES`, `USER_ORDS_HANDLERS`, `USER_ORDS_SCHEMAS`
- `DBA_ORDS_*` (requer `ORDS_ADMINISTRATOR`) — ORDS 24.4+
- Source types: `collection/query`, `collection/item`, `plsql/block`, `mle/javascript`
- CORS, códigos HTTP REST, versionamento de API, OAuth 2.0
- JWT Profiles, `USER_ORDS_JWT_PROFILE`
**Não usar** para: APEX pages/regions, PL/SQL puro sem REST, DBA ops.
## Princípios canônicos
- **Hierarquia ORDS:** Schema → Module → Template → Handler → Parameter.
- **Bind variables sempre:** path params (`:id`), query string (`:status`) são bind automático. SQL dinâmico → `DBMS_ASSERT`