mag/WMS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Added Documentation

Browse Source
This commit is contained in:
Mark Gregory
2026-06-15 07:54:26 +01:00
parent 91b600a4fe
commit 04f8124e65
34 changed files with 2045 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Documentation/Resources/views/categories/create.blade.php
+18
View File
@@ -0,0 +1,18 @@
@extends('documentation::layouts.master')
@section('title', 'Create Category')
@section('content')
@include('documentation::partials.hero', [
'title' => 'Create category',
'subtitle' => 'Add a professional grouping for documents and operational knowledge.',
])
<section class="doc-card">
<div class="doc-card-header"><strong>Category details</strong></div>
<div class="doc-card-body">
<form method="POST" action="{{ route('documentation.categories.store') }}">
@include('documentation::partials.category-form')
</form>
</div>
</section>
@endsection
Documentation/Resources/views/categories/edit.blade.php
+18
View File
@@ -0,0 +1,18 @@
@extends('documentation::layouts.master')
@section('title', 'Edit Category')
@section('content')
@include('documentation::partials.hero', [
'title' => 'Edit category',
'subtitle' => 'Update category naming, ordering, visibility, and presentation metadata.',
])
<section class="doc-card">
<div class="doc-card-header"><strong>{{ $category->name }}</strong></div>
<div class="doc-card-body">
<form method="POST" action="{{ route('documentation.categories.update', $category) }}">
@include('documentation::partials.category-form')
</form>
</div>
</section>
@endsection
Documentation/Resources/views/categories/index.blade.php
+57
View File
@@ -0,0 +1,57 @@
@extends('documentation::layouts.master')
@section('title', 'Document Categories')
@section('content')
@include('documentation::partials.hero', [
'title' => 'Document categories',
'subtitle' => 'Organise documents by policy, process, onboarding, operational support, or technical area.',
])
@if(session('status'))
<div class="doc-alert">{{ session('status') }}</div>
@endif
<section class="doc-card">
<div class="doc-card-header">
<strong>Categories</strong>
<a class="doc-button dark" href="{{ route('documentation.categories.create') }}">New category</a>
</div>
<div class="doc-card-body">
<table class="doc-table">
<thead>
<tr>
<th>Name</th>
<th>Description</th>
<th>Documents</th>
<th>Order</th>
<th>Status</th>
<th></th>
</tr>
</thead>
<tbody>
@forelse($categories as $category)
<tr>
<td><strong>{{ $category->name }}</strong><div class="doc-muted">{{ $category->slug }}</div></td>
<td>{{ $category->description ?: 'No description' }}</td>
<td>{{ $category->documents_count }}</td>
<td>{{ $category->sort_order }}</td>
<td><span class="doc-badge {{ $category->is_active ? '' : 'archived' }}">{{ $category->is_active ? 'Active' : 'Inactive' }}</span></td>
<td>
<a class="doc-link" href="{{ route('documentation.categories.edit', $category) }}">Edit</a>
<form method="POST" action="{{ route('documentation.categories.destroy', $category) }}" style="display:inline;" onsubmit="return confirm('Delete this category? Documents will become uncategorised.')">
@csrf
@method('DELETE')
<button type="submit" class="doc-link" style="border:0;background:none;cursor:pointer;padding:0;margin-left:10px;">Delete</button>
</form>
</td>
</tr>
@empty
<tr><td colspan="6" class="doc-muted">No categories found.</td></tr>
@endforelse
</tbody>
</table>
<div style="margin-top:18px;">{{ $categories->links() }}</div>
</div>
</section>
@endsection
Documentation/Resources/views/documents/create.blade.php
+18
View File
@@ -0,0 +1,18 @@
@extends('documentation::layouts.master')
@section('title', 'Create Document')
@section('content')
@include('documentation::partials.hero', [
'title' => 'Create document',
'subtitle' => 'Add a controlled document, guide, policy, SOP, upload, or operational note.',
])
<section class="doc-card">
<div class="doc-card-header"><strong>Document details</strong></div>
<div class="doc-card-body">
<form method="POST" action="{{ route('documentation.documents.store') }}" enctype="multipart/form-data">
@include('documentation::partials.document-form')
</form>
</div>
</section>
@endsection
Documentation/Resources/views/documents/edit.blade.php
+25
View File
@@ -0,0 +1,25 @@
@extends('documentation::layouts.master')
@section('title', 'Edit Document')
@section('content')
@include('documentation::partials.hero', [
'title' => 'Edit document',
'subtitle' => 'Maintain document metadata, workflow status, version and attachment details.',
])
<section class="doc-card">
<div class="doc-card-header"><strong>{{ $document->title }}</strong></div>
<div class="doc-card-body">
<form method="POST" action="{{ route('documentation.documents.update', $document) }}" enctype="multipart/form-data">
@include('documentation::partials.document-form')
</form>
</div>
</section>
@foreach($document->attachments as $attachment)
<form id="delete-attachment-{{ $attachment->id }}" method="POST" action="{{ route('documentation.documents.attachments.destroy', [$document, $attachment]) }}" onsubmit="return confirm('Remove this attachment?')">
@csrf
@method('DELETE')
</form>
@endforeach
@endsection
Documentation/Resources/views/documents/index.blade.php
+92
View File
@@ -0,0 +1,92 @@
@extends('documentation::layouts.master')
@section('title', 'Documentation')
@section('content')
@include('documentation::partials.hero', [
'title' => 'Documentation Centre',
'subtitle' => 'Create, control, publish, and archive operational documents from a clean professional register.',
])
@if(session('status'))
<div class="doc-alert">{{ session('status') }}</div>
@endif
<section class="doc-grid stats">
<article class="doc-card doc-stat"><strong>{{ $stats['total'] }}</strong><span>Total documents</span></article>
<article class="doc-card doc-stat"><strong>{{ $stats['published'] }}</strong><span>Published</span></article>
<article class="doc-card doc-stat"><strong>{{ $stats['drafts'] }}</strong><span>Drafts</span></article>
<article class="doc-card doc-stat"><strong>{{ $stats['categories'] }}</strong><span>Categories</span></article>
</section>
@if($featuredDocuments->isNotEmpty())
<section class="doc-card" style="margin-bottom:18px;">
<div class="doc-card-header"><strong>Featured documents</strong></div>
<div class="doc-card-body doc-grid" style="grid-template-columns:repeat(auto-fit,minmax(220px,1fr));">
@foreach($featuredDocuments as $featured)
<a class="doc-card doc-card-body" style="text-decoration:none;color:inherit;box-shadow:none;" href="{{ route('documentation.documents.show', $featured) }}">
<span class="doc-badge {{ $featured->status }}">{{ ucfirst($featured->status) }}</span>
<h3 style="margin:12px 0 6px;">{{ $featured->title }}</h3>
<p class="doc-muted" style="margin:0;">{{ $featured->summary ?: 'No summary provided.' }}</p>
</a>
@endforeach
</div>
</section>
@endif
<section class="doc-card">
<div class="doc-card-header">
<strong>Document register</strong>
<a class="doc-button dark" href="{{ route('documentation.documents.create') }}">New document</a>
</div>
<div class="doc-card-body">
<form class="doc-filter" method="GET" action="{{ route('documentation.documents.index') }}">
<input class="doc-input" name="search" value="{{ request('search') }}" placeholder="Search title, reference, summary or body">
<select class="doc-select" name="status">
<option value="">All statuses</option>
@foreach($statuses as $value => $label)
<option value="{{ $value }}" @selected(request('status') === $value)>{{ $label }}</option>
@endforeach
</select>
<select class="doc-select" name="category">
<option value="">All categories</option>
@foreach($categories as $category)
<option value="{{ $category->id }}" @selected((string) request('category') === (string) $category->id)>{{ $category->name }}</option>
@endforeach
</select>
<button class="doc-button light" type="submit">Filter</button>
</form>
<table class="doc-table">
<thead>
<tr>
<th>Document</th>
<th>Category</th>
<th>Status</th>
<th>Version</th>
<th>Updated</th>
<th></th>
</tr>
</thead>
<tbody>
@forelse($documents as $document)
<tr>
<td>
<a href="{{ route('documentation.documents.show', $document) }}">{{ $document->title }}</a>
<div class="doc-muted">{{ $document->reference ?: 'No reference' }} · {{ $document->summary ?: 'No summary' }}</div>
</td>
<td>{{ $document->category?->name ?: 'Uncategorised' }}</td>
<td><span class="doc-badge {{ $document->status }}">{{ ucfirst($document->status) }}</span></td>
<td>{{ $document->version }}</td>
<td>{{ $document->updated_at?->format('d M Y H:i') }}</td>
<td><a class="doc-link" href="{{ route('documentation.documents.edit', $document) }}">Edit</a></td>
</tr>
@empty
<tr><td colspan="6" class="doc-muted">No documents found.</td></tr>
@endforelse
</tbody>
</table>
<div style="margin-top:18px;">{{ $documents->links() }}</div>
</div>
</section>
@endsection
Documentation/Resources/views/documents/show.blade.php
+53
View File
@@ -0,0 +1,53 @@
@extends('documentation::layouts.master')
@section('title', $document->title)
@section('content')
@include('documentation::partials.hero', [
'title' => $document->title,
'subtitle' => $document->summary ?: 'Controlled documentation record with versioning, attachments and Markdown rendering.',
'actions' => [
['label' => 'Edit document', 'url' => route('documentation.documents.edit', $document), 'class' => 'primary'],
['label' => 'Back to documents', 'url' => route('documentation.documents.index'), 'class' => 'secondary'],
],
])
<section class="doc-card">
<div class="doc-card-header">
<div>
<strong>{{ $document->reference ?: 'Document' }}</strong>
<div class="doc-muted">Version {{ $document->version }} @if($document->category) · {{ $document->category->name }} @endif</div>
</div>
<span class="doc-badge {{ $document->status }}">{{ ucfirst($document->status) }}</span>
</div>
<div class="doc-card-body">
<article class="doc-content">{!! $document->rendered_body !!}</article>
</div>
</section>
@if($document->attachment_name || $document->attachments->isNotEmpty())
<section class="doc-card" style="margin-top: 18px;">
<div class="doc-card-header"><strong>Attachments</strong></div>
<div class="doc-card-body">
<div class="doc-attachment-list">
@if($document->attachment_name)
<div class="doc-attachment-item">
<div>
<a class="doc-link" href="{{ route('documentation.documents.download', $document) }}">{{ $document->attachment_name }}</a>
<span class="doc-muted">Primary file</span>
</div>
</div>
@endif
@foreach($document->attachments as $attachment)
<div class="doc-attachment-item">
<div>
<a class="doc-link" href="{{ route('documentation.documents.attachments.download', [$document, $attachment]) }}">{{ $attachment->original_name }}</a>
<span class="doc-muted">{{ $attachment->size_label }}</span>
</div>
</div>
@endforeach
</div>
</div>
</section>
@endif
@endsection
Documentation/Resources/views/index.blade.php
+1
View File
@@ -0,0 +1 @@
@extends('documentation::documents.index')
Documentation/Resources/views/layouts/master.blade.php
+141
View File
@@ -0,0 +1,141 @@
<!doctype html>
<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>{{ trim($__env->yieldContent('title', 'Documentation')) }} - {{ config('app.name', 'Laravel') }}</title>
<style>
:root {
--doc-ink: #10231f;
--doc-muted: #64748b;
--doc-line: #dbe7e2;
--doc-panel: #ffffff;
--doc-soft: #f5faf8;
--doc-brand: #0f766e;
--doc-brand-dark: #115e59;
--doc-accent: #16a34a;
--doc-danger: #b91c1c;
--doc-warning: #b45309;
--doc-radius: 22px;
--doc-shadow: 0 24px 70px rgba(15, 35, 31, .12);
}
body.documentation-module {
margin: 0;
background: linear-gradient(135deg, #eef8f3 0%, #f8fafc 45%, #ecfdf5 100%);
color: var(--doc-ink);
font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
min-height: 100vh;
}
.doc-shell { max-width: 1240px; margin: 0 auto; padding: 28px 20px 56px; }
.doc-hero {
display: grid; grid-template-columns: 1fr auto; gap: 24px; align-items: center;
padding: 28px; border-radius: 30px; color: #fff;
background: radial-gradient(circle at top left, rgba(255,255,255,.24), transparent 34%), linear-gradient(135deg, #064e3b, #0f766e 52%, #16a34a);
box-shadow: var(--doc-shadow); margin-bottom: 22px;
}
.doc-eyebrow { text-transform: uppercase; font-size: 12px; letter-spacing: .16em; font-weight: 800; opacity: .82; margin: 0 0 10px; }
.doc-hero h1 { margin: 0; font-size: clamp(30px, 5vw, 52px); line-height: .98; letter-spacing: -.04em; }
.doc-hero p { max-width: 720px; margin: 14px 0 0; color: rgba(255,255,255,.84); font-size: 16px; line-height: 1.65; }
.doc-actions { display: flex; flex-wrap: wrap; gap: 10px; margin-top: 20px; }
.doc-button {
border: 1px solid transparent; border-radius: 999px; padding: 11px 16px; font-weight: 800; font-size: 14px;
text-decoration: none; display: inline-flex; align-items: center; gap: 8px; cursor: pointer;
}
.doc-button.primary { background: #fff; color: var(--doc-brand-dark); }
.doc-button.secondary { background: rgba(255,255,255,.14); color: #fff; border-color: rgba(255,255,255,.32); }
.doc-button.dark { background: var(--doc-brand); color: #fff; }
.doc-button.light { background: #f8fafc; color: var(--doc-ink); border-color: var(--doc-line); }
.doc-button.danger { background: #fef2f2; color: var(--doc-danger); border-color: #fecaca; padding: 8px 12px; }
.doc-card { background: rgba(255,255,255,.92); border: 1px solid var(--doc-line); border-radius: var(--doc-radius); box-shadow: 0 14px 45px rgba(15,35,31,.08); overflow: hidden; }
.doc-card-header { padding: 20px 22px; border-bottom: 1px solid var(--doc-line); display: flex; align-items: center; justify-content: space-between; gap: 16px; }
.doc-card-body { padding: 22px; }
.doc-grid { display: grid; gap: 18px; }
.doc-grid.stats { grid-template-columns: repeat(4, minmax(0, 1fr)); margin: 22px 0; }
.doc-stat { padding: 20px; }
.doc-stat strong { display:block; font-size: 30px; letter-spacing: -.04em; }
.doc-stat span { color: var(--doc-muted); font-size: 13px; font-weight: 700; text-transform: uppercase; letter-spacing: .08em; }
.doc-table { width: 100%; border-collapse: collapse; }
.doc-table th { text-align: left; font-size: 12px; text-transform: uppercase; letter-spacing: .08em; color: var(--doc-muted); padding: 12px; border-bottom: 1px solid var(--doc-line); }
.doc-table td { padding: 14px 12px; border-bottom: 1px solid #edf3f0; vertical-align: top; }
.doc-table a { color: var(--doc-brand-dark); font-weight: 800; text-decoration: none; }
.doc-badge { display: inline-flex; align-items: center; border-radius: 999px; padding: 5px 10px; font-size: 12px; font-weight: 800; background: #ecfdf5; color: #065f46; border: 1px solid #bbf7d0; }
.doc-badge.draft { background: #f8fafc; color: #475569; border-color: #cbd5e1; }
.doc-badge.archived { background: #fef2f2; color: #991b1b; border-color: #fecaca; }
.doc-form-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 16px; }
.doc-field.full { grid-column: 1 / -1; }
.doc-label { display: block; font-weight: 800; margin-bottom: 8px; font-size: 14px; }
.doc-input, .doc-select, .doc-textarea {
width: 100%; box-sizing: border-box; border: 1px solid #cbd5e1; border-radius: 14px; padding: 12px 14px;
background: #fff; color: var(--doc-ink); font: inherit;
}
.doc-textarea { min-height: 360px; line-height: 1.6; resize: vertical; font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; }
.doc-editor { border: 1px solid #cbd5e1; border-radius: 16px; overflow: hidden; background: #fff; }
.doc-editor .doc-textarea { border: 0; border-radius: 0; min-height: 420px; }
.doc-editor-toolbar { display: flex; flex-wrap: wrap; gap: 6px; padding: 10px; background: #f8fafc; border-bottom: 1px solid var(--doc-line); }
.doc-editor-toolbar button { border: 1px solid #cbd5e1; background: #fff; color: var(--doc-ink); border-radius: 10px; padding: 7px 10px; font-weight: 800; cursor: pointer; }
.doc-editor-toolbar button:hover, .doc-editor-toolbar button:focus { border-color: var(--doc-brand); outline: 2px solid rgba(15, 118, 110, .18); }
.editor-help { padding: 0 14px 12px; margin: -4px 0 0; font-size: 13px; }
.doc-error { color: var(--doc-danger); font-size: 13px; margin-top: 6px; }
.doc-alert { border-radius: 16px; padding: 14px 16px; background: #ecfdf5; color: #065f46; border: 1px solid #bbf7d0; margin-bottom: 18px; font-weight: 700; }
.doc-filter { display: grid; grid-template-columns: 1fr 180px 220px auto; gap: 12px; margin-bottom: 18px; }
.doc-content { line-height: 1.75; font-size: 16px; }
.doc-content h1, .doc-content h2, .doc-content h3 { line-height: 1.2; letter-spacing: -.025em; margin: 1.4em 0 .55em; }
.doc-content h1 { font-size: 2rem; }
.doc-content h2 { font-size: 1.55rem; border-bottom: 1px solid var(--doc-line); padding-bottom: .35rem; }
.doc-content h3 { font-size: 1.25rem; }
.doc-content p, .doc-content ul, .doc-content ol, .doc-content blockquote, .doc-content pre { margin: 0 0 1rem; }
.doc-content code { background: #f1f5f9; border-radius: 7px; padding: .14rem .32rem; font-size: .92em; }
.doc-content pre { overflow-x: auto; background: #0f172a; color: #e2e8f0; border-radius: 16px; padding: 16px; }
.doc-content pre code { background: transparent; color: inherit; padding: 0; }
.doc-content blockquote { border-left: 4px solid var(--doc-brand); padding-left: 16px; color: var(--doc-muted); }
.doc-content table { width: 100%; border-collapse: collapse; margin: 1rem 0; }
.doc-content th, .doc-content td { border: 1px solid var(--doc-line); padding: 10px 12px; text-align: left; }
.doc-muted { color: var(--doc-muted); }
.doc-link { color: var(--doc-brand-dark); font-weight: 800; text-decoration: none; }
.doc-attachment-list { display: grid; gap: 10px; }
.doc-attachment-item { display: flex; justify-content: space-between; align-items: center; gap: 14px; border: 1px solid var(--doc-line); border-radius: 14px; padding: 12px 14px; background: #fff; }
@media (max-width: 860px) {
.doc-hero { grid-template-columns: 1fr; }
.doc-grid.stats { grid-template-columns: repeat(2, minmax(0, 1fr)); }
.doc-filter, .doc-form-grid { grid-template-columns: 1fr; }
.doc-table { display: block; overflow-x: auto; }
}
@media (max-width: 560px) {
.doc-shell { padding: 16px 12px 36px; }
.doc-hero { padding: 22px; border-radius: 22px; }
.doc-grid.stats { grid-template-columns: 1fr; }
}
</style>
</head>
<body class="documentation-module">
<main class="doc-shell">
@yield('content')
</main>
<script>
document.addEventListener('click', function (event) {
const button = event.target.closest('[data-md-before]');
if (! button) {
return;
}
const editor = button.closest('[data-documentation-editor]');
const textarea = editor ? editor.querySelector('[data-markdown-textarea]') : null;
if (! textarea) {
return;
}
const before = button.getAttribute('data-md-before') || '';
const after = button.getAttribute('data-md-after') || '';
const start = textarea.selectionStart || 0;
const end = textarea.selectionEnd || 0;
const selected = textarea.value.substring(start, end);
const replacement = before + selected + after;
textarea.setRangeText(replacement, start, end, 'end');
textarea.focus();
});
</script>
</body>
</html>
Documentation/Resources/views/partials/category-form.blade.php
+43
View File
@@ -0,0 +1,43 @@
@csrf
@if($category->exists)
@method('PUT')
@endif
<div class="doc-form-grid">
<div class="doc-field">
<label class="doc-label" for="name">Name</label>
<input class="doc-input" id="name" name="name" value="{{ old('name', $category->name) }}" required maxlength="150">
@error('name') <div class="doc-error">{{ $message }}</div> @enderror
</div>
<div class="doc-field">
<label class="doc-label" for="slug">Slug</label>
<input class="doc-input" id="slug" name="slug" value="{{ old('slug', $category->slug) }}" maxlength="180" placeholder="Auto-generated when blank">
@error('slug') <div class="doc-error">{{ $message }}</div> @enderror
</div>
<div class="doc-field">
<label class="doc-label" for="icon">Icon</label>
<input class="doc-input" id="icon" name="icon" value="{{ old('icon', $category->icon) }}" maxlength="80" placeholder="book-open, file-check, shield">
@error('icon') <div class="doc-error">{{ $message }}</div> @enderror
</div>
<div class="doc-field">
<label class="doc-label" for="colour">Colour</label>
<input class="doc-input" id="colour" name="colour" value="{{ old('colour', $category->colour ?: 'emerald') }}" required maxlength="32">
@error('colour') <div class="doc-error">{{ $message }}</div> @enderror
</div>
<div class="doc-field">
<label class="doc-label" for="sort_order">Sort order</label>
<input class="doc-input" id="sort_order" name="sort_order" type="number" min="0" value="{{ old('sort_order', $category->sort_order ?: 0) }}">
@error('sort_order') <div class="doc-error">{{ $message }}</div> @enderror
</div>
<div class="doc-field" style="display:flex;align-items:end;">
<label><input type="checkbox" name="is_active" value="1" @checked(old('is_active', $category->is_active ?? true))> Active category</label>
</div>
<div class="doc-field full">
<label class="doc-label" for="description">Description</label>
<textarea class="doc-textarea" id="description" name="description" style="min-height:140px;">{{ old('description', $category->description) }}</textarea>
@error('description') <div class="doc-error">{{ $message }}</div> @enderror
</div>
</div>
<div class="doc-actions" style="margin-top:22px;">
<button class="doc-button dark" type="submit">Save category</button>
<a class="doc-button light" href="{{ route('documentation.categories.index') }}">Cancel</a>
</div>
Documentation/Resources/views/partials/document-form.blade.php
+109
View File
@@ -0,0 +1,109 @@
@csrf
@if($document->exists)
@method('PUT')
@endif
<div class="doc-form-grid">
<div class="doc-field">
<label class="doc-label" for="title">Title</label>
<input class="doc-input" id="title" name="title" value="{{ old('title', $document->title) }}" required maxlength="220">
@error('title') <div class="doc-error">{{ $message }}</div> @enderror
</div>
<div class="doc-field">
<label class="doc-label" for="slug">Slug</label>
<input class="doc-input" id="slug" name="slug" value="{{ old('slug', $document->slug) }}" maxlength="240" placeholder="Auto-generated when blank">
@error('slug') <div class="doc-error">{{ $message }}</div> @enderror
</div>
<div class="doc-field">
<label class="doc-label" for="documentation_category_id">Category</label>
<select class="doc-select" id="documentation_category_id" name="documentation_category_id">
<option value="">No category</option>
@foreach($categories as $category)
<option value="{{ $category->id }}" @selected((string) old('documentation_category_id', $document->documentation_category_id) === (string) $category->id)>{{ $category->name }}</option>
@endforeach
</select>
@error('documentation_category_id') <div class="doc-error">{{ $message }}</div> @enderror
</div>
<div class="doc-field">
<label class="doc-label" for="status">Status</label>
<select class="doc-select" id="status" name="status" required>
@foreach($statuses as $value => $label)
<option value="{{ $value }}" @selected(old('status', $document->status) === $value)>{{ $label }}</option>
@endforeach
</select>
@error('status') <div class="doc-error">{{ $message }}</div> @enderror
</div>
<div class="doc-field">
<label class="doc-label" for="version">Version</label>
<input class="doc-input" id="version" name="version" value="{{ old('version', $document->version ?: '1.0.0') }}" required maxlength="50">
@error('version') <div class="doc-error">{{ $message }}</div> @enderror
</div>
<div class="doc-field">
<label class="doc-label" for="reference">Reference</label>
<input class="doc-input" id="reference" name="reference" value="{{ old('reference', $document->reference) }}" maxlength="100" placeholder="SOP-001, POL-002, etc.">
@error('reference') <div class="doc-error">{{ $message }}</div> @enderror
</div>
<div class="doc-field full">
<label class="doc-label" for="summary">Summary</label>
<input class="doc-input" id="summary" name="summary" value="{{ old('summary', $document->summary) }}" maxlength="500">
@error('summary') <div class="doc-error">{{ $message }}</div> @enderror
</div>
<div class="doc-field full">
<label class="doc-label" for="body">Document body</label>
<div class="doc-editor" data-documentation-editor>
<div class="doc-editor-toolbar" aria-label="Markdown editor controls">
<button type="button" data-md-before="## " data-md-after="" title="Heading">H2</button>
<button type="button" data-md-before="**" data-md-after="**" title="Bold"><strong>B</strong></button>
<button type="button" data-md-before="_" data-md-after="_" title="Italic"><em>I</em></button>
<button type="button" data-md-before="> " data-md-after="" title="Quote">Quote</button>
<button type="button" data-md-before="- " data-md-after="" title="Bullet list">List</button>
<button type="button" data-md-before="1. " data-md-after="" title="Numbered list">1.</button>
<button type="button" data-md-before="[" data-md-after="](https://)" title="Link">Link</button>
<button type="button" data-md-before="`" data-md-after="`" title="Inline code">Code</button>
<button type="button" data-md-before="```php&#10;" data-md-after="&#10;```" title="Code block">Code block</button>
<button type="button" data-md-before="| Column | Column |&#10;| --- | --- |&#10;| Value | Value |" data-md-after="" title="Table">Table</button>
</div>
<textarea class="doc-textarea" id="body" name="body" data-markdown-textarea>{{ old('body', $document->body) }}</textarea>
<p class="doc-muted editor-help">Markdown is supported, including fenced code blocks such as <code>```php</code>, tables, lists, links, and headings.</p>
</div>
@error('body') <div class="doc-error">{{ $message }}</div> @enderror
</div>
<div class="doc-field full">
<label class="doc-label" for="attachment">Primary attachment</label>
<input class="doc-input" id="attachment" name="attachment" type="file">
<p class="doc-muted">Primary Markdown files can be imported into the document body when the body is blank.</p>
@if($document->attachment_name)
<p class="doc-muted">Current primary file: <a class="doc-link" href="{{ route('documentation.documents.download', $document) }}">{{ $document->attachment_name }}</a></p>
<label><input type="checkbox" name="remove_attachment" value="1"> Remove current primary attachment</label>
@endif
@error('attachment') <div class="doc-error">{{ $message }}</div> @enderror
</div>
<div class="doc-field full">
<label class="doc-label" for="attachments">Additional attachments</label>
<input class="doc-input" id="attachments" name="attachments[]" type="file" multiple>
<p class="doc-muted">Attach supporting files such as PDFs, screenshots, spreadsheets, Word documents, Markdown, CSV, and images.</p>
@error('attachments') <div class="doc-error">{{ $message }}</div> @enderror
@error('attachments.*') <div class="doc-error">{{ $message }}</div> @enderror
@if($document->exists && $document->attachments->isNotEmpty())
<div class="doc-attachment-list" style="margin-top: 14px;">
@foreach($document->attachments as $attachment)
<div class="doc-attachment-item">
<div>
<a class="doc-link" href="{{ route('documentation.documents.attachments.download', [$document, $attachment]) }}">{{ $attachment->original_name }}</a>
<span class="doc-muted">{{ $attachment->size_label }}</span>
</div>
<button class="doc-button danger" type="submit" form="delete-attachment-{{ $attachment->id }}">Remove</button>
</div>
@endforeach
</div>
@endif
</div>
<div class="doc-field full">
<label><input type="checkbox" name="is_featured" value="1" @checked(old('is_featured', $document->is_featured))> Feature this document on the dashboard</label>
</div>
</div>
<div class="doc-actions" style="margin-top:22px;">
<button class="doc-button dark" type="submit">Save document</button>
<a class="doc-button light" href="{{ route('documentation.documents.index') }}">Cancel</a>
</div>
Documentation/Resources/views/partials/hero.blade.php
+13
View File
@@ -0,0 +1,13 @@
<section class="doc-hero">
<div>
<p class="doc-eyebrow">{{ $eyebrow ?? 'Documentation Suite' }}</p>
<h1>{{ $title ?? 'Documentation' }}</h1>
<p>{{ $subtitle ?? 'Manage controlled documents, policies, guides, files, and operational knowledge in one professional workspace.' }}</p>
<div class="doc-actions">
<a class="doc-button primary" href="{{ route('documentation.documents.create') }}">Create document</a>
<a class="doc-button secondary" href="{{ route('documentation.categories.index') }}">Manage categories</a>
<a class="doc-button secondary" href="{{ route('documentation.documents.index') }}">Document register</a>
</div>
</div>
<div aria-hidden="true" style="width:140px;height:140px;border-radius:32px;background:rgba(255,255,255,.16);display:grid;place-items:center;border:1px solid rgba(255,255,255,.26);font-size:58px;font-weight:900;">D</div>
</section>