48 — Teams Access Control & Confidential Mode (MicroDAO)¶

Командні доступи, ролі, членство, ACL, confidential mode, індексація, інструменти, агенти, governance-політики. Канонічна специфікація microDAO команд.

1. Purpose & Scope¶

Цей документ визначає:

структуру команд (microDAO),
ролі та дозволи,
ACL для ресурсів,
поведінку Confidential Mode,
вплив на агентів, інструменти, чат, LLM Proxy, Router, Wallet, Embassy, Projects/Tasks,
правила Governance.

Це центральний рівень контролю безпеки й приватності у DAARION.city.

2. Team (microDAO) Model¶

Команда = організаційний домен, який має:

учасників (members),
ролі,
командні налаштування,
власну економіку (1T / KWT / RINGK стейк),
власний набір агентів,
власні канали,
власні ACL.

3. Team Roles¶

Role	Capabilities	Опис
Owner	повний контроль, зміна налаштувань, звільнення Guardian	creator of team
Guardian	майже все, крім знищення команди	security + oversight
Admin	керування каналами/агентами/ресурсами	operational
Member	доступ до основних інструментів	worker
Guest	читання + обмежені інструменти	limited
Agent	системний агент команди	restricted

Команда може мати:

1 owner
0–N guardians
0–N admins
0–N members
0–N guests
0–N private agents

4. Role Capability Mapping¶

Owner¶

повний доступ
оновлювати план
додавати/видаляти членів
змінювати confidential mode
випускати токени команди (якщо дозволено governance)

Guardian¶

контролює security sensitive
додавання агентів
доступ до private channels
керування ACL
активація E2EE

Admin¶

створення каналів
створення проектів
керування задачами
запуск agent flows

Member¶

участь у каналах
запуск агентів (якщо дозволено)
створення задач у публічних проєктах

Guest¶

читання
обмежені інструменти
немає доступу до agent visibility

Agent¶

діє через PDP
може діяти лише у дозволених каналах/проєктах
не має власних ролей

5. Team-Level ACL¶

У команді існує ACL для кожного типу ресурсу:

RESOURCE → [allowed_roles]

Приклад:

Projects¶

create: [owner, guardian, admin]
read: [owner, guardian, admin, member]
update: [owner, guardian, admin]
delete: [owner, guardian]

Channels¶

create: [owner, guardian, admin]
read/write: залежить від channel.acl

Agents¶

create: [owner, guardian]
update: [owner, guardian]
run: [owner, guardian, member] (опційно)

Wallet¶

view: [owner, guardian]
tx: [owner]
claim: [owner, guardian]

Embassy Data¶

read: [owner, guardian]
write: none (тільки embassy service)

6. Team States¶

Команда може перебувати в станах:

active — нормальна робота
locked — тимчасове блокування (борги, порушення)
confidential — підвищена приватність
suspended — потребує KYC / security audit
archived — команда закрита

7. Confidential Mode¶

Confidential Mode — це режим максимального захисту для команд.

Увімкнення:¶

лише Owner або Guardian

Поведінка:¶

7.1 LLM Proxy¶

не бачить plaintext повідомлень
використовує summary-only режим
vision вимкнено
embedding робиться з redacted тексту

7.2 Agents¶

не отримують plaintext
не можуть використовувати tools категорії C/D
не можуть використовувати platform tools
autonomy знижується на 1 рівень
не можуть запускати subagents

7.3 Messaging¶

повідомлення не зберігаються у plaintext
DM канал між Owner та Guardian → E2EE only
file attachments encrypt-only
retention: 0–30 днів

7.4 Projects/Tasks¶

task description → summary-only
файли завжди E2EE
agent-run logs → redacted

7.5 Wallet/RWA¶

доступ обмежений Owner/Guardian
payouts проходять без content-level history
RWA дані теж redacted

8. Team Privacy Layers¶

Рівні приватності:

Level	Description
open	звичайний режим
restricted	менш видимі канали
private	DM-like behavior
confidential	максимальний захист, summary-only

9. Team Settings Schema¶

