accounts/docs/en

Accounts Service Plus Documentation

This documentation set now covers the current engineering reality of accounts.svc.plus instead of placeholder summaries. The detailed pages under docs/architecture/*, docs/api/*, and docs/development/* are shared bilingual pages, while docs/en/* remains the English entry layer.

What Is Covered

• System design from cmd/accountsvc/main.go through API routing, store access, agent registry, and Xray sync.
• Package and type ownership for api, internal/store, internal/auth, internal/service, internal/xrayconfig, internal/agentmode, internal/agentserver, and internal/agentproto.
• HTTP contracts including request fields, response fields, auth mode, owner handler file, and error conventions.

Recommended Reading Paths

For architecture readers

1. Architecture
2. Detailed startup and runtime flow
3. Component ownership map
4. Design decisions

For API and integration readers

1. Developer Guide
2. API overview
3. Authentication and authorization
4. Endpoint matrix
5. Error conventions

For codebase readers

1. Developer Guide
2. Code structure reference
3. Testing baseline

Canonical Entry Pages

• Architecture
• Design
• Deployment
• User Guide
• Developer Guide
• Vibe Coding Reference

Notes

• Detailed subsystem pages are intentionally shared instead of duplicated into docs/en/api/* or docs/en/architecture/*.
• The validation baseline for the current docs set is go test ./...; see testing.