用途：在 Angular 项目中创建与后端通信的 API 服务，统一缓存、错误处理与类型安全模式。
主要能力：提供基础 CRUD 服务、带缓存的查询服务、文件上传下载、自定义请求头、搜索与自动补全等实现模式；基于 PlatformApiService 基类，提供 get、post、put、patch、deleteRequest、postFormData、getBlob、clearCache、clearAllCache 等方法，并支持 enableCache、cacheKey、cacheDurationMs、headers、responseType、reportProgress、observe 等请求选项。
使用方式：服务文件放在 src/Frontend/libs/apps-domains/src/lib/{domain}/services/{feature}-api.service.ts；创建前需确认后端 API 基础地址、列出所有端点、确定缓存需求，并阅读目标应用的设计系统文档（WebV2 应用位于 docs/design-system/，TextSnippetClient 位于 src/Frontend/apps/playground-text-snippet/docs/design-system/，重点看 README.md、07-technical-guide.md、06-state-management.md）。服务需继承 PlatformApiService，用 @Injectable({ providedIn: 'root' }) 注册，apiUrl 通过 environment 拼接，方法标注返回类型并定义 DTO。
适用场景：新增后端通信服务、为 API 调用加缓存、实现文件上传下载、添加自定义请求头或拦截器、实现搜索与自动补全。
限制与注意：避免直接使用 HttpClient、硬编码 URL、缺失类型安全；错误处理建议在组件中通过 tapResponse 完成；验证端点返回 boolean；需按清单核对继承关系、apiUrl、返回类型、DTO、缓存配置与文件操作方式。具体后端地址、环境变量与设计系统内容以实际项目为准，资料未提供更多细节。