feat: add CLAUDE and HACKABILITY documentation, enhance project management UI

Author: ludusrusso

CLAUDE.md

@@ -0,0 +1,87 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Development Commands
+
+- `npm run dev` - Start development server on localhost:3000
+- `npm run build` - Build for production (uses SKIP_ENV_VALIDATION=1)
+- `npm run lint` - Run ESLint
+- `npm run start` - Start production server
+- `npx prisma studio` - Open Prisma database browser
+- `npx prisma generate` - Generate Prisma client (runs automatically after npm install)
+- `npx prisma db seed` - Seed database with initial data
+
+## Project Architecture
+
+**Space Hackability** is a T3 Stack application for managing and showcasing accessibility-focused projects from the Hackability community.
+
+### Tech Stack
+- **Next.js 13.1.6** with hybrid App Router + Pages Router
+- **tRPC 10.9.1** for type-safe API communication
+- **Prisma 4.9.0** with PostgreSQL for data persistence
+- **NextAuth.js 4.19.2** for Google OAuth authentication
+- **Tailwind CSS + DaisyUI** for styling
+- **Editor.js 2.26.5** for rich content editing
+
+### Key Architecture Patterns
+
+**Hybrid Routing**: The app uses both App Router (`/src/app/`) for admin dashboard and Pages Router (`/src/pages/`) for public pages like the homepage.
+
+**Role-Based Access**: Three user levels:
+- Public users (view published projects)
+- Authors (`isAuthor: true` - create/edit own projects)  
+- Admins (`isAdmin: true` - full system access)
+
+**Rich Content System**: Projects use Editor.js for structured content with multiple block types (headers, paragraphs, code, images, tables, etc.). Content is stored as JSON in the `body` field.
+
+### Database Schema
+
+Core models:
+- **User**: Authentication + role flags (`isAdmin`, `isAuthor`)
+- **Project**: Main content model with rich Editor.js `body` (JSON), structured fields (`what`, `why`, `how`), `buildSteps` (JSON array), and media management
+- Standard NextAuth models (Account, Session, VerificationToken)
+
+### tRPC API Structure
+
+Located in `/src/server/api/routers/`:
+- `/auth` - Authentication management
+- `/project` - Core project operations, file uploads (Cloudinary/Google Cloud)
+- `/author` - Author-specific operations (`getMyProjects`, `createProject`)
+- `/admin` - Admin operations (`getAllProjects`, `setDraft`, `deleteProject`, role management)
+- `/files` - File management utilities
+
+**Security**: Procedures use `protectedProcedure`, `authorProcedure`, and `adminProcedure` middleware for access control.
+
+### File Organization
+
+- `/src/projects/` - Project-specific components and forms
+- `/src/ui/` - Reusable UI components (Editor, Logo, Nav, Footer)
+- `/src/projects/forms/` - Form components with Zod validation and React Final Form
+- `/src/app/dashboard/` - Admin interface using App Router
+- `/src/pages/` - Public pages (homepage, project views)
+
+### Media Management
+
+**Images**: Cloudinary integration with `generateCloudinaryUploadSignature` for direct uploads
+**Files**: Google Cloud Storage with `generategsUploadUrl` for document uploads
+**Fallback**: Uses `/hackability.png` for missing project preview images
+
+### Form System
+
+Uses React Final Form with Zod validation:
+- `ZodForm` wrapper component handles schema validation
+- Custom field components (`TextField`, `SelectPicker`) in `/src/projects/forms/`
+- Editor.js integration for rich content fields
+
+### Development Notes
+
+**Environment**: Extensive environment validation using Zod schemas - check `.env.example` for required variables.
+
+**TypeScript**: Strict TypeScript configuration with full end-to-end type safety via tRPC.
+
+**Styling**: Tailwind CSS with DaisyUI component library. The project uses Italian language throughout the UI.
+
+**Build**: Production builds skip environment validation (`SKIP_ENV_VALIDATION=1`) - ensure all environment variables are properly set in production.
+
+**Docker Support**: Multi-stage Dockerfile available for containerized deployment.

HACKABILITY.md

