Next Steps
You’ve opened Ocean App, run the onboarding example, read its Bundle end to end, and changed and regenerated it yourself. From here, where you go depends on what you’re trying to do.
1. Where Do I Go If I Want To
Section titled “1. Where Do I Go If I Want To”| Goal | Go to |
|---|---|
| Understand Ocean’s mental model in depth | Concepts |
| Learn exact DSL syntax | DSL Reference |
| Build another system | Examples |
| Start from a proven, reusable design | Patterns |
| Understand how Ocean-Atlas itself is put together | Architecture |
| Reuse a definition instead of writing one | Ocean Repository |
| Resolve a problem I’ve hit | Troubleshooting |
| Look up a term precisely | Glossary |
| Understand why something was built the way it was | Architecture Decision Records |
| See what’s currently open for debate | Requests for Comment |
| See where Ocean is headed | Roadmap |
2. Your Next Example, by Level
Section titled “2. Your Next Example, by Level”Task Manager was chosen for this path because it’s the one example marked for onboarding. Once you’re comfortable, these are the others, grouped by how much they ask of you:
Beginner — similar scope to Task Manager, different shape:
- Broker-Based Math Service — typed request-response messaging through a broker, something Task Manager doesn’t touch at all.
- In-Memory Calculator FSM — your first finite state machine, without persistence to think about at the same time.
Intermediate — more moving parts, still approachable:
- Inventory Management — a larger, more CRUD-heavy domain than Task Manager’s single entity.
- Entity-Based Order FSM — a persisted
entity whose lifecycle is governed by an FSM, not by an expression rule
like Task Manager’s
IsOverdue. - Simple Vault Usage — typed secrets, kept out of the DSL entirely.
Advanced — multi-service systems:
- Asynchronous Answer Aggregation — broker request-response, shared context, and multi-service coordination.
- Synchronous Answer Aggregation — composing several synchronous services into one answer.
- Invoice Approval Workflow — a full decision-driven approval process across invoices, users, and customers.
3. If You’re Not Sure Yet
Section titled “3. If You’re Not Sure Yet”That’s fine — What Is Ocean? and Concepts are both short enough to revisit before committing to a direction. The path doesn’t expect you to know where you’re headed by the end of it; it only expects you to know enough to choose.