# Ineed-Core 内部文档

面向 `ineed-core` 维护者，回答框架本身的问题：

- 当前有哪些真实 Maven 模块
- 各模块分别承载哪些框架能力
- 各运行时已验证范围和已知缺口是什么
- 集成事件、常量、错误码、i18n 等框架机制如何维护

业务开发的入口已分为[AI 路径](../ai/README.md)和[开发人员教程](../getting-started/first-module.md)。本目录保留框架参考与维护主题；完整索引见[文档首页](../README.md)。

## 推荐阅读顺序

1. [module-inventory.md](module-inventory.md) — 真实模块清单
2. [current-implementation-status.md](current-implementation-status.md) — 当前实现状态与缺口
3. [module-capability-map.md](module-capability-map.md) — 能力分层地图
4. [java-module-directory-guide.md](java-module-directory-guide.md) — 模块目录结构规范
5. [integration-event-guide.md](integration-event-guide.md) — 集成事件机制
6. [constant-errorcode-i18n-guide.md](constant-errorcode-i18n-guide.md) — 常量、错误码与 i18n
7. [api-compatibility-policy.md](api-compatibility-policy.md) — 废弃 API 的登记、复查与安全移除策略
8. [api-documentation-guide.md](api-documentation-guide.md) — Scalar 与 springdoc 约定

## 按任务进入

| 任务 | 推荐文档 |
|------|------|
| 确认真实模块声明 | [module-inventory.md](module-inventory.md) |
| 确认当前实现状态和已知缺口 | [current-implementation-status.md](current-implementation-status.md) |
| 理解框架能力地图和模块边界 | [module-capability-map.md](module-capability-map.md) |
| 判断模块目录形态 | [java-module-directory-guide.md](java-module-directory-guide.md) |
| 维护集成事件机制 | [integration-event-guide.md](integration-event-guide.md) |
| 维护常量/错误码/i18n | [constant-errorcode-i18n-guide.md](constant-errorcode-i18n-guide.md) |
| 登记、复查或移除废弃 API | [api-compatibility-policy.md](api-compatibility-policy.md) |
| 配置或验证 API 文档入口 | [api-documentation-guide.md](api-documentation-guide.md) |

如果你要开发新的业务模块，请转到 [../project-development/README.md](../project-development/README.md)。

> 最后更新：2026-07-30