From 4ae46d12a94dc2a360aa2fdf8b366f87f00dde8e Mon Sep 17 00:00:00 2001
From: "OHASHI, Norikazu" <katz@neko-mori.sakura.ne.jp>
Date: Thu, 18 Apr 2019 23:00:33 +0900
Subject: [PATCH] =?utf8?q?POST=E3=83=91=E3=83=A9=E3=83=A1=E3=83=BC?=
 =?utf8?q?=E3=82=BF=E3=82=92=20YARD=20=E3=81=A7=E8=A8=98=E8=BC=89=E3=81=99?=
 =?utf8?q?=E3=82=8B=E3=82=88=E3=81=86=E3=81=AB=E5=AF=BE=E5=BF=9C=20?=
 =?utf8?q?=E3=83=86=E3=83=BC=E3=83=96=E3=83=AB=E8=A8=AD=E8=A8=88=E3=81=AE?=
 =?utf8?q?=E8=A6=8B=E7=9B=B4=E3=81=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

---
 .yardopts                          |  4 ++++
 readme.md                          | 18 ++++++++++++------
 sinatra/app/controllers/web_gui.rb | 14 ++++++--------
 sinatra/app/models/users_db.rb     |  5 +++++
 4 files changed, 27 insertions(+), 14 deletions(-)
 create mode 100644 .yardopts

diff --git a/.yardopts b/.yardopts
new file mode 100644
index 0000000..4b7b288
--- /dev/null
+++ b/.yardopts
@@ -0,0 +1,4 @@
+--plugin yard-sinatra
+--type-name-tag post_param:"POST parameters"
+-
+readme.md
diff --git a/readme.md b/readme.md
index 3f16d8d..1df7530 100644
--- a/readme.md
+++ b/readme.md
@@ -63,11 +63,17 @@
 |  5 | orignal_author | VARCHAR(127) | | 原著者 |
 |  6 | translator | VARCHAR(127) | | 翻訳者 |
 |  7 | publisher | VARCHAR(127) | | 出版社 |
-|  8 | summary | VARCHAR(511) | | 概要 |
-|  9 | book_shadow | BLOB | | 書影 |
-| 10 | user_id | INTEGER | NOT NULL | ユーザID |
-| 11 | rank | INTEGER | | 評価
-| 12 | creat_at | DATETIME | NOT NULL | 登録日時 |
-| 13 | update_at | DATETIME | NOT NULL | 更新日時 |
+|  8 | book_shadow | TEXT | | 書影(URL) |
+|  9 | creat_at | DATETIME | NOT NULL | 登録日時 |
+| 10 | update_at | DATETIME | NOT NULL | 更新日時 |
 
+### 蔵書管理テーブル (book\_collections)
+| 項番 | カラム名 | 型 | 属性 | 概要 |
+| --: | --- | --- | --- | --- |
+|  1 | isbn | VARCHAR(14) | NOT NULL | ISBNコード |
+|  2 | user_id | INTEGER | NOT NULL | ユーザID |
+|  3 | summary | TEXT | | 概要 |
+|  4 | rank | INTEGER | | 評価 |
+|  5 | creat_at | DATETIME | NOT NULL | 登録日時 |
+|  6 | update_at | DATETIME | NOT NULL | 更新日時 |
 注： isdn + user_id で複合キーとする。
diff --git a/sinatra/app/controllers/web_gui.rb b/sinatra/app/controllers/web_gui.rb
index fc63bad..5238d77 100644
--- a/sinatra/app/controllers/web_gui.rb
+++ b/sinatra/app/controllers/web_gui.rb
@@ -48,11 +48,10 @@ class WebGui < Sinatra::Base
   end
 
   # サインアップページ(POST)
-  # @note POST パラメータ：
-  #   name [String] ログインユーザ名,
-  #   full_name [String] フルネーム,
-  #   email [String] Eメール,
-  #   passwd [String] パスワード
+  # @post_param name [String] ログインユーザ名
+  # @post_param full_name [String] フルネーム
+  # @post_param email [String] Eメール
+  # @post_param passwd [String] パスワード
   # @raise [WebError] サイアップ失敗
   post '/signup' do
     name = params[:name]
@@ -77,9 +76,8 @@ class WebGui < Sinatra::Base
   end
 
   # ログインページ(POST)
-  # @note POST パラメータ:
-  #   name [String] ログインユーザ名,
-  #   passwd [String] パスワード
+  # @post_param name [String] ログインユーザ名,
+  # @post_param passwd [String] パスワード
   # @raise [WebError] ログイン失敗
   post '/login' do
     name = params[:name]
diff --git a/sinatra/app/models/users_db.rb b/sinatra/app/models/users_db.rb
index 90e7e7c..9018393 100644
--- a/sinatra/app/models/users_db.rb
+++ b/sinatra/app/models/users_db.rb
@@ -13,6 +13,10 @@ ActiveRecord::Base.establish_connection(:development)
 
 # ユーザ情報
 class User < ActiveRecord::Base
+  # ユーザアカウントを作成
+  # @param [Symbol] key カラム名
+  # @param [String] pattern 正規表現パターン
+  # @return [Array<User>] すでにユーザ情報を登録済み
   def self.with_regexp(key, pattern)
     column = columns_hash[key.to_s].name
     where("`#{table_name}`.`#{column}` REGEXP ?", pattern)
@@ -25,6 +29,7 @@ class UserAccount
   # ユーザロール
   ROLE_ADMIN  = 0  #管理者権限
   ROLE_NORMAL = 8  #一般権限
+  ROLE_FORGOT = 10 #パスワード忘れ中
   
   # ユーザ認証エラー
   class AuthenticationError < SecurityError
-- 
2.19.2