src/
├── app/                    # Next.js app router pages
│   ├── admin/             # Admin dashboard and user management
│   ├── api/               # API routes
│   │   ├── admin/         # Admin-related endpoints (e.g., user management)
│   │   ├── all-project-tasks/ # Get all project tasks endpoint
│   │   ├── audit-logs/    # Audit log endpoints
│   │   ├── auth/          # Authentication endpoints
│   │   ├── contracts/     # Contract management endpoints
│   │   ├── notes/         # Notes management endpoints
│   │   ├── projects/      # Project management endpoints
│   │   ├── project-tasks/ # Task management endpoints
│   │   ├── task-notes/    # Task-specific notes endpoints
│   │   └── tasks/         # Task template endpoints
│   ├── auth/              # Authentication pages (login, etc.)
│   ├── contracts/         # Contract pages
│   ├── projects/          # Project pages
│   ├── project-tasks/     # Project-specific task pages
│   └── tasks/             # Task management pages
├── components/            # Reusable React components
│   ├── auth/              # Authentication-related components
│   ├── ui/                # UI components (Button, Card, etc.)
│   ├── AuditLogViewer.js  # Component to view audit logs
│   ├── ContractForm.js    # Contract form component
│   ├── NoteForm.js        # Note form component
│   ├── ProjectForm.js     # Project form component
│   ├── ProjectTaskForm.js # Project task form component
│   ├── ProjectTasksSection.js # Project tasks section component
│   ├── TaskForm.js        # Task form component
│   └── TaskTemplateForm.js # Task template form component
├── lib/                  # Utility functions
│   ├── queries/          # Database query functions
│   ├── auditLog.js       # Audit logging utilities
│   ├── auth.js           # Authentication helpers
│   ├── db.js             # Database connection
│   ├── init-db.js        # Database initialization
│   └── userManagement.js # User management functions
└── middleware.js         # Next.js middleware for auth and routing

Available Scripts

npm run dev - Start development server
npm run build - Build for production
npm run start - Start production server
npm run lint - Run ESLint

Docker Commands

docker-compose up - Start the application with Docker
docker-compose down - Stop the Docker containers
docker-compose up --build - Rebuild and start the application

Database Schema

The application uses the following main tables:

contracts - Contract information
projects - Project details linked to contracts
tasks - Task templates
project_tasks - Tasks assigned to specific projects
notes - Project notes and updates
users - User accounts and roles for authentication
sessions - User session management
audit_logs - Detailed logs for security and tracking

API Endpoints

Projects

GET /api/projects - Get all projects
POST /api/projects - Create new project
GET /api/projects/[id] - Get project by ID
PUT /api/projects/[id] - Update project
DELETE /api/projects/[id] - Delete project

Contracts

GET /api/contracts - Get all contracts
POST /api/contracts - Create new contract
GET /api/contracts/[id] - Get contract by ID
PUT /api/contracts/[id] - Update contract
DELETE /api/contracts/[id] - Delete contract

Tasks

GET /api/tasks - Get task templates
POST /api/tasks - Create new task template
GET /api/tasks/[id] - Get task template by ID
PUT /api/tasks/[id] - Update task template
DELETE /api/tasks/[id] - Delete task template
GET /api/tasks/templates - Get all task templates

Project Tasks

GET /api/project-tasks - Get project tasks or task templates
POST /api/project-tasks - Create new project task
PATCH /api/project-tasks/[id] - Update task status
DELETE /api/project-tasks/[id] - Delete task
GET /api/all-project-tasks - Get all project tasks across all projects

Notes

POST /api/notes - Create new note
DELETE /api/notes - Delete note

Audit Logs

GET /api/audit-logs - Get all audit logs
POST /api/audit-logs/log - Create a new audit log entry
GET /api/audit-logs/stats - Get audit log statistics

Admin

GET /api/admin/users - Get all users
POST /api/admin/users - Create a new user
PUT /api/admin/users/[id] - Update a user
DELETE /api/admin/users/[id] - Delete a user

Advanced Map Features

This project includes a powerful map system for project locations, supporting multiple dynamic base layers:

OpenStreetMap (default street map)
Polish Geoportal Orthophoto (aerial imagery via WMTS)
Polish Land Records (WMS cadastral data)
Satellite (Esri) and Topographic layers

Users can switch layers using the map control (📚 icon). WMTS/WMS layers are configured dynamically using OGC GetCapabilities, making it easy to add new sources. See docs/MAP_LAYERS.md for details on adding and configuring map layers.

UI/UX

Modern, responsive interface built with React 19 and Tailwind CSS
Intuitive dashboards, search, and filter components
Modular, reusable UI components for forms, lists, and maps

Extensibility & Testing

Modular codebase: easily add new features, endpoints, or UI components
Automated tests: Playwright for E2E, Jest and Testing Library for unit/integration
Dockerized for consistent development and deployment

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is private and proprietary.