AYCC Pack

AYCC Pack User Guide

One operating path for MainApp_DEMO, AYCC Form Builder, and AYCC DB Designer.

AYCC Pack brings together three connected applications:

• MainApp_DEMO, the main portal for authentication, users, roles, workspaces, and tool access.
• aycc_form_builder, the visual builder for pages, forms, dashboards, and publishable content.
• aycc_db_designer, the designer for databases, tables, fields, integrations, and data sources.

When to Use Each Project

Project	Use it for	Typical local URL
MainApp_DEMO	Login, profile, users, roles, settings, workspaces, and tool access	http://localhost:5173
AYCC Form Builder	Pages, forms, dashboards, templates, plugins, and exportable content	http://localhost:5174
AYCC DB Designer	Databases, tables, rows, connections, and data sources	http://localhost:5175

Recommended entry point

For end users, the normal entry point is MainApp_DEMO. From there you can open the Builder and, when enabled, DB Designer.

Recommended Path

1. Sign in to MainApp_DEMO.
2. Complete any initial onboarding.
3. Check your profile and main settings.
4. Open Form Builder when you need to create interfaces or forms.
5. Open DB Designer when you need to prepare the data structure used by forms.
6. Return to the Builder to connect components, forms, and tables.

MainApp_DEMOAccess, dashboard, roles, workspaces, settings, and user management.AYCC Form BuilderProjects, pages, components, templates, plugins, and exports.AYCC DB DesignerBases, tables, fields, rows, integrations, and data sources.Integrated flowsHow to move from authentication to database and builder work.

Common Concepts

Account and Session

The user account is managed by MainApp_DEMO. After login, the portal keeps the session and lets you access authorized areas. Some tools are opened through a bridge that safely transfers the user identity to the external tool.

Roles

Section visibility depends on assigned roles. For example, the Builder entry is shown to users with builder manager, builder user, or administrator privileges.

Workspaces

A workspace is the personal or team operating area. It can contain views, content, widgets, and links to connected tools.

Projects, Bases, and Tables

In the Builder you work with projects and pages. In DB Designer you work with bases, tables, and data. A common flow is to create the data structure first and then use it in the Builder for forms, lists, or dashboards.

Main Local Services

Service	Port
MainApp frontend	5173
MainApp backend	8000
Keycloak	4000
MainApp PostgreSQL	5432
NocoDB	8081
Form Builder frontend	5174
Form Builder backend	8001
Review backend	3001
Collaboration backend	6000
DB Designer frontend	5175
DB Designer backend	8002

Local environment

If a page does not open, first check that the corresponding service is running and that the port is not already in use.