yellow-bank-soal/FASTAPI_ADMIN_1.0.4_MIGRATION.md

FastAPI Admin 1.0.4 Migration Guide

Date: March 22, 2026 Status: In Progress - Needs Completion Priority: High (Blocking Deployment)

---

Problem

The requirements.txt specified fastapi-admin>=1.4.0 but only version 1.0.4 is available on PyPI. The API between these versions is completely different, causing multiple AttributeError crashes on startup.

---

What's Been Fixed (Partially)

1. inputs.Select - Line 135, 141, 147, 189, 223, 255, 285, 350

Before (1.4.0 API):

input_=inputs.Select(options=["ctt", "irt", "hybrid"], default="ctt")

After (1.0.4 API):

input_=inputs.Select(default="ctt")  # No 'options' parameter

Fix Applied: ✅ Yes (via sed)

---

2. displays.Select - Multiple lines

Before:

display=displays.Select(choices=["ctt", "irt", "hybrid"])

After:

display=displays.Display()  # Select doesn't exist

Fix Applied: ✅ Yes (via sed)

---

3. displays.DateTime - Multiple lines

Before:

display=displays.DateTime()

After:

display=displays.DatetimeDisplay()  # Note the capital 'D' and lowercase 'i'

Fix Applied: ✅ Yes (via sed)

---

4. displays.Text - Line 230+

Before:

display=displays.Text(maxlen=100)

After:

display=displays.Display()  # Text doesn't exist

Fix Applied: ✅ Yes (via sed)

---

What Still Needs Fixing

5. admin_app.settings - Lines 602-606

Current Error:

AttributeError: 'FastAPIAdmin' object has no attribute 'settings'

Current Code (Lines 600-610):

# Configure admin app
admin_app.settings.logo_url = "/static/logo.png"
admin_app.settings.site_title = "IRT Bank Soal Admin"
admin_app.settings.site_description = "Admin Panel for Adaptive Question Bank System"

# Register authentication provider
admin_app.settings.auth_provider = AdminAuthProvider()

Needs Investigation: Check how to configure FastAPIAdmin in 1.0.4:

python3 -c "from fastapi_admin.app import app; print(dir(app))"

Likely need to pass settings during initialization or use a different configuration method.

---

6. Custom Link Resources - Lines 617-620

Current Code:

# Register dashboard links
admin_app.register(CalibrationDashboardLink)
admin_app.register(ItemStatisticsLink)
admin_app.register(SessionOverviewLink)

Needs Investigation: Check if Link resource type exists in 1.0.4 and if admin_app.register() works the same way.

---

Available Classes in 1.0.4

fastapi_admin.widgets.inputs

Color, Date, DateTime, DisplayOnly, Editor, Email, Enum, File, FileUpload,
ForeignKey, Image, Input, Json, List, ManyToMany, Model, Number, Password,
Radio, RadioEnum, Select, Switch, Text, TextArea

Note: Select only accepts: help_text, default, null, disabled

fastapi_admin.widgets.displays

Boolean, DateDisplay, DatetimeDisplay, Display, Image, InputOnly, Json

Note: No Select, Text, Number - use Display instead

---

Commands to Complete Migration

Step 1: Check FastAPIAdmin available attributes

cd /www/wwwroot/irt-bank-soal
source venv/bin/activate
python3 -c "from fastapi_admin.app import app; print([x for x in dir(app) if not x.startswith('_')])"

Step 2: Read the create_admin_app function

sed -n '590,630p' /www/wwwroot/irt-bank-soal/app/admin.py

Step 3: Check how to initialize FastAPIAdmin properly

Look at fastapi-admin 1.0.4 documentation or source code to understand:

• How to set logo_url
• How to set site_title
• How to set site_description
• How to register auth provider
• How to register resources

Step 4: Fix the admin configuration

Rewrite create_admin_app() function to use 1.0.4 API

Step 5: Test

pm2 restart irt-bank-soal
sleep 3
pm2 logs irt-bank-soal --lines 10
curl http://127.0.0.1:8000/

---

Quick Fix Option (Disable Admin Panel)

If admin panel is not immediately needed, temporarily disable it:

In app/main.py line 19:

# Temporarily disabled for 1.0.4 migration
# from app.admin import admin as admin_app
admin_app = None

And comment out the mounting code:

# if admin_app:
#     app.mount("/admin", admin_app)

This allows the main API to run while admin panel is being fixed.

---

Files Modified

File	Status
requirements.txt	Changed fastapi-admin>=1.4.0 to fastapi-admin>=1.0.0
app/admin.py	Partially fixed (inputs.Select, displays.*)

---

Remaining Tasks

• Fix admin_app.settings configuration
• Verify admin_app.register() works for Model resources
• Verify Link resources work
• Test admin panel at /admin endpoint
• Document final working configuration

---

Reference: Full Admin File

To see the full admin.py file:

cat /www/wwwroot/irt-bank-soal/app/admin.py

---

Document End

Next Agent: Complete the admin configuration fix and verify the app starts successfully.