Rename Reference Architecture to Include Deployment and Add more Recommendations

[ryanmelt]

What is the use case or problem this feature would solve?

We should better define what people should think about and decide before deploying COSMOS for Prod/Test.

Describe the solution you'd like

More directions on what to do

Additional context

No response

Screenshots

No response

[crawlchat]

Thanks for bringing this up! Based on the current documentation, I can see what guidance exists and where there might be gaps.

Current State

The documentation does cover some key decision points:

Reference Architectures & Use Cases

COSMOS has two main deployment paths, each with different considerations:

• COSMOS Core (single-server) is suitable for evaluation, test, or development
• COSMOS Enterprise (single-server or Kubernetes) is suitable for formal test, production, or operations

Key differences include user management, RBAC, scalability, and support model.

Security Considerations

There are documented security boundaries covering Docker networks, host computer security, and credential management, but these are relatively brief.

The Gap

The documentation describes what features exist (Core vs. Enterprise capabilities), but doesn't provide a comprehensive pre-deployment checklist or decision framework — like:

• Sizing considerations (hardware, expected users, data volume)
• Network/infrastructure planning
• Backup & disaster recovery strategy
• Monitoring & alerting requirements
• User access control strategy (before going to Prod)
• Data retention/archival plans
• Integration points with existing systems

---

To help the team prioritize this: Could you clarify what specific decisions or concerns your team faced (or expects to face) when moving from test to production? For example:

• Multi-user management?
• Scalability/performance planning?
• Security hardening?
• Operational runbook requirements?

This would help target the new guidance most effectively.

[jmthomas]

We also need a better top level context diagram: C2, MM, FD, data processing, antenna. A context diagram around the assembly integration and test workflow would also be helpful.