https://build.ralphmayr.com/tags/architecture/Recent content in Architecture on Build in PublicHugoen-us©️ Ralph Mayr 2026Mon, 25 Aug 2025 00:00:00 +0000https://build.ralphmayr.com/posts/56-state-diagrams-are-fun/Mon, 25 Aug 2025 00:00:00 +0000https://build.ralphmayr.com/posts/56-state-diagrams-are-fun/<p>One would think that poketto.me is so straightforward that any kind of architectural documentation would be unnecessary. But then...</p> <p>Whenever a user saves something, the app first fetches the raw content from the relevant webpage. Then, the content undergoes an asynchronous 'cleanup' process (as I mentioned previously, I use an LLM to fix broken formatting, etc.). If the user has turned on that setting, the content is then translated. This already results in five different states that a Save can be in: New (no content available yet), Extracted (raw content available), Processing (raw content cleaned up), Translating (content being translated), and 'None' (everything done). Of course, the frontend needs to be mindful of what to allow the user to do in each of these states.</p>