搭建轻舟一期门户、后台和统一登录。

让分类、会员和示例工具共用同一账号,本地即可跑通登录与授权。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Dev
2026-11-09 16:46:35 +08:00
co-authored by Cursor
commit 60daff2365
173 changed files with 21585 additions and 0 deletions
@@ -0,0 +1,187 @@
<?php
namespace App\Http\Controllers\Api\V1;
use App\Http\Controllers\Controller;
use App\Models\Deployment;
use App\Models\Order;
use App\Models\Plan;
use App\Models\ServiceTicket;
use App\Models\UserSession;
use App\Models\UserToolOpen;
use App\Services\AuthService;
use App\Services\MembershipService;
use App\Support\Presenter;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
class AccountController extends Controller
{
public function __construct(
private readonly AuthService $auth,
private readonly MembershipService $membership,
) {}
public function overview(Request $request)
{
$user = $request->user();
$recent = UserToolOpen::query()->with('tool.tags')->where('user_id', $user->id)->orderByDesc('last_opened_at')->limit(8)->get()
->filter(fn ($row) => $row->tool && $row->tool->status === 'published')
->map(fn ($row) => Presenter::toolCard($row->tool))->values();
return $this->ok([
'user' => Presenter::user($user),
'recent_tools' => $recent,
'pending_orders' => Order::query()->where('user_id', $user->id)->where('status', 'pending')->count(),
]);
}
public function updateProfile(Request $request)
{
$data = $request->validate(['nickname' => ['required', 'string', 'min:2', 'max:40']]);
$request->user()->update(['nickname' => $data['nickname']]);
return $this->ok(Presenter::user($request->user()->refresh()), '资料已更新');
}
public function updatePassword(Request $request)
{
$data = $request->validate([
'old_password' => ['nullable', 'string'],
'password' => ['required', 'string'],
]);
$this->auth->changePassword(
$request->user(),
isset($data['old_password']) ? $this->auth->decrypt($data['old_password']) : null,
$this->auth->decrypt($data['password'])
);
return $this->ok(null, '密码已更新,其他工具需要重新登录');
}
public function bind(Request $request)
{
$data = $request->validate([
'channel' => ['required', 'in:sms,email'],
'account' => ['required', 'string'],
'code' => ['required', 'string'],
]);
$this->auth->bind($request->user(), $data['channel'], $data['account'], $data['code']);
return $this->ok(Presenter::user($request->user()->refresh()), '绑定成功');
}
public function sessions(Request $request)
{
$current = $request->session()->getId();
$rows = UserSession::query()->where('user_id', $request->user()->id)->whereNull('revoked_at')->orderByDesc('last_seen_at')->get();
return $this->ok($rows->map(fn (UserSession $row) => [
'id' => $row->id,
'ip' => $row->ip,
'user_agent' => $row->user_agent,
'last_seen_at' => $row->last_seen_at?->toIso8601String(),
'current' => $row->session_id === $current,
])->values());
}
public function revokeSession(Request $request, UserSession $session)
{
$this->owns($request, $session);
$current = $session->session_id === $request->session()->getId();
$session->update(['revoked_at' => now()]);
DB::table('sessions')->where('id', $session->session_id)->delete();
if ($current) {
$this->auth->logout($request, false);
}
return $this->ok(['logged_out' => $current], '会话已下线');
}
public function revokeAll(Request $request)
{
$this->auth->logout($request, true);
return $this->ok(null, '已全部下线');
}
public function membership(Request $request)
{
return $this->ok($this->membership->snapshot($request->user()));
}
public function orders(Request $request)
{
$rows = Order::query()->where('user_id', $request->user()->id)->latest()->limit(50)->get();
return $this->ok($rows->map(fn (Order $order) => $this->orderPayload($order))->values());
}
public function storeOrder(Request $request)
{
$data = $request->validate(['plan_id' => ['required', 'integer']]);
$plan = Plan::query()->where('status', 'published')->findOrFail($data['plan_id']);
if ($plan->price_cents <= 0) {
return response()->json(['message' => '免费方案无需下单', 'code' => 'free_plan'], 422);
}
$order = Order::query()->create([
'order_no' => 'QZ'.now()->format('YmdHis').random_int(1000, 9999),
'user_id' => $request->user()->id,
'type' => 'subscription',
'status' => 'pending',
'amount_cents' => $plan->price_cents,
'title' => $plan->name,
]);
$order->items()->create([
'plan_id' => $plan->id,
'title' => $plan->name,
'amount_cents' => $plan->price_cents,
]);
return $this->ok($this->orderPayload($order), '订单已提交,等待确认收款');
}
public function services(Request $request)
{
$userId = $request->user()->id;
return $this->ok([
'tickets' => ServiceTicket::query()->with('tool:id,name')->where('user_id', $userId)->latest()->get(),
'deployments' => Deployment::query()->with('tool:id,name')->where('user_id', $userId)->latest()->get(),
]);
}
public function storeTicket(Request $request)
{
$data = $request->validate([
'contact' => ['required', 'string', 'max:120'],
'requirement' => ['required', 'string', 'max:5000'],
'tool_id' => ['nullable', 'integer', 'exists:tools,id'],
]);
$ticket = ServiceTicket::query()->create($data + [
'user_id' => $request->user()->id,
'status' => 'pending',
]);
return $this->ok($ticket, '需求已提交');
}
private function owns(Request $request, UserSession $session): void
{
abort_unless($session->user_id === $request->user()->id && $session->revoked_at === null, 404);
}
private function orderPayload(Order $order): array
{
return [
'id' => $order->id,
'order_no' => $order->order_no,
'type' => $order->type,
'status' => $order->status,
'amount_cents' => $order->amount_cents,
'title' => $order->title,
'paid_at' => $order->paid_at?->toIso8601String(),
'created_at' => $order->created_at?->toIso8601String(),
];
}
}
@@ -0,0 +1,269 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin;
use App\Http\Controllers\Controller;
use App\Models\Category;
use App\Models\HomeSection;
use App\Models\Tag;
use App\Models\Tool;
use App\Support\HtmlSanitizer;
use Illuminate\Http\Request;
use Illuminate\Validation\Rule;
class CatalogController extends Controller
{
public function categories()
{
return $this->ok(Category::query()->orderByDesc('sort')->orderBy('id')->get());
}
public function storeCategory(Request $request)
{
$category = Category::query()->create($this->categoryData($request));
$this->audit($request->user(), 'category.create', $category, '新建分类 '.$category->name);
return $this->ok($category);
}
public function updateCategory(Request $request, Category $category)
{
$category->update($this->categoryData($request, $category->id));
$this->audit($request->user(), 'category.update', $category, '更新分类 '.$category->name);
return $this->ok($category);
}
public function destroyCategory(Request $request, Category $category)
{
if ($category->children()->exists()) {
return response()->json(['message' => '请先删除子分类', 'code' => 'has_children'], 422);
}
$category->tools()->detach();
$category->delete();
$this->audit($request->user(), 'category.delete', $category, '删除分类 '.$category->name);
return $this->ok(null, '已删除');
}
public function tags()
{
return $this->ok(Tag::query()->orderBy('name')->get());
}
public function storeTag(Request $request)
{
$data = $request->validate([
'name' => ['required', 'string', 'max:40'],
'slug' => ['required', 'regex:/^[a-z0-9]+(?:-[a-z0-9]+)*$/', 'unique:tags,slug'],
]);
$tag = Tag::query()->create($data);
$this->audit($request->user(), 'tag.create', $tag, '新建标签 '.$tag->name);
return $this->ok($tag);
}
public function updateTag(Request $request, Tag $tag)
{
$data = $request->validate([
'name' => ['required', 'string', 'max:40'],
'slug' => ['required', 'regex:/^[a-z0-9]+(?:-[a-z0-9]+)*$/', Rule::unique('tags', 'slug')->ignore($tag->id)],
]);
$tag->update($data);
$this->audit($request->user(), 'tag.update', $tag, '更新标签 '.$tag->name);
return $this->ok($tag);
}
public function destroyTag(Request $request, Tag $tag)
{
$tag->tools()->detach();
$tag->delete();
$this->audit($request->user(), 'tag.delete', $tag, '删除标签 '.$tag->name);
return $this->ok(null, '已删除');
}
public function tools(Request $request)
{
$query = Tool::query()->with('categories:id,name', 'tags:id,name');
if ($keyword = trim((string) $request->query('q', ''))) {
$query->where('name', 'like', '%'.addcslashes($keyword, '%_\\').'%');
}
$page = $query->orderByDesc('sort')->orderByDesc('id')->paginate(15);
return $this->ok([
'items' => collect($page->items())->map(fn (Tool $tool) => $this->toolPayload($tool))->values(),
'total' => $page->total(),
'page' => $page->currentPage(),
]);
}
public function storeTool(Request $request)
{
$data = $this->toolData($request);
if ($data['status'] === 'published') {
$data['published_at'] = now();
}
$tool = Tool::query()->create($data);
$this->syncTool($tool, $request);
$this->audit($request->user(), 'tool.create', $tool, '新建工具 '.$tool->name);
return $this->ok($this->toolPayload($tool->load('categories:id,name', 'tags:id,name')));
}
public function updateTool(Request $request, Tool $tool)
{
$data = $this->toolData($request, $tool->id);
if ($data['status'] === 'published' && ! $tool->published_at) {
$data['published_at'] = now();
}
$tool->update($data);
$this->syncTool($tool, $request);
$this->audit($request->user(), 'tool.update', $tool, '更新工具 '.$tool->name);
return $this->ok($this->toolPayload($tool->load('categories:id,name', 'tags:id,name')));
}
public function destroyTool(Request $request, Tool $tool)
{
if ($tool->oauthClients()->exists()) {
return response()->json(['message' => '工具仍被登录客户端引用', 'code' => 'in_use'], 422);
}
$tool->categories()->detach();
$tool->tags()->detach();
$tool->delete();
$this->audit($request->user(), 'tool.delete', $tool, '删除工具 '.$tool->name);
return $this->ok(null, '已删除');
}
public function sections()
{
return $this->ok(HomeSection::query()->with('tools:id,name')->orderByDesc('sort')->get()->map(function (HomeSection $section) {
return [
'id' => $section->id,
'title' => $section->title,
'slug' => $section->slug,
'sort' => $section->sort,
'display_limit' => $section->display_limit,
'status' => $section->status,
'tool_ids' => $section->tools->pluck('id')->values(),
'tools' => $section->tools->map(fn ($tool) => ['id' => $tool->id, 'name' => $tool->name])->values(),
];
}));
}
public function storeSection(Request $request)
{
$section = HomeSection::query()->create($this->sectionData($request));
$this->syncSection($section, $request);
$this->audit($request->user(), 'section.create', $section, '新建分区 '.$section->title);
return $this->ok($section->load('tools:id,name'));
}
public function updateSection(Request $request, HomeSection $section)
{
$section->update($this->sectionData($request, $section->id));
$this->syncSection($section, $request);
$this->audit($request->user(), 'section.update', $section, '更新分区 '.$section->title);
return $this->ok($section->load('tools:id,name'));
}
public function destroySection(Request $request, HomeSection $section)
{
$section->tools()->detach();
$section->delete();
$this->audit($request->user(), 'section.delete', $section, '删除分区 '.$section->title);
return $this->ok(null, '已删除');
}
private function categoryData(Request $request, ?int $id = null): array
{
return $request->validate([
'parent_id' => ['nullable', 'integer', 'exists:categories,id'],
'name' => ['required', 'string', 'max:80'],
'slug' => ['required', 'regex:/^[a-z0-9]+(?:-[a-z0-9]+)*$/', Rule::unique('categories', 'slug')->ignore($id)],
'icon' => ['nullable', 'string', 'max:40'],
'sort' => ['nullable', 'integer'],
'show_in_nav' => ['required', 'boolean'],
'status' => ['required', 'in:published,hidden'],
]);
}
private function toolData(Request $request, ?int $id = null): array
{
$data = $request->validate([
'name' => ['required', 'string', 'max:80'],
'slug' => ['required', 'regex:/^[a-z0-9]+(?:-[a-z0-9]+)*$/', Rule::unique('tools', 'slug')->ignore($id)],
'icon' => ['nullable', 'string', 'max:255'],
'summary' => ['required', 'string', 'max:255'],
'content' => ['nullable', 'string'],
'type' => ['required', 'in:integrated,link'],
'open_url' => ['required', 'url', 'max:500'],
'language' => ['nullable', 'string', 'max:40'],
'internal_note' => ['nullable', 'string'],
'badge' => ['required', 'in:free,member,enterprise'],
'required_entitlement' => ['nullable', 'string', 'max:120'],
'sort' => ['nullable', 'integer'],
'is_recommended' => ['required', 'boolean'],
'status' => ['required', 'in:draft,published'],
]);
$data['content'] = HtmlSanitizer::clean($data['content'] ?? '');
$data['sort'] = $data['sort'] ?? 0;
return $data;
}
private function syncTool(Tool $tool, Request $request): void
{
$ids = $request->validate([
'category_ids' => ['array'],
'category_ids.*' => ['integer', 'exists:categories,id'],
'tag_ids' => ['array'],
'tag_ids.*' => ['integer', 'exists:tags,id'],
]);
$tool->categories()->sync($ids['category_ids'] ?? []);
$tool->tags()->sync($ids['tag_ids'] ?? []);
}
private function toolPayload(Tool $tool): array
{
return $tool->only([
'id', 'name', 'slug', 'icon', 'summary', 'content', 'type', 'open_url', 'language',
'internal_note', 'badge', 'required_entitlement', 'sort', 'is_recommended', 'status', 'clicks',
]) + [
'category_ids' => $tool->categories->pluck('id')->values(),
'tag_ids' => $tool->tags->pluck('id')->values(),
'categories' => $tool->categories->map(fn ($item) => ['id' => $item->id, 'name' => $item->name])->values(),
'tags' => $tool->tags->map(fn ($item) => ['id' => $item->id, 'name' => $item->name])->values(),
];
}
private function sectionData(Request $request, ?int $id = null): array
{
return $request->validate([
'title' => ['required', 'string', 'max:80'],
'slug' => ['required', 'regex:/^[a-z0-9]+(?:-[a-z0-9]+)*$/', Rule::unique('home_sections', 'slug')->ignore($id)],
'sort' => ['nullable', 'integer'],
'display_limit' => ['nullable', 'integer', 'min:1', 'max:24'],
'status' => ['required', 'in:published,hidden'],
]);
}
private function syncSection(HomeSection $section, Request $request): void
{
$ids = $request->validate([
'tool_ids' => ['array'],
'tool_ids.*' => ['integer', 'exists:tools,id'],
])['tool_ids'] ?? [];
$sync = [];
foreach (array_values($ids) as $index => $toolId) {
$sync[$toolId] = ['sort' => $index];
}
$section->tools()->sync($sync);
}
}
@@ -0,0 +1,176 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin;
use App\Http\Controllers\Controller;
use App\Models\Deployment;
use App\Models\Order;
use App\Models\Plan;
use App\Models\PlanEntitlement;
use App\Models\ServiceTicket;
use App\Services\MembershipService;
use App\Support\Presenter;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
use Illuminate\Validation\Rule;
class CommerceController extends Controller
{
public function __construct(private readonly MembershipService $membership) {}
public function plans()
{
return $this->ok(Plan::query()->with('entitlements')->orderByDesc('sort')->get()->map(fn (Plan $plan) => Presenter::plan($plan)));
}
public function storePlan(Request $request)
{
$plan = DB::transaction(function () use ($request) {
$plan = Plan::query()->create($this->planData($request));
$this->syncEntitlements($plan, $request);
return $plan->load('entitlements');
});
$this->audit($request->user(), 'plan.create', $plan, '新建方案 '.$plan->name);
return $this->ok(Presenter::plan($plan));
}
public function updatePlan(Request $request, Plan $plan)
{
DB::transaction(function () use ($request, $plan) {
$plan->update($this->planData($request, $plan->id));
$this->syncEntitlements($plan, $request);
});
$this->audit($request->user(), 'plan.update', $plan, '更新方案 '.$plan->name);
return $this->ok(Presenter::plan($plan->load('entitlements')));
}
public function orders(Request $request)
{
$query = Order::query()->with('user:id,nickname')->latest();
if ($status = $request->query('status')) {
$query->where('status', $status);
}
return $this->ok($query->limit(100)->get()->map(fn (Order $order) => [
'id' => $order->id,
'order_no' => $order->order_no,
'title' => $order->title,
'type' => $order->type,
'status' => $order->status,
'amount_cents' => $order->amount_cents,
'user' => $order->user?->nickname,
'remark' => $order->remark,
'created_at' => $order->created_at?->toIso8601String(),
]));
}
public function confirmOrder(Request $request, Order $order)
{
$data = $request->validate(['remark' => ['nullable', 'string', 'max:255']]);
if (isset($data['remark'])) {
$order->remark = $data['remark'];
$order->save();
}
$this->membership->confirmOrder($order->fresh());
$this->audit($request->user(), 'order.confirm', $order, '确认收款 '.$order->order_no);
return $this->ok(null, '已确认收款');
}
public function closeOrder(Request $request, Order $order)
{
if ($order->status !== 'pending') {
return response()->json(['message' => '只能关闭待支付订单', 'code' => 'invalid_status'], 422);
}
$order->update(['status' => 'closed']);
$this->audit($request->user(), 'order.close', $order, '关闭订单 '.$order->order_no);
return $this->ok(null, '订单已关闭');
}
public function tickets()
{
return $this->ok(ServiceTicket::query()->with('user:id,nickname', 'tool:id,name')->latest()->limit(100)->get());
}
public function updateTicket(Request $request, ServiceTicket $ticket)
{
$data = $request->validate([
'status' => ['required', 'in:pending,quoted,doing,checking,done,closed'],
'quote_cents' => ['nullable', 'integer', 'min:0'],
'delivery_note' => ['nullable', 'string'],
]);
$ticket->update($data);
$this->audit($request->user(), 'ticket.update', $ticket, '更新工单 #'.$ticket->id);
return $this->ok($ticket);
}
public function deployments()
{
return $this->ok(Deployment::query()->with('user:id,nickname', 'tool:id,name')->latest()->limit(100)->get());
}
public function storeDeployment(Request $request)
{
$data = $this->deploymentData($request);
$deployment = Deployment::query()->create($data);
$this->audit($request->user(), 'deployment.create', $deployment, '新建云端实例 #'.$deployment->id);
return $this->ok($deployment);
}
public function updateDeployment(Request $request, Deployment $deployment)
{
$deployment->update($this->deploymentData($request));
$this->audit($request->user(), 'deployment.update', $deployment, '更新云端实例 #'.$deployment->id);
return $this->ok($deployment);
}
private function planData(Request $request, ?int $id = null): array
{
return $request->validate([
'code' => ['required', 'regex:/^[a-z0-9]+(?:-[a-z0-9]+)*$/', Rule::unique('plans', 'code')->ignore($id)],
'name' => ['required', 'string', 'max:80'],
'price_cents' => ['required', 'integer', 'min:0'],
'period' => ['required', 'in:month,year,lifetime'],
'description' => ['nullable', 'string', 'max:255'],
'sort' => ['nullable', 'integer'],
'status' => ['required', 'in:published,hidden'],
]);
}
private function syncEntitlements(Plan $plan, Request $request): void
{
$items = $request->validate([
'entitlements' => ['array'],
'entitlements.*.key' => ['required', 'string', 'max:120'],
'entitlements.*.value' => ['required', 'string', 'max:120'],
])['entitlements'] ?? [];
$plan->entitlements()->delete();
foreach ($items as $item) {
PlanEntitlement::query()->create([
'plan_id' => $plan->id,
'entitlement_key' => $item['key'],
'entitlement_value' => $item['value'],
]);
}
}
private function deploymentData(Request $request): array
{
return $request->validate([
'user_id' => ['required', 'integer', 'exists:users,id'],
'tool_id' => ['nullable', 'integer', 'exists:tools,id'],
'spec' => ['nullable', 'string', 'max:120'],
'access_url' => ['nullable', 'string', 'max:500'],
'status' => ['required', 'in:pending,running,paused,released'],
'ends_at' => ['nullable', 'date'],
'remark' => ['nullable', 'string', 'max:255'],
]);
}
}
@@ -0,0 +1,166 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin;
use App\Http\Controllers\Controller;
use App\Models\Agreement;
use App\Models\Article;
use App\Models\Banner;
use App\Models\Navigation;
use App\Support\HtmlSanitizer;
use Illuminate\Http\Request;
use Illuminate\Validation\Rule;
class ContentController extends Controller
{
public function articles()
{
return $this->ok(Article::query()->latest('id')->limit(100)->get());
}
public function storeArticle(Request $request)
{
$article = Article::query()->create($this->articleData($request));
$this->audit($request->user(), 'article.create', $article, '新建文章 '.$article->title);
return $this->ok($article);
}
public function updateArticle(Request $request, Article $article)
{
$data = $this->articleData($request, $article->id);
if ($data['status'] === 'published' && ! $article->published_at) {
$data['published_at'] = now();
}
$article->update($data);
$this->audit($request->user(), 'article.update', $article, '更新文章 '.$article->title);
return $this->ok($article);
}
public function destroyArticle(Request $request, Article $article)
{
$article->delete();
$this->audit($request->user(), 'article.delete', $article, '删除文章 '.$article->title);
return $this->ok(null, '已删除');
}
public function banners()
{
return $this->ok(Banner::query()->orderByDesc('sort')->get());
}
public function storeBanner(Request $request)
{
$banner = Banner::query()->create($this->bannerData($request));
$this->audit($request->user(), 'banner.create', $banner, '新建轮播 '.$banner->title);
return $this->ok($banner);
}
public function updateBanner(Request $request, Banner $banner)
{
$banner->update($this->bannerData($request));
$this->audit($request->user(), 'banner.update', $banner, '更新轮播 '.$banner->title);
return $this->ok($banner);
}
public function destroyBanner(Request $request, Banner $banner)
{
$banner->delete();
$this->audit($request->user(), 'banner.delete', $banner, '删除轮播 '.$banner->title);
return $this->ok(null, '已删除');
}
public function navigations()
{
return $this->ok(Navigation::query()->orderBy('group_name')->orderByDesc('sort')->get());
}
public function storeNavigation(Request $request)
{
$item = Navigation::query()->create($this->navData($request));
$this->audit($request->user(), 'nav.create', $item, '新建导航 '.$item->title);
return $this->ok($item);
}
public function updateNavigation(Request $request, Navigation $navigation)
{
$navigation->update($this->navData($request));
$this->audit($request->user(), 'nav.update', $navigation, '更新导航 '.$navigation->title);
return $this->ok($navigation);
}
public function destroyNavigation(Request $request, Navigation $navigation)
{
$navigation->delete();
$this->audit($request->user(), 'nav.delete', $navigation, '删除导航 '.$navigation->title);
return $this->ok(null, '已删除');
}
public function agreements()
{
return $this->ok(Agreement::query()->orderBy('type')->get());
}
public function updateAgreement(Request $request, Agreement $agreement)
{
$data = $request->validate([
'title' => ['required', 'string', 'max:120'],
'body' => ['required', 'string'],
]);
$data['body'] = HtmlSanitizer::clean($data['body']);
$agreement->update($data);
$this->audit($request->user(), 'agreement.update', $agreement, '更新协议 '.$agreement->title);
return $this->ok($agreement);
}
private function articleData(Request $request, ?int $id = null): array
{
$data = $request->validate([
'type' => ['required', 'in:help,announcement,page'],
'title' => ['required', 'string', 'max:160'],
'slug' => ['required', 'regex:/^[a-z0-9]+(?:-[a-z0-9]+)*$/', Rule::unique('articles', 'slug')->ignore($id)],
'summary' => ['nullable', 'string', 'max:255'],
'body' => ['required', 'string'],
'status' => ['required', 'in:draft,published'],
]);
$data['body'] = HtmlSanitizer::clean($data['body']);
if ($data['status'] === 'published') {
$data['published_at'] = now();
}
return $data;
}
private function bannerData(Request $request): array
{
return $request->validate([
'title' => ['required', 'string', 'max:120'],
'image' => ['nullable', 'string', 'max:500'],
'link' => ['nullable', 'string', 'max:500'],
'sort' => ['nullable', 'integer'],
'starts_at' => ['nullable', 'date'],
'ends_at' => ['nullable', 'date'],
'status' => ['required', 'in:published,hidden'],
]);
}
private function navData(Request $request): array
{
return $request->validate([
'group_name' => ['required', 'in:header,footer'],
'title' => ['required', 'string', 'max:80'],
'link' => ['required', 'string', 'max:500'],
'sort' => ['nullable', 'integer'],
'status' => ['required', 'in:published,hidden'],
]);
}
}
@@ -0,0 +1,89 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin;
use App\Http\Controllers\Controller;
use App\Models\AuditLog;
use App\Models\Plan;
use App\Models\User;
use App\Services\AuthService;
use App\Services\MembershipService;
use App\Support\Presenter;
use Illuminate\Http\Request;
class PeopleController extends Controller
{
public function __construct(
private readonly MembershipService $membership,
private readonly AuthService $auth,
) {}
public function users(Request $request)
{
$query = User::query()->with('identities', 'subscription.plan');
if ($keyword = trim((string) $request->query('q', ''))) {
$like = '%'.addcslashes($keyword, '%_\\').'%';
$query->where(function ($q) use ($like) {
$q->where('nickname', 'like', $like)
->orWhereHas('identities', fn ($identity) => $identity->where('identifier', 'like', $like));
});
}
$page = $query->latest()->paginate(15);
return $this->ok([
'items' => collect($page->items())->map(fn (User $user) => Presenter::user($user, true))->values(),
'total' => $page->total(),
'page' => $page->currentPage(),
]);
}
public function updateUser(Request $request, User $user)
{
$data = $request->validate([
'status' => ['required', 'in:active,disabled'],
'disabled_reason' => ['nullable', 'string', 'max:255'],
]);
if ($user->id === $request->user()->id && $data['status'] !== 'active') {
return response()->json(['message' => '不能停用当前登录账号', 'code' => 'self'], 422);
}
$user->update($data);
if ($data['status'] !== 'active') {
$this->auth->revokeTokens($user);
}
$this->audit($request->user(), 'user.update', $user, '更新用户状态 '.$user->nickname);
return $this->ok(Presenter::user($user->refresh(), true));
}
public function grant(Request $request, User $user)
{
$data = $request->validate([
'plan_code' => ['required', 'string'],
'days' => ['required', 'integer', 'min:0', 'max:3650'],
]);
if ($data['days'] === 0) {
$this->membership->stop($user);
$this->audit($request->user(), 'membership.stop', $user, '停用会员 '.$user->nickname);
return $this->ok(Presenter::user($user->refresh(), true), '会员已停用');
}
$plan = Plan::query()->where('code', $data['plan_code'])->firstOrFail();
$this->membership->grant($user, $plan, now()->addDays($data['days']));
$this->audit($request->user(), 'membership.grant', $user, '开通 '.$plan->name.' '.$data['days'].' 天');
return $this->ok(Presenter::user($user->refresh(), true), '会员已开通');
}
public function audits()
{
$rows = AuditLog::query()->with('actor:id,nickname')->latest()->limit(100)->get();
return $this->ok($rows->map(fn (AuditLog $row) => [
'id' => $row->id,
'action' => $row->action,
'summary' => $row->summary,
'actor' => $row->actor?->nickname,
'created_at' => $row->created_at?->toIso8601String(),
]));
}
}
@@ -0,0 +1,123 @@
<?php
namespace App\Http\Controllers\Api\V1\Admin;
use App\Http\Controllers\Controller;
use App\Models\LoginLog;
use App\Models\OauthClient;
use App\Models\Order;
use App\Models\ServiceTicket;
use App\Models\Setting;
use App\Models\Subscription;
use App\Models\ToolOpenLog;
use App\Models\User;
use App\Support\Settings;
use Illuminate\Http\Request;
use Illuminate\Support\Str;
use Illuminate\Validation\Rule;
class SystemController extends Controller
{
public function dashboard()
{
return $this->ok([
'users' => User::query()->count(),
'members' => Subscription::query()->where('status', 'active')->where('ends_at', '>', now())->count(),
'logins_today' => LoginLog::query()->where('success', true)->where('created_at', '>=', today())->count(),
'opens_today' => ToolOpenLog::query()->where('created_at', '>=', today())->count(),
'pending_orders' => Order::query()->where('status', 'pending')->count(),
'open_tickets' => ServiceTicket::query()->whereIn('status', ['pending', 'quoted', 'doing', 'checking'])->count(),
]);
}
public function clients()
{
return $this->ok(OauthClient::query()->with('tool:id,name')->latest()->get()->map(fn (OauthClient $client) => $this->clientPayload($client)));
}
public function storeClient(Request $request)
{
$data = $this->clientData($request);
$secret = Str::random(32);
$client = OauthClient::query()->create($data + ['secret_hash' => hash('sha256', $secret)]);
$this->audit($request->user(), 'client.create', $client, '新建客户端 '.$client->name);
return $this->ok($this->clientPayload($client) + ['secret' => $secret], '密钥只显示一次');
}
public function updateClient(Request $request, OauthClient $client)
{
$client->update($this->clientData($request, $client->id));
$this->audit($request->user(), 'client.update', $client, '更新客户端 '.$client->name);
return $this->ok($this->clientPayload($client));
}
public function resetSecret(Request $request, OauthClient $client)
{
$secret = Str::random(32);
$client->update(['secret_hash' => hash('sha256', $secret)]);
$this->audit($request->user(), 'client.secret', $client, '重置客户端密钥 '.$client->name);
return $this->ok(['secret' => $secret], '新密钥只显示一次');
}
public function settings()
{
return $this->ok(Setting::query()->orderBy('key')->get());
}
public function updateSettings(Request $request)
{
$data = $request->validate([
'items' => ['required', 'array'],
'items.site_name' => ['nullable', 'string', 'max:40'],
'items.site_description' => ['nullable', 'string', 'max:255'],
'items.icp' => ['nullable', 'string', 'max:80'],
'items.grace_days' => ['nullable', 'integer', 'min:0', 'max:30'],
'items.sms_register_creates_user' => ['nullable', 'in:0,1'],
'items.mail_enabled' => ['nullable', 'in:0,1'],
]);
foreach ($data['items'] as $key => $value) {
Setting::query()->updateOrCreate(['key' => $key], ['value' => (string) $value]);
}
Settings::flush();
$this->audit($request->user(), 'settings.update', null, '更新系统设置');
return $this->ok(Setting::query()->orderBy('key')->get(), '设置已保存');
}
private function clientData(Request $request, ?int $id = null): array
{
$data = $request->validate([
'name' => ['required', 'string', 'max:80'],
'client_id' => ['required', 'regex:/^[a-z0-9_\-]+$/', Rule::unique('oauth_clients', 'client_id')->ignore($id)],
'redirect_uris' => ['required', 'array', 'min:1'],
'redirect_uris.*' => ['url', 'max:500'],
'logout_uris' => ['nullable', 'array'],
'logout_uris.*' => ['url', 'max:500'],
'tool_id' => ['nullable', 'integer', 'exists:tools,id'],
'is_first_party' => ['required', 'boolean'],
'is_public' => ['required', 'boolean'],
'status' => ['required', 'in:active,disabled'],
]);
return $data;
}
private function clientPayload(OauthClient $client): array
{
return [
'id' => $client->id,
'name' => $client->name,
'client_id' => $client->client_id,
'redirect_uris' => $client->redirect_uris,
'logout_uris' => $client->logout_uris ?? [],
'tool_id' => $client->tool_id,
'tool_name' => $client->tool?->name,
'is_first_party' => $client->is_first_party,
'is_public' => $client->is_public,
'status' => $client->status,
];
}
}
@@ -0,0 +1,116 @@
<?php
namespace App\Http\Controllers\Api\V1;
use App\Http\Controllers\Controller;
use App\Services\AuthService;
use App\Support\Presenter;
use Illuminate\Http\Request;
class AuthController extends Controller
{
public function __construct(private readonly AuthService $auth) {}
public function publicKey()
{
return $this->ok(['pem' => $this->auth->publicKeyPem()]);
}
public function captcha()
{
return $this->ok($this->auth->captcha());
}
public function sendCode(Request $request)
{
$data = $request->validate([
'scene' => ['required', 'in:register,login,reset,bind'],
'channel' => ['required', 'in:sms,email'],
'account' => ['required', 'string', 'max:191'],
]);
return $this->ok($this->auth->sendCode($data['scene'], $data['channel'], $data['account'], (string) $request->ip()));
}
public function register(Request $request)
{
$data = $request->validate([
'channel' => ['required', 'in:sms,email'],
'account' => ['required', 'string'],
'code' => ['required', 'string'],
'password' => ['required', 'string'],
'nickname' => ['nullable', 'string', 'max:40'],
]);
$user = $this->auth->register(
$data['channel'],
$data['account'],
$data['code'],
$this->auth->decrypt($data['password']),
$data['nickname'] ?? null,
$request
);
return $this->ok(Presenter::user($user), '注册成功');
}
public function login(Request $request)
{
$data = $request->validate([
'account' => ['required', 'string'],
'password' => ['required', 'string'],
'captcha_key' => ['nullable', 'string'],
'captcha_code' => ['nullable', 'string'],
]);
$user = $this->auth->loginWithPassword(
$data['account'],
$this->auth->decrypt($data['password']),
$data['captcha_key'] ?? null,
$data['captcha_code'] ?? null,
$request
);
return $this->ok(Presenter::user($user), '登录成功');
}
public function loginSms(Request $request)
{
$data = $request->validate([
'account' => ['required', 'string'],
'code' => ['required', 'string'],
]);
$user = $this->auth->loginWithSms($data['account'], $data['code'], $request);
return $this->ok(Presenter::user($user), '登录成功');
}
public function forgot(Request $request)
{
$data = $request->validate([
'account' => ['required', 'string'],
'code' => ['required', 'string'],
'password' => ['required', 'string'],
]);
$this->auth->resetPassword($data['account'], $data['code'], $this->auth->decrypt($data['password']));
return $this->ok(null, '密码已重置');
}
public function logout(Request $request)
{
$this->auth->logout($request, true);
return $this->ok(null, '已退出');
}
public function me(Request $request)
{
$user = $request->user();
if (! $user) {
return response()->json(['message' => '未登录', 'code' => 'unauthenticated', 'data' => null], 401);
}
$session = $user->sessions()->where('session_id', $request->session()->getId())->first();
$session?->update(['last_seen_at' => now()]);
return $this->ok(Presenter::user($user));
}
}
@@ -0,0 +1,255 @@
<?php
namespace App\Http\Controllers\Api\V1;
use App\Http\Controllers\Controller;
use App\Models\Agreement;
use App\Models\Article;
use App\Models\Banner;
use App\Models\Category;
use App\Models\HomeSection;
use App\Models\Navigation;
use App\Models\Plan;
use App\Models\Tool;
use App\Models\UserToolOpen;
use App\Support\Presenter;
use App\Support\Settings;
use Illuminate\Http\Request;
class PortalController extends Controller
{
public function meta()
{
$categories = Category::query()
->with(['children' => fn ($q) => $q->where('status', 'published')])
->whereNull('parent_id')
->where('status', 'published')
->where('show_in_nav', true)
->orderByDesc('sort')
->orderBy('id')
->get();
return $this->ok([
'site_name' => Settings::get('site_name', '轻舟'),
'description' => Settings::get('site_description', ''),
'icp' => Settings::get('icp', ''),
'mail_enabled' => Settings::bool('mail_enabled'),
'nav' => $this->nav('header'),
'footer' => $this->nav('footer'),
'categories' => $categories->map(fn (Category $category) => $this->categoryNode($category)),
]);
}
public function home()
{
$sections = HomeSection::query()
->with(['tools' => fn ($q) => $q->published()->with('tags')])
->where('status', 'published')
->orderByDesc('sort')
->orderBy('id')
->get();
$banners = Banner::query()->where('status', 'published')
->where(function ($q) {
$q->whereNull('starts_at')->orWhere('starts_at', '<=', now());
})
->where(function ($q) {
$q->whereNull('ends_at')->orWhere('ends_at', '>=', now());
})
->orderByDesc('sort')->get();
$announcement = Article::query()->published()->where('type', 'announcement')->latest('published_at')->first();
return $this->ok([
'sections' => $sections->map(fn (HomeSection $section) => [
'id' => $section->id,
'title' => $section->title,
'slug' => $section->slug,
'tools' => $section->tools->take($section->display_limit)->map(fn (Tool $tool) => Presenter::toolCard($tool))->values(),
]),
'banners' => $banners->map(fn (Banner $banner) => [
'id' => $banner->id,
'title' => $banner->title,
'image' => $banner->image,
'link' => $banner->link,
]),
'announcement' => $announcement ? [
'title' => $announcement->title,
'slug' => $announcement->slug,
'summary' => $announcement->summary,
] : null,
]);
}
public function category(Request $request, string $slug)
{
$category = Category::query()->with('children')->where('slug', $slug)->where('status', 'published')->firstOrFail();
$ids = $category->children->pluck('id')->push($category->id);
$query = Tool::query()->published()->with('tags')->whereHas('categories', fn ($q) => $q->whereIn('categories.id', $ids));
$this->applySort($query, (string) $request->query('sort', 'recommend'));
$page = $query->paginate(24);
return $this->ok([
'category' => $this->categoryNode($category),
'items' => collect($page->items())->map(fn (Tool $tool) => Presenter::toolCard($tool))->values(),
'total' => $page->total(),
'page' => $page->currentPage(),
'per_page' => $page->perPage(),
]);
}
public function tool(string $slug)
{
$tool = Tool::query()->published()->with('tags', 'categories')->where('slug', $slug)->firstOrFail();
$related = Tool::query()->published()->with('tags')
->whereKeyNot($tool->id)
->whereHas('categories', fn ($q) => $q->whereIn('categories.id', $tool->categories->pluck('id')))
->limit(4)
->get();
return $this->ok(Presenter::toolDetail($tool) + [
'related' => $related->map(fn (Tool $item) => Presenter::toolCard($item))->values(),
]);
}
public function go(string $slug)
{
$tool = Tool::query()->published()->where('slug', $slug)->where('type', 'link')->firstOrFail();
$tool->increment('clicks');
return redirect()->away($tool->open_url);
}
public function search(Request $request)
{
$keyword = trim((string) $request->query('q', ''));
$scope = (string) $request->query('scope', 'tools');
$like = '%'.addcslashes($keyword, '%_\\').'%';
if ($scope === 'help') {
$query = Article::query()->published()->where('type', 'help');
if ($keyword !== '') {
$query->where(fn ($q) => $q->where('title', 'like', $like)->orWhere('summary', 'like', $like));
}
$page = $query->latest('published_at')->paginate(24);
return $this->ok([
'items' => collect($page->items())->map(fn (Article $article) => [
'title' => $article->title,
'slug' => $article->slug,
'summary' => $article->summary,
])->values(),
'total' => $page->total(),
'page' => $page->currentPage(),
'per_page' => $page->perPage(),
]);
}
if ($scope === 'recent') {
$user = $request->user();
if (! $user) {
return response()->json(['message' => '请先登录', 'code' => 'unauthenticated'], 401);
}
$opens = UserToolOpen::query()->with('tool.tags')->where('user_id', $user->id)->orderByDesc('last_opened_at')->get();
$items = $opens->filter(function (UserToolOpen $open) use ($keyword) {
return $open->tool && $open->tool->status === 'published'
&& ($keyword === '' || str_contains($open->tool->name, $keyword) || str_contains($open->tool->summary, $keyword));
})->map(fn (UserToolOpen $open) => Presenter::toolCard($open->tool))->values();
return $this->ok(['items' => $items, 'total' => $items->count(), 'page' => 1, 'per_page' => $items->count()]);
}
$query = Tool::query()->published()->with('tags');
if ($keyword !== '') {
$query->where(function ($q) use ($like) {
$q->where('name', 'like', $like)
->orWhere('summary', 'like', $like)
->orWhereHas('tags', fn ($tag) => $tag->where('name', 'like', $like));
});
}
$page = $query->orderByDesc('is_recommended')->orderByDesc('sort')->paginate(24);
$hot = $page->total() === 0
? Tool::query()->published()->with('tags')->orderByDesc('is_recommended')->limit(8)->get()
: collect();
return $this->ok([
'items' => collect($page->items())->map(fn (Tool $tool) => Presenter::toolCard($tool))->values(),
'hot' => $hot->map(fn (Tool $tool) => Presenter::toolCard($tool))->values(),
'total' => $page->total(),
'page' => $page->currentPage(),
'per_page' => $page->perPage(),
]);
}
public function plans()
{
$plans = Plan::query()->with('entitlements')->where('status', 'published')->orderByDesc('sort')->orderBy('id')->get();
return $this->ok($plans->map(fn (Plan $plan) => Presenter::plan($plan))->values());
}
public function articles(Request $request)
{
$type = (string) $request->query('type', 'help');
$items = Article::query()->published()->where('type', $type)->latest('published_at')->get();
return $this->ok($items->map(fn (Article $article) => [
'title' => $article->title,
'slug' => $article->slug,
'summary' => $article->summary,
'published_at' => $article->published_at?->toIso8601String(),
])->values());
}
public function article(string $slug)
{
$article = Article::query()->published()->where('slug', $slug)->firstOrFail();
return $this->ok([
'title' => $article->title,
'slug' => $article->slug,
'summary' => $article->summary,
'body' => $article->body,
'type' => $article->type,
'published_at' => $article->published_at?->toIso8601String(),
]);
}
public function agreement(string $type)
{
$agreement = Agreement::query()->where('type', $type)->firstOrFail();
return $this->ok([
'type' => $agreement->type,
'title' => $agreement->title,
'body' => $agreement->body,
]);
}
private function nav(string $group): array
{
return Navigation::query()->where('group_name', $group)->where('status', 'published')->orderByDesc('sort')->get()
->map(fn (Navigation $item) => ['title' => $item->title, 'link' => $item->link])->all();
}
private function categoryNode(Category $category): array
{
return [
'id' => $category->id,
'name' => $category->name,
'slug' => $category->slug,
'icon' => $category->icon,
'children' => $category->children->map(fn (Category $child) => [
'id' => $child->id,
'name' => $child->name,
'slug' => $child->slug,
'icon' => $child->icon,
])->values(),
];
}
private function applySort($query, string $sort): void
{
match ($sort) {
'latest' => $query->orderByDesc('published_at'),
'name' => $query->orderBy('name'),
default => $query->orderByDesc('is_recommended')->orderByDesc('sort'),
};
}
}