How nurasss/t-skills.kz works
T-Skills is a closed-beta assessment product centered on a versioned assessment workflow: users enter through the web UI, submit responses through assessment APIs, and the server scores and persists sessions before presenting reports. Related branches cover teen assessments, accounts and privacy requests, checkout, and administration. Source excerpts show the controller, scoring, persistence, authentication, and validation layers; several other capabilities are documented in the README but their implementation details were not sampled, so those links are documented rather than inferred from module names.
Main entry points: durable-store.ts Assessment and account store · orbita-app.tsx Web shell and views · route.ts Assessment APIs · index.ts D1 and R2 bindings
Components 26
User experience
- Web shell and views
app/orbita-app.tsx - Workflow controller
hooks/use-orbita-controller.ts - Assessment views
app/views/assessment/assessment-view.tsx
Assessment domain
- Assessment APIs
app/api/assessments/route.ts - Scoring engine
lib/assessment-engine.ts - Assessment item bank
lib/item-bank.ts - Version contracts
lib/t-skills/versions.ts - Prepared v5 pipeline
lib/t-skills/v5/pipeline.ts - Teen assessment flow
app/views/teen/teen-flow-view.tsx - Reports and PDFs
app/api/reports/[id]/download/route.ts
Identity and data
- Assessment and account store
lib/durable-store.ts - D1 and R2 bindings
db/index.ts - Application identity
lib/app-auth.ts - Authentication APIs
app/api/auth/register/route.ts - Export and deletion APIs
app/api/account/export/route.ts - Scheduled retention
app/internal/retention/route.ts
Commerce and operations
- Checkout API
app/api/checkout/route.ts - Payment provider
lib/payment-provider.ts - Payment webhooks
app/api/payments/webhook/route.ts
Administration
- Admin console
app/admin/admin-console.tsx - Admin APIs
app/api/admin/overview/route.ts - Admin store
lib/admin-store.ts
Other components
- Assessment user
- D1 database
- Private R2 artifacts
- Payment service
Connections 27
- Assessment user → Web shell and views: uses
README.md - Web shell and views → Workflow controller: composes
app/orbita-app.tsx - Workflow controller → Assessment APIs: submits responses
hooks/use-orbita-controller.ts - Web shell and views → Assessment views: routes views
- Assessment APIs → Assessment and account store: creates sessions
app/api/assessments/route.ts - Assessment and account store → Scoring engine: scores responses
lib/durable-store.ts - Scoring engine → Assessment item bank: uses items
lib/assessment-engine.ts - Assessment APIs → Version contracts: selects contract
app/api/assessments/route.ts - Assessment and account store → D1 and R2 bindings: uses bindings
lib/durable-store.ts - D1 and R2 bindings → D1 database: persists state
db/index.ts - Assessment and account store → Reports and PDFs: stores report artifacts
- Reports and PDFs → Private R2 artifacts: serves private files
README.md - Assessment user → Authentication APIs: registers
README.md - Authentication APIs → Application identity: creates identity
app/api/auth/register/route.ts - Application identity → D1 and R2 bindings: uses D1
lib/app-auth.ts - Assessment user → Checkout API: starts checkout
README.md - Checkout API → Payment provider: creates payment
app/api/checkout/route.ts - Payment provider → Payment service: integrates
README.md - Payment service → Payment webhooks: sends events
README.md - Assessment user → Export and deletion APIs: requests export or deletion
README.md - Export and deletion APIs → Assessment and account store: updates account data
- Scheduled retention → Assessment and account store: applies retention
app/internal/retention/route.ts - Admin console → Admin APIs: manages operations
README.md - Admin APIs → Admin store: uses admin data
- Admin console → Admin APIs: manages content and settings
README.md - Assessment user → Teen assessment flow: takes teen assessment
README.md - Prepared v5 pipeline → Version contracts: keeps versioned contract
README.md