{
  "team_id": "t_444",
  "name": "GreenFood Hub",
  "plan": "Premium",
  "confidential": true,
  "settings": {
    "agents_enabled": true,
    "allow_subagents": false,
    "allow_router_flows": true,
    "file_storage_limit_mb": 5000,
    "agent_default_autonomy": "low"
  },
  "acl_overrides": {
    "wallet.view": ["owner","guardian"],
    "wallet.tx": ["owner"],
    "projects.create": ["owner","guardian","admin"]
  }
}

10. PDP Integration¶

PDP оцінює дію:

роль користувача
ACL ресурсу
командний стан
confidential mode
usage
план команди
stake RINGK

Висновок:

allow | deny | require-confirmation

11. Governance Controls¶

Governance може:

змінювати allowed roles
визначати максимальну автономію агентів
вмикати/вимикати confidential mode для певного плану
вводити policy templates для ACL
встановлювати KYC-вимоги
заморожувати команди, що порушили правила

12. Membership Lifecycle¶

Create Team:¶

Owner створює
Дається початковий ACL

Invite Member:¶

Owner/Admin може запросити → role=member

Promote:¶

Member → Admin → Guardian

Demote:¶

лише Owner може демотити Guardian

Remove:¶

Owner або Guardian (якщо не Owner)

13. Agent Integration Rules¶

Агенти:

самі не мають ролей
використовують access keys
діють тільки через PDP
бачать тільки те, що канал/проект дозволяє
у confidential mode → summary-only
не можуть змінювати ACL
не можуть виконувати wallet.tx

14. Examples¶

Example 1 — Створення приватного каналу¶

roles: [owner, guardian]
confidential: false

Example 2 — Канал для автономного агента¶

roles: [owner, guardian, member]
agents_allowed: [ag_777]
confidential: false

Example 3 — Канал у confidential mode¶

type: confidential
agents_allowed: []
raw disabled
summary-only

15. Integration with Other Docs¶

Цей документ доповнює:

47_messaging_channels_and_privacy_layers.md
32_policy_service_PDP_design.md
36_agent_runtime_isolation_and_sandboxing.md
45_llm_proxy_and_multimodel_routing.md
46_router_orchestrator_design.md
40_rwa_energy_food_water_flow_specs.md

16. Завдання для Cursor¶

You are a senior backend engineer. Implement Teams Access Control & Confidential Mode using:
- 48_teams_access_control_and_confidential_mode.md
- 32_policy_service_PDP_design.md
- 47_messaging_channels_and_privacy_layers.md

Tasks:
1) Define Team Roles (Owner, Guardian, Admin, Member, Guest, Agent) with capabilities.
2) Implement Role Capability Mapping (per role permissions).
3) Create Team-Level ACL (Projects, Channels, Agents, Wallet, Embassy Data).
4) Implement Team States (active, locked, confidential, suspended, archived).
5) Add Confidential Mode (LLM Proxy behavior, Agents restrictions, Messaging rules, Projects/Tasks rules, Wallet/RWA rules).
6) Implement Team Privacy Layers (open, restricted, private, confidential).
7) Create Team Settings Schema (JSON config with settings and ACL overrides).
8) Integrate with PDP (role, ACL, team state, confidential mode, usage, plan, stake evaluation).
9) Add Governance Controls (allowed roles, agent autonomy, confidential mode activation, ACL templates, KYC requirements, team freezing).
10) Implement Membership Lifecycle (Create Team, Invite Member, Promote, Demote, Remove).
11) Add Agent Integration Rules (no roles, access keys, PDP-only, channel/project permissions, confidential mode restrictions, no ACL changes, no wallet.tx).

Output:
- list of modified files
- diff
- summary

17. Summary¶

Система команд (microDAO):

має строгі ролі та ACL
повністю інтегрована з PDP
визначає дозволи для projects/tasks/wallet/agents
підтримує confidential mode (summary-only, no plaintext, no vision)
гарантує приватність даних
дозволяє побудову складних робочих просторів
є фундаментом безпеки та організації в DAARION OS

Версія: 1.0
Останнє оновлення: 2024-11-14