feat: Add Matrix infrastructure (Synapse + Element Web)

- Synapse homeserver.yaml configuration
- Element Web config.json
- PostgreSQL init script for synapse DB
- Nginx gateway configuration
- Docker Compose for Matrix stack
- README_MATRIX.md documentation

infra/matrix/README_MATRIX.md

@@ -0,0 +1,152 @@
+# Matrix Integration for DAARION.city
+
+## Overview
+
+Matrix забезпечує децентралізований real-time чат для DAARION.city:
+- **Synapse** — Matrix homeserver
+- **Element Web** — веб-клієнт
+- **DAARION Bridge** (майбутнє) — інтеграція з City Rooms та Agents
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    DAARION.city                         │
+├─────────────────────────────────────────────────────────┤
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────┐  │
+│  │ Element Web │  │   Synapse   │  │  DAARION Auth   │  │
+│  │   (8088)    │→ │   (8008)    │← │     (7020)      │  │
+│  └─────────────┘  └─────────────┘  └─────────────────┘  │
+│         │               │                   │           │
+│         └───────────────┼───────────────────┘           │
+│                         ↓                               │
+│                   ┌───────────┐                         │
+│                   │ PostgreSQL│                         │
+│                   │  (synapse)│                         │
+│                   └───────────┘                         │
+└─────────────────────────────────────────────────────────┘
+```
+
+## URLs
+
+| Service | Internal | External |
+|---------|----------|----------|
+| Synapse API | http://127.0.0.1:8008 | https://matrix.daarion.space/_matrix/ |
+| Element Web | http://127.0.0.1:8088 | https://matrix.daarion.space/element/ |
+| Well-known | - | https://matrix.daarion.space/.well-known/matrix/* |
+
+## Deployment Phases
+
+### Phase 1: Base Synapse (Current)
+- [x] Конфігурація homeserver.yaml
+- [x] PostgreSQL schema
+- [x] Docker Compose
+- [ ] Deploy на NODE1
+- [ ] SSL/DNS для matrix.daarion.space
+
+### Phase 2: Element Web
+- [x] config.json
+- [ ] Deploy Element
+- [ ] Nginx routing /element/
+
+### Phase 3: DAARION Auth Integration
+- [ ] User provisioning при реєстрації
+- [ ] SSO через DAARION JWT
+- [ ] Sync user profiles
+
+### Phase 4: City Rooms Bridge
+- [ ] Маппінг City Rooms → Matrix Rooms
+- [ ] Agent messages → Matrix events
+- [ ] Presence sync
+
+### Phase 5: Federation (Optional)
+- [ ] DNS SRV records
+- [ ] Federation keys
+- [ ] Multi-node setup
+
+## Configuration
+
+### Environment Variables
+
+```bash
+# Required
+SYNAPSE_DB_PASSWORD=your_secure_password
+SYNAPSE_REGISTRATION_SECRET=your_registration_secret
+TURN_SHARED_SECRET=your_turn_secret
+
+# Optional
+SYNAPSE_SERVER_NAME=daarion.space
+```
+
+### DNS Records
+
+```
+matrix.daarion.space    A       144.76.224.179
+_matrix._tcp.daarion.space    SRV    10 5 443 matrix.daarion.space
+```
+
+## User Registration
+
+Реєстрація через API (для інтеграції з DAARION Auth):
+
+```bash
+# Register user via admin API
+curl -X POST "http://localhost:8008/_synapse/admin/v1/register" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "nonce": "...",
+    "username": "user123",
+    "password": "...",
+    "admin": false
+  }'
+```
+
+## Security
+
+1. **Registration disabled** — користувачі створюються тільки через DAARION Auth
+2. **Admin API** — обмежений доступ
+3. **Rate limiting** — налаштовано в homeserver.yaml
+4. **E2EE** — підтримується Element Web
+
+## Monitoring
+
+Метрики доступні на порту 9000:
+- `/_synapse/metrics` — Prometheus метрики
+
+## Troubleshooting
+
+### Synapse не стартує
+```bash
+docker logs daarion-synapse
+# Перевірити signing.key
+docker exec daarion-synapse ls -la /data/
+```
+
+### Database connection failed
+```bash
+# Перевірити PostgreSQL
+docker exec -it dagi-postgres psql -U postgres -c "\l"
+```
+
+### Element не підключається
+1. Перевірити CORS headers
+2. Перевірити .well-known endpoints
+3. Перевірити config.json base_url
+
+## Files
+
+```
+infra/matrix/
+├── synapse/
+│   ├── homeserver.yaml     # Main config
+│   └── log.config          # Logging config
+├── postgres/
+│   └── init.sql            # DB initialization
+├── element-web/
+│   └── config.json         # Element config
+├── gateway/
+│   └── matrix.conf         # Nginx config
+├── docker-compose.matrix.yml
+└── README_MATRIX.md
+```
+