core.urls

 1"""
 2URL configuration for core project.
 3
 4The `urlpatterns` list routes URLs to views. For more information please see:
 5    https://docs.djangoproject.com/en/5.1/topics/http/urls/
 6Examples:
 7Function views
 8    1. Add an import:  from my_app import views
 9    2. Add a URL to urlpatterns:  path('', views.home, name='home')
10Class-based views
11    1. Add an import:  from other_app.views import Home
12    2. Add a URL to urlpatterns:  path('', Home.as_view(), name='home')
13Including another URLconf
14    1. Import the include() function: from django.urls import include, path
15    2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
16"""
17from django.conf import settings
18from django.contrib import admin
19from django.urls import path, include
20from rest_framework.authtoken.views import obtain_auth_token
21from drf_spectacular.views import SpectacularAPIView, SpectacularRedocView, SpectacularSwaggerView
22from accounts import views
23from django.conf.urls.static import static
24
25urlpatterns = [
26    path('admin/', admin.site.urls),
27    path('accounts/', include('accounts.urls')),
28    path('api/token-auth/', views.CustomAuthToken.as_view(), name='custom_token_auth'),
29    path('api/token-auth/logout/', views.LogoutView.as_view(), name='custom_token_logout'),
30    path('api/refresh-user/', views.RefreshUserView.as_view(), name='refresh_user'),
31    path('', include('app.infrastructure.urls')),
32    path('', include('app.memos.urls')),
33    # drf-spectacular docs endpoints
34    path('api/docs/schema/', SpectacularAPIView.as_view(), name='schema'),
35    path('api/docs/schema/swagger-ui/', SpectacularSwaggerView.as_view(url_name='schema'), name='swagger-ui'),
36    path('api/docs/schema/redoc/', SpectacularRedocView.as_view(url_name='schema'), name='redoc'),
37] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
38
39"""
40Core URL patterns:
41
42- /admin/                                 : Django admin site
43- /accounts/                              : Accounts app URLs (admin dashboard, hospital/user management)
44- /api/token-auth/                        : Custom authentication token API
45- /api/token-auth/logout/                 : Logout API
46- /api/refresh-user/                      : Refresh user token API
47- /api/                                   : Infrastructure and memos API endpoints
48- /api/docs/schema/                       : OpenAPI schema (drf-spectacular)
49- /api/docs/schema/swagger-ui/            : Swagger UI for API docs
50- /api/docs/schema/redoc/                 : Redoc UI for API docs
51
52All endpoints are documented for OpenAPI generation via drf-spectacular.
53"""