Add posts from wiki

_posts/2013-10-29-reportlab-101.md

@@ -0,0 +1,182 @@
+---
+layout: post
+type:   handbook
+title:  "ReportLab 101"
+date:   2013-10-29
+tags: coding pdf reportlab
+---
+
+## Style
+
+เราจะใช้เพียงแค่ font TH Sarabun New ครับ โดยจะมีให้เลือกแค่ 2 แบบ:-
+
+* TH Sarabun New
+* TH Sarabun New Bold
+
+ส่วนแต่ละส่วนนั้น สามารถจัดการ style โดยการออกแบบ Style ของแต่ละส่วนก่อน เช่น ให้หัวกระดาษเป็นอย่างนึง, เนื้อหาอย่างนึง, ในตารางอีกแบบนึง, คำอธิบายใต้ตารางอีกแบบนึง เป็นต้น พยายามจัดการให้มันไม่ต้องมีแบบมาก เพราะ (1)ง่ายต่อการอ่าน code (2)ง่ายต่อต่อการแก้ไข (3)ไม่ฟุ่มเฟือย
+
+เท่าที่ดูวิธีที่ง่ายที่สุดคือ ใช้ `ParagraphStyle` โดยเราสามารถจัดการได้โดย `import ParagraphStyle` ด้านบนของ file ก่อน
+
+    from core.views.pdfs import Paragraph, ParagraphStyle
+
+จากนั้นเราก็จะสามารถกำหนด style ของตัวเองได้
+
+    style_x1 = ParagraphStyle(name="style_name", 
+                           fontName='TH Sarabun New',
+                           fontSize=16,
+                           alignment=TA_CENTER,
+                           leading=16,
+                           spaceAfter=8,)
+
+`name="xxx"` เป็นสิ่งที่จำเป็นสำหรับ `ParagraphStyle` นอกนั้นก็กำหนดตามต้องการ ตรง `TA_CENTER` แปลว่า ให้มันอยู่ตรงกลาง ซึ่งก็ยังมี `TA_LEFT`, `TA_RIGHT`, `TA_JUSTIFY` ตามชื่อ โดยถ้าต้องการใช้ค่าพวกนี้ก็ต้อง import ด้วย เช่น
+
+    from reportlab.lib.enums import TA_CENTER, TA_LEFT
+
+ที่ผ่านมาคือ การตั้งว่า style เราจะมีอะไรบ้างต่อไปก็จะเป็นการใช้ style หลักๆแล้วเราจะใช้ Python List (ก็อารมณ์ array นั่นแหละ) ในการเก็บข้อมูลแต่ละชุดๆไป จะอารมณ์ประมาณว่า
+
+    lines = []  # เริ่ม declare list ก่อน
+    lines.append(Paragraph("บรรทัดแรก", style_x1))  # อันนี้เหมือนเพิ่ม element ใน list
+    lines.append(Paragraph("บรรทัดที่สอง", style_x1))  # อันนี้เหมือนเพิ่ม element ใน list ต่อไป
+
+เราก็จะได้ประมาณว่า
+
+                    บรรทัดแรก
+                  บรรทัดที่สอง
+
+มันจะตรงกลางนะ แต่พิมในนี้ลำบาก ก็เลยทำเป็นเป็นแค่ตัวอย่าง 
+
+### Color
+
+การกำหนดสีจากที่ใช้ `colors.lightgrey` อะไรไปก็ยังสามารถกำหนดสีเองได้โดย
+
+    from reportlab.lib.colors import Color
+    red50transparent = Color(100, 0, 0, alpha=0.5)
+
+โดย `Color(สีแดง, สีเขียว, สีฟ้า, alpha=1)` โดยแต่ละสีมีค่าตั้งแต่ 0-255 และ alpha ก็มีค่าตั้งแต 0-1 (1 คือ ทึบ, 0 คือ ใสทะลุปรุโปร่ง) จากนั้นก็เอา `red50transparent` ไปแทนที่ `colors.lightgrey` ได้เลย 
+
+### ข้อสังเกต
+
+1. การขึ้นบรรทัดใหม่ถ้าเป็น Paragraph เดียวกันมันจะตัดขึ้นบรรทัดใหม่ให้เอง โดยใช้ช่องว่างเป็นตัวตัด มันใช้ได้ดีกับภาษาอังกฤษ แต่ไม่ใช่ภาษาไทย ดังนั้นเราต้องตัดคำเองครับ ถ้าคิดว่าตัวอักษรมันมีจำนวนไม่แน่นอน เผื่อไว้เลยครับ ดีกว่ากลายเป็นฉีกคำประหลาดๆ ให้ด้านหลังว่างไว้เยอะหน่อยยังดีกว่ามาก
+1. การขึ้นบรรทัดใหม่ สามารถใช้ html tag <br/> เป็นตัวขึ้นบรรทัดใหม่ได้เลย
+1. แต่ละ Paragraph จะขึ้นบรรทัดใหม่เสมอ ค่ามันจะขึ้นกับ spaceBefore กับ spaceAfter
+
+
+## Table
+
+ตารางเป็นอีกส่วนที่มีความซับซ้อนพอสมควรในกรณีที่มี cell รวมกัน แต่ถ้าตามปกติก็ง่ายๆ ไม่มีอะไร มาดูตัวอย่างง่ายๆ แล้วค่อยไล่อธิบายบางทีอาจจะเข้าใจง่ายกว่า
+
+    data = [
+       ['top\nLeft', '10', '20', '30'],
+       ['01', '11', '21'],
+       ['02', '12', '22', '32'],
+       ['03', '13', '23', '33'],
+       ['04', '14', '24', '34'],
+    ]
+    t = Table(data, style=[
+       ('FONTNAME', (0,0), (-1,-1), 'TH Sarabun New Bold'),
+       ('GRID', (0,0), (-1,-1), 0.5 , colors.grey),
+       ('BACKGROUND',(0,0),(1,1),colors.palegreen),
+       ('SPAN',(0,0),(1,1)),
+       ('BACKGROUND',(-2,-2),(-1,-1), colors.red),
+       ('SPAN',(-2,-2),(-1,-1)),
+    ])
+    lines.append(t)
+
+data นั้นจะเป็นตัวเก็บข้อมูลไว้แสดงในตารางโดยจะเป็น list 2 หรือ 3 มิติ เรียกไม่ถูกเหมือนกัน แต่มันจะซ้อนกันอย่างนั้น โดยระดับแรกจะเป็นตัวข้อมูลแสดงของ row และระดับที่ 2 ก็คือจะเป็นตัวข้อมูลในระดับ column ของแต่ละ row โดยข้อมูลนั้นจะใช้ `Table` เป็นตัวแปลงให้เป็นตาราง (ซึ่งก็ต้อง import อีกนั่นแหละ)
+
+    from core.views.pdfs import Table
+
+หลังจากนั้นก็ต้องไปต่อใน lines เหมือนกับที่ทำกับ Paragraph ไม่มีผิดครับ ความสับสนของตารางมันจะอยู่ตรงที่ style มากกว่า มาดูผลโดยประมาณกันก่อนว่า มันจะได้ ตารางใน pdf ยังไงกันแน่ 
+
+<table class="wikitable"><tbody><tr><td style="background-color: #33dd33;" colspan="2" rowspan="2">top<p>Left</p></td><td>20</td><td>30</td></tr><tr><td>12</td><td></td></tr><tr><td>02</td><td>12</td><td>22</td><td>32</td></tr><tr><td>03</td><td>13</td><td style="background-color: #f66;" colspan="2" rowspan="2">23</td></tr><tr><td>04</td><td>14</td></tr></tbody></table>
+
+ตารางจะเริ่มที่มุมบนซ้าย -- เริ่มด้วย column 0 และ row 0 --> (0, 0) ตามที่เห็นก็สีมั่วๆนะครับ ขี้เกียจครับ อย่างที่เห็นชัดๆ คือ จะมี cell merge กันอยู่ 2 ที่ คือ
+
+1. มุมซ้ายบน ตำแหน่ง `(col, row) (0, 0)` ถึง `(1, 1)`
+1. มุมขวาล่าง ตำแหน่ง `(col, row) (2, 3)` ถึง `(3, 4)` หรือมองอีกมุม (ขวาล่าง) คือ `(-2,-2),(-1,-1)`
+
+จริงๆ ก็จะเห็นชัดเจนกว่า style มันเนี่ย ตรงที่ cell merge กัน ถูกกำหนดด้วย
+
+    ('BACKGROUND',(0,0),(1,1),colors.palegreen),
+    ('SPAN',(0,0),(1,1)),
+
+`BACKGROUND` ก็ไม่ได้เกี่ยวอะไรกับเค้า เพียงแค่บอกสีครับ SPAN เป็นตัวบอกว่า เราจะรวม cell ไหนถึงตรงไหนกันแน่ โดยข้อมูลจะเป็นข้อมูลของ cell แรกเสมอครับ 
+
+### จัดตำแหน่ง
+
+ถ้าต้องการจะจัดตำแหน่งอักษรของแต่ละ cell ก็เพิ่มใน style ของ Table ได้
+
+    ('ALIGN',(0,0),(0,0),'CENTER'),
+    ('VALIGN',(0,0),(0,0),'MIDDLE'),
+
+* `ALIGN` คือ จัดตำแหน่งแนวนอน มีค่าเป็น `LEFT`, `RIGHT`, `CENTER` -- ค่า default เป็น `LEFT`
+* `VALIGN` คือ จัดตำแหน่งแนวนอน มีค่าเป็น `TOP`, `MIDDLE`, `BOTTOM` -- ค่า default เป็น `BOTTOM`
+
+ในกรณีที่ต้องการจัดการตำแหน่งของ cell ที่มีการรวม cell กำหนดตำแหน่งแค่ cell ที่มีข้อมูล (มุมขวาบน) ก็พอ 
+
+### ข้อสังเกต
+
+1. `SPAN` สามารถกำหนด ตำแหน่งค่าติดลบได้ `('SPAN',(-2,-2),(-1,-1))` << โดยจะเป็นการคิดจากมุมขวาล่างมา ตรงข้ามกับค่าบวกที่คิดจากมุมซ้ายบน
+1. `SPAN` จะไม่สนใจข้อมูลที่อยู่ในตำแหน่งอื่นเลย นอกจากตัวมุมบนขวาของที่รวม -- ตัวอื่นจะอารมณ์ถูกทับไปเลย โดยสังเกตได้จากตัวอย่าง row ที่ 2 กลายเป็นว่า 01, 11 หายไปเลย โดยตำแหน่ง 21 ก็ไม่ได้เปลี่ยนไป
+1. ถ้า list มีไม่ครบในตาราง ตรงที่ขาดไปก็จะเป็นช่องว่าง
+1. การขึ้นบรรทัดใหม่ในตารางใช้ escape key `\n` ไม่ใช่ `<br/>` เหมือนใน `Paragraph`
+1. พวก `SPAN` ใน style ไม่ได้ต้องเรียงลำดับอะไรครับ จัดยังไงก็ได้ มันอ่านรู้เรื่อง แต่ที่ควรจะทำให้มันเป็นจากบนลงล่าง เป็นระบบหน่อยก็เพราะแค่เราจะกลับไปแก้ลำบากขึ้นเยอะ ถ้ามันไล่ไม่ได้ง่ายๆครับ
+
+เท่านี้ก็น่าจะพอได้ idea ไปลองแล้วหล่ะ 
+
+
+## การแก้ใน .py
+
+ใครใช้รายงานไหน จริงๆ ก็น่าจะมีอะไรอยู่ใน file พอสมควรแล้วครับ แต่ส่วนที่ต้องแก้ คือ ส่วนของ
+
+    def prep_to_pdf(self, context):
+        lines = []
+        ......
+        .....
+        ...
+        ..
+        return render_to_pdf(lines)
+
+แค่ส่วนจุดๆๆ นี้แหละครับ ที่ต้องแก้ไข (ซึ่งชื่อตัวแปร lines ก็เปลี่ยนได้ตามชอบใจครับ ที่ใช้ lines เพราะจะได้สอดคล้องกับตัวอย่างด้านบน) 
+
+### การใช้คำสั่งต่างๆ
+
+โดยมากแล้วจะเป็นการเปรียบเทียบคำสั่งต่างๆ ของ templatetag ที่เห็นใน .html กับที่ต้องเขียนใน python (.py) ใน html นั้นจะมีการเรียกใช้งานตัวแปรและ function ที่ต่างออกไปจากปกติ
+
+    {{date}}
+
+`{{ }}` ไว้สำหรับแสดงผลตัวแปรนั้นเป็น string
+
+    {{date|month_full_th}}
+
+| เป็นการบ่งบอกว่า มีการใช้ function กับตัวแปร date โดยเราจะสามารถดูได้ว่า function นี้คืออะไรได้จากการ import function ข้างบน ซึ่งใน `templatetag` จะใช้คำสั่ง `{ % load yyyyy % }`
+
+การใช้งาน function พวกนี้ใน python code นั้นจะสามารถทำได้โดย
+
+    from core.templatetags.extratags import intcomma2, intword_th, month_full_th
+     
+    thb = 1423.223
+    print u'ราคา %s' % intcomma2(thb)
+    # จะได้ผลลัพธ์เป็น
+    ราคา 1,423.22
+
+### คำสั่งอ้างอิง
+
+templatetags ที่ใช้ใน .html ก็มีแตกต่างกันออกไปแต่หลักๆก็จะมีอยู่ 2 ที่ด้วยกันคือ
+
+* `report_tags` -- ส่วนใหญ่จะเป็นการแปลงค่าแสดงผลที่เกี่ยวกับโรงเรียนทั้งหมด เช่น แสดงรอบ แสดงชั้นเป็นต้น
+
+        from school.templatetags.report_tags import *
+* `extra_tags` -- เป็นการแปลงค่าเพื่อแสดงผลทั่วๆไป เช่น ใน , ในหลักพัน การพิมวันที่เป็นภาษาไทย หรือพิมจำนวนเงินเป็นภาษาไทย
+
+        from core.templatetags.extra_tags import *
+
+รายละเอียดของคำสั่งมีดังนี้ 
+
+<table class="wikitable"><tbody><tr><th> file</th><th> function</th><th> description</th></tr><tr><td style="background-color: #ffffcc;" rowspan="6">report_tags</td><td style="background-color: #ffffcc;" colspan="2"> school.templatetags.report_tags</td></tr><tr><td> shift_display</td><td> แปลงค่า<ul><li> 0 -&gt; รอบเช้า และ</li><li> 1 -&gt; รอบบ่าย</li></ul></td></tr><tr><td> coarse_grade_display</td><td> แสดงชั้นปีแบบคร่าวๆ โดยจะใช้ค่าชั้นปีแบบใดก็ได้  ผลเป็นแบบหยาบเสมอ โดยจะแสดงเป็น<ul><li> เตรียมอนุบาล</li><li> อนุบาล</li><li> ประถมศึกษา</li><li> มัธยมศึกษาตอนต้น</li><li> มัธยมศึกษาตอนปลาย</li><li> ประกาศนียบัตรวิชาชีพ</li><li> ปวส.</li><li> ปวท.</li></ul></td></tr><tr><td> fine_grade_display</td><td> แสดงชั้นปีแบบเจาะจงชั้นปี<p>โดยจะแสดงเป็น</p><ul><li> เตรียมอนุบาล</li><li> อ.1, อ.2, อ.3</li><li> ป.1, ป.2, ป.3, ป.4, ป.5, ป.6, </li><li> ม.1, ม.2, ม.3, ม.4, ม.5, ม.6, </li><li> ปวช.1-3</li><li> ปวส.1-3</li><li> ปวท.1-2</li></ul></td></tr><tr><td> course_display</td><td> แสดงหลักสูตรของสายวิชาชีพของแต่ละห้อง</td></tr><tr><td> education_level_display</td><td> แสดงวุฒิที่ได้รับการบรรจุของบุคลากร เช่น ป.เอก (ครู) ป.เอก</td></tr><tr><td style="background-color: #ffffcc;" rowspan="9"> extra_tags</td><td style="background-color: #ffffcc;" colspan="2"> core.templatetags.extra_tags</td></tr><tr><td> intcomma2</td><td> เติม , ให้กับหลักพัน และถ้าค่าเป็นทศนิยมก็จะตัดเหลือแค่ 2 หลักให้อัตโนมัติ</td></tr><tr><td> intword_th</td><td> แสดงจำนวนเงินเป็นภาษาไทย</td></tr><tr><td> date_abbv_th</td><td> 11 พ.ย. 2556</td></tr><tr><td> date_full_th</td><td> 5 ธันวาคม 2556</td></tr><tr><td> month_abbv_th</td><td> ม.ค. 2556</td></tr><tr><td> month_full_th</td><td> กุมภาพันธ์ 2556</td></tr><tr><td> year_th</td><td> 2556</td></tr><tr><td> system_status_display</td><td></td></tr></tbody></table>
+
+
+
+
+
+

