vibe-coded/webref
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

phase 5

Browse Source
This commit is contained in:
Danilo Reyes
2025-11-02 01:47:25 -06:00
parent 48020b6f42
commit 010df31455
45 changed files with 8045 additions and 720 deletions
Download Patch File Download Diff File Expand all files Collapse all files

528
flake.nix
View File

@@ -3,254 +3,320 @@
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
flake-utils.url = "github:numtide/flake-utils";
nixos-generators = {
url = "github:nix-community/nixos-generators";
inputs.nixpkgs.follows = "nixpkgs";
};
};
outputs =
{ self, nixpkgs, flake-utils }:
flake-utils.lib.eachDefaultSystem (
system:
let
pkgs = nixpkgs.legacyPackages.${system};
{
self,
nixpkgs,
nixos-generators,
}:
let
system = "x86_64-linux";
pkgs = nixpkgs.legacyPackages.${system};
pythonEnv = pkgs.python3.withPackages (
ps: with ps; [
# Core backend dependencies
fastapi
uvicorn
sqlalchemy
alembic
pydantic
pydantic-settings # Settings management
psycopg2 # PostgreSQL driver
# Auth & Security
python-jose
passlib
bcrypt # Password hashing backend for passlib
email-validator # Email validation for pydantic
# Image processing
pillow
# Storage
boto3
# HTTP & uploads
httpx
python-multipart
# Testing
pytest
pytest-cov
pytest-asyncio
]
# Shared Python dependencies - used by both dev environment and package
pythonDeps =
ps: withTests:
with ps;
[
# Core backend dependencies
fastapi
uvicorn
sqlalchemy
alembic
pydantic
pydantic-settings # Settings management
psycopg2 # PostgreSQL driver
# Auth & Security
python-jose
passlib
bcrypt # Password hashing backend for passlib
email-validator # Email validation for pydantic
# Image processing
pillow
python-magic # File type detection via magic bytes
# Storage
boto3
# HTTP & uploads
httpx
python-multipart
]
++ (
if withTests then
[
# Testing (dev only)
pytest
pytest-cov
pytest-asyncio
]
else
[ ]
);
in
{
devShells.default = pkgs.mkShell {
buildInputs = with pkgs; [
# Python environment
pythonEnv
uv
ruff
# Database
postgresql
pythonEnv = pkgs.python3.withPackages (ps: pythonDeps ps true);
in
{
# Development shell
devShells.${system}.default = pkgs.mkShell {
buildInputs = with pkgs; [
# Python environment
pythonEnv
uv
ruff
# Frontend
nodejs
nodePackages.npm
# Database
postgresql
# Image processing
imagemagick
# Frontend
nodejs
nodePackages.npm
eslint
# Storage
minio
minio-client
# Image processing
imagemagick
file # Required for python-magic to detect file types
# Development tools
git
direnv
# Storage
minio
minio-client
# Optional: monitoring/debugging
# redis
# Development tools
git
direnv
];
shellHook = ''
echo "🚀 Reference Board Viewer Development Environment"
echo ""
echo "📦 Versions:"
echo " Python: $(python --version)"
echo " Node.js: $(node --version)"
echo " PostgreSQL: $(psql --version | head -n1)"
echo " MinIO: $(minio --version | head -n1)"
echo ""
echo "🔧 Development Services:"
echo " Start: ./scripts/dev-services.sh start"
echo " Stop: ./scripts/dev-services.sh stop"
echo " Status: ./scripts/dev-services.sh status"
echo ""
echo "📚 Quick Commands:"
echo " Backend: cd backend && uvicorn app.main:app --reload"
echo " Frontend: cd frontend && npm run dev"
echo " Database: psql -h localhost -U webref webref"
echo " Tests: cd backend && pytest --cov"
echo ""
echo "📖 Documentation:"
echo " API Docs: http://localhost:8000/docs"
echo " App: http://localhost:5173"
echo " MinIO UI: http://localhost:9001"
echo ""
# Set up environment variables
export DATABASE_URL="postgresql://webref@localhost:5432/webref"
export MINIO_ENDPOINT="localhost:9000"
export MINIO_ACCESS_KEY="minioadmin"
export MINIO_SECRET_KEY="minioadmin"
export PYTHONPATH="$PWD/backend:$PYTHONPATH"
'';
};
# Apps - Scripts that can be run with `nix run`
apps.${system} = {
default = {
type = "app";
program = "${pkgs.writeShellScript "help" ''
echo "Available commands:"
echo " nix run .#lint - Run all linting checks"
echo " nix run .#lint-backend - Run backend linting only"
echo " nix run .#lint-frontend - Run frontend linting only"
echo " nix run .#lint-fix - Auto-fix linting issues"
''}";
};
# Unified linting - calls both backend and frontend lints
lint = {
type = "app";
program = "${pkgs.writeShellScript "lint" ''
set -e
# Run backend linting
${self.apps.${system}.lint-backend.program}
echo ""
# Run frontend linting
${self.apps.${system}.lint-frontend.program}
echo ""
echo "✅ All linting checks passed!"
''}";
};
# Auto-fix linting issues
lint-fix = {
type = "app";
program = "${pkgs.writeShellScript "lint-fix" ''
set -e
echo "🔧 Auto-fixing backend Python code..."
if [ -d "backend" ]; then
cd backend
${pkgs.ruff}/bin/ruff check --fix --no-cache app/ || true
${pkgs.ruff}/bin/ruff format app/
cd ..
else
echo "⚠ Not in project root (backend/ not found)"
exit 1
fi
if [ -d "frontend/node_modules" ]; then
echo ""
echo "🔧 Auto-fixing frontend code..."
cd frontend
${pkgs.nodePackages.prettier}/bin/prettier --write src/
cd ..
fi
echo ""
echo "✅ Auto-fix complete!"
''}";
};
# Backend linting only
lint-backend = {
type = "app";
program = "${pkgs.writeShellScript "lint-backend" ''
set -e
echo "🔍 Linting backend Python code..."
if [ -d "backend" ]; then
cd backend
${pkgs.ruff}/bin/ruff check --no-cache app/
${pkgs.ruff}/bin/ruff format --check app/
cd ..
else
echo "⚠ Not in project root (backend/ not found)"
exit 1
fi
echo "✅ Backend linting passed!"
''}";
};
# Frontend linting only
lint-frontend = {
type = "app";
program = "${pkgs.writeShellScript "lint-frontend" ''
set -e
# Add nodejs to PATH for npm scripts
export PATH="${pkgs.nodejs}/bin:$PATH"
echo "🔍 Linting frontend TypeScript/Svelte code..."
if [ -d "frontend/node_modules" ]; then
cd frontend
npm run lint
${pkgs.nodePackages.prettier}/bin/prettier --check src/
npm run check
cd ..
else
echo "⚠ Frontend node_modules not found"
echo "Run 'cd frontend && npm install' first"
exit 1
fi
echo "✅ Frontend linting passed!"
''}";
};
# Run development VM
dev-vm = {
type = "app";
program = "${self.packages.${system}.dev-vm}/bin/run-nixos-vm";
};
};
# Package definitions (for production deployment)
packages.${system} = {
# Backend package
backend = pkgs.python3Packages.buildPythonApplication {
pname = "webref-backend";
version = "1.0.0";
pyproject = true;
src = ./backend;
build-system = with pkgs.python3Packages; [
setuptools
];
shellHook = ''
echo "🚀 Reference Board Viewer Development Environment"
echo ""
echo "📦 Versions:"
echo " Python: $(python --version)"
echo " Node.js: $(node --version)"
echo " PostgreSQL: $(psql --version | head -n1)"
echo " MinIO: $(minio --version | head -n1)"
echo ""
echo "📚 Quick Commands:"
echo " Backend: cd backend && uvicorn app.main:app --reload"
echo " Frontend: cd frontend && npm run dev"
echo " Database: psql webref"
echo " Tests: cd backend && pytest --cov"
echo " MinIO: minio server ~/minio-data --console-address :9001"
echo ""
echo "📖 Documentation:"
echo " API Docs: http://localhost:8000/docs"
echo " App: http://localhost:5173"
echo " MinIO UI: http://localhost:9001"
echo ""
propagatedBuildInputs = pythonDeps pkgs.python3Packages false;
# Set up environment variables
export DATABASE_URL="postgresql://localhost/webref"
export PYTHONPATH="$PWD/backend:$PYTHONPATH"
'';
};
# Apps - Scripts that can be run with `nix run`
apps = {
default = {
type = "app";
program = "${pkgs.writeShellScript "help" ''
echo "Available commands:"
echo " nix run .#lint - Run linting checks"
echo " nix run .#lint-fix - Auto-fix linting issues"
''}";
meta = {
description = "Show available commands";
};
};
# Unified linting for all code
lint = {
type = "app";
program = "${pkgs.writeShellScript "lint" ''
set -e
# Backend Python linting
echo "🔍 Linting backend Python code..."
if [ -d "backend" ]; then
cd backend
${pkgs.ruff}/bin/ruff check --no-cache app/
${pkgs.ruff}/bin/ruff format --check app/
cd ..
else
echo "⚠ Not in project root (backend/ not found)"
exit 1
fi
# Frontend linting (if node_modules exists)
if [ -d "frontend/node_modules" ]; then
echo ""
echo "🔍 Linting frontend TypeScript/Svelte code..."
cd frontend
npm run lint
${pkgs.nodePackages.prettier}/bin/prettier --check src/
npm run check
cd ..
else
echo "⚠ Frontend node_modules not found, run 'npm install' first"
fi
echo ""
echo "✅ All linting checks passed!"
''}";
meta = {
description = "Run linting checks on backend and frontend code";
};
};
# Auto-fix linting issues
lint-fix = {
type = "app";
program = "${pkgs.writeShellScript "lint-fix" ''
set -e
echo "🔧 Auto-fixing backend Python code..."
if [ -d "backend" ]; then
cd backend
${pkgs.ruff}/bin/ruff check --fix --no-cache app/ || true
${pkgs.ruff}/bin/ruff format app/
cd ..
else
echo "⚠ Not in project root (backend/ not found)"
exit 1
fi
if [ -d "frontend/node_modules" ]; then
echo ""
echo "🔧 Auto-fixing frontend code..."
cd frontend
${pkgs.nodePackages.prettier}/bin/prettier --write src/
cd ..
fi
echo ""
echo "✅ Auto-fix complete!"
''}";
meta = {
description = "Auto-fix linting issues in backend and frontend code";
};
meta = {
description = "Reference Board Viewer - Backend API";
homepage = "https://github.com/yourusername/webref";
license = pkgs.lib.licenses.mit;
};
};
# Package definitions (for production deployment)
packages = rec {
# Backend package
backend = pkgs.python3Packages.buildPythonApplication {
pname = "webref-backend";
version = "1.0.0";
pyproject = true;
src = ./backend;
build-system = with pkgs.python3Packages; [
setuptools
];
propagatedBuildInputs = with pkgs.python3Packages; [
fastapi
uvicorn
sqlalchemy
alembic
pydantic
pydantic-settings
psycopg2
python-jose
passlib
pillow
boto3
httpx
python-multipart
email-validator
bcrypt
];
meta = {
description = "Reference Board Viewer - Backend API";
homepage = "https://github.com/yourusername/webref";
license = pkgs.lib.licenses.mit;
};
};
# Frontend package (disabled until dependencies are installed)
# To enable: run 'npm install' in frontend/, then uncomment this
# frontend = pkgs.buildNpmPackage {
# pname = "webref-frontend";
# version = "1.0.0";
# src = ./frontend;
# npmDepsHash = "sha256-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="; # Update after first build
# buildPhase = ''
# npm run build
# '';
# installPhase = ''
# mkdir -p $out
# cp -r build/* $out/
# '';
# meta = {
# description = "Reference Board Viewer - Frontend SPA";
# homepage = "https://github.com/yourusername/webref";
# license = pkgs.lib.licenses.mit;
# };
# };
default = backend;
# QEMU VM for development services
dev-vm = nixos-generators.nixosGenerate {
system = "x86_64-linux";
modules = [ ./nixos/dev-services.nix ];
format = "vm";
};
# NixOS VM tests
checks = import ./nixos/tests.nix { inherit pkgs; };
}
);
# VM for CI testing
ci-vm = nixos-generators.nixosGenerate {
system = "x86_64-linux";
modules = [
./nixos/dev-services.nix
{
# CI-specific configuration
services.openssh.enable = true;
services.openssh.settings.PermitRootLogin = "yes";
users.users.root.password = "test";
}
];
format = "vm";
};
# Container for lightweight testing
dev-container = nixos-generators.nixosGenerate {
system = "x86_64-linux";
modules = [ ./nixos/dev-services.nix ];
format = "lxc";
};
default = self.packages.${system}.backend;
};
# NixOS VM tests
checks.${system} = import ./nixos/tests.nix { inherit pkgs; };
# NixOS configurations
nixosConfigurations = {
# Development services VM
dev-services = nixpkgs.lib.nixosSystem {
system = "x86_64-linux";
modules = [
./nixos/dev-services.nix
{
# Minimal system configuration
fileSystems."/" = {
device = "tmpfs";
fsType = "tmpfs";
options = [ "mode=0755" ];
};
boot.loader.systemd-boot.enable = true;
system.stateVersion = "24.05";
}
];
};
};
};
}