\n
\n \n
\n \n \n
\n \nاین پروژه ای است به سفارش آلتک (اشنایدر الکتریک ایران) برای سنجش صحت شماره سریال ها با پیامک. من پروژه رو ازشون قبول کردم به این شرط که همه مراحلش رو ضبط و منتشر کنم تا نمونه ای باشه از انجام یک پروژه واقعی توسط یک فری لنسر. در این پروژه از تکنولوژی های زیر استفاده می شه:\n\n- پایتون\n- فلسک\n- ای پی آی های دریافت و ارسال اسمس از درگاه پیامک کاوه نگار\n- پاس فندق\n- مای اسکوئل\n\nکل ویدئوها رو می تونین از لینک های زیر ببینین.\n
\n\nEvery single step of this project is screen captures and you can follow them [On youtube](https://www.youtube.com/playlist?list=PL-tKrPVkKKE1vAT_rgjnvL_RgFUI9oJ9a) or [On Aparat](https://www.aparat.com/v/fAZSV?playlist=288572). \n\n## How to run\n1. Install python3, pip3, virtualenv, MySQL in your system.\n2. Clone the project `git clone https://github.com/jadijadi/sms_serial_verification && cd sms_serial_verification`\n3. in the app folder, rename the `config.py.sample` to `config.py` and do proper changes.\n4. db configs are in config.py. Create the db and grant all access to the specified user with specified password.\n5. Create a virtualenv named venv using `virtualenv -p python3 venv`\n6. Connect to virtualenv using `source venv/bin/activate`\n7. From the project folder, install packages using `pip install -r requirements.txt`\n8. Now environment is ready. Run it by `python app/main.py`\n\n## Example of creating db and granting access:\n\n> Note: this is just a sample. You have to find your own systems commands.\n\n```\nCREATE DATABASE smsmysql;\nUSE smsmysql;\nCREATE USER 'smsmysql'@'localhost' IDENTIFIED BY 'test' PASSWORD NEVER EXPIRE;\nGRANT ALL PRIVILEGES ON smsmysql.* TO 'smsmysql'@'localhost';\n```\n\n"
},
{
"path": "TODO.md",
"content": "## TODO\n- [x] Farhad seifi https://ngrok.com/\n- [x] add db path to config.py.sample\n- [x] do more while normalizing, specially against SQLInjection. remove all non alpha numerical\n- [x] some health check url\n- [x] there is problem with JJ1000000 and JJ100\n- [x] create requirements.txt (pip freeze)\n- [x] the insert will fail if there is a ' or \" in excel file\n- [x] another 10 % problem :D\n- [x] refactor name str in normalize function\n- [x] in normalize, convert AB001 to AB00001 (max len? say 15)\n- [x] dockerize (alpine? search for uwsgi)\n- [x] merge pull requests.. check I mean :)\n- [x] do proper inserts with INTO\n- [x] templating\n- [x] thanks H shafiee\n- [x] rate limit\n- [x] add call back token on kavenegar site\n- [x] we do not normalize the failed serials when importing!\n- [x] invalids can have duplicates\n- [x] migrate to mysql\n- [x] if we have 2 matches on serials, regurn a general OK message\n- [x] add altech logo from Downloads/logo.png ; top left\n- [x] close db connection in check_serial\n- [x] count the failed insertions in db\n- [x] regenerate requirements.txt with MySQLdb\n- [x] proper texts are provided in Downloads/sms_reply_texts\n- [x] is it possible to check a serial from the gui?\n- [x] dummy message for end to end test via SMS\n- [x] log all incomming smss\n- [x] Atomic problem when I'm commiting every 10 inserts\n- [x] show smss at the bottom of the Dashboard\n- [x] define indexes on mysql\n- [x] trim too long sms input\n- [x] add some nubmer to the cards\n- [x] fix line 83 and 86 :D\n- [x] are we counting inserts correctly?! :D after the merge \n- [x] Kavenegar tell which IPs they use on their admin GUI, be we already implemented another solution\n- [x] show Exception errors\n- [x] message and answer fields should be rtl\n- [x] is it a good idea to insert rows one by one? not sure. but... what to do :| say 100?\n- [x] remove debug mode\n- [x] fix page titles\n- [x] a way for restful authentication\n- [x] fix space in file name problem\n- [x] show \"waiting for calculation\" in logs, when dropping the old ones after upload\n"
},
{
"path": "app/config.py.sample",
"content": "# this is a sample config file. rename it to `config.py` and edit accordingly\n\nAPI_KEY = 'put your API key from kavenegar here'\n\n# Mysql configs\nMYSQL_HOST = 'localhost'\nMYSQL_USERNAME = 'smsmysql'\nMYSQL_PASSWORD = 'test'\nMYSQL_DB_NAME = 'smsmysql'\n\n\n# call back url from KaveNegar will look like\n# /v1/CALL_BACK_TOKEN/process\nCALL_BACK_TOKEN = 'CALL BACK TOKEN'\n\n# login cedentials\nUSERNAME = 'jadi'\nPASSWORD = 'pass'\n\n# generate one strong secret key for flask.\nSECRET_KEY = 'random long string with alphanumeric + #()*&'\n\n\n### Do not change below unless you know what you are doing\nUPLOAD_FOLDER = '/tmp'\nALLOWED_EXTENSIONS = {'xlsx'} \n\n### remote systems can call this program like \n### /v1/{REMOTE_CALL_API_KEY}/check_one_serial/\n
\n \n \n \n \n\n"
},
{
"path": "app/templates/404.html",
"content": "\n\n \n \n \n \n \n \n \n \n \n
\n \n \n
\n \n \n \n \n\n"
},
{
"path": "app/templates/500.html",
"content": "\n\n \n \n \n \n \n \n \n \n \n
\n \n \n
\n \n
\n \n \n
\n \n
\n \n \n \n \n\n"
},
{
"path": "app/templates/alert.html",
"content": "{% with messages = get_flashed_messages(with_categories=true) %}\n {% if messages %}\n {% for category, message in messages %}\n \n \n \n
\n \n \n
\n \n
\n \n \n
\n \n {{ message }}\n \n
\n {% endfor %}\n {% endif %}\n{% endwith %}"
},
{
"path": "app/templates/copyleft.html",
"content": "Copyleft by Altech (Schneider Electric Iran)\n \n
\n Version 1.4\n
\n"
},
{
"path": "app/templates/db_status.html",
"content": "\n\n \n \n \n \n \n \n \n Version 1.4\n
\n
\n \n \n \n \n\n"
}
]\n \n \n
\n \n \n
\n \n
\n \n
\n \n \n
\n Login
\n {% include 'alert.html' %}\n \n
\n