OneWallet¶
E-money кошелёк (Таиланд, регулятор Bank of Thailand, валюта THB). Flutter-приложения + Serverpod Auth Center + Payment Manager + TigerBeetle ledger + SvelteKit Admin/Blog.
На какие вопросы отвечает¶
- Какие проекты входят в платформу и где они лежат?
- Где точка входа в документацию?
- Какие приложения для пользователей, а какие — для мерчантов и операторов?
- Как быстро запустить базовое приложение?
📁 Структура¶
| Папка | Назначение | Стек |
|---|---|---|
projects/onewallet_base/ |
Auth Center (JWT/KYC/PII) + базовый Flutter | Serverpod (Dart) + Flutter |
projects/payment-manager/ |
Платёжный движок: intents, ledger, PSP | Node 22 + Fastify + Drizzle + TigerBeetle |
projects/one_loop_app/ |
Consumer-приложение (appId=closeloop): P2P/QR/NFC/мини-аппы | Flutter |
projects/one_merchant_app/ |
Merchant-приложение (appId=merchant): POS (NFC + QR-invoice), Blog | Flutter |
projects/admin-panel/ |
Панель операторов | SvelteKit 2 + Svelte 5 + TS + Tailwind v4 |
projects/one_blog/ |
CMS «What's on» (схема blog.*) |
SvelteKit + Drizzle |
projects/demo-miniapp/ |
Шаблон мини-аппа (LAUNCH_JWT RS256 + window.OneWallet SDK) |
SvelteKit |
projects/kyc-service/ |
KYC OCR worker (Gemini/Ollama + CompreFace) | Node + BullMQ |
projects/notifications-service/ |
Push-уведомления (FCM) | Node + firebase-admin |
projects/deploy/ |
Инфраструктура (docker-compose, env, seeds) | Docker Compose |
projects/posts/ |
Markdown-статьи (контент, не сервис) | Markdown |
projects/public-tech-docs/ |
Публичная документация | — |
📖 Документация¶
Точка входа — docs/README.md (навигация по ролям: бизнес, разработка, ADR, compliance).
- docs/business/ — что такое OneWallet, акторы, приложения, сценарии, лимиты, roadmap
- docs/dev/ — обзор, сервисы, схемы данных, платежи/ledger, безопасность, storage/KYC, деплой
- docs/adr/ — архитектурные решения (TigerBeetle, единый HMAC, разделение схем, single intent API, PII, appId)
- docs/compliance/ — материалы для BOT и аудита
Карта проектов¶
graph TD
Loop[one_loop_app] --> AC[Auth Center]
Merch[one_merchant_app] --> AC
Mini[demo-miniapp] --> AC
Admin[admin-panel] --> PM[Payment Manager]
Admin --> AC
AC --> PM
PM --> TB[(TigerBeetle)]
PM --> KYC[kyc-service]
PM --> Notif[notifications-service]
Blog[one_blog]🚀 Быстрый старт¶
# Flutter приложение (базовое)
cd projects/onewallet_base/onewallet_base_flutter
flutter pub get
flutter run
# Serverpod backend (в отдельном терминале)
cd ../onewallet_base_server
serverpod start
Инфраструктура (PostgreSQL, Valkey, TigerBeetle и др.) поднимается через projects/deploy/ — см. docs/dev/07-deployment.md.