Project Index

Updated: 2026-04-02

Root

000_START_HERE.md: copy-ready continuation prompt for the next agent session
.dockerignore: trims Docker build context to runtime-relevant files only
AGENTS.md: repository workflow rules for autonomous contributors
compose.yaml: Docker Compose entrypoint for the bundled panel + 3proxy runtime, including panel auth env defaults
Dockerfile: multi-stage image that builds the panel and compiles 3proxy
README.md: quick start and current project scope
package.json: frontend/backend scripts and dependencies, including combined local dev startup
tsconfig.server.json: server type-check configuration
vite.config.ts: Vite + Vitest configuration plus local /api proxy to the control-plane backend

src/main.tsx: application bootstrap
src/App.tsx: authenticated panel shell with API-backed login, sessionStorage token persistence, localized labels, early theme application, and protected panel mutations
src/SystemTab.tsx: Settings tab with separate panel-settings and services cards, editable proxy endpoint, unified service type editing, remove confirmation, and generated config preview
src/App.test.tsx: login-gate, preferences persistence, modal interaction, pause/resume, delete-confirm, and settings-save UI tests
src/app.css: full panel styling
src/data/mockDashboard.ts: default panel state and frontend fallback snapshot
src/lib/3proxy.ts: formatting and status helpers
src/lib/3proxy.test.ts: paranoia-oriented tests for core domain rules
src/lib/panelPreferences.ts: localStorage-backed panel language/theme preferences plus theme application helpers with system as the default theme
src/lib/panelText.ts: English/Russian UI text catalog for the panel shell and settings flows
src/shared/contracts.ts: shared panel, service, user, and API data contracts
src/shared/validation.ts: shared validation for user creation, system edits, service type mapping, and quota conversion
src/test/setup.ts: Testing Library matchers

server/index.ts: backend entrypoint and runtime bootstrap
server/app.ts: Express app with login, protected panel state/runtime routes, and writable system configuration API with linked-user cleanup on removed services
server/app.test.ts: API tests for user management plus system-update safety, cascade delete, and config edge cases
server/lib/auth.ts: expiring token issuance and bearer-token verification for the panel
server/lib/config.ts: 3proxy config renderer, validation, and dashboard derivation for SOCKS/HTTP managed services
server/lib/config.test.ts: config-generation regression tests
server/lib/runtime.ts: managed 3proxy process controller
server/lib/store.ts: JSON-backed persistent state store with legacy admin-service migration