Portfolio Website Architecture for Dummies

This website serves two purposes - it's where the author writes about their thoughts and where they showcase their projects. In the near future, they will be releasing their first product called ThoughtForm. ThoughtForm is a conversational thinking workspace that uses an AI assistant to help users explore, organize, and articulate their thoughts and feelings.

Through conversation, examples, clarification, challenge, and alternative perspectives, ThoughtForm assists users in developing an evolving idea map that can be inspected and corrected. If needed, the AI can also bring together this understanding into a coherent expression in the user's own words.

The website's architecture is based on the ports-and-adapters design pattern. This approach simplifies complexity by separating the system into distinct layers and components, each with a specific function. For the website, these include a host layer, delivery layer, and application layer. Ports and adapters refer to the interfaces between these layers, allowing them to communicate and work together seamlessly.

To understand this architecture better, the author compares it to a shopping centre. The main unit in the centre displays the author's writing, while smaller units house the projects. These projects, like ThoughtForm, can operate independently but can also share resources such as security, storage, and AI capabilities. When a user visits ThoughtForm, they enter through the main unit and interact with the AI assistant to explore their thoughts and feelings.

The assistant builds an idea map, which is an inspectable view of the user's established ideas and perspectives. If the user finds this helpful, ThoughtForm can help them articulate these ideas in their own words.

One of the key benefits of this architecture is its flexibility. Just like a shopping centre can be upgraded or have different suppliers without the need for ThoughtForm to redesign itself, this architecture allows the website to change its underlying services without requiring major modifications. This means the website can grow and adapt over time, making it easier to maintain and update.