@@ -0,0 +1,105 @@
+# HACKABILITY.md
+
+This file provides context about Hackability, the Italian non-profit organization behind this project platform.
+
+## About Hackability
+
+**Hackability** is a pioneering Italian non-profit organization founded in Turin in 2016, after three years of informal activity. The association is dedicated to developing innovative accessibility solutions through collaborative design and digital fabrication technologies.
+
+## Mission and Vision
+
+Hackability's core mission is to bring together the skills of designers, makers, and digital artisans with the needs and creativity of people with disabilities and elderly individuals. Their goal is to co-create personalized solutions that enhance daily autonomy and promote social inclusion.
+
+### Key Principles
+- **Co-design (Co-progettazione)**: Active involvement of users in the entire design and development process
+- **Social Impact**: Creating durable solutions that provide long-term benefits
+- **Scalability**: Developing solutions that can be reproduced and scaled economically
+- **Digital Fabrication**: Using 3D printing, maker spaces, and digital technologies as tools for inclusive innovation
+- **Community Building**: Growing territorial communities around accessibility and inclusion
+
+## The Hackability Methodology
+
+Hackability has developed a distinctive "Hackability Thinking" methodology that:
+
+- Identifies and addresses emerging social, cultural, economic, and technological needs related to accessibility
+- Recognizes that people with disabilities often create custom solutions themselves or with caregivers
+- Systematically involves people with and without disabilities in cooperative design and fabrication
+- Uses digital fabrication technologies to create custom assistive solutions
+- Empowers disability communities to independently use digital technologies
+
+## Impact and Achievements
+
+### Quantitative Impact
+- **400+ accessibility solutions** co-designed over ten years of activity
+- **~1,000 solutions** distributed annually to people with disabilities, seniors, and caregivers
+- **150+ completed projects** involving approximately 900 people
+- **400+ orthoses** co-designed and delivered to users in Turin's Spinal Unit in 12 months
+
+### Recognition and Awards
+- **European Social Innovation Competition** winner (2017)
+- **Compasso d'Oro ADI** design award - honorable mention (2020)
+- **XXVI Compasso d'Oro ADI** design award recognition
+
+## Infrastructure and Operations
+
+### Maker Spaces and Labs
+- **InclusiveLab** - Main facility in Turin
+- **Tech4Care makerspaces** - Network across spinal units in Piedmont region
+- **Territorial production laboratories** - Distributed approach to accessibility solutions
+
+### Collaborations
+- **Universities**: Including University of Turin (Idem project: Inclusive Design Empowerment Mountain)
+- **Corporations**: Partnerships with Barilla, Juventus FC, Toyota
+- **Healthcare**: Integration with spinal units and rehabilitation centers
+- **Disability Organizations**: Including Lega del Filo d'Oro (main Italian deaf-blind association)
+
+## Example Projects and Solutions
+
+### PARLOMA Project
+A groundbreaking communication system for deaf-blind individuals featuring:
+- Low-cost depth sensor as input device
+- Anthropomorphic robotic hand as output device
+- Hand-shape recognition and remote transmission
+- Functions as a "telephone" for deaf-blind people
+
+### Orthoses and Assistive Devices
+- Custom 3D-printed orthoses co-designed by therapists and patients
+- Personalized home automation solutions
+- Custom aids and adaptive equipment
+- Low-cost scalable assistive technologies
+
+## Current Focus Areas
+
+### Active Projects
+- **Tech4Care #Silver**: Co-design marathons involving 60+ participants (makers, designers, businesses, end users)
+- **Idem: Inclusive Design Empowerment Mountain**: Collaboration with University of Turin
+- **Ongoing research**: Supported by Italian Ministry of Research and University through various programs
+
+### Target Communities
+- People with physical disabilities
+- Elderly individuals and their caregivers
+- Healthcare professionals and therapists
+- Designers and makers interested in social impact
+- Organizations seeking inclusive design solutions
+
+## Philosophy and Approach
+
+Hackability represents a paradigm shift from traditional assistive technology development by:
+
+1. **User-Centered Design**: People with disabilities are not just end users but active co-designers
+2. **Community Empowerment**: Building local capacity for ongoing solution development
+3. **Open Innovation**: Sharing methodologies and solutions for broader impact
+4. **Technology Democratization**: Making digital fabrication accessible to disability communities
+5. **Sustainable Impact**: Creating solutions that are economically viable and scalable
+
+## Connection to This Platform
+
+This Space Hackability platform serves as the digital documentation and collaboration hub for Hackability's methodology and projects. It enables:
+
+- **Documentation**: Comprehensive project documentation using structured formats
+- **Knowledge Sharing**: Open source and Creative Commons licensing for broader impact
+- **Community Building**: Platform for collaboration between designers, makers, and users
+- **Methodology Dissemination**: Sharing the Hackability approach with global communities
+- **Project Showcase**: Highlighting successful accessibility solutions and their impact
+
+The platform embodies Hackability's commitment to open innovation, collaborative design, and the democratization of accessible technology development.