MOD-01
kulai_auth
RDZEŃ UWIERZYTELNIANIA
Haszowanie haseł oraz tworzenie i walidacja HMAC JWT bez zależności od frameworka lub persystencji.
SYSTEM 03
KULAI MODULES
WIELOKROTNEGO UŻYCIA INFRASTRUKTURA PYTHONA
Ekosystem 60 własnych pakietów Pythona obejmujący fundamenty aplikacji, moduły domenowe, persystencję, adaptery FastAPI i integracje z providerami.
PYTHONFASTAPIPYDANTICSQLALCHEMYREDISPOSTGRESQL
TOŻSAMOŚĆ SYSTEMU
ID SYSTEMUKULAI-MODULES-03
STATUSAKTYWNY ROZWÓJ
TYPINFRASTRUKTURA OPROGRAMOWANIA
Warstwa wielokrotnego użycia obejmująca rdzeń, persystencję i adaptery HTTP do składania systemów aplikacyjnych.
01 / PRZEGLĄD
PRZEGLĄD PROJEKTU
KulAI Modules to ekosystem własnych pakietów Python do wielokrotnego użytku infrastruktury aplikacyjnej i zdolności domenowych. Oddziela rdzenie niezależne od frameworka, warstwy persystencji i adaptery FastAPI, aby nowy produkt mógł składać potrzebne elementy.
Zweryfikowany snapshot źródeł zawiera 60 pakietów, 422 plików źródłowych Pythona i 319 plików testów. Inwentarz obejmuje konfigurację, logowanie, błędy, bazy danych, uwierzytelnianie, użytkowników, płatności, subskrypcje, dostęp, zadania, providerów, kontrakty LLM, ewaluację ML, transkrypcję i scraping.
02 / INWENTARZ MODUŁÓW
PEŁNA MAPA MODUŁÓW
MOD-02
kulai_auth_fastapi
FASTAPI AUTH
Logowanie e-mail-hasło, rejestracja, odświeżanie, wylogowanie i podłączanie zależności bieżącego użytkownika.
MOD-03
kulai_balance
RDZEŃ EKONOMICZNY
Trwałe portfele, rezerwacje i dopisywany wyłącznie dziennik salda z idempotentnymi mutacjami.
MOD-04
kulai_balance_fastapi
FASTAPI ECONOMICS
Uwierzytelnione odczyty salda oraz chronione trasy salda użytkownika, wewnętrzne i administracyjne.
MOD-05
kulai_billing_access
MODEL ODCZYTU DOSTĘPU
Niezależna od frameworka normalizacja subskrypcji, uprawnień, sald i podsumowań użycia.
MOD-06
kulai_billing_access_fastapi
FASTAPI ACCESS
Adapter HTTP dostępu do rozliczeń tylko do odczytu z trasą bieżącego podmiotu i chronionymi trasami wyszukiwania.
MOD-07
kulai_billing_access_integrations
INTEGRACJA DOSTĘPU
Adaptery tylko do odczytu składające dane subskrypcji, uprawnień, salda i użycia.
MOD-08
kulai_cache
INFRASTRUKTURA REDIS
Cykl życia asynchronicznego klienta Redis, operacje na cache z prefiksami, pomocniki JSON i blokady rozproszone.
MOD-09
kulai_calendar
RDZEŃ KALENDARZA
Zakresowe usługi, zasoby, dostępność, rezerwacje, przejścia cyklu życia i zdarzenia audytowe.
MOD-10
kulai_calendar_fastapi
FASTAPI CALENDAR
Schematy HTTP, wstrzykiwanie zależności i konfigurowalne trasy nad rdzeniem kalendarza.
MOD-11
kulai_calendar_postgres
WSPÓŁBIEŻNOŚĆ POSTGRES
Blokady doradcze PostgreSQL dla wrażliwego na współbieżność tworzenia i zmiany terminów rezerwacji.
MOD-12
kulai_cms
SILNIK TREŚCI
Typowane treści, sekcje oparte na JSON, menu nawigacji i persystencja wiadomości kontaktowych.
MOD-13
kulai_cms_admin_fastapi
INTERFEJS ADMINISTRACJI CMS
Renderowany po stronie serwera chroniony panel administracyjny nad API administracyjnym CMS.
MOD-14
kulai_config
CONFIGURATION
Typowane ustawienia Pydantic, wybór środowiska, warstwowe ładowanie dotenv i wiązanie konfiguracji.
MOD-15
kulai_db
FUNDAMENT BAZY DANYCH
Infrastruktura asynchronicznego silnika i sesji SQLAlchemy, baza ORM oraz pomocniki Alembic.
MOD-16
kulai_devices
TOŻSAMOŚĆ URZĄDZENIA
Rekordy urządzeń gościnnych i powiązanych, sekrety, JWT urządzeń, wiązanie, rotacja i unieważnianie.
MOD-17
kulai_devices_fastapi
FASTAPI DEVICES
Trasy FastAPI i podłączanie zależności dla rdzenia tożsamości urządzeń.
MOD-18
kulai_errors
KONTRAKT BŁĘDÓW
Wspólne kody błędów, typowane wyjątki, oddzielenie szczegółów publicznych i handlery FastAPI.
MOD-19
kulai_fastapi_core
FASTAPI FOUNDATION
Fabryka aplikacji, konfiguracja CORS, middleware logowania i rejestracja domyślnych wyjątków.
MOD-20
kulai_fastapi_health
ZDROWIE USŁUGI
Standardowe endpointy liveness i readiness z opcjonalnymi kontrolami bazy danych.
MOD-21
kulai_llm
RDZEŃ LLM
Niezależne od providera, nie-streamingowe kontrakty czatu LLM, egzekwowanie możliwości i ścisła walidacja ustrukturyzowanych wyników Pydantic.
MOD-22
kulai_logging
OBSERVABILITY
Logowanie JSON oraz identyfikatory korelacji żądań i zadań przekazywane przez zmienne kontekstowe.
MOD-23
kulai_ml_eval
RDZEŃ EWALUACJI ML
Przenośne kontrakty eksperymentów ML, ewaluacja klasyfikacji i diagnostyka ryzyk metodologicznych.
MOD-24
kulai_ml_eval_db
PERSYSTENCJA EWALUACJI ML
Persystencja SQL artefaktów ewaluacji ML, zweryfikowane przebiegi roundtrip rdzenia i niezmienna, ograniczona zakresem historia ewaluacji.
MOD-25
kulai_ml_eval_fastapi
FASTAPI DLA EWALUACJI ML
Kontrolowana, odizolowana zakresem persystencja HTTP artefaktów ewaluacji ML z jawnymi granicami transakcji zapisu.
MOD-26
kulai_outbox
NIEZAWODNE WYSYŁANIE
Trwałe zdarzenia biznesowe z dzierżawioną, ponawialną i idempotentną wysyłką.
MOD-27
kulai_payments
RDZEŃ PŁATNOŚCI
Znormalizowane fakty płatności, weryfikacja podpisów Stripe, dane webhooków i sanitizacja.
MOD-28
kulai_payments_balance
MOST PŁATNOŚCI
Idempotentny most między potwierdzonymi żądaniami realizacji płatności a przyznawaniem salda.
MOD-29
kulai_payments_fastapi
FASTAPI PAYMENTS
Transport podpisanych webhooków Stripe, podłączanie sesji bazy danych i ustalone odpowiedzi HTTP.
MOD-30
kulai_permissions
RDZEŃ UPRAWNIEŃ
Niezależna od frameworka ocena uprawnień z domyślną odmową, politykami i portami.
MOD-31
kulai_permissions_db
MAGAZYN UPRAWNIEŃ
Persystencja i ładowanie obowiązujących polityk dla reguł uprawnień opartych na bazie danych.
MOD-32
kulai_permissions_fastapi
FASTAPI PERMISSIONS
Adapter FastAPI dla oceny rdzenia i polityk uprawnień opartych na bazie danych.
MOD-33
kulai_plan_entitlements
DOMENA PLANÓW
Przenośne kontrakty dostępu do funkcji, limitów użycia i okresowego przyznawania kredytów.
MOD-34
kulai_plan_entitlements_db
MAGAZYN PLANÓW
Definicje bazy danych i cykl życia planów, funkcji, limitów oraz przyznawanych kredytów.
MOD-35
kulai_plan_entitlements_fastapi
FASTAPI PLANS
Dostęp HTTP, chroniona administracja i podglądy uprawnień planów tylko do odczytu.
MOD-36
kulai_plan_entitlements_integrations
INTEGRACJA PLANÓW
Deterministyczne mapowanie DTO planów na dane uprawnień, użycia, salda i subskrypcji.
MOD-37
kulai_plans
KATALOG PLANÓW
Niezmienny katalog cen i okresów z modelami bazy danych oraz wbudowanym seedowaniem.
MOD-38
kulai_plans_fastapi
FASTAPI PLAN CATALOG
Publiczny odczyt planów oraz chronione tworzenie i akcje domyślnego seedowania.
MOD-39
kulai_provider_auth
RDZEŃ UWIERZYTELNIANIA DOSTAWCÓW
Niezależne od frameworka przypadki użycia uwierzytelniania dostawców, kontrakty i obsługa profili.
MOD-40
kulai_provider_auth_fastapi
FASTAPI PROVIDER AUTH
Walidacja HTTP, mapowanie odpowiedzi i kompozycja wokół wstrzykniętych portów dostawców.
MOD-41
kulai_provider_auth_users_bridge
MOST UWIERZYTELNIANIA
Adaptery łączące przepływy uwierzytelniania dostawców z kulai_users i wystawianiem tokenów kulai_auth.
MOD-42
kulai_provider_facebook
FACEBOOK PROVIDER
Weryfikacja tokenów Facebook Graph API mapowana na kontrakt profilu dostawcy.
MOD-43
kulai_provider_google
GOOGLE PROVIDER
Weryfikacja tokenów Google ID mapowana na kontrakt profilu dostawcy.
MOD-44
kulai_provider_identities
IDENTITY STORAGE
Zakresowe mapowania tożsamości zewnętrznych dostawców, migawki profili i usługi cyklu życia.
MOD-45
kulai_provider_ollama
PROVIDER OLLAMA
Lokalny lub skonfigurowany dla hosta provider czatu Ollama implementujący niezależny od providera kontrakt KulAI LLM.
MOD-46
kulai_provider_whisper
PROVIDER WHISPER
Lokalny provider speech-to-text oparty na faster-whisper z typowaną konfiguracją, leniwym serializowanym wnioskowaniem, ograniczonymi wejściami i niezależnymi od providera wynikami transkrypcji.
MOD-47
kulai_rate_limit
RDZEŃ LIMITOWANIA
Ważone reguły stałych okien, liczniki Redis, deterministyczne klucze i błędy limitów.
MOD-48
kulai_rate_limit_fastapi
FASTAPI RATE LIMITING
Zależność endpointu, middleware aplikacji i uwzględniająca proxy ekstrakcja adresu IP klienta.
MOD-49
kulai_scraper
RDZEŃ SCRAPERA
Niezależna od transportu asynchroniczna orkiestracja crawlingu z deterministycznymi partiami, polityką źródeł, dokładnym deduplikowaniem i wznawialnymi checkpointami.
MOD-50
kulai_sms_gateway
RDZEŃ SMS
Niezależna od dostawcy wysyłka SMS, kontrakty, opcjonalna persystencja i idempotentny stan audytu.
MOD-51
kulai_sms_gateway_fastapi
FASTAPI SMS
Bezpieczne dla HTTP wysyłanie SMS i trasy odczytu audytu z podłączaniem zależności.
MOD-52
kulai_subscriptions
DOMENA SUBSKRYPCJI
Niezależne od dostawcy funkcje cyklu życia dla uruchamiania, anulowania, zmian płatności i dostępu.
MOD-53
kulai_subscriptions_db
MAGAZYN SUBSKRYPCJI
Trwałe dane subskrypcji, obsługa okresów, żądania outbox i handlery salda.
MOD-54
kulai_subscriptions_fastapi
FASTAPI SUBSCRIPTIONS
Odczyty podmiotu, chroniona administracja i wewnętrzne trasy przygotowania przyznania okresowego.
MOD-55
kulai_tasks
ZADANIA ASYNCHRONICZNE
Kolejkowanie oparte na Redis, workery, ponowienia, trasowanie dead-letter i planowanie interwałów.
MOD-56
kulai_transcription
RDZEŃ TRANSKRYPCJI
Niezależne od providera kontrakty speech-to-text, sprawdzanie możliwości, walidacja wyników i asynchroniczna orkiestracja providerów.
MOD-57
kulai_tunnels
TUNELE USŁUG
Abstrakcja dostawcy i zarządzanie cyklem życia przy udostępnianiu lokalnej usługi HTTP.
MOD-58
kulai_usage
ŚLEDZENIE UŻYCIA
Zakresowe liczniki dzienne, kontrole limitów i projekcje użycia tylko do odczytu.
MOD-59
kulai_users
PERSYSTENCJA UŻYTKOWNIKÓW
Konta użytkowników, uwierzytelnianie hasłem i persystencja unieważniania tokenów odświeżania.
MOD-60
kulai_users_fastapi
FASTAPI USERS
Uwierzytelniony odczyt konta i aktualizacja adresu e-mail przez użytkownika.
03 / GŁÓWNA INFRASTRUKTURA
WARSTWA FUNDAMENTOWA
FOUND-01
KULAI_CONFIG
Typowane ustawienia i ładowanie dotenv dają aplikacjom wspólny kontrakt konfiguracji bez przejmowania własności nad zewnętrzną usługą.
FOUND-02
KULAI_LOGGING
Formatowanie JSON oraz korelacja żądań lub zadań zapewniają spójne logi w usługach HTTP, workerach i procesach CLI.
FOUND-03
KULAI_ERRORS
Wspólna taksonomia błędów oddziela bezpieczne dane publiczne od szczegółów wewnętrznych i udostępnia wielokrotnego użycia handlery.
FOUND-04
KULAI_DB
Asynchroniczny silnik i sesje SQLAlchemy, fundamenty ORM oraz pomocnicze narzędzia migracji wyznaczają granicę persystencji.
FOUND-05
KULAI_AUTH
Primitives haseł i JWT pozostają niezależne od frameworka, a wyszukiwanie użytkowników i persystencja pozostają w pakietach składających system.
FOUND-06
KULAI_FASTAPI_CORE
Fabryki aplikacji, CORS, middleware i domyślna rejestracja wyjątków tworzą wielokrotnego użycia warstwę składania HTTP.
04 / MODEL KOMPOZYCJI
JAK MODUŁY WSPÓŁPRACUJĄ
Źródła definiują powtarzalny sposób kompozycji: aplikacja dostarcza konfigurację i politykę, moduły rdzeniowe posiadają wyspecjalizowane reguły, pakiety persystencji odpowiadają za przechowywanie, a pakiety FastAPI wystawiają te możliwości przez granice HTTP.
Ścieżka kompozycji aplikacji hostującej
- APLIKACJA HOSTUJĄCA
- KULAI_CONFIG
- KULAI_DB
- DOMENA / USŁUGA
- ADAPTER FASTAPI
- TRASA HTTP
05 / PRAKTYCZNE WYKORZYSTANIE
URUCHOMIENIE / INTEGRACJA PROJEKTU
UC-01
URUCHOM USŁUGĘ
Zacznij od typowanej konfiguracji, wspólnego logowania, obsługi błędów i infrastruktury sesji bazy zamiast odtwarzać te granice w każdej aplikacji.
UC-02
DODAJ KOMPETENCJĘ DOMENOWĄ
Wybierz wyspecjalizowany rdzeń, taki jak kalendarz, subskrypcje, CMS, użytkownicy lub płatności, i ukryj jego przypadki użycia za jawnym API pakietu.
UC-03
EXPOSE HTTP ROUTES
Dodaj pasujący adapter FastAPI, gdy aplikacja potrzebuje fabryk tras, schematów żądań i wstrzykiwanych zależności hosta.
UC-04
SKŁADAJ PRZEKROJOWE PROCESY
Łącz moduły dostępu, uprawnień, salda, użycia, outboxu, cache i zadań tam, gdzie aplikacja rzeczywiście potrzebuje tych możliwości.
UC-05
KEEP HOST OWNERSHIP CLEAR
Pozwól aplikacji hostującej dostarczać granicę transakcji, decyzje polityk, zewnętrzne dane uwierzytelniające i własne procesy.
06 / DECYZJE INŻYNIERSKIE
ARCHITEKTURA W KODZIE ŹRÓDŁOWYM
ENG-01
EXPLICIT PACKAGE BOUNDARIES
Pakiety rdzeni domenowych, persystencji i adapterów FastAPI są rozdzielone na dystrybucje z udokumentowanymi granicami odpowiedzialności.
ENG-02
HOST-OWNED TRANSACTIONS
Wiele warstw repozytoriów i usług wykonuje flush oraz refresh bez commitowania, pozostawiając transakcję zewnętrzną aplikacji hostującej lub adapterowi HTTP zgodnie z dokumentacją.
ENG-03
STABILNE PUBLICZNE API
Korzenie pakietów definiują eksportowane modele, fabryki i przypadki użycia, zapewniając aplikacjom świadomie wybrane punkty integracji.
ENG-04
PORTY INTEGRACJI TYLKO DO ODCZYTU
Integracje dostępu billingowego składają istniejące moduły persystencji przez porty odczytu bez modyfikowania subskrypcji, sald ani użycia.
ENG-05
WYKRYWANIE BAZY BEZ WŁASNOŚCI MIGRACJI
Rejestracja ORM udostępnia modele hostowi na potrzeby autogenerowania Alembic, zachowując jawną własność rewizji schematu.
ENG-06
NIEZAWODNOŚĆ JAKO MODUŁY
Idempotencja, wysyłka outbox, ponowienia, dzierżawy, unieważnianie i blokady doradcze są wyodrębnionymi odpowiedzialnościami, a nie ukrytym kodem aplikacji.
07 / INWENTARZ TECHNICZNY
ZWERYFIKOWANY STACK
STACK-01
PYTHON
Wszystkie 60 pakietów first-party są dystrybucjami Pythona, a ich źródła znajdują się w katalogach src pakietów.
STACK-02
FASTAPI
Wyspecjalizowane pakiety adapterów dostarczają konfigurowalne routery, zależności i fabryki aplikacji.
STACK-03
PYDANTIC
Ustawienia, obiekty domenowe i schematy HTTP korzystają z typowanych granic walidacji w całym ekosystemie.
STACK-04
SQLALCHEMY
Pakiety oparte na bazie używają asynchronicznych modeli ORM, repozytoriów, sesji i wspólnych konwencji metadanych.
STACK-05
ALEMBIC
Rewizje migracji i pomocniki rejestracji modeli znajdują się w pakietach persystencji oraz ścieżkach integracji hosta.
STACK-06
REDIS
Moduły cache, rate-limit i zadań używają Redis do współdzielonych liczników, blokad, kolejek i trwałego stanu runtime.
STACK-07
POSTGRESQL
Źródła obejmują ścieżki persystencji PostgreSQL oraz dedykowany adapter blokad advisory dla współbieżności kalendarza.
STACK-08
ADAPTERY STRIPE / NGROK
Pakiety webhooków płatności i lokalnych tuneli izolują granice zależne od dostawców za pomocą wyspecjalizowanych adapterów.
08 / STAN PROJEKTU
AKTUALNY ZAKRES
STANAKTYWNY ROZWÓJ
MODULES 60 PAKIETÓW FIRST-PARTY
SOURCE 422 PLIKÓW ŹRÓDŁOWYCH PYTHONA
TESTS 319 PLIKÓW TESTÓW / 1990 FUNKCJI TESTOWYCH
GŁÓWNA ROLA REUSABLE CORE / PERSISTENCE / FASTAPI ADAPTERS