🌐
Портал для клиентов B2B
portal
portal_ecosystem
🛡️ RLS Protected
Самообслуживание клиентов с несколькими заказчиками: каталогические заказы, сбор счетов, отчеты о обслуживании и поддержка.
Fachliche Bestimmung: Эксклюзивный B2B-покупательский портал для клиентов. Он предлагает 14 интегрированных модулей (продукты, заказы с наборами атрибутов, предложения, заказы, сообщения о обслуживании, счета, сроки, возвраты, приложения и билеты на поддержку).
⚡ Рабочие процессы и жизненные циклы (4)
🗄️ Модели данных & поля (1)
🔌 Входные пункты (UI & API) (42)
🛡️ Регуляторство и соответствие
⚡ Рабочие процессы и жизненные циклы
Заказ на портале клиентов и ERP-кассерование
portal_order_cascade
От корзины в портале покупателя до автоматического основное средство от коммерческое предложение и заказа на поставку.
sequenceDiagram
Kunde im Portal->>PortalAPI: POST /portal/{slug}/bestellung (Positionen & Fieldsets)
PortalAPI->>PortalAPI: validate_attribute_values()
PortalAPI->>DB: INSERT INTO quotes (source_type = 'SYSTEM')
PortalAPI->>DB: INSERT INTO work_orders (order_type = 'delivery', status = 'SCHEDULED')
PortalAPI-->>Kunde im Portal: Bestätigungsseite & Auftragsnummer
1. CATALOG
Выбор продукции
клиент выбирает продукты и заполняет динамические наборы полевых атрибутов.
Aktionen: Обязательная проверка поля в браузере
2. SUBMIT
Передача заказов
POST на /portal/{slug}/заказ с типовалидированными семантическими_атрибутами.
Aktionen: выполнять order_submit
3. QUOTE_GEN
Оферта
Система создает котировку с source_type='SYSTEM' и 'portal_order'.
Aktionen: Принять semantic_attributes
4. WORKORDER_GEN
Заказная установка
Автоматические продукты выполнения заказа (рабочий заказ) в LVS/ERP.
Aktionen: склад или подъемные
Приказ пользователя: customer crude subagent
plan:command_customer_crud_subagent
Проверенный план длительности (durable_plan), старт: manual_command.
1. customer_crud_subagent
customer_crud_subagent
{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "customer_crud_subagent", "condition_fact": null}
Aktionen: customer_crud_subagent
Benutzerbefehl: portal admin agent
plan:command_portal_admin_agent
Geprüfter Durable-Plan (unreviewed_plan), Start: manual_command.
1. portal_admin_agent
portal_admin_agent
{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "portal_admin_agent", "condition_fact": null}
Aktionen: portal_admin_agent
Запрос на клиентский портал
plan:portal_request_dispatch
Проверенный длительный план (durable_plan), старт: domain_event.
1. portal_request_dispatch_agent
portal_request_dispatch_agent
{"key": "step_0", "label": "Portal-Anfrage als Aufgabe disponieren", "adapter": "agent.execute", "agent": "portal_request_dispatch_agent", "condition_fact": null}
Aktionen: portal_request_dispatch_agent
🗄️ Модели данных & поля
🔌 Входные пункты (UI & API)
| Art | Метод | Конечный пункт / путь | Titel & Zweck | Право на |
|---|---|---|---|---|
| ⚡ REST API | DELETE | /api/v1/customers/{customer_id} |
delete_customer
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | DELETE | /api/v1/customers/{customer_id}/contacts/{contact_id} |
delete_contact
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | GET | /api/v1/customers |
list_customers
Semantic binding: inventory_only; mutation=False
|
customers
|
| ⚡ REST API | GET | /api/v1/customers/stats |
customer_stats
Semantic binding: inventory_only; mutation=False
|
customers
|
| ⚡ REST API | GET | /api/v1/customers/{customer_id} |
get_customer
Semantic binding: inventory_only; mutation=False
|
customers
|
| ⚡ REST API | GET | /api/v1/customers/{customer_id}/contacts |
list_contacts
Semantic binding: inventory_only; mutation=False
|
customers
|
| ⚡ REST API | GET | /api/v1/customers/{customer_id}/invoice-recipient |
get_invoice_recipient
Semantic binding: inventory_only; mutation=False
|
customers
|
| ⚡ REST API | GET | /api/v1/customers/{customer_id}/portal |
customer_portal_state
Semantic binding: inventory_only; mutation=False
|
customers
|
| ⚡ REST API | GET | /api/v1/customers/{customer_id}/shop-rates |
list_partner_shop_rates
Semantic binding: inventory_only; mutation=False
|
customers
|
| ⚡ REST API | GET | /api/v1/customers/{customer_id}/tree |
get_customer_tree
Semantic binding: inventory_only; mutation=False
|
customers
|
| ⚡ REST API | GET | /customers |
customers_page
Semantic binding: inventory_only; mutation=False
|
customers
|
| ⚡ REST API | GET | /customers/new |
customer_create_page
Semantic binding: inventory_only; mutation=False
|
customers
|
| ⚡ REST API | GET | /customers/{customer_id} |
customer_detail_page
Semantic binding: inventory_only; mutation=False
|
customers
|
| ⚡ REST API | GET | /customers/{customer_id}/edit |
customer_detail_page
Semantic binding: inventory_only; mutation=False
|
customers
|
| ⚡ REST API | GET | /customers/{customer_id}/portal |
customer_portal_admin_page
Semantic binding: inventory_only; mutation=False
|
customers
|
| ⚡ REST API | GET | /portal/{slug}/profil |
profile_page
Semantic binding: inventory_only; mutation=False
|
customers
|
| ⚡ REST API | PATCH | /api/v1/customers/{customer_id} |
update_customer
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | PATCH | /api/v1/customers/{customer_id}/contacts/{contact_id} |
update_contact
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /api/v1/customers |
create_customer
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /api/v1/customers/{customer_id}/contacts |
create_contact
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /api/v1/customers/{customer_id}/portal/accounts |
customer_portal_account_add
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /api/v1/customers/{customer_id}/portal/accounts/{account_id}/password |
customer_portal_account_password
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /api/v1/customers/{customer_id}/portal/accounts/{account_id}/status |
customer_portal_account_status
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /api/v1/customers/{customer_id}/portal/invites |
customer_portal_invite
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /api/v1/customers/{customer_id}/portal/invites/{invite_id}/revoke |
customer_portal_invite_revoke
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /api/v1/customers/{customer_id}/portal/toggle |
customer_portal_toggle
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /customers/{customer_id}/portal |
customer_portal_admin_save
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /customers/{customer_id}/portal/accounts |
customer_portal_account_create
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /customers/{customer_id}/portal/accounts/{account_id}/password |
customer_portal_account_password
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /customers/{customer_id}/portal/accounts/{account_id}/status |
customer_portal_account_status
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /customers/{customer_id}/portal/invites |
customer_portal_invite_create
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /customers/{customer_id}/portal/invites/{invite_id}/revoke |
customer_portal_invite_revoke
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /portal/{slug}/profil |
profile_submit
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /portal/{slug}/profil/kontakte |
profile_contact_save
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /portal/{slug}/profil/kontakte/{contact_id}/loeschen |
profile_contact_delete
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /portal/{slug}/profil/standorte |
profile_location_save
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | POST | /portal/{slug}/profil/standorte/{location_id}/deaktivieren |
profile_location_deactivate
Semantic binding: operator_surface; mutation=True
|
customers
|
| ⚡ REST API | PUT | /api/v1/customers/{customer_id}/shop-rates |
upsert_partner_shop_rate
Semantic binding: operator_surface; mutation=True
|
customers
|
| 🖥️ WEB-UI | GET | /portal/{slug}/ |
Начальная страница портала
Диашборд клиентов с быстрыми приступами и статусовыми каналами
|
Standard |
| 🖥️ WEB-UI | GET | /portal/{slug}/bestellung |
Портал
Заказ каталогов с динамическими наборами полевых
|
Standard |
| 🖥️ WEB-UI | GET | /portal/{slug}/rechnungen |
Портал расчетов
Загрузка счета и PDF
|
Standard |
| ⚡ REST API | POST | /portal/{slug}/bestellung |
Подача заказа
Validifies fieldsets and generates quotes/workorders
|
Standard |
🛡️ Регуляторство и соответствие
Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:
- Статья 15 DSGVO (право на информацию и доступ к данным)
- B2B-безопасность данных и изоляция RLS
Связанные модули: