55 lines
3.1 KiB
Markdown
55 lines
3.1 KiB
Markdown
# ss-tools Development Guidelines
|
|
|
|
Auto-generated from all feature plans. Last updated: 2025-12-19
|
|
|
|
## Active Technologies
|
|
- Python 3.9+, Node.js 18+ + `uvicorn`, `npm`, `bash` (003-project-launch-script)
|
|
- Python 3.9+, Node.js 18+ + SvelteKit, FastAPI, Tailwind CSS (inferred from existing frontend) (004-integrate-svelte-kit)
|
|
- N/A (Frontend integration) (004-integrate-svelte-kit)
|
|
- Python 3.9+, Node.js 18+ + FastAPI, SvelteKit, Tailwind CSS, Pydantic (005-fix-ui-ws-validation)
|
|
- N/A (Configuration based) (005-fix-ui-ws-validation)
|
|
- Filesystem (plugins, logs, backups), SQLite (optional, for job history if needed) (005-fix-ui-ws-validation)
|
|
- Python 3.9+ (Backend), Node.js 18+ (Frontend) + FastAPI, SvelteKit, Tailwind CSS (007-migration-dashboard-grid)
|
|
- N/A (Superset API integration) (007-migration-dashboard-grid)
|
|
- Python 3.9+ (Backend), Node.js 18+ (Frontend) + FastAPI, SvelteKit, Tailwind CSS, Pydantic, Superset API (007-migration-dashboard-grid)
|
|
- N/A (Superset API integration - read-only for metadata) (007-migration-dashboard-grid)
|
|
- Python 3.9+ (backend), Node.js 18+ (frontend) + FastAPI, SvelteKit, Tailwind CSS, Pydantic, SQLAlchemy, Superset API (008-migration-ui-improvements)
|
|
- SQLite (optional for job history), existing database for mappings (008-migration-ui-improvements)
|
|
- Python 3.9+, Node.js 18+ + FastAPI, SvelteKit, Tailwind CSS, Pydantic, SQLAlchemy, Superset API (008-migration-ui-improvements)
|
|
- Python 3.9+, Node.js 18+ + FastAPI, APScheduler, SQLAlchemy, SvelteKit, Tailwind CSS (009-backup-scheduler)
|
|
- SQLite (`tasks.db`), JSON (`config.json`) (009-backup-scheduler)
|
|
- Python 3.9+ (Backend), Node.js 18+ (Frontend) + FastAPI, SvelteKit, Tailwind CSS, Pydantic, SQLAlchemy, `superset_tool` (internal lib) (010-refactor-cli-to-web)
|
|
- SQLite (for job history/results, connection configs), Filesystem (for temporary file uploads) (010-refactor-cli-to-web)
|
|
- Python 3.9+ + FastAPI, Pydantic, requests, pyyaml (migrated from superset_tool) (012-remove-superset-tool)
|
|
- SQLite (tasks.db, migrations.db), Filesystem (012-remove-superset-tool)
|
|
- Filesystem (local git repo), SQLite (for GitServerConfig, Environment) (011-git-integration-dashboard)
|
|
- Python 3.9+ (Backend), Node.js 18+ (Frontend) + FastAPI, SvelteKit, GitPython (or CLI git), Pydantic, SQLAlchemy, Superset API (011-git-integration-dashboard)
|
|
- SQLite (for config/history), Filesystem (local Git repositories) (011-git-integration-dashboard)
|
|
|
|
- Python 3.9+ (Backend), Node.js 18+ (Frontend Build) (001-plugin-arch-svelte-ui)
|
|
|
|
## Project Structure
|
|
|
|
```text
|
|
backend/
|
|
frontend/
|
|
tests/
|
|
```
|
|
|
|
## Commands
|
|
|
|
cd src; pytest; ruff check .
|
|
|
|
## Code Style
|
|
|
|
Python 3.9+ (Backend), Node.js 18+ (Frontend Build): Follow standard conventions
|
|
|
|
## Recent Changes
|
|
- 011-git-integration-dashboard: Added Python 3.9+ (Backend), Node.js 18+ (Frontend) + FastAPI, SvelteKit, GitPython (or CLI git), Pydantic, SQLAlchemy, Superset API
|
|
- 011-git-integration-dashboard: Added Python 3.9+, Node.js 18+
|
|
- 012-remove-superset-tool: Added Python 3.9+ + FastAPI, Pydantic, requests, pyyaml (migrated from superset_tool)
|
|
|
|
|
|
<!-- MANUAL ADDITIONS START -->
|
|
<!-- MANUAL ADDITIONS END -->
|