415-frameworks-quarkus-mongodb

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Quarkus — MongoDB

Quarkus — MongoDB

Apply Quarkus MongoDB guidance with concrete examples for design, implementation, and error handling.
应用 Quarkus MongoDB 指导,并通过具体示例说明设计、实现和错误处理。

Constraints

约束

Compile before MongoDB refactors; verify after changes.
  • MANDATORY: Run
    ./mvnw compile
    or
    mvn compile
    before applying any change
  • SAFETY: If compilation fails, stop immediately
  • VERIFY: Run
    ./mvnw clean verify
    or
    mvn clean verify
    after applying improvements
  • BEFORE APPLYING: Read the reference for detailed rules and examples
进行 MongoDB 重构前必须先编译;更改后必须进行验证。
  • 强制要求:应用任何更改之前,运行
    ./mvnw compile
    或
    mvn compile
  • 安全要求:如果编译失败,立即停止操作
  • 验证要求:应用改进之后,运行
    ./mvnw clean verify
    或
    mvn clean verify
  • 应用更改之前:阅读参考资料,了解详细规则和示例

When to use this skill

何时使用此 skill

  • Add MongoDB in Quarkus
  • Review Quarkus Mongo Panache entities/repositories
  • Improve duplicate key handling, retry policy, or optimistic locking in Quarkus Mongo
  • Model MongoDB documents for a Quarkus service
  • Configure Quarkus MongoDB clients codecs or transactions
  • 在 Quarkus 中添加 MongoDB
  • 审查 Quarkus Mongo Panache 实体和仓储
  • 改进 Quarkus Mongo 中的重复键处理、重试策略或乐观锁
  • 为 Quarkus 服务设计 MongoDB 文档模型
  • 配置 Quarkus MongoDB 客户端 codecs 或 transactions

Workflow

工作流

  1. Read reference and assess project context
Read
references/415-frameworks-quarkus-mongodb.md
and inspect persistence setup before proposing changes.
  1. Gather scope and decide target improvements
Identify model/query consistency needs and define safe improvements.
  1. Apply framework-aligned changes
Implement/refactor Panache Mongo mappings, repository access, and failure handling.
  1. Run verification and report results
Execute build/tests and summarize what changed, what was verified, and follow-up actions.
  1. 阅读参考资料并评估项目上下文
阅读
references/415-frameworks-quarkus-mongodb.md
,并在提出更改之前检查持久化配置。
  1. 确定范围并决定目标改进
确定模型和查询一致性的需求,并定义安全的改进方案。
  1. 应用符合框架规范的更改
实现或重构 Panache Mongo 映射、仓储访问和失败处理。
  1. 运行验证并报告结果
执行构建和测试,并总结所做的更改、已验证的内容以及后续操作。

Reference

参考资料

For detailed guidance, examples, and constraints, see references/415-frameworks-quarkus-mongodb.md.
有关详细指导、示例和约束,请参阅 references/415-frameworks-quarkus-mongodb.md。