docs(server): add service-layer and api_endpoints code maps

[yyiilluu]

What

Add directory-local code-map READMEs for the server's two largest undocumented layers, and cross-link them from the existing server/README.md:

• reflexio/server/services/README.md — per-directory index of the business-logic layer (generation, evaluation, async extraction, search, persistence) with entry classes and key rules.
• reflexio/server/api_endpoints/README.md — the RequestContext contract plus a per-file handler/helper map.
• reflexio/server/README.md — adds "Detailed Documentation" links to the two new maps (API Endpoints, Services, and See Also sections).

Why

These two directories had no README, so an agent landing in services/ or api_endpoints/ had no local navigation. The new maps follow the repo's how_to_write_readme.md code-map conventions (concise, navigation-focused, NEVER/ALWAYS rules preserved) and complement — rather than duplicate — the workflow detail already in server/README.md.

Scope

Documentation only — no code or behavior changes.

Summary by CodeRabbit

• Documentation
  • Enhanced internal documentation structure with navigation improvements and detailed guides for the API endpoints and services architecture.

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

This PR establishes server architecture documentation by introducing detailed README files for the API endpoints and services layers. The main server README is updated with navigation links, while two new README files document the API layer's request-handling pattern and the services layer's business-logic responsibilities.

Changes

Server Architecture Documentation

Layer / File(s)	Summary
Main server documentation index and navigation reflexio/server/README.md	Updates the main server README to add "Detailed Documentation" links in the API Endpoints and Services sections, plus explicit cross-references in the See Also list, directing readers to the new api_endpoints/README.md and services/README.md documentation.
API endpoints architecture documentation reflexio/server/api_endpoints/README.md	Introduces comprehensive documentation describing endpoint-helper file organization (request context, CRUD helpers, account/health/tool-call/stall APIs), the core routing pattern using RequestContext and Reflexio delegation, auth injection, and operational rules (avoid Reflexio instantiation in handlers, use migration-retry and HMAC-verify helpers for safe writes).
Services layer architecture and engineering rules reflexio/server/services/README.md	Introduces comprehensive documentation outlining service responsibilities (LLM orchestration, extraction, evaluation, storage) versus API authentication, core modules (orchestration, generation services, async extraction, evaluation/search, persistence), subsystem layouts, and implementation constraints (service pattern, LiteLLMClient usage, OperationStateManager routing, configuration placement).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• ReflexioAI/reflexio#110: Both PRs update reflexio/server/README.md to improve server architecture documentation and navigation to the services layer.
• ReflexioAI/reflexio#113: Both PRs modify reflexio/server/README.md and introduce or update API endpoints and services documentation, with overlapping navigation cross-references.

Poem

A rabbit hops through the docs with glee, 🐰
Building signposts for all to see—
From API depths to services wide,
Clear architecture is now your guide! 📚✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: adding service-layer and API endpoints code maps (documentation) to the server directory.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/readme-code-maps

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}