Files

T

H1K0 745fe38e63 chore(project): drop the docs/reference Flask snapshot

The previous Python/Flask app under docs/reference/ was kept as a visual
design reference while bootstrapping the new frontend. That's well past
done, and 85 files of dead code just add noise to search and exploration.
Remove it (recoverable from history if needed) and update CLAUDE.md: keep
the design tokens, drop the now-dead pointer at the folder.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-17 17:20:49 +03:00

1.9 KiB

Raw Blame History

Tanabata File Manager

Multi-user, tag-based web file manager for images and video.

Architecture

Monorepo: backend/ (Go) + frontend/ (SvelteKit).

Backend: Go + Gin + pgx v5 + goose migrations. Clean Architecture.
Frontend: SvelteKit SPA + Tailwind CSS + CSS custom properties.
DB: PostgreSQL 14+.
Auth: JWT Bearer tokens.

Key documents (read before coding)

openapi.yaml — full REST API specification (36 paths, 58 operations)
docs/GO_PROJECT_STRUCTURE.md — backend architecture, layer rules, DI pattern
docs/FRONTEND_STRUCTURE.md — frontend architecture, CSS approach, API client
docs/Описание.md — product requirements in Russian
backend/migrations/001_init.sql — database schema (4 schemas, 16 tables)

Design reference

Visual design tokens for the frontend (carried over from the previous Python/Flask version):

Color palette: #312F45 (bg), #9592B5 (accent), #444455 (tag default), #111118 (elevated)
Font: Epilogue (variable weight)
Dark theme is primary
Mobile-first layout with bottom navbar
160×160 thumbnail grid for files
Colored tag pills
Floating selection bar for multi-select

Backend commands

cd backend
go run ./cmd/server          # run dev server
go test ./...                # run all tests

Frontend commands

cd frontend
npm run dev                  # vite dev server
npm run build                # production build
npm run generate:types       # regenerate API types from openapi.yaml

Conventions

Go: gofmt, no global state, context.Context as first param in all service methods
TypeScript: strict mode, named exports
SQL: snake_case, all migrations via goose
API errors: { code, message, details? }
Git: conventional commits with scope — type(scope): message
- (backend) for Go backend code
- (frontend) for SvelteKit/TypeScript code
- (project) for root-level files (.gitignore, docs, structure)

1.9 KiB Raw Blame History Unescape Escape