System Creation

Role: Project Manager | Solution Architect 🏗️

A System in AIPD represents an independent service, application, or technical component within the overall project architecture (for example: Order Service, Admin Portal, Payment Gateway, Mobile App). Each System is a separate management unit that contains its own Environments, Features, Configurations, API Specs, and Foundation Documents.

How to use

Open System Management from the main navigation bar of the AIPD Client.

The screen is split into two areas:

• Left column — list of existing Systems, with a search field at the top.
• Right pane — create panel or details of the currently selected System.

---

Create a new System

1. At the bottom of the left column, click "Connect New System".

2. The "Connect New System" panel opens on the right. Fill in the information:

   Basic information:

   Field	Required	Notes
   System Name	Yes	Display name (for example: Order Service, Admin Portal)
   System Code	Yes	Short identifier — letters, numbers, - and _ only (for example: SYS-001, ORDER_SVC)
   Description	Yes	Short description of this System's role in the project

   Deployment Regions:

   Field	Required	Allowed values
   Countries	No	Global, US, EU, UK, CA, AU, JP, CN, Internal

   Technical Stack:

   Field	Required	Allowed values
   Languages	No	TypeScript, JavaScript, Python, Java, Go, Rust, C++, C#, Ruby, PHP, Swift, Kotlin

   Organisation:

   Field	Required	Notes
   Labels	No	Custom tags — type and press Enter or comma to add. No predefined options.

3. Click "Create System". The new System appears immediately in the left list and is auto-selected.

---

View and navigate the new System

When a System is selected, the right pane switches to System Details with 5 tabs:

Tab	Contents
Foundation	Foundational technical docs (knowledge base for the AI Agent)
Environments	Deployment environments (Dev, Staging, Prod...)
Features	List of the System's features
Configs	Env variables, secrets, DB and queue connections
API Specs	Swagger/OpenAPI URL per environment

The top-left corner of the details pane shows the System name, code (cyan badge), and description. Click the ⚙️ icon to edit the System's information.

---

Edit a System

Click the ⚙️ icon on the System Details header (or the dropdown menu on the list card) to open the "Edit System" panel. Update the information and click "Save Changes".

Delete a System

Open the dropdown menu on the System card/row → select "Delete" → confirm in the dialog. This action cannot be undone — all Environments, Features, Configs, API Specs, and Foundation Documents of the System will be deleted along with it.

---

Recommended order after creating a System

To give the AI Agent enough context to operate, follow this order:

1. Environments  →  define deployment environments
2. Features      →  list features
3. Configs       →  add environment variables and secrets
4. API Specs     →  import Swagger URL to extract endpoints
5. Foundation    →  write foundational technical docs

Naming a System

Use short names that accurately reflect the technical boundary of the service. Good examples: User Auth Service, Payment Gateway, Notification Worker. Avoid generic names such as Backend or Service 1.

Next step

After creating a System, move on to 02 — Environment Creation to define deployment environments.