Add document converter, seeder data structure, and project wiki
- ai-service/convert.py: converts Office/PDF files to markdown with frontmatter - database/seeders/data/: folder structure for themas, projects, documents, etc. - database/seeders/data/raw/: drop zone for Office/PDF files to convert - wiki/: project architecture, concepts, and knowledge graph documentation - Remove unused Laravel example tests Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
znetsixe
95
README.md
95
README.md
@@ -1,58 +1,71 @@
|
||||
<p align="center"><a href="https://laravel.com" target="_blank"><img src="https://raw.githubusercontent.com/laravel/art/master/logo-lockup/5%20SVG/2%20CMYK/1%20Full%20Color/laravel-logolockup-cmyk-red.svg" width="400" alt="Laravel Logo"></a></p>
|
||||
# Innovatieplatform
|
||||
|
||||
<p align="center">
|
||||
<a href="https://github.com/laravel/framework/actions"><img src="https://github.com/laravel/framework/workflows/tests/badge.svg" alt="Build Status"></a>
|
||||
<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/dt/laravel/framework" alt="Total Downloads"></a>
|
||||
<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/v/laravel/framework" alt="Latest Stable Version"></a>
|
||||
<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/l/laravel/framework" alt="License"></a>
|
||||
</p>
|
||||
Innovation governance platform for the R&D Lab at Waterschap Brabantse Delta. Supports the full lifecycle of innovation trajectories — from signal to handover — with AI-powered search, summarization, and project assistance.
|
||||
|
||||
## About Laravel
|
||||
## Tech Stack
|
||||
|
||||
Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as:
|
||||
- **Backend:** Laravel 13 (PHP 8.3+) — service-oriented, event-driven, API-first
|
||||
- **Frontend:** Vue 3 + Inertia.js + Vite 8 + Tailwind CSS 4.2
|
||||
- **Visualization:** D3.js 7.9 (zoomable metro map)
|
||||
- **Database:** PostgreSQL 16 + pgvector
|
||||
- **AI Service:** Python FastAPI + LangGraph + RAG
|
||||
- **Infrastructure:** Docker Compose (nginx, php-fpm, worker, scheduler, ai-service, postgresql, redis)
|
||||
|
||||
- [Simple, fast routing engine](https://laravel.com/docs/routing).
|
||||
- [Powerful dependency injection container](https://laravel.com/docs/container).
|
||||
- Multiple back-ends for [session](https://laravel.com/docs/session) and [cache](https://laravel.com/docs/cache) storage.
|
||||
- Expressive, intuitive [database ORM](https://laravel.com/docs/eloquent).
|
||||
- Database agnostic [schema migrations](https://laravel.com/docs/migrations).
|
||||
- [Robust background job processing](https://laravel.com/docs/queues).
|
||||
- [Real-time event broadcasting](https://laravel.com/docs/broadcasting).
|
||||
|
||||
Laravel is accessible, powerful, and provides tools required for large, robust applications.
|
||||
|
||||
## Learning Laravel
|
||||
|
||||
Laravel has the most extensive and thorough [documentation](https://laravel.com/docs) and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework.
|
||||
|
||||
In addition, [Laracasts](https://laracasts.com) contains thousands of video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library.
|
||||
|
||||
You can also watch bite-sized lessons with real-world projects on [Laravel Learn](https://laravel.com/learn), where you will be guided through building a Laravel application from scratch while learning PHP fundamentals.
|
||||
|
||||
## Agentic Development
|
||||
|
||||
Laravel's predictable structure and conventions make it ideal for AI coding agents like Claude Code, Cursor, and GitHub Copilot. Install [Laravel Boost](https://laravel.com/docs/ai) to supercharge your AI workflow:
|
||||
## Quick Start
|
||||
|
||||
```bash
|
||||
composer require laravel/boost --dev
|
||||
# Clone and setup
|
||||
git clone https://gitea.wbd-rd.nl/vps1_gitea_admin/innovatieplatform.git
|
||||
cd innovatieplatform
|
||||
composer setup
|
||||
|
||||
php artisan boost:install
|
||||
# Development (starts Laravel server, queue worker, logs, and Vite)
|
||||
composer dev
|
||||
```
|
||||
|
||||
Boost provides your agent 15+ tools and skills that help agents build Laravel applications while following best practices.
|
||||
### Docker
|
||||
|
||||
## Contributing
|
||||
```bash
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the [Laravel documentation](https://laravel.com/docs/contributions).
|
||||
Services: nginx (:80), postgresql (:5432), redis (:6379), ai-service (:8000)
|
||||
|
||||
## Code of Conduct
|
||||
## Project Structure
|
||||
|
||||
In order to ensure that the Laravel community is welcoming to all, please review and abide by the [Code of Conduct](https://laravel.com/docs/contributions#code-of-conduct).
|
||||
```
|
||||
app/
|
||||
Models/ 21 Eloquent models (Project, Fase, Commitment, Document, ...)
|
||||
Enums/ 14 status/type enums (ProjectStatus, FaseType, ...)
|
||||
Services/ Business logic (ProjectService, MapDataService, ThemaService)
|
||||
Http/Controllers/ API + Inertia controllers
|
||||
resources/js/
|
||||
Pages/ Inertia page components (MetroMap, Auth, Dashboard)
|
||||
Components/ Vue components (MetroCanvas, CliBar, NodePreview, Breadcrumb)
|
||||
Layouts/ App layout wrapper
|
||||
ai-service/ Python FastAPI AI service
|
||||
wiki/ Project knowledge base (wiki-template schema)
|
||||
docker/ Docker configs (php, nginx, scheduler)
|
||||
.claude/agents/ 10 Claude Code agent definitions
|
||||
```
|
||||
|
||||
## Security Vulnerabilities
|
||||
## Documentation
|
||||
|
||||
If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [taylor@laravel.com](mailto:taylor@laravel.com). All security vulnerabilities will be promptly addressed.
|
||||
- **CLAUDE.md** — Architecture principles, build agents, MVP scope
|
||||
- **STYLE_GUIDE.md** — Metro map UI + retro-futurism design system
|
||||
- **wiki/** — Knowledge base with structured data, architecture docs, and query tools
|
||||
|
||||
## License
|
||||
## Wiki
|
||||
|
||||
The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).
|
||||
```bash
|
||||
python wiki/tools/query.py health # Project health overview
|
||||
python wiki/tools/query.py entity "project" # Everything about an entity
|
||||
bash wiki/tools/search.sh "keyword" # Full-text search
|
||||
bash wiki/tools/lint.sh # Check wiki health
|
||||
```
|
||||
|
||||
## Tests
|
||||
|
||||
```bash
|
||||
composer test
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user