_posts/2013-11-12-psis-record.md

@@ -0,0 +1,634 @@
+---
+layout: post
+type:   handbook
+title:  "psisRecord"
+date:   2013-11-12
+tags: database
+---
+Now all data in the past will be in another database. MongoDB it is.
+
+### เป้าหมาย
+
+* ข้อมูลที่เก็บไว้จะต้องมีมากพอที่จะสร้างรายงานใหม่ได้ทันที โดยไม่มีโอกาสที่จะมีข้อมูลหายไปได้ เช่น ข้อมูลไร้สาระอย่างรายละเอียดเพิ่มเติมอย่างตัวอย่างคำอธิบายตัวย่อค่าคงที่จะไม่จำเป็นต้องใส่เพราะซ้ำซ้อนและสามารถเรียกได้แน่นอน ทุกเวลาจากฐานข้อมูลหลัก
+* ข้อมูลจะต้องเข้าถึงง่ายเพื่อสร้างรายงานเปรียบเทียบให้กับสำนักงานต่างๆ ได้
+
+
+### buffer
+
+เป็นส่วนที่มีการคำนวณข้อมูลเพื่อเก็บไว้สำหรับรายงานต่อๆไป หลักๆ คือ ms* report เท่านั้นที่ใช้สำหรับตอนนี้
+
+    { 
+     "_id": xx,
+     "school": "<school_id>",
+     "date": ISODate("xxx"),  # report_date
+     "report": "*",
+     ...
+    }
+
+#### report
+
+1. ms_est_receipt
+2. ms_actual
+3. ms_actual_receipt
+4. ms_actual_diff_receipt
+5. ms_matrix
+
+ค่าหนังสือเรียน ใบเสร็จ ประมาณการ
+
+    { 
+        "_id": xx,
+        "school": "<school_id>",
+        "date": ISODate("xxx"),  # report_date
+        "report": "ms_est_receipt",
+        "data": {
+           ...
+        }
+    }
+
+ค่าหนังสือเรียน นักเรียนที่มีอยู่จริง Jun 10
+
+    { 
+        "_id": xx,
+        "school": "<school_id>",
+        "date": ISODate("xxx"),  # report_date
+        "report": "ms_actual",
+        "data": {
+           ...
+        }
+    }
+
+ค่าหนังสือเรียน ใบสำคัญรับขอเบิกเพิ่มเติม Jun 10
+
+    { 
+        "_id": xx,
+        "school": "<school_id>",
+        "date": ISODate("xxx"),  # report_date
+        "report": "ms_actual_diff_receipt",
+        "data": {
+           ...
+        }
+    }
+
+ค่าหนังสือเรียน นักเรียนที่มีอยู่จริง Nov 10
+
+    { 
+        "_id": xx,
+        "school": "<school_id>",
+        "date": ISODate("xxx"),  # report_date
+        "report": "ms_actual",
+        "data": {
+           ...
+        }
+    }
+
+ค่าหนังสือเรียน ใบสำคัญรับขอเบิก Nov 10
+
+    { 
+        "_id": xx,
+        "school": "<school_id>",
+        "date": ISODate("xxx"),  # report_date
+        "report": "ms_actual_receipt",
+        "data": {
+           ...
+        }
+    }
+
+## report
+
+หลักๆ ข้อมูลตรงนี้ก็เอาไว้ออกรายงานโดยที่ไม่จำเป็นต้องประมวลผลจากข้อมูลใหม่ (หรือข้อมูลดิบไม่มีแล้ว) รายงานก็มีประมาณ
+
+1. sub1
+1. sub2
+1. sub3
+1. sub4
+1. sub5
+1. sub6
+1. salary
+1. payment
+1. sub4_fake
+1. ms_est
+1. ms_est_receipt
+1. ms_actual_jun10
+1. ms_actual_jun10_receipt
+1. ms_matrix
+1. ms_actual_nov10
+1. ms_actual_nov10_receipt
+
+### รายงาน อน.1
+
+    { 
+     "_id": xx,
+     "school": "<school_id>",
+     "date": ISODate("xxx"),  # report_date
+     "report": "sub1",
+     "is_charity": true/false,
+     "data": {
+              'disabled': {
+                           'sum': 0, 
+                           'shift': [
+                             {},  # day shift
+                             {},  # night shift
+                             ]
+                          },
+              'normal': {
+                         'sum': 0,
+                         'shift': [  ## list consisting of 0, 1 indicating shift
+                             {   # shift start
+                                u'1-0': {   # grade and course
+                                         'text': {'grade': '1', 'course': u'0'}, 
+                                         'number': 
+                                             {
+                                               'boarding': 0, 
+                                               'normal': 296, 
+                                               'tuition': 1937.0, 
+                                               'disabled': 0, 
+                                               'rate': {'normal': 7793.0, 'charity': 0}
+                                             }
+                                        }
+                             },
+                             {
+                                  ... # another shift if applied
+                             }
+                         ]
+             },
+     "total": {
+                   'normal': {
+                           '0': {'normal':0, 'charity':0, 'sum':0}, 
+                           '1': {'normal':0, 'charity':0, 'sum':0},
+                           'all':{'normal':0, 'charity':0, 'sum':0},
+                       },
+                   'disabled': {
+                          '0': {'disabled':0, 'boarding':0, 'sum':0},
+                          '1': {'disabled':0, 'boarding':0, 'sum':0},
+                          'all': {'disabled':0, 'boarding':0, 'sum':0},
+                       },
+              }
+    }
+
+### รายงาน อน.2
+
+    { 
+     "_id": xx,
+     "school": "<school_id>",
+     "date": ISODate("xxx"),  # report_date
+     "report": "sub2",
+     "is_charity": true/false,
+     "data": { 
+           '0': {   # shift !
+               '0': {  # coarse grade
+                       'sum': {
+                           'abs_total': 0, 
+                           'charity': 0, 'normal': 0, 'boarding': 0, 'disabled': 0, 
+                           'teachers': 0, 'salary': 0,
+                       },
+                       'crs': [
+                           {   # room thing and teacher data
+                             "room": xx, "all_students": 0, "boarding": 0, "disabled": 0, "eligible": 0,
+                             "full_name": xxx, "education": yyy, "employment_date": yyyy-mm-dd,
+                             "employment_document_number": xxx, "salary": 0
+                           }, 
+                           {},
+                           {},
+                       ],
+                       'extra': [ 
+                           {   # only teacher data
+                             "full_name": xxx, "education": yyy, "employment_date": yyyy-mm-dd,
+                             "employment_document_number": xxx, "salary": 0
+                           }, 
+                           {},
+                           {},
+                       ]
+                 },
+               '1': {  # coarse grade
+                  
+                 },
+             },
+           '1': {   # shift if applied
+             },
+       },
+     "total": {
+               '0': {'abs_total': 0, 'normal': 0, 'boarding': 0, 'disabled': 0, 'teachers': 0, 'salary': 0,},
+               '1': {'abs_total': 0, 'normal': 0, 'boarding': 0, 'disabled': 0, 'teachers': 0, 'salary': 0,},
+               'all': {'abs_total': 0, 'normal': 0, 'boarding': 0, 'disabled': 0, 'teachers': 0, 'salary': 0,}
+       }
+    }
+
+### รายงาน อน.3
+
+    { 
+        "_id": xx,
+        "school": "<school_id>",
+        "date": ISODate("xxx"),  # report_date
+        "report": "sub3",
+        "is_charity": true/false,
+        "data": {
+        }
+    }
+
+### รายงาน อน.4
+
+    { 
+        "_id": xx,
+        "school": "<school_id>",
+        "date": ISODate("xxx"),  # report_date
+        "report": "sub4",
+        "is_charity": true/false,
+        "data": {
+        }
+    }
+
+### รายงาน อน.5
+
+    { 
+        "_id": xx,
+        "school": "<school_id>",
+        "date": ISODate("xxx"),  # report_date
+        "report": "sub5",
+        "is_charity": true/false,
+        "data": {
+        }
+    }
+
+### รายงาน อน.6
+
+    { 
+        "_id": xx,
+        "school": "<school_id>",
+        "date": ISODate("xxx"),  # report_date
+        "report": "sub6",
+        "is_charity": true/false,
+        "data": {
+        }
+    }
+
+### บัญชีการจ่ายเงินเดือนครู
+
+    { 
+        "_id": xx,
+        "school": "<school_id>",
+        "date": ISODate("xxx"),  # report_date
+        "report": "salary",
+        "is_charity": true/false,
+        "data": {
+        }
+    }
+
+### หลักฐานการจ่ายเงินเดือนครู
+
+    { 
+        "_id": xx,
+        "school": "<school_id>",
+        "date": ISODate("xxx"),  # report_date
+        "report": "payment",
+        "is_charity": true/false,
+        "data": {
+        }
+    }
+
+### ข้อมูลเก็บเผื่อสร้าง อน.4 ย้อนหลัง
+
+    { 
+        "_id": xx,
+        "school": "<school_id>",
+        "date": ISODate("xxx"),  # report_date
+        "report": "sub4_fake",
+        "data": {
+            # student detail count enough to feed ReportSub4Mixin.get_processed_data()
+        }
+    }
+
+## stat
+
+### original data
+
+This is what data with all grades; no dob cut; no student_status considered; no issue considered; but we only sum student in class. Student without class is out of luck ever. This is a pure query.
+
+    { 
+        "_id": xx,
+        "school": "<school_id>",
+        "date": ISODate("xxx"),
+        "type": "original",
+        "data": { 
+        }
+    }
+
+### raw data without any cut
+
+Raw data which met basic requirements, no further cut. (shift isn't considered) This should meet few requirements:
+
+* eligible grade
+* verified & completed classroom
+* date of birth
+* student_status
+* resolved issue students
+
+From get_subsidized_students_queryset() w/o any cut.
+
+    { 
+     "_id": xx,
+     "school": "<school_id>",
+     "date": ISODate("xxx"),
+     "type": "raw",
+     "data": { 
+        }
+    }
+
+นร. ประเภทสามัญศึกษา ที่มีสิทธิ์รับเงินอุดหนุนรายบุคคล
+Data from get_subsidized_students_in_fine_grade()
+
+    { 
+     "_id": xx,
+     "school": "<school_id>",
+     "date": ISODate("xxx"),
+     "type": "educational",
+     "data": { 
+        }
+    }
+
+นร. ประเภทอาชีวศึกษา ที่มีสิทธิ์รับเงินอุดหนุนรายบุคคล
+Data from get_subsidized_students_in_fine_grade()
+
+    { 
+     "_id": xx,
+     "school": "<school_id>",
+     "date": ISODate("xxx"),
+     "type": "technical",
+     "data": { 
+        }
+    }
+
+นร. พิการในโรงเรียนเอกชน ประเภทสามัญศึกษา
+Filter verified disabled people from get_subsidized_students_queryset().
+
+    { 
+     "_id": xx,
+     "school": "<school_id>",
+     "date": ISODate("xxx"),
+     "type": "disabled_educational",
+     "data": { 
+        }
+    }
+
+นร. พิการในโรงเรียนเอกชน ประเภทอาชีวศึกษา
+Filter verified disabled people from get_subsidized_students_queryset().
+
+    { 
+     "_id": xx,
+     "school": "<school_id>",
+     "date": ISODate("xxx"),
+     "type": "disabled_technical",
+     "data": { 
+        }
+    }
+
+นร. โรงเรียนการกุศล และโรงเรียนสอนศาสนาอิสลามควบคู่กับวิชาสามัญที่มีมูลนิธิ/มัสยิดเป็นผู้รับใบอนุญาต
+Data from evaluate_errors() which (school).is_charity() has to return True
+
+    { 
+     "_id": xx,
+     "school": "<school_id>",
+     "date": ISODate("xxx"),
+     "type": "charity",
+     "data": { 
+        }
+    }
+
+## history
+
+เป็นการเก็บข้อมูลนักเรียนเข้า-ออกทั้งหมด จาก `archive_students_transfer`
+
+    { 
+     "_id": xx,
+     "people_id": "<people_id>",
+     "date": ISODate("xxx"),
+     "transfer": "in/out",
+     "school": "<school_id>",
+     ... # depending on whether it's transfer IN/OUT
+    }
+
+data is pretty much the same way sub5/sub6 is.
+
+## searchArchive
+
+* school [yearly data]
+* teacher [monthly data in/out only]
+* student [every in/out]
+* report [not implemented -- using report]
+
+### school
+
+    { 
+     "_id": xx,
+     "archive_type": "school",
+     "school": "<school_id>",
+     "basic": {
+       "thai_name": "<thai_name>",
+       "eng_name": "<eng_name>",
+       "serv_area_code": "<serv_area_code>",
+     },
+     "board": {
+       "licensee": {"people_id": "", "full_name": "",},
+       "manager": {"people_id": "", "full_name": "",},
+       "principle": {"people_id": "", "full_name": "",},
+     },
+     "bank": {
+       "account_number": "",
+       "account_name": "",
+       "bank": "",
+       "bank_branch": "",
+     },
+     "license": [
+       {
+           "license_number": "",
+           "license_date": "",
+           "license_effective_date": "",
+           "age": [min, max],
+           "shift": {
+               "0": {"capacity": 0, "room": 0, "time": ["0", "0"], "grade": ["0", "0"]},
+               "1": {"capacity": 0, "room": 0, "time": ["0", "0"], "grade": ["0", "0"]},
+           }
+       }, 
+       ## more items
+       {}, {}, ...
+     ]
+    }
+
+### teacher
+
+    { 
+     "_id": xx,
+     "archive_type": "teacher",
+     "school": "<school_id>",
+     "people_id": "",
+     "full_name": "",
+     "transfer_type": "<in/out>",
+     "date": ISODate("xxx"),
+     "editor": "<user_id>"
+    }
+
+### student
+
+    { 
+     "_id": xx,
+     "archive_type": "student",
+     "school": "<school_id>",
+     "people_id": "",
+     "full_name": "",
+     "transfer_type": "<in/out>",
+     "xfer_status": "<DC/RM/QT/GD/RL/DN/CF/IW/II/IO>",
+     "student_id": "",
+     "date": ISODate("xxx"),
+     "editor": "<user_id>"
+    }
+
+### confirmation
+
+ข้อมูลในส่วนยืนยันข้อมูลถูกต้องในส่วนต่างๆ
+ส่วนยืนยันของโรงเรียน
+ยืนยันความถูกต้องประจำปี (เฉพาะเดือน 6)
+ยืนยันความถูกต้องประจำเดือน
+ส่วนยืนยันคุณภาพของข้อมูลของสำนักงาน
+ยืนยันการยื่นเอกสาร
+ยืนยันความถูกต้องของข้อมูล
+ส่วนยืนยันของโรงเรียน - ยืนยันความถูกต้องประจำปี (เฉพาะเดือน 6)
+
+    { 
+     "_id": xx,
+     "user_id": 000,
+     "username": "<username> or <email>",
+     "date": ISODate("xxx"),
+     "school": "<school_id>",
+     "what": "confirmation",
+     "type": "monthly",  # only student for now.
+    }
+
+ส่วนยืนยันของโรงเรียน - ยืนยันความถูกต้องประจำเดือน
+
+    { 
+     "_id": xx,
+     "user_id": 000,
+     "username": "<username> or <email>",
+     "date": ISODate("xxx"),
+     "school": "<school_id>",
+     "what": "confirmation",
+     "type": "yearly",  # only student for now.
+    }
+
+ส่วนยืนยันคุณภาพของข้อมูลของสำนักงาน - ยืนยันการยื่นเอกสาร
+
+    { 
+     "_id": xx,
+     "user_id": 000,
+     "username": "<username> or <email>",
+     "date": ISODate("xxx"),
+     "school": "<school_id>",
+     "office": "<office_id>",
+     "what": "dataQuality",
+     "type": "delivered",
+    }
+
+ส่วนยืนยันคุณภาพของข้อมูลของสำนักงาน - ยืนยันความถูกต้องของข้อมูล
+
+    { 
+     "_id": xx,
+     "user_id": 000,
+     "username": "<username> or <email>",
+     "date": ISODate("xxx"),
+     "school": "<school_id>",
+     "office": "<office_id>",
+     "what": "dataQuality",
+     "type": "completeness",
+    }
+
+### preferences
+
+System-wide's key-value storage.
+
+no. |  name  |  value |  description
+--- | --- | --- | ---
+1 | `subsidy_rate_header` | text |
+2 | `ms_est_first_level_cut` | decimal 0-1 |
+__System Preferences__ | via <br/> `core.get_system_pref()` `core.set_system_pref() `| |
+--- | --- | --- | ---
+3 | `enforce_disability_expiration_date` | boolean 
+4 | `enforce_people_id_validation`  | boolean 
+5 | `backfill_reviews_in_progress`   | boolean | no more running repetitive back-filling reviews ever
+6 | `check_student_issue_in_progress` | boolean | no more running repetitive task
+7 | `check_teacher_issue_in_progress` | boolean | no more running repetitive task
+8 | `sub4sum_in_progress` | boolean | no more running repetitive task
+9 | `sub4sum_office_in_progress` | boolean | no more running repetitive task
+
+หัวเรื่องของ subsidy rate
+
+    { 
+     "_id": xx,
+     "year": "2013",
+     "name": "subsidy_rate_header",
+     "value": "xxxxxxxxxxx",
+     "user": "<user_pk>",
+     "username": "<username>",
+     "date": "utc"
+    }
+
+อัตราตัดของการสนับสนุนตามการประมาณการของเรียนฟรี 15 ปี
+
+    { 
+     "_id": xx,
+     "year": "2013",
+     "name": "ms_est_first_level_cut",
+     "value": "xxxxxxxxxxx",  # 0-1 (or 0-100%) [default 0.8]
+     "user": "<user_pk>",
+     "username": "<username>",
+     "date": "utc"
+    }
+
+การบังคับใช้วันหมดอายุของนักเรียนพิการ
+
+    { 
+     "_id": xx,
+     "name": "enforce_disability_expiration_date",
+     "value": "true/false",  # boolean
+     "user": "<user_pk>",
+     "date": "utc"
+    }
+
+การบังคับการตรวจสอบเลขประจำตัวประชาชนทั้งหมด
+ถ้าเปิด true -- จะทำให้เลขประจำตัวประชาชนที่ผิดหลักและยังไม่ได้ตรวจสอบไม่ได้รับอุดหนุน
+ถ้าปิด false -- เลขประจำตัวที่ผิดหลักและยังไม่ได้ตรวจสอบก็จะได้รับอุดหนุน
+
+    { 
+     "_id": xx,
+     "name": "enforce_people_id_validation",
+     "value": "true/false",  # boolean
+     "user": "<user_pk>",
+     "date": "utc"
+    }
+
+## userPreferences
+
+ค่าต่างๆ ที่เกี่ยวกับ user โดยตรง
+
+    { 
+     "_id": xx,
+     "key": "logout_3rd_party_all_together",
+     "value": "True/False",
+     "user": "<user.pk>"
+    }
+
+จะเป็นค่าในกรณีที่ต้องการออกจากระบบของ Google/Yahoo ด้วย (Facebook ยังไม่ sign out เองอัตโนมัติ) เหมาะกับเครื่องที่ไม่ใช่ของตัวเองเพราะจะได้ไม่ sign in พวกนี้ค้างไว้ ถ้าออกจาก PSIS ก็ออกจาก Google/Yahoo ให้ด้วยทันที [ซึ่งนั่นคือค่า default]
+
+## userData
+
+    { 
+     "_id": xx,
+     "date": "utc",
+     "user": "<user.pk>",
+     "name": "",
+     "value": "",
+    }
+
+ตอนนี้จะเก็บเพียงแค่ task_id ซึ่งจะถูกลบหลังผ่านไป 2-3 วัน เพราะยังไง celery result task ก็ไม่มีเก็บหลังจากนั้นอยู่ดี
+
+name | value
+--- | ---
+task_id | <many many character>

_posts/2013-11-13-app-setup.md

@@ -0,0 +1,209 @@
+---
+layout: post
+type:   handbook
+title:  "PSISv2 Setup"
+date:   2014-11-13
+tags: admin setup
+---
+
+
+## การติดตั้งระบบ PSIS v2
+
+ระบบ __PSIS v2__ นั้นจะรองรับเครื่องแม่ข่ายที่สามารถใช้งาน `Python` และฐานข้อมูล `PostgreSQL` หรือ `MySQL` หรือ `Oracle` ได้ แต่อย่างไรก็ดีเครื่องแม่ข่ายที่แนะนำในการใช้งานกับ __PSIS v2__ นั้นจะเป็นระบบปฏิบัติการใดๆ ก็ตามที่ทำงานบน Linux kernel ไม่ว่าจะเป็น Debian, Ubuntu, CentOS, RedHat, Arch ตามแต่ความถนัดของผู้ปฏิบัติการ ซึ่งเอกสารนี้จะใช้ระบบปฏิบัติการ Ubuntu 12.04 เป็นตัวอย่าง
+ความต้องการของระบบ __PSIS v2__
+
+* Python 2.7.x หรือใหม่กว่า
+* PostgreSQL 9 หรือใหม่กว่า
+* nginx 1.0.0 หรือใหม่กว่า
+
+## ขั้นตอนการติดตั้งระบบ PSIS v2
+
+หลังจากติดตั้งระบบปฏิบัติการ Ubuntu 12.04 เรียบร้อยแล้ว จะต้องมีการติดตั้งโปรแกรมที่จำเป็นในการใช้งานของระบบ PSIS v2 ดังนี้
+ติดตั้งความพร้อมของระบบที่ต้องใช้เพิ่มเติมจากระบบปฏิบัติการ
+
+    # apt-get update
+    # apt-get install postgresql mongodb nginx python python-pip git mercurial nodejs npm mysql-client
+    # npm install -g bower
+
+
+## ติดตั้งส่วนของ PSIS v2
+
+การติดตั้งส่วนนี้จะไม่มีหลักเกณฑ์ที่แน่นอนในการติดตั้ง แต่เอกสารนี้จะสิ่งที่เกี่ยวข้องกับโปรแกรมทั้งหมดใน `/opt/` เพื่อความสะดวกในการอธิบาย ซึ่งจะสามารถเปลี่ยนแปลงได้ตามความเหมาะสม
+
+    # mkdir -p /opt/psis-v2/
+    # cd /opt/psis-v2
+
+ทำการคัดลอกไฟล์มายังไดเรกทอรี่นี้
+
+    # bzip2 -d psis-v2-app.bz2
+
+จะได้ไดเรกทอรี่ `/opt/psis-v2/app/` เพิ่มขึ้นมาซึ่งเป็นส่วนของโปรแกรมนั้น จากนั้นจะต้องทำการสร้างไดเรกทอรี่แยกเพื่อให้เป็น root ของ `nginx` เพ่ื่อความปลอดภัยของไฟล์โปรแกรมหลัก
+
+    # mkdir -p /opt/psis-v2/static/
+    # ln -s /opt/psis-v2/app/static /opt/psis-v2/static
+
+สร้างไดเรกทอรี่สำหรับเก็บ log
+
+    # mkdir -p /opt/psis-v2/log
+
+จากนั้นจะต้องลง `virtualenv` และ `virtualenvwrapper` โดยใช้คำสั่ง
+
+    # pip install virtualenv virtualenvwrapper
+
+หลังจากลงโปรแกรมที่จำเป็นต่อระบบ จะยังต้องลง library ที่ PSIS v2 ใช้งานด้วย
+
+    # apt-get build-dep python-mysqldb
+    # apt-get install graphviz libgraphviz-dev pkg-config
+
+และ
+
+    $ cd /opt/psis-v2/
+    $ pip install -r requirements.txt
+    $ bower install
+
+ถ้าไม่มี error อะไรก็จะเป็นการเสร็จสิ้นการติดตั้งเราสามารถทดสอบว่าใช้งานได้หรือไม่ด้วยคำสั่ง
+
+    $ ./manage.py runserver
+
+เมื่อใช้งานได้แล้ว ก็สามารถปิดการทำสอบได้จาก ctrl+C
+
+
+### ติดตั้งส่วนของ nginx
+
+หลังจากส่วนนี้ก็จะต้องทำการปรับแต่งค่าของ nginx เพื่อให้เป็น proxy server และ media server ของระบบ PSIS v2
+
+    # vim /etc/nginx/sites-available/psis
+
+โดยมีข้อมูลดังนี้
+
+    server {
+       listen 80;
+       server_name  psisapp.com psis.opec.go.th;
+
+       access_log      /opt/psis-v2/log/nginx_access.log;
+       error_log       /opt/psis-v2/log/nginx_error.log;
+
+       root /opt/psis-v2/static/;
+       location ~* \.html$ {
+           expires -1;
+       }
+       location ~* \.(css|js|gif|jpe?g|png)$ {
+           expires 168h;
+           add_header Pragma public;
+           add_header Cache-Control "public, must-revalidate, proxy-revalidate";
+       }
+       location /media/ {
+           # if asset versioning is used
+           if ($query_string) {
+               expires max;
+           }
+       }
+       location /static/ {
+           # if asset versioning is used
+           if ($query_string) {
+               expires max;
+           }
+       }
+       location / {
+           proxy_pass_header Server;
+           proxy_set_header Host $http_host;
+           proxy_redirect off;
+           proxy_set_header X-Real-IP $remote_addr;
+           proxy_set_header X-Scheme $scheme;
+           proxy_connect_timeout 15;
+           proxy_read_timeout 45;
+           proxy_pass http://localhost:8000/;
+       }
+    }
+
+จากนั้นจะต้องสร้าง symbolic link ไปยัง `/etc/nginx/sites-enabled/` เพื่อให้ `nginx` ได้ทำงานตามที่เราต้องการ
+
+    # ln -s /etc/nginx/sites-available/psis /etc/nginx/sites-enabled/psis
+
+จากนั้นเราสามารถตรวจสอบว่าไฟล์ที่เราทำนั้นมีความถูกต้องหรือไม่จาก
+
+    # service nginx configtest
+
+เมื่อตรวจสอบแล้วไม่พบข้อผิดพลาดใดๆ จะขึ้นว่า `Testing nginx configuration: nginx.` และจากนั้นก็สามารถทดสอบได้จากคำสั่ง
+
+    # service nginx reload
+
+
+### ติดตั้งส่วนฐานข้อมูล
+
+ระบบ PSIS v2 นั้นจะใช้ฐานข้อมูล 2 ชนิดด้วยกันคือ
+
+    PostgreSQL ซึ่งจะเป็นฐานข้อมูลหลักสำหรับข้อมูลปัจจุบันทั้งหมด
+    MongoDB ใช้สำหรับเก็บข้อมูลที่ได้ประมวลผลแล้ว
+
+__PostgreSQL__
+
+หลังจากติดตั้งไปแล้วในส่วนติดตั้งเพื่อความพร้อมของระบบปฏิบัติการ การเปิดใช้งานก็จะใช้คำสั่งง่ายๆ คือ
+
+    # service postgresql start
+
+__MongoDB__
+
+หลังจากติดตั้งไปแล้วในส่วนติดตั้งเพื่อความพร้อมของระบบปฏิบัติการ การเปิดใช้งานก็จะใช้คำสั่งง่ายๆ คือ
+
+    # service mongodb start
+
+
+### ติดตั้งส่วน upstart
+
+ในส่วนนี้จะเป็นส่วนที่ทำให้เราสามารถเปิดปิดการทำงานของระบบ PSIS v2 ได้โดยคำสั่งง่ายๆ ดังนี้
+
+    # start psis_app
+    # stop psis_app
+
+ส่วนที่เกี่ยวข้องสำหรับ `upstart` นั้นจะมี 2 ส่วน คือ script สำหรับเรียก `gnuicorn` และ `upstart` script ของระบบปฏิบัติการในไดเรกทอรี่ /etc/init/
+
+ส่วนแรก คือ ส่วนไฟล์สคริปสำหรับ `gunicorn` คือ แอปพริเคชันสำหรับเรียกใช้งาน `wsgi` โดยสร้าง bash script ดังนี้
+
+    # vim /opt/psis-v2/run_app.sh
+
+โดยจะมีรายละเอียดดังนี้
+
+    #!/bin/bash 
+    set -e 
+    LOGFILE=gunicorn_django.log 
+    LOGDIR=$(dirname $LOGFILE) 
+    NUM_WORKERS=3  #recommended formula here is 1 + 2 * NUM_CORES 
+
+    VENV_DIR=/home/psisapp/.virtualenvs/psis 
+    DJANGO_DIR=/opt/psis-v2/app 
+    #we don't want to run this as root.. 
+    USER=psisapp 
+    GROUP=psisapp 
+
+    cd $DJANGO_DIR 
+    source $VENV_DIR/bin/activate 
+    test -d $LOGDIR || mkdir -p $LOGDIR 
+
+    #exec gunicorn_django -w $NUM_WORKERS -b 0.0.0.0:8000 
+    exec gunicorn core.wsgi:application -w $NUM_WORKERS -b 0.0.0.0:8000 
+      --log-level=debug 
+      --log-file=$LOGFILE 2>>$LOGFILE 
+      --user=$USER --group=$GROUP  
+
+ในส่วนของไฟล์ `upstart` จะต้องสร้างไฟล์ `psis_app.conf`
+
+    # vim /etc/init/psis_app.conf 
+
+โดยจะมีรายละเอียดเป็นดังนี้
+
+    description "PSIS v2 Application" 
+    start on runlevel [2345] 
+    stop on runlevel [06] 
+    respawn 
+    respawn limit 10 5 
+    exec /opt/psis-v2/run_app.sh 
+
+ข้างต้นจะเป็นวิธีทั้งหมดในการติดตั้งระบบ PSIS v2 เพื่อให้ใช้งานได้จากคำสั่ง 2 คำสั่งง่ายๆ
+
+    $ sudo start psis_app
+    $ sudo stop psis_app
+
+ซึ่งในการใช้งานจริงอาจจะใช้ `crontab` โดย root เพื่อทำให้ระบบ PSIS v2 ทำงานได้อัตโนมัติ เช่น
+
+    @reboot start psis_app

_posts/2013-12-19-pdf-styling.md

@@ -0,0 +1,174 @@
+---
+layout: post
+type:   handbook
+title:  "PDF Styling"
+date:   2013-12-19
+tags: coding
+---
+
+จะมี style คร่าวๆ ให้ได้จัดการปรับแต่งกันเอง (โดยเฉพาะตำแหน่งการวาง ชิดซ้าย กลาง ชิดขวา) ใน core.views.pdfs ซึ่งจริงๆแล้วก็จะแบ่งมาตรฐานเป็น 2 ส่วน คือ
+
+* `Paragraph` -- กำหนดด้วย `ParagraphStyle`
+* `Table` -- กำหนด style ด้วย `style_tab` (แต่ต้องใส่เองทั้งหมด)
+
+## Paragraph
+
+ในส่วนนี้จะเป็นการกำหนด style คร่าวๆ เพื่อให้เป็นแนวทางหลักในการใช้งานทั้งหมด โดยมีทั้งหมดดังนี้
+
+1. `style_base` - อันนี้เอาไว้เป็น parent style เฉยๆครับ เพราะมีกำหนดแค่รูปแบบตัวอักษรเป็น TH Sarabun
+1. `style_h1` - ขนาด font 18 ตัวหนา พร้อมมี space บนล่างตามเหมาะสม
+1. `style_h1c` - อันนี้คือ `h1` แต่ตั้ง align เป็น center ครับ
+1. `style_h2` - ขนาด font 16 ตัวหนา พร้อมมี space บนล่างตามเหมาะสม
+1. `style_h2c` - อันนี้คือ `h2` แต่ตั้ง align เป็น center ครับ
+1. `style_h3` - ขนาด font 14 ตัวหนา พร้อมมี space บนล่างตามเหมาะสม
+1. `style_h3c` - อันนี้คือ `h2` แต่ตั้ง align เป็น center ครับ
+1. `style_normal` - ขนาด font 14 ไม่มี space บนล่าง ไม่มีย่อหน้า
+1. `style_normal_indent` - เหมือน `style_normal` แต่มีย่อหน้าของบรรทัดแรกเข้าไป 4 space ครับ
+1. `style_footnote` - อันนี้สำหรับอธิบายใต้ตารางครับ ตัวเล็กๆ 12 ไม่มี space บนล่าง ไม่มีย่อหน้า
+
+หรือจะเป็น code ก็ตามด้านล่างนี้
+
+    style_base = ParagraphStyle('normal', parent=style_base_sample,
+                               fontName='TH Sarabun New')
+    style_h1 = ParagraphStyle('h1', parent=style_base, 
+                           fontName='TH Sarabun New Bold',
+                           fontSize=18,
+                           leading=21,
+                           spaceBefore=7, spaceAfter=8,)
+    style_h1c = ParagraphStyle('h1c', parent=style_h1,
+                           alignment=TA_CENTER,)
+    style_h2 = ParagraphStyle('h2', parent=style_base, 
+                           fontName='TH Sarabun New Bold',
+                           fontSize=16,
+                           leading=19,
+                           spaceBefore=7, spaceAfter=8,)
+    style_h2c = ParagraphStyle('h1c', parent=style_h2,
+                           alignment=TA_CENTER,)
+    style_h3 = ParagraphStyle('h2', parent=style_base, 
+                           fontName='TH Sarabun New Bold',
+                           fontSize=14,
+                           leading=17,
+                           spaceBefore=7, spaceAfter=8,)
+    style_h3c = ParagraphStyle('h1c', parent=style_h3,
+                           alignment=TA_CENTER,)
+    style_normal = ParagraphStyle('normal', parent=style_base,
+                           fontSize=14,
+                           leading=17,)
+    style_normal_indent = ParagraphStyle('normal', parent=style_normal,
+                           firstLineIndent=16)
+    style_footnote = ParagraphStyle('footnote', parent=style_base,
+                           fontSize=12,
+                           leading=15,)
+
+การใช้งานจะสามารถ import ได้ประมาณนี้
+
+    from core.views.pdfs import style_h1, style_h1c, style_normal
+
+style พวกนี้อาจจะตอบคำถามไม่ได้หมด เช่น ตัวชิดขอบซ้าย ขอบขวาจะทำอย่างไร แนะนำให้ทำตามนี้เพื่อให้ code ดูสะอาดและจัดการง่ายที่สุดครับ เช่น กรณีเราต้องการส่วนที่พิมวันที่ซึ่งจะมีขนาดตามปกติ (`style_normal`) แต่มันจะต้องชิดขอบขวา ก็จะสามารถทำได้โดยสร้าง style ของตัวเองเป็น
+
+    style_normal_right = ParagraphStyle('nr', parent=style_normal, alignment=TA_RIGHT,)
+
+ตอนนี้เราก็จะได้ style ที่ชิดขวามาแล้วโดยที่เราไม่ได้กำหนดรูปแบบตัวอักษรเองเลย เพียงแค่กำหนดว่าให้มันชิดฝั่งไหนก็พอตรง `alignment=TA_RIGHT` ส่วนในเรื่องของย่อหน้านั้นจะมี 2 เรื่องที่ต้องรู้คือ
+
+1. `firstLineIndent` อันนี้จะคือ จะให้ย่อหน้าเท่าไหร่สำหรับบรรทัดแรก แล้วบรรทัดอื่นก็จะกลับมาชิดซ้ายสุดเหมือนเดิม
+1. `leftIndent` จะเป็นการเลื่อนตำแหน่งขอบซ้ายทั้งย่อหน้า เหมือนอารมณ์ใช้กับ list ที่เป็นข้อๆ มันจะไม่ล้นไปซ้ายสุดขอบกระดาษ แต่เป็นการกำหนดว่า เลื่อนขอบซ้ายทั้ง `Paragraph`
+1. หน่วยของค่าที่ใช้สำหรับ 2 ตัวนี้ ก็ไม่แน่ใจเหมือนกันว่า คืออะไรครับ แต่ 4 คือ เท่ากับ 1 ตัวอักษร หรือถ้าต้องการ 4 space ก็จะต้องใช้ `firstLineIndent=16` เป็นต้น
+
+ทั้งสองอันนี้สามารถใช้ร่วมกันได้ครับ ไม่มีปัญหาอะไร
+
+ส่วนหนึ่งที่ผมคิดว่า น่าจะมีปัญหาคือ ความสูงระหว่าง `Paragraph` หรือ `spaceBefore` และ `spaceAfter` ทาง style ข้างต้นจะมีการกำหนดเพียงแค่ส่วนของ `style_h1`, `style_h1c`, `style_h2`, `style_h2c`, `style_h3`, `style_h3c` แต่ในส่วนของ `style_normal` จะไม่ได้กำหนดไว้ ดังนั้นจะสามารถเลือกได้เองว่าจะทำ style ใหม่เพื่อเพิ่มในส่วนนี้ หรือว่าจะใช้ Spacer ก็ได้
+
+### Spacer
+
+เป็นแค่ตัวว่างเปล่าไว้กำหนดความสูง
+
+    from core.views.pdfs import Spacer
+
+เวลาใช้ก็
+
+    lst.append(Spacer(1, 0.2*inch))
+
+ก็จะได้พื้นที่ว่างระหว่างตัวบนกับตัวล่างมาแล้ว 1/5 ของ 1 นิ้ว 
+
+## Table
+
+ส่วนของ Table นั้น ไม่สามารถตั้งมาตรฐานได้อย่างชัดเจน การกำหนดมาตรฐานคร่าวๆ ของตารางก็จะเป็น (1) การบังคับความกว้างของตารางและ (2) style ก็จะมีการกำหนดขนาดแบบ font, สี
+ความกว้างของตาราง
+
+เท่าที่ดูจะต้องมีการทำกระดาษแบบ landscape ด้วย แต่ไว้สรุปในเวลาต่อไป ตอนนี้ก็เป็นมาตรฐานแนวตั้งไปก่อน
+
+1. ตารางกว้างได้สูงสุด 6.8" แนวตั้ง ส่วนแนวนอนยังไม่ได้รองรับในขณะนี้
+1. ตารางมีขนาดได้ตั้งแต่ 5.8" - 6.8" เท่านั้น เว้นแต่จะได้รับการยอมรับแล้ว
+1. รวมทั้งส่วนของลายเซ็นก็เช่นกัน จะต้องเป็น table กว้างไม่ <= 6.8"
+1. ในกรณีที่ในรายงานมีหลายตารางในหน้าเดียวกัน ความกว้างของรายงานจะต้องมีความกว้างเท่ากันทั้งหมด แม้ว่าจะมีจำนวน column ไม่เท่ากัน หรืออย่างไรก็ตามครับ ก็ปรับให้มันเท่ากันซะ
+
+#### การกำหนดขนาดของ Table
+
+จากเดิมที่รูปแบบจะเป็น
+
+    t = Table(data, style=xxxxxxxxx)
+
+ก็จะมีตัวแปรเพิ่มขึ้นมาเป็น
+
+    t = Table(data, 
+           colWidths=[0.25*inch, 1.25*inch, 2.0*inch, 1.25*inch, 1.25*inch, 1.0*inch], 
+           style=xxxxxxxxx
+       )
+
+หรือจะใช้เป็น
+
+    t = Table(data, 
+              colWidths=[0.25*inch, 1.25*inch, 2.0*inch, 1.25*inch, 1.25*inch, 1.0*inch]
+           )
+    t.setStyle(TableStyle(xxxxxx))
+
+จะสังเกตเห็นได้ว่า `colWidths` มีการกำหนดตัวเลขชัดเจน เป็นความกว้างของตารางทั้งหมด (กำหนดด้วยบรรทัดที่มี column มากที่สุด ส่วนเรื่อง SPAN มันจัดการให้ตรงกับความกว้างเองครับ) สิ่งที่อธิบายได้คือ ความกว้างของตารางทั้งหมดคือ 0.25 + 1.25 + 2 + 1.25 + 1.25 + 1 = 7 แสดงว่า ตารางนี้มีความกว้างเกินที่กำหนดไว้ (จริงๆแล้วมันคือ กว้างเกินส่วนของ Paragraph จากซ้ายถึงขวาด้วย มันจะไม่สวยครับ) จะต้องแก้ไขให้ได้ 6.8 หรือน้อยกว่า เช่น 0.25 + 1.25 + 2 + 1.15 + 1.15 + 1 = 6.8 ให้ได้เท่ากับ 6.8
+
+
+#### การกำหนด style
+
+ส่วนนี้จะขึ้นกับตัวแปร style_tab
+
+    from core.views.pdfs import style_tab
+
+ส่วนการใช้งานแทนที่จะเขียนลงไปชัดเจนในส่วนของ fontface, fontsize ก็จะกลายเป็น
+
+    number_table_style = [
+           ('FONTNAME', (0,0), (-1,-1), style_tab['font']),
+           ('INNERGRID', (0,0), (-1,-1), 0.5 , style_tab['header_bg']),
+           ('FONTSIZE', (0, 0), (-1, -1), 13),
+           ('BOTTOMPADDING', (0, 0), (-1, -1), 4),
+           ('FONTNAME', (0,0), (8,2), style_tab['header_font']),
+           ('ALIGN',(1,4),(-1,-1),'LEFT'),
+           ('ALIGN',(2,4),(-1,-1),'RIGHT'),
+           ('BACKGROUND',(0,0),(8,2), style_tab['header_bg']),
+           ('SPAN',(0,0),(0,2)),
+           ('ALIGN',(0,0),(0,2),'CENTER'),
+           ('VALIGN',(0,0),(0,2),'MIDDLE'),
+           ('SPAN',(1,0),(1,2)),
+           ('ALIGN',(1,0),(1,2),'CENTER'),
+           ('VALIGN',(1,0),(1,2),'MIDDLE'),
+           ('SPAN',(-7,0),(-2,0)),
+           ('ALIGN',(-7,0),(-2,0),'CENTER'),
+           ('SPAN',(8,0),(8,2)),
+           ('ALIGN',(8,0),(8,2),'CENTER'),
+           ('VALIGN',(8,0),(8,2),'MIDDLE'),
+           ('SPAN',(2,1),(4,1)),
+           ('ALIGN',(2,1),(4,1),'CENTER'),
+           ('SPAN',(5,1),(7,1)),
+           ('ALIGN',(5,1),(7,1),'CENTER'),
+           ('SPAN',(0,3),(8,3)),
+           ('SPAN',(0,-1,),(1,-1)),
+           ('FONTNAME', (0,-2), (8,-1), style_tab['header_font']),
+           ('LINEABOVE', (0,0), (-1,-1), 0.5 , style_tab['header_bg']),
+           ('LINELEFT', (0,0), (-1,-1), 0.5 , style_tab['header_bg']),
+           ('GRID', (0,0), (-1,-1), 0.5 , style_tab['grid_color']),
+    ]
+
+จะสังเกตได้ว่า `style_tab` จะไปทดแทนการกำหนดสีพื้น, สี border, fontface, fontsize ทั้งหมดจากเดิมที่จะใช้ `colors.grey`, 'TH Sarabun New' เป็นต้น สิ่งที่สามารถเรียกได้จาก `style_tab` คือ
+
+* `style_tab['font']` -- คือ font ปกติในตาราง
+* `style_tab['header_font']` -- คือ font ตัวหนา
+* `style_tab['header_bg']` -- คือ สีพื้นของหัวตาราง (สีเทา)
+* `style_tab['fontsize']` -- คือ ขนาด font
+* `style_tab['grid_color']` -- คือ สีของ border ของตาราง

_posts/2013-12-23-auto-people-id.md

@@ -0,0 +1,19 @@
+---
+layout: post
+title:  "เลขประจำตัวประชาชนอัตโนมัติ"
+date:   2013-12-23
+tags: people_id
+---
+เลขอัตโนมัติสำหรับบุคคลที่ไม่มีเลข 13 หลัก ระบบจะสร้างเลขอัตโนมัติขึ้นตามนี้ เพื่อป้องกันโอกาสที่จะเกิดเลขซ้ำซ้อนขึ้น 
+
+    if this returns auto, then we make up people_id for the system.
+       Pxx1387767388 (13-char ID)
+       | |     |
+       | |     -- UTC UNIX Timestamp (it should be 10-digit for a while)
+       | -------- first digits of sha1(school_id) 
+       |            > this should make it more immune to duplicate
+       ---------- P -- showing that it's AUTO people_id
+
+    This way -- It's not possible to have a duplicate ID.. 
+               time machine isn't existed yet.
+

_posts/2014-11-04-errorcode.md

@@ -0,0 +1,24 @@
+---
+layout: post
+title:  "PSISv2 Error Code"
+date:   2014-11-04
+tags: error
+---
+
+Error definitions are as following:
+
+* `4A0G` school.report.miscsupport
+    * calculate_actual_support
+        * there is no ms_actual
+* `4A1G` school.report.miscsupport
+    * get_actual_for
+        * Blank student queryset
+* `4E0G` school.report.miscsupport
+    * get_estimated_for
+        * Blank student queryset
+* `5B0P` school.views.classrooms.ClassroomOperations post()
+    * delete command on student -- normally impossible case
+* `9A1G` people.views.PeopleSyncView get()
+* `9A1P` people.views.PeopleSyncView post()
+* `9A2G` people.views.PeopleExporter get()
+* `9A2P` people.views.PeopleExporter post()

_posts/2014-11-10-admin-command.md

@@ -0,0 +1,70 @@
+---
+layout: post
+type:   handbook
+title:  "Admin Commands"
+date:   2014-11-10
+tags: command admin
+---
+These are checklist admin needs to get done.
+
+* [ดึงข้อมูลจาก PSIS v1](#psis-v1)
+* [คำสั่งตรวจสอบปัญหาต่างๆ](#section)
+* [คำสั่งเก็บประมวลผลข้อมูล](#section-1)
+* [คำสั่งอื่นๆ](#section-2)
+
+
+## ดึงข้อมูลจาก PSIS v1
+
+เริ่มกันที่คำสั่งสำหรับการดึงข้อมูลเก่าเลย หลักการคล้ายกัน คือ กำหนด `school_id` ได้ตามชอบใจ ถ้าไม่ครบมันจะ search ด้วยรหัสที่พิมลงไปเป็นตัวเริ่มต้น
+
+* `$ ./manage.py <command> <school_id>`
+
+อันนี้คือจัดการของโรงเรียนที่ต้องการ
+
+* `$ ./manage.py <command> 1010`
+
+อันนี้คือจัดการของโรงเรียนที่มีรหัสโรงเรียนขึ้นต้นด้วย `1010` ทั้งหมด
+
+* `$ ./manage.py <command> all`
+
+อันนี้คือจัดการของทุกโรงเรียน ซึ่งไม่แนะนำเลยเพราะแยกเป็นหลาย process จะเร็วกว่ามากนัก
+
+คำสั่งที่มีของชุดนี้คือ
+
+* `import_v1_bank`
+* `import_v1_class_rel`
+* `import_v1_classroom`
+* `import_v1_employee`
+* `import_v1_sinfo`
+* `import_v1_student`
+* `import_v1_address`
+* `import_v1_people`
+
+เพื่อที่จะให้ได้ข้อมูลของโรงเรียนที่สมบูรณ์นั้น จะต้องทำตามคำสั่งต่อไปนี้
+
+* `import_v1_people`
+* `import_v1_student`, `import_v1_employee`, `import_v1_classroom`
+* `import_v1_sinfo`, `import_v1_address`, `import_v1_bank`, `import_v1_class_rel`
+
+โดยในข้อเดียวกันลำดับไม่มีความสำคัญ จะเริ่มอันไหนก่อนก็ไม่มีปัญหา การนำเข้าข้อมูลนั้น โดยมากจะมีการลบข้อมูลในระบบ PSISv2 ก่อนเสมอ ก่อนที่จะนำเข้าใหม่ ดังนั้น เมื่อมีการเปลี่ยนแปลงข้อมูลใน PSISv2 แล้ว ก็ไม่ควรที่จะใช้การนำเข้าแบบนี้อีกเลย
+
+
+## คำสั่งตรวจสอบปัญหาต่างๆ
+
+* `check_teacher_issue`
+* `check_student_issue`
+
+
+## คำสั่งเก็บประมวลผลข้อมูล
+
+* `run_misc_support` -- ข้อมูลเริ่มต้นสำหรับอุดหนุนทางการศึกษา
+* `db_builder` -- บังคับให้ระบบประมวลผลเงินอุดหนุนเรียนฟรี 15 ปี (เพื่อจะได้มีการแสดงผลในส่วนของสำนักงาน ไม่เช่นนั้นจะต้องรอให้โรงเรียนเปิดรายงานก่อน)
+* `mongo_report` -- รายงาน อน. และเงินเดือน
+* `mongo_stat` -- สถิติในส่วนใหญ่ใน _TOR ข้อ 4.3_
+* `mongo_yearly_stat` -- สถิติที่ URL เริ่มต้นด้วย `/yrly/`
+* `archive_students_transfer` -- [**] จำเป็นต้องสั่งทำงานวันแรกของเดือน เพื่อความถูกต้องของระบบ
+
+## คำสั่งอื่นๆ
+
+* `backfill_reviews` -- ทำงานโดยการใส่ review record ไว้สำหรับข้อมูลที่จำเป็นต้องมีการตรวจสอบ
+* `prefix_filler` -- ใส่เพศให้กับ record ที่ยังไม่มีใช้เพื่อความถูกต้องของข้อมูล Statistics เท่านั้น (เท่าที่คิดออก)

_posts/2014-11-10-admin-todo-list.md

@@ -0,0 +1,113 @@
+---
+layout: post
+type:   handbook
+title:  "Todo List"
+date:   2014-11-10
+tags: todo admin
+---
+These are checklist admin needs to get done.
+
+* [On June 10](#june-10)
+* [At the beginning of the month](#at-the-beginning-of-the-month)
+* [On Nov 10](#november-10)
+* [On Feb 15](#february-15)
+* [At the end of Febuary](#at-the-end-of-febuary)
+
+
+### June 10
+
+* backup PostgreSQL
+* backup and tar MongoDB
+* cleanup everything first (should take < 10 mins for all)
+    * `backfill_reviews`
+    * `check_student_issue`
+    * `check_teacher_issue`
+    * `archive_issues`
+    * `cleanup_glitches`
+* `mongo_report --date=20xx0610 --report=yearly`
+    * It's much better to have 1, 2, 3, ..., 9 separately (much faster)
+* `run_misc_support --date=20xx0610`
+    * it's also a good idea to separate into 1, 2, 3, 4, 5, ..., 9 or it could take > 5 hours to finish
+    * with i5 & SSD, 9 takes little over 1:30 hour
+* `mongo_yearly_stat --date=20xx0610 all`
+
+Pre-compile report for office
+
+on `/office/opec/stat/` & `/misc_support/` (on ztokyo3 contained enough tools)
+
+* `staticsitegen`
+    * don't forget to change code for `Jun10Renderer` & `MiscSupportJun10Renderer`
+    * `MiscSupportJun10Renderer` alone takes roughly 35 mins on i5 and SSD
+* `./toolkit/__meduza_cleanup.sh`
+* `~/bin/sync_psis_meduza.sh`
+* double check if data is there,
+    * `/office/opec/stat/`
+    * `/misc_support/` แบบสรุปเบิกจริง
+    * `/misc_support/` ภาคเรียนที่ 1, PDF
+
+### At the beginning of the month
+
+If it's March 1st, there is an extra work below.
+
+* backup PostgreSQL
+* backup and tar MongoDB
+* cleanup everything first (should take < 10 mins for all)
+    * `backfill_reviews`
+    * `check_student_issue`
+    * `check_teacher_issue`
+    * `archive_issues`
+    * `cleanup_glitches`
+* `mongo_report --date=20xxyy01 --report=monthly`
+    * It's much better to have 1, 2, 3, ..., 9 separately (much faster)
+* visit `/sub4sum/` page to invoke
+    * `sub4sum`
+    * `sub4sum_office`
+* `archive_students_transfer` - This usually throws 100k tasks to Celery which takes > 5 hours to complete.
+
+
+
+### November 10
+
+The process is simple, but it takes time to get jobs done.
+
+* backup PostgreSQL
+* backup and tar MongoDB
+* `run_misc_support --date=20xx1110`
+    * it's a good idea to separate into 1, 2, 3, 4, 5, ..., 9 or it could take > 5 hours to finish
+    * processed on tokyo1 & 3 simultaneously took only < 15 mins to get all things done
+    * note load distributes throughout every app & DB servers. No hard hit at all. That's why it runs smoothly fast here.
+* `mongo_report --date=20xx1110 --report=ms_nov10`
+    * 1 takes less than 10 minutes to complete (most work are done in run_misc_support already.
+    * note this does take its toll on ztokyo2 though. DB server gets hit hard at 100% every cores. Thus, it's oddly taking longer than run_misc_support in production.
+
+Pre-compile report for office on `/misc_support/` too. (on ztokyo3 contained enough tools)
+
+* staticsitegen -- don't forget to change code for Nov10Renderer
+    * This takes > 1:15 to finish on i5 & SSD; meduza is a blocking single process, so it doesn't get any better on ztokyo3, 1:35 it took on Nov 10, 2014
+* `./toolkit/__meduza_cleanup.sh`
+* `~/bin/sync_psis_meduza.sh`
+* double check if data is there,
+    * แบบสรุปเบิกจริง 10 พย.
+    * ภาคเรียนที่ 2, PDF
+
+### February 15
+
+* backup PostgreSQL
+* backup and tar MongoDB
+* make sure ms_rate is fulfilled
+* `mongo_report --date=20xx0215 --report=ms_feb15`
+
+Pre-compile report for office on `/misc_support/` too. (on ztokyo3 contained enough tools)
+
+* staticsitegen -- don't forget to change code for Feb15Renderer
+* `./toolkit/__meduza_cleanup.sh`
+* `~/bin/sync_psis_meduza.sh`
+* double check if data is there,
+    * สรุปขอเบิกประมาณการ
+
+### At the end of Febuary
+
+This is an extra work from **at the beginning of the month**
+
+* `mongo_yearly_stat --date=20xx0215 all`
+    * It's much better to have 1, 2, 3, ..., 9 separately (much faster)

handbook.md

@@ -0,0 +1,27 @@
+---
+layout: page
+title:  "Handbook"
+date:   2014-12-12
+tags: 
+---
+
+* [Admin Todo List][todolist]
+* [Admin Commands][command]
+* [Setup][setup]
+* [Milestone][milestone]
+* [psisRecord][psisrecord]
+* [PDF styling][pdfstyling]
+* [ReportLab 101][reportlab]
+
+
+
+
+
+
+[todolist]: /2014/11/admin-todo-list
+[setup]: /2014/11/app-setup
+[command]: /2014/11/admin-command
+[milestone]: /2013/10/milestone
+[psisrecord]: /2013/11/psis-record
+[pdfstyling]: /2013/12/pdf-styling
+[reportlab]: /2013/10/reportlab-101

index.html

@@ -5,10 +5,12 @@ layout: default
 <div class="home">
   <ul class="post-list">
     {% for post in site.posts %}
+      {% if post.type != 'handbook' %}
       <li>
         <span class="post-meta">{{ post.date | date: "%b %-d, %Y" }}</span>
         <a class="post-link" href="{{ post.url | prepend: site.baseurl }}">{{ post.title }}</a>
       </li>
+      {% endif %}
     {% endfor %}
   </ul>