# -*- coding: utf-8 -*-
"""lab06_sqlalchemy_crud · 第5章 数据库存储（端口 5115）

本节重点（对应教材配套 PPT，授课：谢福财）：
    - 模型即表：class Student(db.Model) 映射到 students 表
    - 建表：db.create_all() 第一次运行时创建
    - 增删改查：db.session.add / delete / commit 与 query 系列
    - 分页：db.paginate(page, per_page) 与模板里的上一页/下一页
    - SQLite 落盘：sqlite:///students.db 相对路径的注意事项

运行：
    ..\\.venv\\Scripts\\python.exe app.py      # 或双击 run.bat / PyCharm 点绿三角
    浏览器打开 http://127.0.0.1:5115/

说明：本文件每一段都有注释；带 ★ 的行是这一讲要重点看的代码。
"""

import os

from flask import Flask, render_template, request, redirect, url_for, flash
from flask_sqlalchemy import SQLAlchemy
from flask_bootstrap import Bootstrap5

BASE = os.path.dirname(os.path.abspath(__file__))

app = Flask(__name__)
app.config['SECRET_KEY'] = 'shefucai-classroom'
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///' + os.path.join(BASE, 'students.db')  # SQLite 文件库
app.config['BOOTSTRAP_SERVE_LOCAL'] = True

db = SQLAlchemy(app)      # ① 初始化：拿到 db 对象（模型基类/会话/引擎全在它身上）
Bootstrap5(app)


# ② 通用模型基类（教材 5.3 的 BaseModel）：统一 __repr__，print 出来一眼看清字段
class BaseModel:
    """所有模型都继承它，省得每个类重写一遍 __repr__"""

    def __repr__(self):
        fields = []
        for k, v in self.__dict__.items():
            if k.startswith('_'):            # 跳过 SQLAlchemy 内部属性（_sa_instance_state 等）
                continue
            if isinstance(v, BaseModel):     # 关联对象只显示类型，避免无限递归
                fields.append(f'{k}=<{v.__class__.__name__} ...>')
            elif isinstance(v, str):
                fields.append(f"{k}='{v}'")
            else:
                fields.append(f'{k}={v!r}')
        return f'<{self.__class__.__name__} {" ".join(fields)}>'


# ③ 定义模型：一个类 = 一张表，一个属性 = 一个字段
class Student(BaseModel, db.Model):   # ⚠ 基类必须写在 db.Model 前面
    __tablename__ = 'students'                       # 表名
    id = db.Column(db.Integer, primary_key=True)     # 主键自增
    name = db.Column(db.String(20), nullable=False)  # 姓名，非空
    cls = db.Column(db.String(10), default='软件1班')  # 班级，默认值
    score = db.Column(db.Float)                      # 成绩


# ④ Shell 上下文：flask shell 进去后 db / Student 直接能用，不用手写 import
#    教材第五章用 flask_script 的 make_shell_context()，新版用这个装饰器
@app.shell_context_processor
def make_shell_context():
    return {'db': db, 'Student': Student}


def seed():
    """首次运行灌 12 条示例数据"""
    with app.app_context():
        db.create_all()                              # 建表（存在则跳过）
        if Student.query.count() == 0:
            names = ['张晓勇', '李梅', '王强', '赵敏', '刘洋', '陈静',
                     '杨帆', '周婷', '孙浩', '林小芳', '黄成', '吴丹']
            for i, n in enumerate(names):
                db.session.add(Student(name=n, score=60 + i * 3))   # add 进会话
            db.session.commit()                      # commit 才真正写库


# ⑤ 查询 + 分页列表
# ★ 本节重点：学生列表（分页查询）
@app.route('/')
def index():
    page = request.args.get('page', 1, type=int)     # 当前页码（?page=2）
    pg = db.paginate(db.select(Student).order_by(Student.id),  # 3.x 写法
                     page=page, per_page=5, error_out=False)    # 每页5条
    return render_template('index.html', pg=pg)


# ⑥ 增：表单提交 → add + commit
# ★ 本节重点：新增一条学生（POST 后重定向回列表）
@app.route('/add', methods=['POST'])
def add():
    name = request.form.get('name', '').strip()
    score = request.form.get('score', type=float)
    if not name:
        flash('姓名不能为空')
    else:
        db.session.add(Student(name=name, score=score))
        db.session.commit()
        flash(f'已添加：{name}')
    return redirect(url_for('index'))


# ⑦ 删：按主键删一条
@app.route('/del/<int:sid>')
def dele(sid):
    s = db.get_or_404(Student, sid)                  # 3.x 写法：按主键取，没有则404
    db.session.delete(s)
    db.session.commit()
    flash(f'已删除：{s.name}')
    return redirect(url_for('index'))


if __name__ == '__main__':
    seed()
    app.run(debug=True, port=5115)
