99cd8ae727
- Architecture: overview, 7 ADR, tech stack - Principles: code-style, git-workflow, security - API contracts: auth, profile, tests, admin endpoints - Database schema: tables, relationships, indexes - LLM strategy: prompts, fallback, validation, Qwen 2.5 14B - Onboarding: setup, Docker, .env template - Progress: roadmap, changelog - Agents: context, backend instructions Made-with: Cursor
2.4 KiB
2.4 KiB
samreshu-docs
Документация проекта samreshu — веб-приложение для тестирования знаний по веб-технологиям с LLM-генерацией вопросов.
Навигация
Архитектура
- Общая архитектура — стек, схема сервисов, принципы
- ADR: Polyrepo
- ADR: Fastify
- ADR: Drizzle ORM
- ADR: PostgreSQL
- ADR: LLM-абстракция
- ADR: VPS + Docker deploy
- ADR: Без shared-types репо
Принципы
- Code style — соглашения по коду, конфиги линтеров
- Git workflow — ветки, коммиты, PR
- Безопасность —
TODOrate limiting, CORS, auth security
API
- Контракты —
TODOREST endpoints, request/response форматы
База данных
- Схема — таблицы, связи, пояснения
LLM
- Стратегия —
TODOпровайдеры, fallback, банк вопросов, prompt engineering
Прогресс
Онбординг
- Настройка окружения — как поднять проект локально
AI-агенты
- Контекст для агентов — общее описание проекта для AI-ассистентов
- Инструкции для backend — структура, порядок разработки, паттерны
Репозитории
| Репо | Описание |
|---|---|
samreshu-backend |
Fastify + TypeScript + Drizzle ORM |
samreshu-frontend |
React + TypeScript + Vite |
samreshu-docs |
Документация, ADR, прогресс |