5374(ゴミナシ).jpサービスの立ち上げに必要なデータの準備


###このドキュメントを書いた日時
* 2014年02月16日 午後 新規
* 2014年02月16日 22時 追記(これから立ち上げる方へ)
* 2014年02月24日 05時 修正（target.csvファイルの説明）


***
#5374の仕組みを知る

* JavaScriptで動作している
* 最低限HTTPサーバがあれば作れる
* 収集日は何曜日または第何週の何曜日をもとに計算している
* データをすべて読み込んだ後に動作する

```
5374についてはドキュメントの最後に書いてあります。
```

***
#すべての地域に対応できているか？
　残念ながら現時点で全国のすべての地域に対応できるとは考えておりません。
対応できるかどうかはこのドキュメントを読んで皆さんが判断してください。
しかし対応できないからと諦める必要はありません。
金沢市で始まったこの５３７４プロジェクトは全国へ広がっています。
そして、オープンソースの利点を活かして各地のエンジニアがブラッシュアップしています。
皆さんも是非このプロジェクトに参加してください。

```
このドキュメントの最後にコミュニティーの情報が書いてありますので参考にしてください。
```


***
# プログラミンングが出来なくても作れるか？
多少のプログラミングの知識があった方が良いのは確かです。
しかし、立ち上げ作業の８割〜９割は情報の整理とデータの作成です。
パソコンの操作やスプレッドシート（EXCELなど）が使える方であれば可能だと考えています。
しかも安心してください。コミュニティーには沢山のエンジニアが参加しています。
コミュニティーに参加することで不安は解決することでしょう。



***
# 維持費は必要か？
アプリの立ち上げに使うサーバに何を使うかで違いますが
今回は無料で使えるgithubというクラウドサービスを
使う事ができますので維持費は必要ありません。


***
#＊＊＊　では、早速作ってみましょう。∠(･`_´･ )　＊＊＊

***
#情報を集める

###どこを探すか？
* 自治体ホームページのゴミ収集に関する情報
* 広報誌
* ゴミ収集に関するチラシ

```ポイント
・一般家庭向けのゴミ情報を探すこと。
・最新のものを探すこと。
```

###どんな情報が必要か？
* ゴミの区分（燃えるゴミ、燃えないゴミ・燃やさないゴミ、資源ゴミ　など）
* ゴミの区分の収集曜日（毎週何曜日、第何週の何曜日　など）
* 収集センターの休止期間（年末年始　など）
* ゴミの区分（分別）毎のゴミ種類一覧

###どんな形式のデータが多いか？
* PDF
* HTML
* EXCEL
* 紙媒体

```
自治体毎に情報の提供方法は異なりますが、人が見ることを前提としていますので多かれ少なかれデータの加工が必要です。
```

###どのような方法でデータを加工するか？
* 手作業で入力する（誰でも出来ます）
* プログラムで自動化変換する（プログラムを作りたい方はどうぞ）



***
#第何週の考え方
* 第２火曜日という表現

その月の１日が何曜日で始まるかで異なる。
例えば水曜日から始まっている場合は１４日となる。

|日|月|火|水|木|金|土|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
||||1|2|3|4|
|5|6|7|8|9|10|11|
|12|13|***14***|15|16|17|18|
|19|20|21|22|23|24|25|
|26|27|28|29|30|31||

以下のように火曜日から始まった場合は８日となる。

|日|月|火|水|木|金|土|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|||1|2|3|4|5|
|6|7|***8***|9|10|11|12|
|13|14|15|16|17|18|19|
|20|21|22|23|24|25|26|
|27|28|29|30|31|||

つまり第２火曜日というのは、その月の２回目の火曜日ということを指す。
5374ではこのルールでデータを作成する。


***
#情報を分析する


#### ゴミ区分を整理する
* ゴミの区分（分別方法）は何種類か？

```
金沢市のオリジナルバージョンは４種類ですが、設定を変更することで９種類まで対応した実績があります。
```


#### 地域（地区）を整理する
* ゴミの収集単位の地域を整理する



#### 収集ルールを整理する
* 収集センターの休止期間はあるか？
* 収集は曜日で決まっているか？
* 収集は毎月か？

#### ゴミの種類を整理する
* ゴミの区分にどんなゴミ（ゴミの種類）が対象になっているか？






***
#データを作成する

####作成するデータファイルは４種類
* center.csv（収集センターの休止期間）
* description.csv（ゴミの区分）
* target.csv（ゴミ区分の対象となるゴミ種類）
* area_days.csv（地区の収集スケジュール）

```補足
・ファイルはCSV形式のテキストファイルで記述する。
・文字コードはUTF-8とする。
・１行目は見出し行とする。
```

```
項目名Ａ,項目名B,項目名C,項目名D
データ,データ,データ,データ
データ,データ,データ,データ
データ,データ,データ,データ
データ,データ,データ,データ
```

####center.csvファイルの構造

|名称|休止開始日|休止終了日|
|:-:|:-:|:-:|
|Ａセンター|2014/12/29|2015/01/03|

```補足
・複数のセンターがある場合には１行に１つのセンターの形式で複数行で記述する。
```


####description.csvファイルの構造

|label|sublabel|description|styles|bgcolor|
|:-:|:-:|:-:|:--|:--|
|燃やさないごみ|||img/moyasanai02.svg|#733b96|
|資源|||img/shigen02.svg|#77ae1f|
|燃やすごみ|||img/moyasu02.svg|#ea3b13|
|びん|||img/bin02.svg|#2dc7aa|

```bash:補足
・labelのデータはarea_days.csvファイルの見出しに記述する名称と一致させること。
・stylesはゴミ区分の文字イメージ画像を指定する。（SVG形式）※用意できることが望ましい
・bgcolorはゴミ区分の背景色をRGBを１６進数で指定する。
・sublabel、descriptionは未使用。
```

####target.csvファイルの構造

|type|name|notice|furigana|
|:-:|:-:|:-:|:-:|
|燃やさないごみ|IHクッキングヒーター||あ|
|燃やさないごみ|アイロン||あ|
|資源|枝豆のネット||	え|
|資源|王冠（金属製）||お|
|資源|王冠（プラスチック製）||お|	
|燃やすごみ|アルミ箔||あ|
|燃やすごみ|アルミ箔の芯（紙製等）||あ|
|びん|一升びん|酒屋さんなどへ返しましょう・キャップを外してひと洗い|い|
|びん|ウィスキーのびん|キャップを外してひと洗い・割れたものも回収します|う|
|びん|カップ酒のびん|キャップを外してひと洗い|か|

```bash:補足
・typeはゴミの区分（分別種類）を記述する。
・nameはゴミの種類を記述する。
・noticeは分別方法を記述する。(※2014年2月19日実装されました)
・furiganaはゴミの読みを記述する。グルーピングに使用している。
```

####area_days.csvファイルの構造

|地名|センター|燃やすごみ|燃やさないごみ|資源|びん|
|:-:|:-:|:-:|:-:|:-:|:-:|
|あ地区|Ａセンター|月 木|水2|火1 火3|水4|
|い地区|Ａセンター|月 木|水4|火1 火3|水2|
|う地区|Ａセンター|火 金|月3|月2 月4:4 6 8 10 12 2|水1|

```bash:補足
・地区はファイルに記述した順番で一覧の選択肢に表示されるので探し易い順番で記述すると良い。
・３列目より右の見出しはゴミの区分として使用するのでdescription.csvファイルのlabelと一致させること。
```

```毎週収集される曜日の記述
・毎週収集されるときは曜日の漢字１文字を記述する。週に複数あるときは半角スペースで区切って記述する。
```

```第何週の何曜日と記述
・曜日の漢字の後に第何週の数字を半角で記述する。複数あるときは半角スペースで区切って記述する。
```

```対象月がある場合の記述
・収集の月を曜日の後にコロン(:)に続けて半角数字で記述する。複数あるときは半角スペースで区切って記述する。（例では偶数月）
```


***
#立ち上げ方法は、以下を参考にしてください。

* [地元の 5374 を、自前サーバを用意せずに github pages で公開する手順](http://qiita.com/kuboon/items/1b4f64a42ce5365fb1c7 "Qiita") [Qiita]


***
#これから立ち上げる方へ
###必ずご一読ください
####５３７４が作られた背景、デザインに関するポリシー

* [5374のカスタマイズについて](https://github.com/codeforkanazawa-org/5374#5347%E3%81%AE%E3%82%AB%E3%82%B9%E3%82%BF%E3%83%9E%E3%82%A4%E3%82%BA%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6) [Github]
* [参考の色資料](https://github.com/codeforkanazawa-org/5374/blob/master/5374colormanual.pdf?raw=true) [PDF]

####ソースファイルはどれを使うか
* [ソースファイルリポジトリ](https://github.com/codeforkanazawa-org/5374 "") [Github]

***
***
# ５３７４（ゴミナシ）．ｊｐについて

5374.jpは石川県金沢市のコミュニティー Code for Kanazawa （コード・フォー・カナザワ）が開発したシンプルなWebアプリです。
スマートフォンのブラウザーで使用されることを想定していますがPCでも使用できます。
しかし、残念ながらフューチャーフォン（ガラケー）には対応しておりません。
5374のソースコードはオープンソースで公開されています。ライセンスに従う事で利用することができます。

* [公式サイト Code for Kanazawa](http://codeforkanazawa.org/ "Code for Kanazawa")
* [Facebookページ Code for Kanazawa](https://www.facebook.com/CodeForKanazawa "Code for Kanazawa")
* [Facebookグループ Code for Kanazawa](https://www.facebook.com/groups/200623153433673/ "Code for Kanazawa") (Facebookのアカウントが必要です。)
* [5374（ゴミナシ）.jp公式サイト](http://5374.jp/ "5374.jp")
* [5374（ゴミナシ）.jpグループ](https://www.facebook.com/groups/554468327982662/ "5374") (Facebookのアカウントが必要です。)

***
# このドキュメントについて

このドキュメントは茨城県のコミュニティー Code for Ibaraki(コード・フォー・茨城)が作成しました。

* [公式サイト Code for Ibaraki](http://codeforibaraki.org/ "Code for Ibaraki")
* [Facebookページ Code for Ibaraki](https://www.facebook.com/codeforibaraki "Code for Ibaraki")
* [Facebookグループ Code for Ibaraki](https://www.facebook.com/groups/codeforibaraki/ "Code for Ibaraki") (Facebookのアカウントが必要です。)